lucashahmannandClaude Opus 5.5
e66f89f49e
Statistikportal für den All-the-Mods-10-Server (Minecraft 1.21.1, NeoForge 21.1): - mod/: serverseitige NeoForge-Mod atmstats – Ereignisse, Live-Zähler, Servergesundheit, FTB-Dateien; Outbox auf der Festplatte, signierter gzip-Versand per HTTPS mit Backoff - backend/: Fastify + PostgreSQL – idempotenter Ingest, Projektionen, Parser für SNBT, FTB Quests/Teams, world/stats, world/advancements und latest.log; Ranglisten, Snapshots, Retention, öffentliche API, SSE-Live-Updates, Admin mit argon2/CSRF, SFTP-Worker - web/: Next.js-Dashboard – Übersicht, Ranglisten, Spielerprofile, ATM10, Server, Datenquellen, Verwaltung - shared/: Protokoll v1 und API-Typen; tools/: Simulator, Log-Anonymisierer, RCON-Client - deploy/: Docker Compose hinter Traefik, Backup; docs/: Architektur, Datenquellen, Betrieb Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.3 KiB
atmstats (NeoForge-Mod)
Serverseitige Statistik-Erfassung für das ATM10-Statistikportal. Minecraft 1.21.1, NeoForge ab 21.1.0, Java 21.
Clients brauchen die Mod nicht (displayTest = IGNORE_ALL_VERSION). Sie registriert keine Blöcke, Items oder Pakete.
Bauen und testen
./gradlew build # JAR in build/libs/atmstats-<version>.jar
./gradlew test # Unit-Tests des Kerns
./gradlew runServer # lokaler Testserver in run/ (eula.txt und config/atmstats-server.toml vorher anlegen)
Für einen lokalen Ende-zu-Ende-Test: Backend starten, Token erzeugen, in run/config/atmstats-server.toml
endpoint = "http://127.0.0.1:3001" eintragen (nicht localhost: Java löst das zuerst als IPv6 auf), RCON in
run/server.properties aktivieren und den Server mit node tools/rcon.mjs 127.0.0.1 25575 <passwort> stop beenden.
Was die Mod erfasst
| Ereignis | Auslöser |
|---|---|
server_start / server_stop |
Serverstart (Versionen, Modliste) / -stopp |
player_join / player_leave |
Login/Logout echter Spieler (keine FakePlayer) |
player_death |
Tod eines Spielers: Dimension, Schadensart, Killer |
entity_kill |
Spieler besiegt einen Boss (c:bosses) oder Spieler |
advancement |
Advancement mit Anzeige (keine Rezepte) |
dimension_change |
Dimensionswechsel |
stats_snapshot |
alle 5 min geänderte Vanilla-Zähler online Spieler (erster Snapshot nach Start vollständig) |
file_sync |
geänderte Dateien: world/ftbquests/*.snbt, world/ftbteams/{player,party}/*.snbt, config/ftbquests/quests/chapters/*.snbt, config/ftbquests/quests/lang/en_us/**/*.snbt_merged (rund 4 MB beim ersten Start, danach nur Änderungen) |
health |
jede Minute: Ø/P95/Max-Tickdauer, TPS, Spieler, geladene Chunks, Heap |
Last
Auf dem Server-Thread passieren nur das Anlegen kleiner Records, System.nanoTime() pro Tick und alle 5 Minuten
das Kopieren der Zählertabelle von höchstens zwei Spielern pro Tick. JSON, gzip, Dateien und HTTPS laufen im
Thread atmstats-worker mit niedriger Priorität. Im lokalen Testlauf trat keine „Can't keep up“-Meldung auf.
Dateien auf dem Gameserver
config/atmstats-server.toml: Konfiguration (siehedocs/OPERATIONS.md)atmstats/outbox/: noch nicht bestätigte Ereignisse;rejected/enthält vom Backend abgelehnte Batches mit Grund