Eranio
Color theme

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

  1. Download the current version (Achievements-1.0.0.jar) and place it in the plugins folder of your Paper or Purpur server. In the Pelican Panel you can also use the Minecraft plugin installer (provider Eranio).
  2. Start the server once so the plugin creates the config.yml file in plugins/Achievements/.
  3. Adjust config.yml if 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".