Overview, installation & commands
Eranio Published on: 15. November 2026
Achievements (Minecraft): Overview, installation & commands
Achievements is a Minecraft server plugin that rewards players for what they do. It runs entirely on your own server, an outside connection is only needed for the optional livestream feed.
How it works
The plugin reads the statistics Minecraft already keeps for every player (blocks mined, items crafted, distance travelled, mobs defeated, food eaten and more) and adds its own trackers for biomes, dimensions, deaths and a few secrets. Both are compared against a catalog of 351 achievements with four tiers: Bronze, Silver, Gold and Legendary. Because the vanilla statistics are used, a player who already played on the server gets credit for earlier progress the moment they join.
Unlocks are shown as advancement toasts and listed in their own tab of the advancement screen, with the chat announcement of vanilla advancements. If you switch advancements off, a title and a sound are shown instead.
Requirements
- Paper or Purpur 1.20 or newer, tested up to the newest release listed with the download. Spigot and Bukkit are not supported, the plugin disables itself with a message on those.
- Java 17 or newer (the Java version your server needs anyway)
- Optional: MySQL 8 or MariaDB
Installation
- Download the current version (
Achievements-1.0.0.jar) and place it in thepluginsfolder of your Paper or Purpur server. In the Pelican Panel you can also use the Minecraft plugin installer (provider Eranio). - Start the server once so the plugin creates the
config.ymlfile inplugins/Achievements/. - Adjust
config.ymlif needed and run/achievements reload.
New versions are found by the plugin installer on its own, see the documentation of the Minecraft plugin installer under Own update source.
Commands
| Command | Description | Permission |
|---|---|---|
/achievements |
Opens the menu. Aliases: /erfolge, /erfolg, /ach |
achievements.use |
/achievements top |
Shows the ten players with the most points | achievements.use |
/achievements private and /achievements public |
Hides or shows your profile in the ranking | achievements.use |
/achievements title <id> |
Sets an unlocked achievement as your title, without an id it removes the title | achievements.use |
/achievements reload |
Reloads config.yml and the achievement files |
achievements.admin |
/achievements give <player> <id> |
Unlocks an achievement for an online player | achievements.admin |
/achievements revoke <player> <id> |
Removes an achievement from an online player | achievements.admin |
/achievements reset <player> |
Resets all progress and unlocks of an online player | achievements.admin |
/achievements selftest |
Checks that every statistic source works on this server version | achievements.admin |
achievements.use is granted to everyone by default, achievements.admin to operators.
The menu
The first page shows your head with overall progress, points and your five latest unlocks, plus one button per category. A category lists its achievements with description, tier, progress bar, unlock date and how many percent of the players have it. Secret achievements show a grey dye instead of their name, a hint and, once you reached 75 percent, the note "Almost there".