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.