res://… = mit dem Spiel ausgeliefert, https://… = Bild auf eigenem Host. Die Spielerzahl erscheint nur beim Realm dieses Masters, wenn die Gameserver sie melden. Quelle: dbservice.auth_db.command_permissions), gilt für alle Realms dieses Stacks.auth_db.violation_log).auth_db.test_results).qa für einen benannten Testerkreis, player für eine offene Runde. Nur offene Runden nehmen Antworten an; geschlossene bleiben lesbar. Die Reihenfolge der Runden in Auswahlliste und Testprotokoll legt die Karte „Reihenfolge der Runden“ unten fest (oder das Feld „Reihenfolge“ im Editor)./systemcheck im Testprotokoll-Dienst – ohne Anmeldung, die meisten Einsender haben noch kein Konto. Einstufung nach den aktuellen Schwellen des Clients (Ø FPS / 1 %-Tief): flüssig 60/40, gut 45/30, spielbar 30/20, knapp ab 20 FPS, darunter zu langsam; mehr als 20 Ausreißer je Minute kosten eine Stufe. Ändern sich die Schwellen, werden auch alte Einsendungen neu eingestuft. Standardmäßig zählen gestörte Messungen, Kurzläufe und ausgeblendete Einsendungen nicht mit. Ausblenden nimmt eine Einsendung aus der Auswertung, Löschen (ab gm) entfernt sie samt Discord-Name und E-Mail endgültig – der Weg für Löschwünsche. Quelle: dbservice (auth_db.systemcheck_submissions)./meldungen und melden bei „Behoben“ zurück, ob es jetzt geht. Mit REDMINE_URL + REDMINE_API_KEY in der .env lässt sich ein Ticket nach Redmine übertragen; danach gehen Status und Verlauf automatisch hinüber (nur in diese Richtung). Löschen ab Rolle gm. Aus dem Spiel (Taste F10) gemeldete Fehler erscheinen hier sofort als Ticket, mit Karte, Position, Bildschirmfoto, Logzeilen und einem /tp-Befehl zum Hinspringen (Filter „Aus dem Spiel“).dev). Die Felder heißen wie in SpellData.gd, ein freigegebener Entwurf lässt sich deshalb direkt in Skillbaum-Konfigurator und world_db übernehmen – spielwirksam ist ein Entwurf nicht. Der Server-Check rechts zeigt, was der Gameserver heute wirklich kann (Schaden, Heilung, Auren, DoT/HoT); alles unter „Mechanik, die der Server noch nicht kann“ ist Server-Arbeit. Speichert jemand anderes zwischendurch denselben Entwurf, wird nichts überschrieben, sondern ein Konflikt gemeldet. Löschen: eigene Entwürfe, fremde ab gm. „Im Spiel“ oben in der Liste zeigt alle vorhandenen Fähigkeiten mit Icon; ein Klick macht daraus einen Entwurf. Quelle: dbservice (auth_db.faehigkeit_entwuerfe).auth liefert veröffentlichte und fällige geplante Beiträge ohne Anmeldung aus (GET /api/launcher/content, höchstens 30, angeheftete vorn); neue Inhalte sieht der Launcher nach spätestens 60 s. Als Entwurf speichern, zurückziehen und nie ausgelieferte Entwürfe löschen geht ab Rolle dev; Planen, Veröffentlichen und Archivieren ab gm (für dev ausgegraut). Speichert jemand anderes zwischendurch denselben Beitrag, wird nichts überschrieben, sondern ein Konflikt gemeldet. Rechts steht eine Vorschau der Launcher-Karte und des Artikels. Quelle: dbservice (auth_db.launcher_posts, launcher_media).dev, Speichern nur admin (für alle anderen gesperrt). Darunter eine verkleinerte Vorschau des Launcher-Fensters mit dem Formularstand und der Abgleich mit der Leseansicht GET /api/launcher/content (Bilder als SHA-256); der Launcher sieht Änderungen über auth nach spätestens 60 s. Quelle: dbservice (auth_db.launcher_settings, launcher_media).dev; ein gleiches Bild (gleicher SHA-256) wird nicht zweimal gespeichert, das vorhandene wird hervorgehoben. Löschen nur unbenutzter Bilder ab gm (für dev ausgegraut); ist ein Bild inzwischen benutzt, lehnt der Server mit einem Konflikt ab. Quelle: dbservice (auth_db.launcher_media).:neu: oder :fix:, die im Artikeltext als kleines Bild in Zeilenhöhe erscheinen. Ein Abzeichen ist ein Kürzel (2 bis 32 Zeichen aus a–z, 0–9 und _), ein Bild aus den Launcher-Medien und optional die ID des gleichnamigen Discord-Server-Emojis für spätere Ankündigungen. Lesen ab Rolle dev, Anlegen, Ändern und Löschen ab gm, weil ein Abzeichen sofort in allen veröffentlichten Beiträgen wirkt. Ein benutztes Bild lässt sich unter „Medien“ nicht löschen. Der Launcher sieht Änderungen über auth nach spätestens 60 s. Quelle: dbservice (auth_db.launcher_abzeichen, Migration 75).Überblick
Mytho ist ein modularer MMO-Backend-Stack in Rust. Er ist getrennt in eine Control-Plane (dieser Master) und mehrere Daten-Dienste (Auth, Chat, Game, Datenbank), alle in Docker. Je Umgebung (Live/Test/Dev) läuft ein eigener, vollständig getrennter Stack mit eigenen Datenbanken – dieses Dashboard verwaltet den Stack seines Realms (das Dev-Dashboard zusätzlich realmübergreifend Deployment und Nutzer). Diese Seite beschreibt die geplante Zielarchitektur, den aktuellen Stand und das Gameserver-Konzept.
Zielarchitektur v5 (geplant)
Leitprinzip: Ein Edge Load Balancer (Traefik) ist ab dem MVP der einzige öffentliche Eingang für die austauschbaren HTTP/WSS-Dienste (Status, Login/Auth, Realm-Gateway, Chat). Gameplay-Verbindungen werden dagegen gezielt vom Realm-Gateway zugewiesen (konkrete Zieladresse + Zone-Ticket) – kein zufälliges Round-Robin. Der Master bleibt interne Control Plane und liegt nicht im Gameplay-Datenpfad. Master, NATS, Redis und PostgreSQL bleiben privat. (Quelle: Mytho_*_v5 in Server/doku/.)
Ausfallsicherheit
- Auth signiert Token mit Ed25519; andere Dienste prüfen sie lokal mit dem öffentlichen Schlüssel. Fällt Auth aus, bleiben eingeloggte Spieler aktiv – nur neue Logins sind blockiert.
- Fällt der Master aus, laufen die Dienste weiter und melden sich danach selbst wieder an.
- Mehrere Game-Server-Instanzen: fällt eine aus, sind nur deren Zonen betroffen.
Aktueller Stand vs. geplant
| Bereich | Heute | Geplant |
|---|---|---|
| Dienst-Kommunikation | HTTP-Registry + Heartbeat (hinter RegistryClient-Trait) | NATS-Bus (Pub/Sub, Request/Reply) als zweite Trait-Implementierung |
| Öffentlicher Eingang | Dienste-Ports direkt (nur 127.0.0.1) | Edge Load Balancer (Traefik): TLS, Routing, Health, Rate-Limit |
| Client-Transport | HTTP/JSON (Login, Register, Launch-Ticket, Charaktere, Weltinhalte) + ENet/UDP für die Spielwelt | WSS über Edge (Realm/Chat) + direkte Zone-Verbindung |
| Realm-/Zone-Zugang | Realm-Verzeichnis (realms in auth_db) + Zugangsrollen (player/dev/gm/admin); Realm-Auswahl im Client, Login im Launcher | Realm-Gateway: Realm-/Character-Flows, Zone-/Chat-Tickets |
| Game-Welt | ENet-World-Entry + Movement/Chat, Map-Interest-Management, Live-Ausrüstung, Doppel-Login-Schutz, server-autoritative Autosave (Position, Stats, Inventar, Währungen, Quests, Bank, Skills, Taschen) | Zonen/Layer, server-autoritative Simulation |
| Persistenz | dbservice ↔ PostgreSQL mit drei Datenbanken je Realm: auth_db (Konten/Realms), character_db (Charaktere/Wirtschaft/Quest-Fortschritt), world_db (Weltinhalte) | Persistence Service + Redis-Cache |
| Auth | DB-Login (argon2id) + Registrierung, signierte Token, Launch-Ticket, IP-Rate-Limit + Konto-Lockout | + Refresh/Revocation, X-Forwarded-For hinter Proxy |
| Deployment | Realm-Promotion (Dev → Test → Live) und Rebuild aus dem Quellcode, beides aus dem Dashboard (Reiter „Steuerung", Dev-Overlay) | CI-gestützte Pipelines |
Dienste
| Dienst | Aufgabe |
|---|---|
| master | Registry, Health, Web-Dashboard (Dienste, Steuerung, Realms, Nutzer, Tests, Fähigkeiten, Launcher, Doku), Container-Steuerung, Deployment (Promotion/Rebuild), Nutzer-/Realm-Verwaltung (auch realmübergreifend, Dev-Overlay) |
| auth | DB-Login (argon2id) + Registrierung, Launch-Ticket, signierte Session-Token, Public-Key; HTTP-Fassade für Realm-Liste, Charaktere und Weltinhalte (Lesen: Session-Token, Schreiben: Rollen ab dev) |
| chat | Prototyp (Registrierung + Heartbeat); die Spiel-Chat-Kanäle (welt, flüstern) laufen derzeit über den Gameserver |
| gameserver | ENet-Welttransport: World-Entry (Ticket→DB-Charakter→Spawn), Movement-/Chat-Broadcast je Map, Live-Ausrüstung, Doppel-Login-Schutz, server-autoritative Autosave (Position/Stats/Inventar/Währungen/Quests/Bank/Skills/Taschen); pro Zone/Shard skalierbar |
| dbservice | PostgreSQL-Anbindung mit drei Pools: Konten/Realms (auth_db), Charaktere inkl. Wirtschaft + Quest-Fortschritt (character_db), Weltinhalte (world_db); Health + Kennzahlen per Heartbeat |
| tester | Testprotokoll für Testrunden: Tester melden sich mit ihrem Spielkonto an (eigener Token-Zweck test), haken einen Testplan ab und geben einen Statusbericht ab. Bewusst ein eigener Prozess und nicht Teil des Masters – dieser steuert Container und Deployments, jenes ist eine Anmeldemaske im offenen Netz. Hält keine DB-Zugangsdaten. Auswertung und Editor liegen hier im Dashboard (Reiter „Tests“). Zweite Aufgabe: die offene Seite /systemcheck für Systemcheck-Einsendungen ohne Anmeldung (Größen- und IP-Bremse, Auswertung unter „Tests → Systemcheck“) |
Datenbanken (je Realm)
| Datenbank | Inhalt |
|---|---|
| auth_db | Konten (argon2id-Hashes), Zugangsrollen, Login-Historie/Lockout, Bann-Status, Realm-Verzeichnis, Kommando-Berechtigungen (command_permissions), Anti-Cheat-Protokoll (violation_log, 24 h), Testprotokoll (test_plans/test_results/test_submissions) |
| character_db | Charaktere (Slot 0–3, Soft-Delete), Stats/Fortschritt, Inventar, Währungen, Item-Katalog, Quest-Fortschritt (character_quests), Bank (character_bank/account_bank), Skillbaum-Punkte (character_skills), Taschen |
| world_db | Weltinhalte, eine Tabelle je Art (world_quest, world_npc, Spawns, Dialoge, Vendor, Wegpunkte, Spells, Skilltrees, Kampfregeln): key + rohes Editor-JSON. Quelle der Wahrheit statt lokaler Dateien; Clients ziehen sie beim Login (mit lokalen Backups), Editor-Speichern pusht automatisch (Rollen ab dev), manuell per /worldsync push|pull |
Jeder Realm (Live/Test/Dev) hat seine eigenen drei Datenbanken in einem eigenen Postgres-Container – Daten vermischen sich nie. Schema-Migrationen liegen in db/init/ und werden bei Promotion/Rebuild idempotent nachgezogen.
Dashboard-Funktionen
- Dienste: Live-Status aller registrierten Dienste (Heartbeat, Kennzahlen wie Konten-/Charakter-/Quest-Zahlen der Datenbanken).
- Steuerung: Container starten/stoppen/neustarten (nur mit
ENABLE_DOCKER_CONTROL=true). Im Dev-Overlay zusätzlich Deployment: Promotion überträgt gebaute Images Dev → Test → Live, Rebuild baut einen Realm aus dem Quellcode neu – beides mit Migrations-Phase und Live-Protokoll. - Realms: Realm-Verzeichnis pflegen (Name, Status, „Sichtbar ab“ und „Betreten ab“ je Rollenstufe, dazu die Anzeige der Realmauswahl: Bild als
res://-Pfad oderhttps://-Adresse, Region, Modus pve/pvp/rp, Beschreibung als Tooltip) – wirkt direkt auf die Realmauswahl im Client. Beim Realm dieses Masters steht die aktuelle Spielerzahl, sofern die Gameserver sie melden; der Client bekommt dieselbe Zahl überGET /api/realmsdes Auth-Dienstes (Quelle: Heartbeat-Kennzahlspieler, Migration 72). - Nutzer: Konten als filterbare Tabelle (Suche/Rolle/Status) mit Inline-Rollenwahl und Bann-Editor (temporär/permanent). Konto anlegen legt Konten auf einem wählbaren Realm an (Passwort-Hashing bleibt im Auth-Dienst des Ziel-Realms). Mit konfigurierten Sibling-Mastern (
ADMIN_REALM_MASTER_URLS, Dev-Overlay) schaltet ein Realm-Umschalter die Kontenverwaltung auf Test/Live um. - Nutzer → Commands verwalten (nur Rolle
admin): Mindestrolle je Spiel-Kommando – Admin-Kanal (admin.add_gold,admin.add_experience,admin.set_level,admin.add_item,admin.set_speed,admin.kill_npc), dieselben Kommandos auf andere Spieler (admin.set_level.other…, Standardgm: greift nur, wenn der GM im Spiel einen Mitspieler anvisiert hat; der Server nimmt immer das Maximum aus Grund- und.other-Schlüssel), Anzeige-Tags über dem Spielernamen (tag.adm…), Weltinhalte schreiben (world.push) und Chat-Nachrichten senden (chat.send, Standardplayer– höher stellen beschränkt den Chat z. B. im Wartungsfenster auf Team-Rollen). Die Spalte Chat-Befehl zeigt die auslösende Chat-Eingabe (z. B./addgold <betrag>; Quelle:ChatCommandHandler.gd, DB-Spaltechat_commands, nicht editierbar). Quelle:auth_db.command_permissions. Der Gameserver übernimmt Änderungen binnen 60 s; laufende Sitzungen behalten die Rolle aus ihrem Launch-Ticket bis zum nächsten Login. Fehlt ein Eintrag, gilt der Standardwert aus dem Code (fail-safe). - Nutzer → Verstöße (ab Rolle
gm): Anti-Cheat-Protokoll – eine Zeile je beendeter Spielsitzung, in der der Gameserver Client-Updates wegen fehlender Plausibilität verworfen hat, mit Verteilung je Art, Sitzungsdauer und der Angabe, ob die Sitzung wegen der Strike-Schwelle (50) getrennt wurde. Der laufende Server-Log ist auf eine Zeile alle 5 s je Sitzung gedrosselt und verliert die Verteilung; eine Zeile je Verstoß wäre umgekehrt selbst ein Flut-Vektor. Für Rollen abqagreifen die Plausibilitäts-Prüfungen nicht (Speed-/Teleport-Tests sind Arbeitsmittel, Tester sollen keine Strikes sammeln) – solche Sitzungen erscheinen normalerweise nicht. Quelle:auth_db.violation_log, Aufbewahrung 24 Stunden (VIOLATION_LOG_RETENTION_HOURS), danach automatische Löschung. Fehlt die Tabelle, bleibt die Liste leer (fail-safe). - Fähigkeiten (ab Rolle
dev, alsodev,gm,admin): die Fähigkeiten-Werkstatt. Neue Fähigkeiten gemeinsam entwerfen – Felder wieSpellData.gdim Client (Wirkung, Kosten und Timing, Aura/DoT/HoT, Aufwertungen je Rang, Darstellung, Texte, Prüfstatus Entwurf → Zur Prüfung → Freigegeben → Umgesetzt), dazu ein Icon (im Browser auf 64 × 64 verkleinert). Rechts eine Vorschau im Stil des Skillbuch-Tooltips, der Server-Check (was der Gameserver heute kann: Schaden, Heilung, Auren, DoT/HoT; angekreuzte Mechaniken wie Betäubung oder Verlangsamung sind Server-Arbeit) und ein JSON-Export für Konfigurator und world_db. Entwürfe auf „Zur Prüfung“ sehen Konten abqaim Testprotokoll unter/pruefungund geben je Person „passt“ oder „Problem“ mit Notiz ab; die Rückmeldungen stehen im Abschnitt „QA-Rückmeldungen“ des Entwurfs (Migration 48). Der Umschalter „Im Spiel“ zeigt alle Fähigkeiten, die es schon gibt (dieselbe Liste wie/faehigkeitenim Testprotokoll, mit Icons, Kampfwerte aus der world_db); ein Klick legt daraus einen Entwurf zum Überarbeiten an; der Knopf oben („… zur Prüfung stellen“) legt für alle angezeigten Fähigkeiten ohne Entwurf auf einmal einen an, damit QA auch den Bestand prüft. „Exportieren“ oben in der Liste lädt alle Entwürfe eines Status (Standard: freigegeben) samt Icons als eine JSON-Datei herunter – Grundlage für die Übernahme in den Client. Ein Entwurf ist nicht spielwirksam. Speichert jemand anderes zwischendurch denselben Entwurf, meldet das Dashboard einen Konflikt statt zu überschreiben. Löschen: eigene Entwürfe, fremde abgm. Quelle:auth_db.faehigkeit_entwuerfe(Migration 47). - Launcher → Beiträge (ab Rolle
dev; Planen, Veröffentlichen und Archivieren abgm, fürdevausgegraut): Neuigkeiten, Patchnotes und Community-Beiträge für die drei Reiter des Launchers. Liste mit Filter Kategorie und Status (Plakette, Build, Zeitpunkt, angeheftet, zuletzt geändert von); Editor mit Längenzählern (Titel 120, Kurztext 300, Text 8000, Link 500, nurhttps://), Build nur bei Patchnotes, Reihenfolge, Bild aus den vorhandenen Bildern oder neu hochgeladen (PNG, JPEG, WebP, höchstens 2 MiB und 1920 × 1080, schon im Browser geprüft; gleiches Bild wird nicht doppelt gespeichert). Statusknöpfe Als Entwurf speichern, Veröffentlichen, Planen (lokale Zeit, gesendet als UTC), Zurückziehen, Archivieren; Löschen nur bei nie ausgelieferten Entwürfen, mit Bestätigung. Speichert jemand anderes zwischendurch, bleibt die eigene Eingabe sichtbar und lässt sich nach „Neu laden“ übernehmen. Rechts eine Live-Vorschau der Launcher-Karte und des Artikels. Der Artikeltext ist Markdown wie in Discord:**fett**,*kursiv*,__unterstrichen__,~~durchgestrichen~~,[Text](https://…); nur am Zeilenanfang#/##/###Überschrift,-#kleine graue Statuszeile,>Zitat,-Aufzählung; Leerzeile = Absatz; HTML und BBCode werden nie ausgewertet. Über dem Textfeld eine Formatierungsleiste (fett, kursiv, unterstrichen, durchgestrichen, Überschrift, Statuszeile, Zitat, Aufzählung, Link-Dialog,?mit den Regeln) samt Strg+B/I/U/K; jeder Schritt lässt sich mit Strg+Z zurücknehmen. Vorschau und Launcher übersetzen nach denselben Regeln und werden mit derselben Falltabelle geprüft (E1). Emojis sind normale Unicode-Zeichen und bleiben unverändert: Knopf „🙂 ▾“ in der Leiste mit Suche, „Zuletzt benutzt“ (nur in diesem Browser), Spiel- und Patchnotes-Emojis vorn und weiteren Gruppen; eingefügt wird in das zuletzt benutzte Feld Titel, Kurztext oder Text. Die Zähler zählen wie der Server in Unicode-Zeichen (⚔️ zählt 2, 🎉 zählt 1). Der Launcher zeigt sie farbig über die Emoji-Schrift des Systems; Flaggen zeigt Windows nur als Buchstaben (E2). Eigene Abzeichen: Knopf „Abzeichen ▾“ in der Leiste fügt:kürzel:ins Feld „Text“ ein; dort erscheint ein bekanntes Kürzel in Vorschau und Launcher als Bild in Zeilenhöhe, unbekannte Kürzel, Kürzel mitten im Wort und in Links bleiben Text. In Titel und Kurztext bleiben Kürzel Text (die Karten zeigen keine Bilder), der Editor weist darauf hin (E3). Bilder im Text: Knopf „Bild“ in der Leiste öffnet die Medienauswahl mit Vorschaubildern, Hochladen und Beschreibung und setzt die Zeileallein auf eine eigene Zeile (höchstens 10 je Beitrag); Vorschau und Launcher zeigen das Bild zentriert in Textbreite, nie größer als das Bild, mit der Beschreibung darunter. Die Quelle ist immer eine Nummer der Medienliste:bleibt Text, eine unbekannte Nummer weist der Server beim Speichern ab. Sichtbar ab Launcher-Build 28 (E4, Migration 76). Der Launcher sieht Neues überGET /api/launcher/contentamauthnach spätestens 60 s. Quelle:auth_db.launcher_posts,launcher_media(Migration 74). - Launcher → Darstellung (lesen ab Rolle
dev, speichern nuradmin; für alle anderen gesperrt mit Hinweis): Logo, Hintergrund und Kartenbild für Beiträge ohne eigenes Bild, je aus den vorhandenen Bildern, neu hochgeladen oder „Eingebautes Bild verwenden“ (leer = Notfallbild des Launchers); empfohlene Maße Hintergrund 1920 × 1080, Logo mit Transparenz etwa 480 × 140, Kartenbild etwa 16:7, Abweichungen als Hinweis. Herausgeberzeile (höchstens 80 Zeichen) und die Links Website, Discord, Support (nurhttps://oder leer; leer = der Knopf zeigt einen Hinweis). Darunter „So sieht es der Launcher“: verkleinerter Nachbau des Launcher-Fensters in 1600 × 900 bis 720 × 760 (unter 1000 Pixel Kontokarte über den Neuigkeiten, gerollter Inhalt ausgerollt gezeigt) mit den ersten drei veröffentlichten Beiträgen; Links nur als Text. Danach der Abgleich mit der LeseansichtGET /api/launcher/content(SHA-256 der Bilder, Herausgeber, Links); der Launcher sieht den Stand überauthnach spätestens 60 s. Quelle:auth_db.launcher_settings. - Launcher → Medien (ab Rolle
dev; Löschen abgm, fürdevausgegraut): Raster aller Bilder der Launcher-Inhalte mit Vorschau, Maßen, Größe, Typ, hochgeladen von und am, gekürztem SHA-256 (voll im Tooltip, Kopierknopf, ohne Zwischenablage wird er markiert) und der Verwendung als Plaketten (Anzahl Beiträge, davon im Text, Plätze Logo, Hintergrund, Kartenbild, Abzeichen wie:neu:; ein Klick darauf springt in „Abzeichen“). Ein Klick auf die Beitragsplakette listet die Beiträge mit diesem Bild als Titelbild oder im Text (Klick öffnet sie in „Beiträge“), eine Darstellungsplakette springt in „Darstellung“. Oben die Summe der Größen und der unbenutzten Bilder, Filter „Nur unbenutzte“, Sortierung nach Datum oder Größe. Hochladen per Knopf oder durch Ziehen und Ablegen mehrerer Dateien (dieselben Browser-Prüfungen wie bei „Beiträge“); gibt es das Bild schon (gleicher SHA-256), meldet der Reiter „gab es schon, kein zweites Bild angelegt“ und hebt das vorhandene hervor. Löschen nur unbenutzter Bilder im Dialog mit Vorschaubild; ist das Bild inzwischen benutzt, kommt ein lesbarer Konflikt (409) und die Liste wird neu geladen. Quelle:auth_db.launcher_media. - Launcher → Abzeichen (lesen ab Rolle
dev; anlegen, ändern, löschen abgm, fürdevgesperrt mit Hinweis): eigene Abzeichen wie:neu:,:fix:,:test:,:balance:,:hotfix:. Liste mit Vorschau in Zeilenhöhe, Kürzel, Beschreibung, Discord-ID, Reihenfolge und zuletzt geändert. Formular: Kürzel (2 bis 32 Zeichen aus a–z, 0–9 und _, Doppelpunkte und Großschreibung werden bereinigt, später nicht änderbar), Bild aus den vorhandenen Medien oder neu hochgeladen, Beschreibung (höchstens 120 Zeichen), Discord-Emoji-ID (optional: in Discord\:neu:eintippen, die Zahl aus<:neu:123…>eintragen; die ganze Zeile einfügen geht auch), Reihenfolge; Vorschau im Stil des Launcher-Artikels (Überschrift, Grundtext, Aufzählung, Statuszeile) und in Discord-Größe (22 Pixel). Löschen im Dialog; Beiträge zeigen danach wieder den Text:kürzel:, das Bild bleibt unter „Medien“. Ein Bild, das ein Abzeichen nutzt, lässt sich dort nicht löschen (409). Quelle:auth_db.launcher_abzeichen(Migration 75). - Tests → Systemcheck (ab Rolle
dev, Löschen abgm): Einsendungen des Client-Systemchecks, abgegeben über die Seite/systemcheckim Diensttester– ohne Anmeldung. Der Browser des Einsenders liest den Bericht selbst, übertragen werden nur der Bericht als JSON und die Formularangaben (Eindruck, MMO-Erfahrung, Maestia-Kenntnis, Zeit für geschlossene Tests, Discord/E-Mail). Das Formular gibt es auf Deutsch und Englisch (/systemcheck?lang=en); die gewählte Sprache steht in der Einsendung, damit ihr in der richtigen Sprache anschreibt. Der Master stuft beim Lesen nach den Schwellen des Clients ein (flüssig 60/40, gut 45/30, spielbar 30/20, knapp ab 20 FPS; mehr als 20 Ausreißer je Minute kosten eine Stufe), die Einstufung steht also nicht in der Datenbank. Ansicht: Kennzahlen, Verteilung der Einstufung, Auswertung je Grafikkarte und je Prozessor, Bewerber für geschlossene Tests, alle Einsendungen mit Details und Rohbericht; Excel mit drei Blättern. „Formular ansehen“ (auch über die Nummer in der Bewerberliste) öffnet eine Einsendung komplett als Blatt: der Bericht aufbereitet wie auf der Formularseite (Urteil, Kennzahlen, Strecke, Hardware, alle Messwerte, Hinweise), darunter alle Antworten; mit Druckansicht, Schließen per Knopf, Escape oder Klick daneben. Standardmäßig ohne gestörte Messungen, Kurzläufe und ausgeblendete Einsendungen. Quelle:auth_db.systemcheck_submissions(Migration 45). Fehlt die Tabelle, bleibt die Liste leer und die Seite meldet „nicht eingerichtet“. - Tests → Tickets (ab Rolle
dev, Löschen abgm): der Bugtracker. Befunde der Testrunden (Auswertung) werden zu Tickets gebündelt – mehrere Tester, ein Problem, ein Ticket. Statusneu → angenommen → in Arbeit → behoben (Build) → bestätigt / wieder offen, dazukein Fehlerunddoppelt. Antworten des Teams und Statuswechsel sehen die Tester im Diensttesterunter/meldungen(nur Tickets zu eigenen Befunden, ohne interne Notizen; im Verlauf mit Anmeldenamen); dort melden sie bei „behoben“ „geht jetzt“ oder „geht immer noch nicht“. Optional Redmine (REDMINE_*in der.env): „Nach Redmine“ legt dort ein Ticket an, danach gleicht der Master Status, Priorität und Verlauf ab – bei jeder Änderung und alleREDMINE_ABGLEICH_MINUTEN, nur in Richtung Redmine. Tabellenbug_tickets,bug_ticket_meldungen,bug_ticket_kommentare(Migration 49). Bekannte Fehler: Alle Tester sehen unter/fehlerdie Tickets mit Stand, der „Beschreibung für Tester“ (vorbefüllt mit der ersten Meldung, von euch bearbeitbar, Migration 53), Anzahl der Meldungen und euren Antworten (keine Namen, Bilder oder weiteren Befundtexte) und können „Betrifft mich auch“ drücken; je Ticket schaltet ihr „Für alle Tester sichtbar“ (Standard an, bei Exploits aus). Migration 51. QA-Konten (abqa) kommentieren dort jedes sichtbare Ticket, ändern Titel und „Beschreibung für Tester“ (mit Eintrag im Verlauf) und bearbeiten ihre eigenen Kommentare (Migration 54); der öffentliche Verlauf zeigt Anmeldenamen. Statusgeschlossen(Migration 52) geht nach Redmine als „Erledigt“; in Redmine geschlossene Tickets schließt der Master hier automatisch. MitREDMINE_AUTOMATISCH(Standard an) geht jedes neue Ticket – auch aus dem Spiel – ohne Knopfdruck nach Redmine. Meldungen aus dem Spiel (Taste F10 im Client,POST /api/meldungenamauth, Meldetoken 24 h) werden sofort Tickets; Kontext (Karte, Position, Charakter, Build, Hardware, Logzeilen) und Bildschirmfoto stehen inspiel_meldungen(Migration 50), je Konto höchstens 5 in 10 Minuten und 30 am Tag. Die Detailansicht zeigt Bild und/tp <karte> <x> <y> <z>(Client, abdev); „Nach Redmine“ hängt das Bild an.
Autoritätsübersicht (Client vs. Server)
Wer bestimmt welchen Spielwert? Legende der Spalte Verwaltung:
- Server-autoritativ – der Server rechnet/entscheidet, der Client kann es nicht fälschen.
- Server-persistiert (client-gemeldet) – der Server speichert, die Werte kommen vom Client, aber mit Plausibilitätsgrenzen (Anti-Cheat verwirft Unmögliches).
- Content (world_db) – vom Editor gepflegt, Schreiben nur ab Rolle
dev. - Client/lokal – (noch) nicht server-abgesichert oder bewusst rein lokal.
| Bereich | Verwaltung | Anmerkung |
|---|---|---|
| Login, Session-/Launch-Ticket, Zugangsrolle, Realm-Zugang | Server-autoritativ | argon2id; Ed25519-Token mit purpose + jti-Einmalverbrauch; Rolle im Ticket |
| Charakter-CRUD/Slots/Aussehen, Ownership, Spielzeit | Server-autoritativ | account_id serverseitig aufgelöst; Playtime zählt der Server |
| Level, Attribute, XP, HP/MP, Position, Bewegung | Server-persistiert (client-gemeldet) | Wertebereiche, Statpunkte-Budget, XP-/Level-Sprung-Caps, Move-Speed-Check (nicht tick-simuliert) |
| Gold-/Item-Zugänge: Vendor-Kauf/-Verkauf, Quest-Belohnung, GM-Kommandos | Server-autoritativ | Preise/Belohnungen aus dem Katalog (world_db + item_templates); Audit-Log character_transactions |
| Inventar-Bestand, Bank, Währungs-/Skill-/Taschen-Sync | Server-persistiert (client-gemeldet) | Voll-Sync mit Plausibilität (Slots/Menge/Enchant) + Währungs-Sprung-Cap |
| Quest-Abgabe & Belohnung | Server-autoritativ | Ziele serverseitig verifiziert, Belohnung einmalig je Annahme (turned_in-Schutz) |
| Quest-Annahme/Status, Fortschrittszähler | Server-persistiert (client-gemeldet) | Zähler auf Zielwert geklemmt; fälschungssicher erst mit Kampf-Autorität |
| Welt-/Editor-Inhalte: Quests, NPCs, Spawns, Dialoge, Vendor, Wegpunkte, Spells, Skilltrees, Kampfregeln | Content (world_db) | Pull beim Login (mit Backups), Editor-Auto-Push, Schreiben ab dev |
| Mitspieler-Sichtbarkeit (Interest-Management), Map-/Portalwechsel, Remote-Ausrüstung, Chat-Routing/Flood | Server-autoritativ | Map-Filter, Kanal-Routing und Flood-Schutz serverseitig |
| Anti-Cheat: Plausibilität, Rate-Limit, Strike-System | Server-autoritativ | ungültige Pakete verworfen; ab 50 Verstößen Kick |
| Audio/Grafik/Keybinds/HUD/Chat-Optik | Client/lokal | reine Präferenzen, kein Server-Bezug |
Kurzfazit: Alles, was Werte erzeugt (Gold, Items, Belohnungen, Level per GM), ist server-autoritativ. Was der Client noch meldet (Bestände, Zähler, Position), ist server-persistiert mit Plausibilitätsgrenzen. Noch offen (an die NPC-/Kampf-Autorität gekoppelt): NPC-Bewegung/HP/Aggro, Kampf/Schaden/Loot, fälschungssicherer Quest-Zähler, dupe-sicherer Inventar-Voll-Sync sowie die ENet-Transport-Verschlüsselung.
Gameserver-Konzept
Sharding: eine Instanz je Zone
Die Spielwelt wird in Zonen (und Layer/Ebenen) aufgeteilt. Jede Zone/Ebene läuft als eigene Game-Server-Instanz. Reicht die Kapazität nicht, kommen weitere Instanzen hinzu (horizontale Skalierung). Im v5-Modell weist das Realm-Gateway dem Spieler die konkrete Instanz zu (Auswahl über den Master nach Health/Last).
Verbindungsablauf (v5)
Wie ein Client in die Spielwelt kommt – vom Launcher-Login über den Edge bis zum gezielt zugewiesenen Zone-Server:
Weitere Bausteine (geplant)
- Server-autoritativ: der Game-Server ist die Wahrheit über Position/Zustand (Anti-Cheat).
- Interest-Management: ein Client erhält nur Updates aus seinem Sichtbereich/seiner Zone.
- Zonenwechsel/Handover: Übergabe zwischen Instanzen über ein neues Ziel-Ticket, koordiniert über Master/Bus.
- Persistenz: kontrolliertes Speichern (u. a. Logout-Position) über den Persistence Service (API + Redis-Cache), nicht direkt aus dem Zone-Server.
Sicherheit
Zugriffszonen (Master)
- Öffentlich:
GET /healthz– ohne Authentifizierung. - Intern (Dienste):
POST /api/register,/api/heartbeat,GET /api/players-online(nur die Spielerzahl des Stacks, für die Realm-Liste des Auth-Dienstes) – nur mit Bearer-TokenMASTER_SERVICE_TOKEN. - Administrativ: Dashboard,
/api/services,/api/realms*,/api/accounts*,/api/commands*(nuradmin),/api/containers*,/api/promotions*– nur mit HTTP Basic (MASTER_ADMIN_USER/MASTER_ADMIN_PASSWORD). - Launcher-Inhalte:
/api/launcher/*(Beiträge, Bilder, Darstellung, Abzeichen) – Dashboard-Sitzung abdev; Planen, Veröffentlichen, Archivieren, Bilder löschen sowie Abzeichen anlegen, ändern und löschen abgm, Darstellung speichern und Discord-Einstellungen nuradmin(prüft der Handler). Bild-Upload als Rohbytes bis 2 MiB (eigenes Body-Limit nur dort), Format per Magic Bytes geprüft.
Härtung
- Secrets werden nur als SHA-256-Hash gehalten und in konstanter Zeit verglichen; in
productionverhindern fehlende oder schwache/Default-Secrets den Start. - Veröffentlichter Port nur an
127.0.0.1gebunden; externer Zugriff ausschließlich hinter TLS-Reverse-Proxy oder VPN. CORS ist deaktiviert. - Rate-Limit für Registrierung und fehlgeschlagene Admin-Anmeldungen (Heartbeats nicht limitiert); Request-Timeout und globales Concurrency-Limit.
- Container-Steuerung standardmäßig deaktiviert (
ENABLE_DOCKER_CONTROL=truenötig); Deployment und realmübergreifende Nutzerverwaltung nur im Dev-Overlay. - Passwörter werden ausschließlich im Auth-Dienst mit argon2id gehasht – auch bei der Konto-Anlage aus dem Dashboard leitet der Master nur weiter und hasht nie selbst.
- Dashboard rendert externe Werte nur als Text (kein HTML-Sink); strikte CSP (
default-src 'self', ohneunsafe-inline) plusX-Content-Type-Options,Referrer-Policy,Permissions-Policy,Cache-Control: no-store; serverseitige Eingabe-Validierung + Body-Limit 16 KiB. - Private Schlüssel werden nie geloggt; in
productionstartet Auth nur mit gültigemAUTH_SIGNING_KEY.
Bedienung
cd Server docker compose up -d --build # bauen + starten docker compose logs -f master # Logs docker compose down # stoppen docker compose up -d --scale gameserver=3 # skalieren
Mehr Details
Ausführliche Dokumentation liegt im Repo unter Server/doku/ (Architektur, Dienste, Konfiguration, API, Datenbank, Betrieb, Gameserver-Konzept).