xQuest

# xQuest ⚔️ | Advanced Quest System !(https://img.shields.io/badge/version-1.0.0-blue) !(https://img.shields.io/badge/minecraft-1.16.5%2B-green) !(https://img.shields.io/badge/java-17-orange) **xQuest** is a modern and fully configurable quest plugin for Minecraft servers. Designed to be lightweight, aesthetic, and easy to use, without the need for complicated external databases. !(https://cdn.modrinth.com/data/cached_images/2d804d698a862bc7866ca931168fe383624dc707_0.webp) --- ## 🔥 Key Features * **⚡ Local Database (H2):** No MySQL needed. The plugin automatically creates its own high-performance local database. * **🎨 Premium Design:** * Full support for **HEX Colors** (&#RRGGBB). * Fully editable GUI menus. * Support for **Custom Heads** (Base64) and Player Heads (`HEAD-Name`). * **⚙️ Fully Configurable:** * Edit main **Commands** (e.g., use `/missions` instead of `/xquest`). * Customize all **Permissions**. * Modify sounds, titles, action bars, and fireworks. * **🏆 Progress System:** * Visual Top #1, #2, #3 in the quest lore. * Automatic "Completed" indicators (Replaces the prize line). * Console-executable rewards. * **🔌 Hooks / Compatibility:** * **PlaceholderAPI:** Use variables in texts. * **Vault:** Economy support. --- ## 📥 Installation 1. Download the **xQuest** `.jar` file. 2. Place it in your server's `/plugins` folder. 3. Ensure you have **PlaceholderAPI** and **Vault** installed (Optional, but recommended). 4. Restart your server. 5. Done! The database and config will be created automatically. --- ## 📜 Commands and Permissions > 💡 **Note:** Both the main command and permissions are **editable** in `config.yml`. | Command (Default) | Permission (Default) | Description | | :--- | :--- | :--- | | `/xquest` | `xquest.use` | Opens the main quest menu. | | `/xquest reload` | `xquest.admin` | Reloads the configuration and quests. | *You can change `xquest.use` to `false` in the config if you want everyone to access it without permissions.* --- ## 🛠️ Configuration (Snippet) The `config.yml` file is the heart of the plugin. Here is an example of how to create a quest with a custom head: ```yaml quests: example_quest: name: "&fQuest &8• &dSlayer" type: KILL target: "ENDER_DRAGON" amount: 1 slot: 12 # Icon using Base64 texture icon: "TEXTURE-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Im..." rewards: - "eco give %player% 5000" - "msg %player% &aYou killed the dragon!" lore: - "&7Defeat the final boss." - "" - "&e⚡ Progress: &f%progress%/%total%" - "&c✦ Reward: &c5000 Coins" ``` ## Available Quest Types: - BREAK (Break blocks) - KILL (Kill entities) - CONSUME (Eat/Drink) - WALK (Walk distance) - SWIM (Swim distance) - FISH (Catch fish) - CRAFT (Craft items) - BREED (Breed animals) ## 👨‍💻 Credits * Developed by xPlugins. Made with ❤️ for the Minecraft community.