# MoreVanillaAdvancements<\/p>\n
**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.<\/p>\n
—<\/p>\n
## \u2726 Key Features \u2726<\/p>\n
### \u2728 Custom Advancements
\n– Create unlimited advancements with customizable icons, descriptions, and objectives
\n– Full progression support (counters, percentages, milestones, etc.) <\/p>\n
### \ud83c\udf81 Reward System
\n– Grant experience points upon completion
\n– Automatically give items as rewards
\n– Execute custom commands when an advancement is completed <\/p>\n
### \ud83d\udcc2 Category Organization
\n– Organize advancements into logical categories
\n– Clean visual layout with customizable icons
\n– Optional hideable categories <\/p>\n
### \ud83d\udda5\ufe0f Intuitive User Interface
\n– Player-friendly and easy-to-navigate GUI menus
\n– Clear display of progress, completion state, and rewards
\n– Intuitive back button and navigation controls <\/p>\n
### \ud83d\udee1\ufe0f Anti-Grief Protection
\n– Items cannot be removed from the GUI
\n– Shift-click, drag and most inventory interactions are blocked
\n– Safe for public use on survival servers <\/p>\n
### \ud83d\udcca Progress Viewing ### \u2699\ufe0f Flexible Configuration —<\/p>\n ## \u2726 Commands \u2726<\/p>\n – **\/mva [open]** \u2013 Open your own advancement menu —<\/p>\n ## \u2726 Configuration \u2726<\/p>\n Everything is configured through YAML files:<\/p>\n – Advancements and their properties (name, description, type, amount, category, rewards, etc.) Typical files:<\/p>\n – `plugins\/MoreVanillaAdvancements\/config.yml` \u2013 General settings, language, GUI settings Example advancement (simplified):<\/p>\n “`yaml Configuration validation:<\/p>\n – On startup and `\/mva reload`, the plugin validates all achievements —<\/p>\n ## \u2726 Permissions \u2726<\/p>\n Player access:<\/p>\n – **morevanillaadvancements.view** \u2013 Access to the advancement menu (default: `true`) Core permissions (suggested):<\/p>\n – **mva.use** \u2013 General access to the `\/mva` command (default: `true`) > Adjust permission names to match your `plugin.yml` if they differ.<\/p>\n —<\/p>\n ## \u2726 Supported Versions \u2726<\/p>\n – Minecraft server software: **Paper\/Spigot 1.21+** Older versions are not officially supported unless explicitly stated in the releases.<\/p>\n —<\/p>\n ## \u2726 User Interface \u2726<\/p>\n ### Player GUI – Name and description of each advancement Navigation:<\/p>\n – Clickable items to open categories or details ### Admin GUI – Quickly toggle broadcast messages in chat —<\/p>\n ## \u2726 Rewards System \u2726<\/p>\n Each advancement can grant one or more rewards:<\/p>\n – **XP reward** – **Item reward** (single or multiple items) – **Command reward** (executed from console) Supported placeholders (in rewards\/commands):<\/p>\n – `{player}` \u2013 The name of the player who completed the advancement <\/p>\n —<\/p>\n ## \u2726 Multi-Language Support \u2726<\/p>\n The plugin ships with a simple localization system:<\/p>\n – Default language: `en` Languages can be configured:<\/p>\n – In `config.yml` (e.g. `language: en`) Language files (examples):<\/p>\n - `lang_en.yml` Each file contains all translatable messages (GUI titles, chat messages, errors, etc.).<\/p>\n ---<\/p>\n ## \u2726 Data & Performance \u2726<\/p>\n - Player progress is persisted in YAML and cached in memory Technical notes:<\/p>\n - Distances tracked in centimeters (100 cm = 1 block) ---<\/p>\n ## \u2726 Build & Installation \u2726<\/p>\n ### Build (Gradle) ```bash The built jar will be available in `build\/libs\/` and can optionally be auto-copied to a `server\/plugins\/` folder if you configured it in your Gradle script.<\/p>\n ### Installation ---<\/p>\n ## \u2726 Roadmap \u2726<\/p>\n Planned or potential future improvements:<\/p>\n - PlaceholderAPI support (e.g. `%mva_progress_{id}%`) ---<\/p>\n ## \u2726 Support \u2726<\/p>\n If you need help:<\/p>\n - Check the documentation in this repository Thank you for using **MoreVanillaAdvancements**!<\/p>\n","protected":false},"excerpt":{"rendered":" Custom Advancements system 100% customizable<\/p>\n","protected":false},"featured_media":106268,"template":"","meta":{"_minecraft_slug":"morevanillaadvancements","_minecraft_project_id":"HV4nzDuy","_minecraft_author":"mathildeuh","_minecraft_license":"Apache-2.0","_minecraft_downloads":133,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"morevanillaadvancements.zip","_minecraft_size_bytes":2254618,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:00:13.694695Z","_minecraft_date_created":"2025-11-22T10:07:00.787998Z","_minecraft_date_modified":"2025-11-19T20:37:53.390314Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/morevanillaadvancements","_minecraft_icon_attachment_id":106268,"_minecraft_imported_at":"2026-06-06T03:17:38+00:00","_minecraft_import_hash":"48bb7f7af24fffcecfed76b08b0e49fe","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-106267","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Open your own progress menu with `\/mva` or `\/mva open`
\n– View another player\u2019s advancements using `\/mva open
\n– Unified, consistent interface for all players <\/p>\n
\n– Multi-language message system
\n– Simple YAML-based configuration files
\n– Supports color codes and text formatting <\/p>\n
\n– **\/mva open
\n– **\/mva create** \u2013 Open the GUI to create a new advancement
\n– **\/mva edit** \u2013 Open the GUI to edit existing advancements
\n– **\/mva delete
\n– **\/mva settings** \u2013 Open the admin settings GUI
\n– **\/mva list [page]** \u2013 List all advancements with clickable pagination
\n– **\/mva view
\n– **\/mva reset
\n– **\/mva lang [code]** \u2013 Change the plugin language (`en`, `fr`, `es`, etc.)
\n– **\/mva reload** \u2013 Reload and validate configuration files <\/p>\n
\n– Categories and their icons\/visibility
\n– Messages and displayed text
\n– GUI titles and icons <\/p>\n
\n– `plugins\/MoreVanillaAdvancements\/achievements.yml` \u2013 All custom advancements
\n– `plugins\/MoreVanillaAdvancements\/progress.yml` \u2013 Saved player progression (auto-managed by the plugin) <\/p>\n
\nachievements:
\n marathon:
\n name: Marathon
\n description: Walk 10 km in total
\n icon: LEATHER_BOOTS
\n type: WALK
\n target: “*”
\n amount: 1000000 # 10 km in centimeters
\n category: “Movement”
\n reward:
\n xp: 100
\n give: “BREAD:4”
\n command: “say {player} just completed Marathon!”
\n“`<\/p>\n
\n– Invalid fields (missing type, invalid amount, bad material names, etc.) are reported in console
\n– Critical errors prevent loading; warnings are logged but the plugin continues to run <\/p>\n
\n– **morevanillaadvancements.view.others** \u2013 View other players’ advancements <\/p>\n
\n– **mva.editor** \u2013 Access to editor features (`\/mva create`, `\/mva edit`, `\/mva delete`, `\/mva settings`)
\n– **mva.reset** \u2013 Use `\/mva reset` to reset player progress
\n– **mva.reload** \u2013 Use `\/mva reload` to reload configuration
\n– **mva.lang** \u2013 Change plugin language with `\/mva lang` <\/p>\n
\n– Recommended Java version: **Java 21** or newer <\/p>\n
\nThe main advancements GUI shows:<\/p>\n
\n– Current progress (e.g. `42 \/ 100`, percentage, etc.)
\n– Completion state (e.g. a green `\u2714 Completed` line when done)
\n– Rewards summary (XP, items, and\/or commands) <\/p>\n
\n– Back button to return to the previous menu
\n– Protection against taking\/moving items out of the GUI <\/p>\n
\nThe admin\/settings GUI allows you to:<\/p>\n
\n– Enable\/disable private titles for completed advancements
\n– Access editor tools to create, edit or delete advancements <\/p>\n
\n “`yaml
\n reward:
\n xp: 100
\n “`<\/p>\n
\n “`yaml
\n reward:
\n give: “DIAMOND:8,EMERALD:4”
\n “`<\/p>\n
\n “`yaml
\n reward:
\n command: “say {player} completed an epic challenge!”
\n “`<\/p>\n
\n– Additional example languages: `fr`, `es` (if provided in your resources) <\/p>\n
\n– At runtime using `\/mva lang ` <\/p>\n
\n- `lang_fr.yml`
\n- `lang_es.yml` <\/p>\n
\n- Completed advancements are no longer tracked to reduce overhead
\n- Regular auto-save and safe shutdown saving
\n- Designed to be lightweight and suitable for survival and SMP servers <\/p>\n
\n- Damage tracked as half-hearts \u00d7 10
\n- Time tracked in ticks (20 ticks = 1 second) <\/p>\n
\nFrom the project root:<\/p>\n
\n.\/gradlew clean build
\n```<\/p>\n
\n1. Place the jar in your server's `plugins\/` folder
\n2. Start the server once to generate default configuration files
\n3. Edit `config.yml` and `achievements.yml` to match your server's needs
\n4. Use `\/mva reload` to apply changes, or restart the server <\/p>\n
\n- Multi-stage \/ tiered advancements
\n- Per-advancement sounds and custom completion messages
\n- Improved in-game GUI editor (search, duplication, filters, etc.)
\n- Additional trigger types (play time, custom stats, etc.) <\/p>\n
\n- Open an issue on GitHub with logs and your configuration snippets
\n- Provide your server version, Java version, and plugin version when reporting bugs <\/p>\n