Zum Inhalt springen

Whitelabel in unter 30 Minuten

Last updated 21.11.2026 17:54:01 by Administrator

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:

  1. Ordner umbenennen, z. B. resources/[deinname]/ und die vier ew_*-Ordner.
  2. fxmanifest.lua anpassen ist nicht nötig — die Namen sind relativ.
  3. server/server.cfg — die ensure-Zeilen an die neuen Namen anpassen:
ensure dein_core
ensure dein_database
ensure dein_accounts
ensure dein_ui
  1. Interne Referenzen auf GetCurrentResourceName() sind dynamisch — es gibt keine festen ew_*-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_name und tagline ersetzt
  • [ ] restart ew_ui / ew_branding_reload ausgefü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