Files
minecraft-atm10-stats/tools/simulator/README.md
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

20 lines
879 B
Markdown

# Ingest-Simulator
Erzeugt plausible Ereignisse im echten Protokoll v1 (gleiche Batches, gzip und HMAC-Signatur wie die Mod),
damit Backend und Frontend ohne Minecraft-Server ausprobiert werden können.
```bash
npm run sim -w tools/simulator -- \
--endpoint http://127.0.0.1:3001 \
--token <Ingest-Token> \
--secret <INGEST_HMAC_SECRET> \
--players 5 --minutes 240 [--realtime]
```
- Startwerte der Zähler stammen aus `backend/test/fixtures/stats/*.json` (echte Serverdaten), weitere Spieler beginnen bei 0.
- Erzeugt Sessions, Health-Werte im Minutenraster, Stats-Snapshots alle 5 Minuten, Tode, Advancements, Boss-Kills,
Dimensionswechsel und den FTB-Quest-Fortschritt aus dem Fixture.
- `--realtime` sendet danach alle 10 Sekunden neue Ereignisse (für die Live-Ansicht).
Die simulierten Werte sind **Testdaten** und gehören nicht in die Produktionsdatenbank.