# 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

```bash
./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