Whitelabel — dein Server in unter 30 Minuten
Echtwelt 3 ist whitelabel-fähig: Alle Instanz-spezifischen Werte (Servername, Slogan, Farben, Startwerte) liegen in Konfigurationsdateien und in der Datenbank — nicht im Code.
1. Servername & Slogan (Spieler-sichtbar)
Datei: resources/[echtwelt]/ew_ui/config/branding.json
{
"app_name": "Dein Servername",
"tagline": "Dein Slogan.",
"accent_primary": "#5b8cff",
"accent_secondary": "#3ecf8e",
"discord_url": "",
"website_url": "",
"impressum": ""
}
Der Name und die Farben gelten auf allen Ebenen: Das Login-Frontend holt sich die
Werte zur Laufzeit über den NUI-Callback getBranding, und EW.Branding (ew_core)
verteilt dieselben Werte an Server- und Client-Logik. Ungültige Werte fallen automatisch
auf die Design-Defaults zurück; leere Felder sind erlaubt.
Hot-Reload ohne Ressourcen-Neustart:
ew_branding_reload
(Admin-/Console-Command; broadcastet ew_core:branding_updated an alle laufenden Clients.
Ein restart ew_ui ist nur nötig, wenn NUI-Updates während einer laufenden Session ausbleiben.)
2. Instanz-Metadaten (SQL)
Verwaltung: ew_core/server/meta.lua + Admin-Kommando servermeta (nur Console/Admins).
servermeta -- alles anzeigen
servermeta get startgeld -- Einzelwert
servermeta set startgeld 2500.00 -- Startgeld deiner Instanz (Euro)
servermeta set whisper_range 3.0 -- Flüster-Reichweite in Metern
Alternativ direkt in SQL:
INSERT INTO server_meta (`key`, `value`, `updated_by`)
VALUES ('startgeld', '2500.00', 'setup')
ON DUPLICATE KEY UPDATE `value` = VALUES(`value`), `updated_at` = CURRENT_TIMESTAMP;
Auflösung: 1. server_meta-Tabelle (DB gewinnt) → 2. config/*.json → 3. Code-Defaults.
3. FXServer-Konfiguration
Datei: server/server.cfg
sv_hostname "^5Dein Servername ^7| Hard-RP deutsch"
sv_projectName "Dein Servername"
sv_projectDesc "Dein Untertitel"
sets tags "roleplay, german, hardcore, deinname"
mysql_connection_string: Benutzer- und Datenbankname sind rein technisch und müssen
nicht umbenannt werden. Wenn du sie änderst, passe nur diese Zeile an — niemals
etwas im Code.
4. Optional: Ressourcen umbenennen
Die technischen Namen (ew_core, ew_database, ew_accounts, ew_ui, resources/[echtwelt]/)
sind absichtlich neutral. Eigene Namen:
- Ordner umbenennen, z. B.
resources/[deinname]/und die vierew_*-Ordner. fxmanifest.luaanpassen ist nicht nötig — die Namen sind relativ.server/server.cfg— dieensure-Zeilen an die neuen Namen anpassen:
ensure dein_core
ensure dein_database
ensure dein_accounts
ensure dein_ui
- Interne Referenzen auf
GetCurrentResourceName()sind dynamisch — es gibt keine festenew_*-Strings in den Skripten selbst.
5. Verify
bash scripts/whitelabel-check.sh
Listet alle Dateien mit Instanznamen, klassifiziert nach Sichtbarkeit. Erwartung nach
Schritt 1–3: Treffer nur noch als „technisch/kommentiert" — keine in der Kategorie
„SPIELER-SICHTBAR". Exit-Code 0 = konform.
Checkliste
- [ ]
branding.json—app_nameundtaglineersetzt - [ ]
restart ew_ui/ew_branding_reloadausgeführt, Login zeigt deinen Namen - [ ]
servermeta set startgeld <wert>gesetzt - [ ]
server/server.cfg—sv_hostname,sv_projectName,sv_projectDesc,sets tags - [ ] Optional: Ressourcen umbenannt,
ensure-Zeilen angepasst - [ ]
scripts/whitelabel-check.sh— keine Spieler-sichtbaren Reste