Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Turn everyday gameplay into a server-wide achievement hunt!
Reward exploration, combat, building, collecting, survival—and the occasional questionable decision involving a Creeper.
INSTALLATION • WIKI • SOURCE CODE • DISCORD SUPPORT
Requirements & Compatibility
- Java requirement: Java 21
- Server software: Spigot and Paper
- Tested Minecraft versions: 1.18, 1.19, 1.20, 1.20.6, 1.21, 26.1 and 26.2
- Required plugins: None—integrations are optional
Make Every Adventure Count
Vanilla advancements are great, but every server has its own story.
Advanced Achievements lets you turn that story into configurable objectives, satisfying rewards, competitive rankings and flashy celebrations. Build a relaxed progression system for an SMP, create brutal challenges for a survival server, or reward the wonderfully strange things your community does every day.
55 Achievement Categories
Advanced Achievements contains 55 built-in category types, including 44 milestone categories, 10 subcategory-based categories and special command achievements.
Track activities such as:
- Building and crafting: blocks placed or broken, items crafted, anvils, enchanting, smelting and farming
- Combat: entity kills, player kills, arrows, target blocks and custom-named mobs
- Exploration: distance travelled by foot, horse, boat, minecart, pig, llama, elytra or while sneaking
- Survival: deaths, food, potions, brewing, beds, fishing, treasures, raids and riptide uses
- Server activity: connections, playtime, commands entered, items collected and custom statistics
- Optional integrations: Jobs Reborn levels and PetMaster transfers
- Special events: create achievements awarded manually through commands
Some categories require an optional integration or may be disabled by default. You decide which objectives belong on your server.
What Players Get
- Customizable achievement GUI: Browse categories, rewards, completion dates and live progress from an inventory interface.
- Achievement books: Generate collectible, shareable books containing a player's accomplishments.
- Competitive rankings: Compare all-time, weekly and monthly achievement hunters.
- Vanilla advancement integration: Generate your custom achievements inside the advancement interface.
- Memorable celebrations: Use fireworks, particles, sounds, titles, action bars, boss bars, chat messages and advancement toasts.
- Progress everywhere: Export achievement totals and statistics through PlaceholderAPI.
Rewards Worth Hunting For
Achievements can reward players with:
- Items and custom-named items
- Experience
- Economy currency through Vault
- Increased maximum health
- Increased maximum oxygen
- One or more console commands
- Special rewards for completing every configured achievement
Run permission, crate, cosmetic or rank commands from an achievement reward—the server console handles the rest.
Built for Server Administrators
- Deep YAML customization: Configure achievement names, descriptions, goals, icons, styles, rewards, thresholds and presentation.
- Flexible restrictions: Exclude categories, worlds, game modes, NPC activity and other unwanted progression.
- Four database engines: Choose H2, SQLite, MySQL or PostgreSQL.
- Network support: Use Bungee mode with a shared database across multiple servers.
- 19 bundled language files: Customize every displayed message or build on an existing community translation.
- Command permissions: Decide who can view progress, use rankings or access administrative actions.
- Configurable performance: Adjust playtime checks, distance checks, statistic cooldowns and advancement generation speed.
Vanilla Advancement Integration
Generate configured achievements inside Minecraft's advancement interface with:
- Custom root title and background
- Achievement goal descriptions
- Normal and rare display styles
- Optional advancement-tab visibility
- Configurable toast pop-ups
- Batched generation to balance speed and server load
Use /aach generate after changing advancement-related settings.
Plugin Integrations
The following plugins have direct integration:
- Vault: Award currency through your installed economy provider.
- PlaceholderAPI: Export achievement totals, percentages and player statistics.
- EssentialsX: Prevent AFK time from counting toward playtime achievements.
- PetMaster: Track pets given to or received from other players.
- Jobs Reborn: Create objectives based on job level progression.
Additional compatibility is available through configuration or PlaceholderAPI:
- MythicMobs and other custom-mob plugins: Track kills using custom entity display names.
- Custom Heads and named-item plugins: Create placement objectives using custom item display names.
- Scoreboards, tab lists, chat, holograms and statistics displays: Show exported values through PlaceholderAPI-compatible plugins.
- BungeeCord networks: Share progress through Bungee mode and a remote database.
Commands
Advanced Achievements provides 18 /aach commands. Use /aach help in game for interactive help, arguments and clickable suggestions.
Click to view the command overview
Player and Information Commands
/aach help— Display the interactive command guide./aach info— Display plugin, version, database and integration information./aach list— Open the achievement GUI./aach stats— Display achievement completion statistics./aach book— Receive an achievement book./aach top— View all-time rankings./aach week— View weekly rankings./aach month— View monthly rankings./aach toggle— Toggle notifications about other players' achievements./aach hcaa— Discover the plugin's easter egg.
Administrative Commands
/aach give— Award a command achievement./aach add— Increase a player statistic./aach check— Check whether a player received an achievement./aach inspect— Inspect recent recipients of an achievement./aach delete— Remove an achievement from a player./aach reset— Reset category statistics./aach reload— Validate and reload configuration files./aach generate— Generate or regenerate vanilla advancements.
PlaceholderAPI Reference
Use these placeholders in compatible scoreboards, tab lists, chat plugins, holograms and other displays.
Click to view the PlaceholderAPI reference
Main Placeholders
%aach_achievements%— Achievements earned by the player.%aach_total_achievements%— Total configured achievements.%aach_achievements_percentage%— Overall completion percentage, such as 42.5%.%aach_total_commands%— Configured command achievements.
Standard Statistics
%aach_<category>%
%aach_total_<category>%
Examples:
%aach_connections%— Player connection count.%aach_total_connections%— Configured connection achievements.%aach_playedtime%— Played time in hours with one decimal place.
Supported standard category names:
connections, deaths, arrows, snowballs, eggs, fish, treasures,
itembreaks, eatenitems, shear, milk, lavabuckets, waterbuckets,
trades, anvilsused, enchantments, beds, maxlevel, consumedpotions,
playedtime, itemdrops, itempickups, hoeplowings, fertilising,
taming, brewing, fireworks, musicdiscs, enderpearls,
petmastergive, petmasterreceive, smelting, distancefoot,
distancepig, distancehorse, distanceminecart, distanceboat,
distancegliding, distancellama, distancesneaking, raidswon,
riptides, advancementscompleted, booksedited
Subcategory Statistics
%aach_<category>_<subcategory>%
Examples:
%aach_places_stone%— Stone blocks placed.%aach_breaks_ice%— Ice blocks broken.%aach_kills_zombie%— Zombies killed.%aach_crafts_diamond_sword%— Diamond swords crafted.%aach_effectsheld_speed%— Speed effects held.
Supported subcategory category names:
places, breaks, kills, targetsshot, crafts, breeding,
playercommands, custom, jobsreborn, effectsheld
Use %aach_total_<category>% to retrieve the number of configured achievements in a standard or subcategory-based category.
Ready to Begin the Hunt?
Start with the installation guide, explore the complete wiki, or view the latest default configuration.
Found a bug? Open a GitHub issue.
Need a hand? Join the Discord support server.
Originally developed by PyvesB from 2015 to 2021. Maintained for modern Minecraft versions by LucidAPs.
