EasyQuests ⚔️

EasyQuests is a modern, lightweight, and highly efficient quest engine featuring a linear progression tree, built specifically for Survival, RPG, and Skyblock servers. It offers seamless integration with modern interfaces and full data synchronization.

⭐ Key Features

🗺️ Smooth Pagination (Multi-Page GUI): If your quest line contains more than 28 quests, the plugin automatically splits it into dynamic pages with smooth feather-based navigation.
💾 Database Storage (SQL): Choose your preferred storage solution: flat YAML files, a local SQLite database protecting against data loss, or an external MySQL database for network synchronization across BungeeCord/Velocity.
⏱️ Fading HUD (Fading Cooldown): BossBars and ActionBars only appear when a player is actively pursuing a quest, automatically fading out after 5 seconds of inactivity to keep the screen clutter-free.
🛡️ Advanced Anti-Exploit System: Automatically tags player-placed blocks (ores, wood) with metadata, preventing exploits where players continuously place and break the same resources.
🧪 Alchemy and Crafting Support: Accurate tracking of bulk item crafting (including Shift-Click) and potion brewing (with full compatibility from 1.16 up to the latest releases: 1.20.5+ and newer).
📝 Automatic Reward Translator: The plugin natively interprets console commands (such as /give and /xp add) and displays them in descriptions as clean, styled text inside the GUI (e.g., » 5x Bread, » 50 XP).

🔗 PlaceholderAPI & CustomNameplates Integration

The plugin provides optimized PlaceholderAPI placeholders, ideal for integration with CustomNameplates, tab lists (TAB), or scoreboards:

Placeholder	Description	Example
`%easyquests_has_active%`	Returns `true` or `false` (used as a condition to display the HUD)	`true`
`%easyquests_active_quest%`	Name of the currently active quest	`Coal Beginnings`
`%easyquests_progress%`	Player's current progress in the quest	`4`
`%easyquests_target%`	Required amount to complete the quest	`16`
`%easyquests_percent%`	Percentage completion of the quest	`25`
`%easyquests_progress_bar%`	RPG-style, colorful progress bar with block characters	`■■■■■■■■■■`

🛠️ Commands and Permissions

/quests (Aliases: /zadania, /easyquests, /questy) — Opens the main quest category menu.
Permission: easyquests.use (Default: true)
/quests reload — Instantly reloads the config.yml file and all categories in the categories/ folder.
Permission: easyquests.admin (Default: OP)

💻 Requirements and Compatibility

Java Version: Java 17 or newer
Server Software: Paper / Spigot 1.16 - 1.20.x, 1.21, 1.22+
Dependencies: PlaceholderAPI (Soft-dependency, recommended)