Übersicht, Installation & Befehle

Eranio Veröffentlicht am: 19. Oktober 2026

Achievements (Hytale): Übersicht, Installation & Befehle

Achievements ist ein Hytale-Server-Plugin, das erfasst, was Spieler in der Welt tun, und sie dafür mit Erfolgen belohnt. Es läuft vollständig auf deinem eigenen Server, eine Verbindung nach außen ist nicht nötig.

Funktionsweise

Das Plugin beobachtet die Spieleraktivität auf deinem Server (Bauen, Abbauen, Kampf, Craften, Erkundung, Handel, Schlafen, Reittiere und mehr) über eigene Beobachter und vergleicht sie mit einem eingebauten Katalog an Erfolgen. Fortschritt und Freischaltungen werden je Spieler gespeichert. Es ist keine Datenbank nötig, alles liegt als Dateien im Datenordner des Plugins, MySQL ist optional verfügbar.

Installation

Die Jar lässt sich über die Setup-Seite von Hytale Admin als optionales Plugin installieren oder von Hand herunterladen.

Lade die aktuelle Version (Achievements-Hytale-1.0.3.jar) von https://eranio.de/downloads/hytale/ herunter, zusammen mit achievements-latest.json für die Versionsprüfung, und kopiere sie in den Ordner mods deines Hytale-Servers.
Starte den Server einmal. Das Plugin legt den Datenordner mods/Eranio_Achievements/ mit einer config.json darin an.
Passe config.json bei Bedarf an und starte den Server neu.

Die Jar ist signiert. Die Signatur liegt in META-INF/MOD.SIG (SHA256withRSA über alle Jar-Einträge, nach Namen sortiert).

Konfiguration (`config.json`)

Feld	Typ	Standardwert	Beschreibung
`language`	String	`en`	Sprache von Fenster, Chat-Meldungen und Benachrichtigungen (`en` oder `de`)
`storage.type`	String	`file`	`file` speichert alles im Datenordner. `mysql` nutzt die Datenbank darunter. Ist die Datenbank nicht erreichbar, speichert das Plugin automatisch in Dateien
`storage.host`	String	`localhost`	MySQL-Host, nur bei `"type": "mysql"`
`storage.port`	Zahl	`3306`	MySQL-Port
`storage.database`	String	`achievements`	MySQL-Datenbankname. Die Tabellen mit dem Präfix `ach_` werden automatisch angelegt
`storage.username`	String	leer	MySQL-Benutzername
`storage.password`	String	leer	MySQL-Passwort
`liveFeed.enabled`	Boolean	`false`	Standardmäßig aus. Eingeschaltet und mit `url` fragt das Plugin einmal pro Minute den eigenen Feed ab, die Livestream-Kategorie wird sichtbar. Ausgeschaltet bleiben die Livestream-Erfolge verborgen
`liveFeed.url`	String	leer	Adresse des eigenen Feeds
`liveFeed.token`	String	leer	Token, gesendet als `Authorization: Bearer <token>`
`liveFeed.minutesToCount`	Zahl	`10`	Minuten, die ein Spieler während eines Streams online sein muss, damit er zählt
`liveFeed.earlyMinutes`	Zahl	`10`	Zeitfenster am Streamanfang, das noch als pünktlich gilt
`pioneerLimit`	Zahl	`50`	Die ersten Spieler bis zu dieser Zahl erhalten den Pionier-Erfolg
`timezone`	String	`UTC`	Zeitzone für tägliche Login-Serien, zum Beispiel `Europe/Berlin`
`announceInChat`	Boolean	`true`	Server-Meilensteine und Server-Premieren im Chat für alle ankündigen

Der Live-Feed muss GET <url>?game=hytale&since=<last_id> mit JSON wie diesem beantworten:

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

Eigene Erfolge

mods/Eranio_Achievements/achievements-custom.json im selben Aufbau wie die mitgelieferte achievements.json anlegen, um Erfolge hinzuzufügen oder bestehende über ihre ID zu überschreiben.

Datendateien

Datei	Inhalt
`config.json`	Konfiguration
`players/<uuid>.json`	Fortschritt, Zähler und Freischaltungen eines Spielers
`server.json`	Serverweite Zähler und Server-Premieren

Beschädigte Dateien werden in *.corrupt.json umbenannt und es beginnt ein neues Profil, eine kaputte Datei hält den Server also nie an.

Befehle

Befehl	Beschreibung
`/achievements`	Öffnet das Erfolge-Fenster. Alias: `/erfolge`
`/achievements title <id>`	Zeigt einen freigeschalteten Erfolg als Titel im Spiel. `titel` geht ebenfalls
`/achievements title`	Entfernt den Titel

Für keinen dieser Befehle ist eine Berechtigung nötig. Jeder Spieler kann das Fenster öffnen und einen seiner freigeschalteten Erfolge als Titel setzen.