xQuest ⚔️ | Advanced Quest System

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.

---

📸 Dashboard Screenshots

Main Dashboard	Quest in Progress	Completed Quest

(The visual design is 100% configurable via config.yml)

---

🔥 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:

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.