Projekt & Architektur
Repository-Layout
Echtwelt3/
├── server/server.cfg # FXServer-Konfiguration
├── resources/[echtwelt]/ # eine Domäne = eine Ressource
│ ├── ew_core/ # Bootstrap, Session, Networking, Config-Loader
│ ├── ew_database/ # Migrationen, Seeds, Repositories
│ ├── ew_accounts/ # Login, Registrierung, Ban, Sessions
│ ├── ew_characters/ # Erstellung, Auswahl, Spawn
│ ├── ew_needs/ # Hunger, Durst, Stamina, Temperatur
│ ├── ew_economy/ # Konten, Transfers, Rechnungen, Steuern
│ ├── ew_illegal/ # kriminelle Karriereleiter
│ └── …
├── ui/ # React-NUI-Frontend (Glassmorphism)
├── shared/ # geteilte C#-Vertragstypen
├── sql/ # Migrationen & Seeds
└── docs/ # Vision, Analyse, ADRs, Whitelabel
Tech-Stack
| Ebene | Wahl |
|---|---|
| Plattform | FiveM (Cfx.re), fxserver latest |
| Server-Sprache | C# (.NET) via CitizenFX.Core |
| Datenbank | MySQL 8 / MariaDB mit Dapper |
| UI | React 18 + TypeScript + Vite, Tailwind, Glassmorphism |
| Voice | pma-voice (Proximity, Radio, Telefon) |
| CI | Build-Checks pro Commit |
Architektur-Grundsätze
- Ressourcen-Trennung pro Domäne — keine Gott-Klasse. Jede Domäne ist eine eigene
Ressource mit eigener
fxmanifest.luaund eigenemconfig/-Ordner. - Server-authoritativ — der Client ist nie vertrauenswürdig. Validierung serverseitig.
- Daten in der DB — alles Persistente liegt in MySQL; Migrationen sind nummerierte
SQL-Skripte (
ew_database/migrations/). - Konfiguration statt Code — ein
config/*.jsonpro Ressource.
Konsequenz-Ökonomie (Vision)
„Hyper-realistisch" bedeutet: Jede Handlung hinterlässt Spuren, jede Spur hat Folgen.
Organe, Krankheiten, Wirtschaftskreisläufe, Beweismaß im Rechtssystem — Details in
docs/ANALYSE.md des Repos.