More Vanilla Advancements

# MoreVanillaAdvancements **MoreVanillaAdvancements** is a plugin that enhances Minecraft's vanilla advancement system by offering a complete and fully customizable progression experience. Create your own achievements, manage rewards, and provide engaging and motivating gameplay for your players. --- ## ✦ Key Features ✦ ### ✨ Custom Advancements - Create unlimited advancements with customizable icons, descriptions, and objectives - Full progression support (counters, percentages, milestones, etc.) ### 🎁 Reward System - Grant experience points upon completion - Automatically give items as rewards - Execute custom commands when an advancement is completed ### 📂 Category Organization - Organize advancements into logical categories - Clean visual layout with customizable icons - Optional hideable categories ### 🖥️ Intuitive User Interface - Player\-friendly and easy\-to\-navigate GUI menus - Clear display of progress, completion state, and rewards - Intuitive back button and navigation controls ### 🛡️ Anti\-Grief Protection - Items cannot be removed from the GUI - Shift\-click, drag and most inventory interactions are blocked - Safe for public use on survival servers ### 📊 Progress Viewing - Open your own progress menu with `/mva` or `/mva open` - View another player’s advancements using `/mva open <player>` - Unified, consistent interface for all players ### ⚙️ Flexible Configuration - Multi\-language message system - Simple YAML\-based configuration files - Supports color codes and text formatting --- ## ✦ Commands ✦ - **/mva \** – Open your own advancement menu - **/mva open \<player\>** – View another player's advancements - **/mva create** – Open the GUI to create a new advancement - **/mva edit** – Open the GUI to edit existing advancements - **/mva delete \<id\>** – Open a confirmation GUI to delete an advancement - **/mva settings** – Open the admin settings GUI - **/mva list \** – List all advancements with clickable pagination - **/mva view \<player\>** – Open another player's progression GUI (online or offline, if supported) - **/mva reset \<player\> \** – Reset a player's advancement progression - **/mva lang \** – Change the plugin language (`en`, `fr`, `es`, etc.) - **/mva reload** – Reload and validate configuration files --- ## ✦ Configuration ✦ Everything is configured through YAML files: - Advancements and their properties (name, description, type, amount, category, rewards, etc.) - Categories and their icons/visibility - Messages and displayed text - GUI titles and icons Typical files: - `plugins/MoreVanillaAdvancements/config.yml` – General settings, language, GUI settings - `plugins/MoreVanillaAdvancements/achievements.yml` – All custom advancements - `plugins/MoreVanillaAdvancements/progress.yml` – Saved player progression (auto\-managed by the plugin) Example advancement (simplified): ```yaml achievements: marathon: name: Marathon description: Walk 10 km in total icon: LEATHER_BOOTS type: WALK target: "*" amount: 1000000 # 10 km in centimeters category: "Movement" reward: xp: 100 give: "BREAD:4" command: "say {player} just completed Marathon!" ``` Configuration validation: - On startup and `/mva reload`, the plugin validates all achievements - Invalid fields (missing type, invalid amount, bad material names, etc.) are reported in console - Critical errors prevent loading; warnings are logged but the plugin continues to run --- ## ✦ Permissions ✦ Player access: - **morevanillaadvancements.view** – Access to the advancement menu (default: `true`) - **morevanillaadvancements.view.others** – View other players' advancements Core permissions (suggested): - **mva.use** – General access to the `/mva` command (default: `true`) - **mva.editor** – Access to editor features (`/mva create`, `/mva edit`, `/mva delete`, `/mva settings`) - **mva.reset** – Use `/mva reset` to reset player progress - **mva.reload** – Use `/mva reload` to reload configuration - **mva.lang** – Change plugin language with `/mva lang` > Adjust permission names to match your `plugin.yml` if they differ. --- ## ✦ Supported Versions ✦ - Minecraft server software: **Paper/Spigot 1.21+** - Recommended Java version: **Java 21** or newer Older versions are not officially supported unless explicitly stated in the releases. --- ## ✦ User Interface ✦ ### Player GUI The main advancements GUI shows: - Name and description of each advancement - Current progress (e.g. `42 / 100`, percentage, etc.) - Completion state (e.g. a green \`✔ Completed\` line when done) - Rewards summary (XP, items, and/or commands) Navigation: - Clickable items to open categories or details - Back button to return to the previous menu - Protection against taking/moving items out of the GUI ### Admin GUI The admin