Dein Roleplay-Server mit GTA5OS

1 Voraussetzungen klären

• Node.js 22 oder neuer und Git auf dem Rechner, auf dem du baust.
• Ein FXServer-Artifact von FiveM und ein kostenloser Cfx.re-License-Key(erstellst du im Keymaster von Cfx.re).
• Eine Datenbank (PostgreSQL oder MySQL/MariaDB) für dauerhaft gespeicherte Daten. Ohne Datenbank läuft GTA5OS nur mit einem Zwischenspeicher: Nach jedem Neustart ist alles weg – gut zum Ausprobieren, nicht für echten Betrieb.
• Einen TeamSpeak-3-Server mit Ingame-Channel für den Sprachchat (mehr in Schritt 4) undOneSync auf dem FXServer.

2 GTA5OS besorgen und bauen

Im Hauptordner des Projekts baust du alles und prüfst es mit den mitgelieferten Tests:

npm install
npm run build   # baut zuerst den Kern, dann alle Plugins
npm test        # Smoke-Tests aller Pakete

Wer nur Ergebnis und Fehlerzeilen sehen möchte, nimmt npm run build:q undnpm run test:q.

3 Server konfigurieren

Der Ordner server/ ist ein fertiger FXServer-Arbeitsbereich mit Startskripten. Die Einstellungen liegen in server/server-data/:

1. Kopiere die Vorlagen: secrets.example.cfg nach secrets.cfg undserver.example.cfg nach server.cfg.
2. Trage deinen Lizenzschlüssel in secrets.cfg ein:

   sv_licenseKey "DEIN_KEY"

3. Setze in server.cfg die Besitzer-Einstellung gta5os_owner_player_idsauf deine eigene License-ID. In der Vorlage steht dort CHANGE_ME.
4. Verbinde die Datenbank über Konvars (das Passwort kommt in die secrets.cfg):

   set gta5os_db_dialect "postgres"   # oder "mysql" (Standard)
   set gta5os_db_host "127.0.0.1"
   set gta5os_db_port "5432"
   set gta5os_db_user "gta5os"
   set gta5os_db_database "gta5os"

5. Gib deinem Server ein eigenes Gesicht. Name, Logo und Kürzel der Spieler-Oberfläche stellst du hier ein (alle drei optional, sonst erscheint „GTA5OS“):

   setr gta5os_hud_name "Mein Server"
   setr gta5os_hud_logo_url "https://example.org/logo.png"   # quadratisch, ca. 128x128
   setr gta5os_hud_short_code "MS"

4 Sprachchat einrichten

Gesprochen wird über TeamSpeak 3 mit demYaCA-Plugin: Gespräche in der Nähe werden je nach Entfernung lauter oder leiser, dazu kommen Funk und Telefon. Ohne diese Einrichtung hört und spricht niemand.

1. Richte einen TeamSpeak-3-Server mit Ingame-Channel ein und stelle sicher, dass OneSync aktiv ist.
2. Lege die Zugangsdaten an: Kopiere yaca-voice/config/server.example.json5 nachconfig/server.json5 und trage TeamSpeak-Server-ID, Ingame-Channel-ID und das Ingame-Channel-Passwort ein. Die Datei ist ein Geheimnis und bleibt von Git ausgeschlossen.
3. Aktiviere die Resource in der server.cfg:

   ensure yaca-voice

4. Hinterlege, was deine Spieler im Spiel angezeigt bekommen, wenn ihr Sprachchat nicht bereit ist – die Adresse deines TeamSpeak-Servers und den Download des YaCA-Plugins für deinen Server:

   setr gta5os_voice_ts_address "ts.mein-server.de"
   setr gta5os_voice_plugin_url "https://…"   # Plugin-Download für deinen Server

   Der Plugin-Link kommt von YaCA. Beide Werte sind keine Geheimnisse.

Reichweiten, Tasten und Funk-Modus stehen in config/shared.json5. Den Ordnernamenyaca-voice nicht ändern: GTA5OS spricht die Resource unter diesem Namen an.

5 Starten und testen

1. Starte den Server mit dem passenden Skript aus dem Ordner server/:start-local.cmd unter Windows, ./start-local.sh in Git Bash oder start-linux.sh unter Linux.
2. Die Skripte bauen vor jedem Start Pakete und Resource. Schlägt der Build fehl, startet der Server bewusst nicht – ein Server mit altem Code würde ein falsches Testergebnis liefern.
3. Verbinde dich mit dem FiveM-Launcher, lege im Einreiseamt einen Charakter an und reise ein.
4. Prüfe den Sprachchat: Solange du nicht im Ingame-Channel bist, zeigt dir das Spiel oben mittig ein Banner mit Grund und Adresse. Verschwindet es, passt alles.