0 Fork 0

Files

T

lucashahmannandClaude Opus 5.5 e66f89f49e feat: ATM10-Statistikportal

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>

2026-10-13 09:33:25 +02:00

2.3 KiB

Raw Permalink Blame History

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 (siehe docs/OPERATIONS.md)
atmstats/outbox/: noch nicht bestätigte Ereignisse; rejected/ enthält vom Backend abgelehnte Batches mit Grund

2.3 KiB Raw Permalink Blame History