Zum Inhalt springen

Modding-Uebersicht

Last updated 21.11.2026 17:53:40 by Administrator

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

  1. Keine Magic Numbers — Werte gehören in config/*.json oder in die server_meta-Tabelle.
  2. Server-authoritativ — jede spielerwirksame Aktion wird serverseitig validiert.
  3. Eine Quelle der Wahrheit — persistente Daten gehören in MySQL, nie in JSON-Dateien.
  4. Keine Spieler-sichtbaren Instanznamen im Code — Prüfung mit scripts/whitelabel-check.sh.