Eranio
Farbthema

Konfiguration & eigene Erfolge

Eranio Veröffentlicht am: 15. November 2026

Achievements (Minecraft): Konfiguration & eigene Erfolge

Alle Einstellungen stehen in plugins/Achievements/config.yml. /achievements reload übernimmt Änderungen an den meisten davon, die Speicherart braucht einen Neustart.

config.yml

Feld Standard Beschreibung
language auto auto nutzt die Clientsprache jedes Spielers (Deutsch oder Englisch, sonst Englisch), de oder en erzwingen eine Sprache für alle. Die Texte der Fortschritte sind für alle gleich und folgen de oder Englisch
storage.type sqlite sqlite (auch akzeptiert: file) hält eine Datenbankdatei achievements.db im Plugin-Ordner, mysql nutzt den Server darunter
storage.mysql.host localhost MySQL-Host, nur bei mysql
storage.mysql.port 3306 MySQL-Port
storage.mysql.database achievements Datenbankname, die Tabellen mit dem Präfix ach_ werden automatisch angelegt
storage.mysql.username leer MySQL-Benutzername
storage.mysql.password leer MySQL-Passwort
live.enabled false Schaltet die Livestream-Anbindung ein. Ohne sie bleibt die Livestream-Kategorie verborgen
live.url leer Adresse des Feeds, siehe unten
live.token leer Token, gesendet als Authorization: Bearer <token>
live.minutes-to-count 10 Minuten, die ein Spieler während eines Streams online sein muss, damit er zählt
live.early-minutes 10 Zeitfenster am Streamanfang, das noch als "pünktlich" gilt
pioneer-limit 50 Die ersten Spieler bis zu dieser Zahl erhalten den Pionier-Erfolg
timezone UTC Zeitzone für tägliche Login-Serien und die Uhrzeit-Geheimnisse, zum Beispiel Europe/Berlin
announce-in-chat true Freischaltungen wie bei Vanilla-Fortschritten allen im Chat melden
notifications.advancements true Freischaltungen als Fortschritts-Hinweis mit eigenem Reiter anzeigen. Ausgeschaltet erscheinen ein Titel und ein Ton
disabled-categories leere Liste Kategorie-IDs, die komplett abgeschaltet sind, zum Beispiel [live, geheim]
selftest-on-start false Führt bei jedem Start die Quellenprüfung aus und schreibt das Ergebnis ins Log
web-api.* aus Optionale lesende Web-Schnittstelle für die eigene Website, siehe die Anleitung Schnittstellen für Websites und Plugins

Der Fortschritt wird jede Minute gespeichert, beim Verlassen eines Spielers und beim Stoppen des Servers.

Speicher

sqlite braucht nichts weiter. Mit mysql können alle Server eines Netzwerks eine Datenbank teilen, die Erfolge eines Spielers folgen ihm dann von Server zu Server. Die Tabellen legt das Plugin selbst an. Ist die Datenbank beim Start nicht erreichbar, schaltet sich das Plugin ab und schreibt den Grund ins Log.

Livestream-Feed (eranio.de)

Nutzt du StreamBridge, sagt der Feed deines Servers auf eranio.de dem Plugin, ob du live bist und welche Spieler von einer Zuschauer-Aktion getroffen wurden. Trage als live.url die Adresse https://eranio.de/api/v1/minecraft/achievement-feed ein, als live.token das StreamBridge-Token deines Servers und setze live.enabled auf true. Das Plugin fragt einmal pro Minute mit game=minecraft und der Nummer des zuletzt bekannten Treffers, die Antwort sieht so aus:

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

Eigene Feeds, die im selben Format antworten, funktionieren ebenfalls.

Eigene Erfolge

Lege plugins/Achievements/custom-achievements.yml mit dem Aufbau des mitgelieferten Katalogs an, um Erfolge hinzuzufügen oder bestehende über ihre ID zu ersetzen. Beispiel:

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."}
Feld Bedeutung
tier bronze, silber, gold oder legendaer (10, 25, 50 oder 100 Punkte)
key Name des Zählers, der mit goal verglichen wird
hidden true für einen geheimen Erfolg, braucht in beiden Sprachen einen hint
since Spielversion, ab der es den Erfolg gibt, zum Beispiel "1.21". Ältere Server blenden ihn aus

Quellen

Ein Schlüssel ohne Quelle wird von einem eingebauten Beobachter gefüllt. Im Abschnitt sources bindest du einen Schlüssel an eine Minecraft-Statistik. Der Wert wird alle zehn Sekunden gelesen und zählt deshalb auch, was vorher passiert ist.

Ausdruck Zählt
stat:WALK_ONE_CM+SPRINT_ONE_CM/100000 Einfache Statistiken (Bukkit-Statistic-Namen), addiert, mit optionalem Teiler hinter einem Schrägstrich
mine:DIAMOND_ORE+DEEPSLATE_DIAMOND_ORE Abgebaute Blöcke
craft:IRON_PICKAXE Hergestellte Gegenstände
use:TORCH Benutzte Gegenstände, dazu zählen gesetzte Blöcke und gegessene Speisen
pickup:ENDER_PEARL Aufgehobene Gegenstände
kill:ZOMBIE Besiegte Monster
total:mine, total:craft, total:pickup, total:place, total:food, total:foods-distinct Summen über alle Blöcke oder Gegenstände

Ein Materialname mit * am Anfang trifft jedes Material, das so endet, zum Beispiel *_LOG. Namen, die es in der laufenden Spielversion nicht gibt, werden übersprungen, /achievements selftest listet Quellen auf, die dadurch leer bleiben.