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
YAMLfiles, a localSQLitedatabase protecting against data loss, or an externalMySQLdatabase 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
/giveand/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 theconfig.ymlfile and all categories in thecategories/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)
