Eranio
Color theme

Configuration & own achievements

Eranio Published on: 15. November 2026

Achievements (Minecraft): Configuration & own achievements

All settings are in plugins/Achievements/config.yml. /achievements reload applies changes to most of them, the storage type needs a restart.

config.yml

Field Default Description
language auto auto uses the client language of each player (German or English, English otherwise), de or en force one language for everyone. Advancement texts are the same for all players and follow de or English
storage.type sqlite sqlite (also accepted: file) keeps a database file achievements.db in the plugin folder, mysql uses the server below
storage.mysql.host localhost MySQL host, only used with mysql
storage.mysql.port 3306 MySQL port
storage.mysql.database achievements Database name, tables are created automatically with the prefix ach_
storage.mysql.username empty MySQL username
storage.mysql.password empty MySQL password
live.enabled false Switches the livestream connection on. Without it the livestream category is hidden
live.url empty Address of the feed, see below
live.token empty Token sent as Authorization: Bearer <token>
live.minutes-to-count 10 Minutes a player has to be online during a stream for it to count
live.early-minutes 10 Window at the start of a stream that still counts as "on time"
pioneer-limit 50 The first players up to this number receive the pioneer achievement
timezone UTC Time zone for daily login streaks and the clock based secrets, for example Europe/Berlin
announce-in-chat true Announce unlocks to everyone in chat like vanilla advancements
notifications.advancements true Show unlocks as advancement toasts with their own advancement tab. When off, a title and a sound are shown
disabled-categories empty list Category ids that are switched off completely, for example [live, geheim]
selftest-on-start false Runs the source check on every start and logs the result
web-api.* off Optional read only web interface for your own website, see the guide Interfaces for websites and plugins

Progress is saved every minute, when a player leaves and when the server stops.

Storage

sqlite needs nothing else. With mysql all servers of a network can share one database, the achievements of a player then follow them from server to server. The plugin creates its tables on its own. If the database cannot be reached on start, the plugin disables itself and logs the reason.

Livestream feed (eranio.de)

If you use StreamBridge, the feed of your server on eranio.de tells the plugin whether you are live and which players were hit by a viewer action. Enter the address https://eranio.de/api/v1/minecraft/achievement-feed as live.url, the StreamBridge token of your server as live.token and set live.enabled to true. The plugin asks once a minute with game=minecraft and the id of the last known hit, the answer looks like this:

{ "live": true, "session": "abc123", "started_at": "2026-10-18T20:00:00Z", "last_id": 42, "hits": [ { "player": "Steve" } ] }

Own feeds that answer in the same format work as well.

Own achievements

Create plugins/Achievements/custom-achievements.yml with the structure of the bundled catalog to add achievements or replace existing ones by id. Example:

categories:
  event:
    icon: FIREWORK_ROCKET
    de: Event
    en: Event
sources:
  my_logs: "mine:OAK_LOG+BIRCH_LOG"
achievements:
  woodcutter:
    category: event
    tier: gold
    icon: IRON_AXE
    key: my_logs
    goal: 500
    de: {name: "Holzmeister", desc: "Fälle 500 Eichen- oder Birkenstämme."}
    en: {name: "Wood master", desc: "Chop 500 oak or birch logs."}
Field Meaning
tier bronze, silber, gold or legendaer (10, 25, 50 or 100 points)
key Name of the counter that is compared with goal
hidden true for a secret achievement, needs a hint in both languages
since Game version from which the achievement exists, for example "1.21". Older servers hide it

Sources

A key without a source is filled by a built in tracker. In the sources section you can bind a key to a Minecraft statistic. The value is read every ten seconds, so it also counts what happened before.

Expression Counts
stat:WALK_ONE_CM+SPRINT_ONE_CM/100000 Plain statistics (Bukkit Statistic names), added up, with an optional divisor behind a slash
mine:DIAMOND_ORE+DEEPSLATE_DIAMOND_ORE Blocks mined
craft:IRON_PICKAXE Items crafted
use:TORCH Items used, which includes placed blocks and eaten food
pickup:ENDER_PEARL Items picked up
kill:ZOMBIE Mobs defeated
total:mine, total:craft, total:pickup, total:place, total:food, total:foods-distinct Totals over all blocks or items

A material name starting with * matches every material that ends this way, for example *_LOG. Names that do not exist on the running game version are skipped, /achievements selftest lists sources that end up empty.