HILFE & ANLEITUNGEN

Dein Syntac-Server.
Schritt für Schritt.

Einrichtung, Config Hub und Lösungen für typische Probleme – verständlich erklärt und schnell zu finden.

ERSTE SCHRITTE

Einrichtung & Updates

Diese drei Punkte helfen, Datenverlust und Startprobleme zu vermeiden.

Vor dem Start

Sichere deine bestehenden Dateien. Prüfe in der Anleitung des Scripts, welche Voraussetzungen für deinen Server gelten.

In der richtigen Reihenfolge starten

Core und Syntac-Scripts müssen in der richtigen Reihenfolge starten:

ensure syn_config
ensure syn_core
ensure NV_AdminJail

Wichtig: NV_AdminJail ist ein Beispiel. Der letzte Eintrag muss exakt dem Ordnernamen deines Scripts entsprechen.

Updates sicher übernehmen

Behalte deine Base-Datei und persönlichen Einstellungen. Folge den Update-Hinweisen und starte betroffene Ressourcen neu, wenn es dort verlangt wird.

EINSTELLUNGEN

Config Hub

Deine Datei bleibt unter deiner Kontrolle. Du entscheidest, ob du sie herunterlädst oder ausdrücklich an deinen Server sendest.

Datei bearbeiten und herunterladen

Öffne deine Syntac-Base-Datei im Config Hub. Die Einstellungen bearbeitest du im Browser; mit „Prüfen & herunterladen“ erhältst du die vollständige Datei.

Ein Download bleibt privat. Ein normaler Download wird nicht an Syntac übertragen. Nur das ausdrücklich bestätigte Senden im Hub überträgt die Datei an deinen Server.

Ersetze die Serverdatei erst, wenn du die Änderungen übernehmen möchtest.

Server verbinden und direkt senden

Die optionale Live-Verbindung muss einmal passend zur installierten Core eingerichtet werden. Ohne aktuellen Serverstatus bleiben serverabhängige Bearbeitungen gesperrt.

Das direkte Senden ist freiwillig: Es wird erst nach deiner Zustimmung und Bestätigung ausgeführt. Die Core prüft die Datei erneut und legt vor Änderungen eine Sicherung an.

Framework und Integrationen auswählen

Im Bereich Syntac Core & Integrationen wählst du ESX, QBCore oder Standalone und Systeme wie pma-voice oder SaltyChat. Die Auswahl wird Syntac-Modulen über die Core bereitgestellt.

Ein Script muss den gewählten Adapter selbst unterstützen. Die Auswahl baut ein bestehendes Script nicht automatisch um.

Für nicht gelistete Systeme wählst du „Eigene Integration“ und trägst Adapter-ID sowie den exakten Resource-Ordnernamen ein. Weitere Systeme kannst du unter „Weitere Integrationen“ ergänzen. Die Webseite speichert nur diese Angaben und führt keinen eingegebenen Code aus.

Wichtig: Das aktuelle NV_AdminJail bleibt ESX-gebunden. Die Auswahl QBCore oder Standalone portiert dieses Script nicht automatisch.

Nach einer Änderung lädst du die geprüfte Base herunter oder sendest sie ausdrücklich an deinen Server. Starte danach die Core und betroffene Syntac-Module neu.

SCHNELLE HILFE

Häufige Probleme lösen

Wähle die Meldung, die am besten zu deiner Situation passt.

Base-Datei wird abgelehnt

Wähle die Syntac-Base-Datei, keine einzelne Script-Config. Dateiname, Inhalt und unterstützte Version werden beim Öffnen geprüft.

Die Datei darf höchstens 2 MB groß sein. Wenn du sie manuell bearbeitet hast und der Hub sie ablehnt, vergleiche die Syntax mit dem Beispiel „Ungültige JSON-Syntax“ weiter unten.

Serverstatus fehlt oder Script ist gesperrt

Prüfe, ob die Core und das betreffende Script auf deinem FiveM-Server gestartet sind und das Script die Syntac-Core-Anbindung unterstützt.

Bei einer Installation über die server.cfg müssen die Ressourcen in dieser Reihenfolge gestartet werden:

ensure syn_config
ensure syn_core
ensure NV_AdminJail

NV_AdminJail ist ein Beispiel. Ersetze den Namen durch den tatsächlichen Ordnernamen deines Scripts.

Wenn du die optionale Verbindung nutzt, muss das private Token im Hub mit diesem Serverfeld übereinstimmen:

StatusBridge.ModuleToken

Teile dieses Token niemals.

Sicherung kann nicht geschrieben werden

Die Core kann keine verlässliche Sicherung erstellen und ersetzt deshalb die Base-Datei nicht. Das schützt deine bestehende Konfiguration.

Prüfe freien Speicherplatz und Schreibrechte für die Resource syn_config. Für eine genauere Diagnose gib in der Serverkonsole Folgendes ein:

syn_core_doctor

Der Befehl prüft Core, Base-Datei, Sicherungen und Syntac-Module. Schalte die Sicherungsprüfung nicht aus; wende dich bei Bedarf mit der Diagnose an den Support.

Direktes Senden wartet oder schlägt fehl

Warte auf die Prüfung durch die Core und sende nicht mehrfach. Prüfe, ob der Server läuft und die Verbindung zur Website verfügbar ist.

Wird die Datei abgelehnt, zeigt der Hub den Grund an. Korrigiere den gemeldeten Punkt, bevor du es erneut versuchst.

Ungültige JSON-Syntax

Fehlerbeispiel:

{
  "enabled": true,
}

Korrigierte Schreibweise:

{
  "enabled": true
}

JSON erlaubt nach dem letzten Eintrag kein Komma. Diese Beispiele zeigen nur die Syntax und sind keine vollständige Syntac-Base-Datei. Prüfe die korrigierte Datei anschließend erneut im Config Hub.