Entwicklung & Modding — Übersicht
Echtwelt 3 ist als Framework gebaut: Eine Domäne = eine FiveM-Ressource. Alles Instanzspezifische (Name, Farben, Startgeld) liegt in Konfigurationsdateien und in der Datenbank — nicht im Code. Genau das macht Modding und Whitelabel einfach.
Wegweiser
| Seite | Für wen? |
|---|---|
| Projekt & Architektur | Einstieg: Repo-Layout, Tech-Stack, Grundsätze |
| Erste eigene Ressource bauen | Tutorial: neues ew_*-Modul anlegen |
| Konfigurationsdateien | config/*.json, Branding, servermeta |
| Datenbank & Migrationen | Migrationen, Seeds, Dapper-Queries |
| NUI & UI bauen | React 18 + TypeScript + Vite, Glassmorphism |
| Server-Events & Networking | Server-authoritativ: Events, Validation |
| Website-Bridge anbinden (Lua) | Auth, Shop-Vorteile, Whitelist aus dem Spiel |
| Whitelabel in unter 30 Minuten | Eigenes Branding ohne Codeänderung |
| CI & Qualität | Build-Pipeline, Struktur-Checks |
Goldene Regeln
- Keine Magic Numbers — Werte gehören in
config/*.jsonoder in dieserver_meta-Tabelle. - Server-authoritativ — jede spielerwirksame Aktion wird serverseitig validiert.
- Eine Quelle der Wahrheit — persistente Daten gehören in MySQL, nie in JSON-Dateien.
- Keine Spieler-sichtbaren Instanznamen im Code — Prüfung mit
scripts/whitelabel-check.sh.