Verwende den GTA V Story Mode für gewöhnliches Offline-Spiel und einen privaten FXServer, wenn du FiveM-Ressourcen alleine testen musst. Es sind unterschiedliche Laufzeitumgebungen. Eine Story Mode Mod funktioniert nicht automatisch als FiveM-Ressource, und ein Serverskript benötigt normalerweise FXServer, selbst wenn nur eine Person beitritt.
Die hier gezeigten Konfigurations- und Codebeispiele beziehen sich auf FiveM für GTA V Legacy. Enhanced hat andere Laufzeit- und Kompatibilitätsregeln; überprüfe die Legacy-zu-Enhanced-Änderungen von Cfx.re bevor du sie auf einen Enhanced-Server anwendest.
Wähle den richtigen Modus
| Ziel | Passende Option | Wichtige Begrenzung |
|---|---|---|
| Spiele die GTA V Kampagne offline | GTA V Story Mode | Es werden keine FiveM-Serverressourcen ausgeführt. |
| Erkunde eine FiveM-Umgebung alleine | Ein Server, der Einzelspieler zulässt | Der Serverbesitzer kontrolliert seine Ressourcen und Regeln. |
| Entwickle oder teste eine Ressource privat | Lokaler/privater FXServer | Du benötigst immer noch die Abhängigkeiten und Konfiguration der Ressource. |
Installiere den Client von der offiziellen Quelle
Behalte eine legitime, aktualisierte GTA V-Installation und installiere FiveM über den offiziellen Client-Pfad. Mische keine unbekannten Injektoren, GTA Online-Cheat-Tools oder zufällige Repacks in das Test-Setup. Wenn der Client vor dem Verbinden fehlschlägt, reproduziere dies zuerst mit einem sauberen GTA V-/FiveM-Setup.
Erstelle einen privaten Solo-Testserver
- Befolge die aktuellen Cfx.re-Server-Setup-Anweisungen für das Betriebssystem.
- Starte txAdmin und erstelle ein separates Testprofil, anstatt Produktionsdaten zu ändern.
- Binde den Server nur so breit, wie der Test es erfordert. Füge Authentifizierungs- oder Firewall-Beschränkungen hinzu, bevor du ihn außerhalb des lokalen Rechners zugänglich machst.
- Installiere eine Ressource mit ihren dokumentierten Abhängigkeiten und der Datenbankmigration.
- Füge die Ressource zur Serverkonfiguration hinzu, starte neu und trete über den lokalen/privaten Endpunkt bei.
Ein txAdmin-Rezept ist ein Bereitstellungs-Startpunkt, kein Beweis dafür, dass jede gebündelte Abhängigkeit oder Community-Ressource aktuell ist. Notiere die Rezept- und Artefaktversionen, damit der Test wiederholt werden kann.
Verstehe die Ressourcenkompatibilität
FiveM-Ressourcen können von einem Framework, einer Datenbank, einem Inventar, einem Target-System, einem Spiel-Build oder anderen Ressourcen abhängen. Lies fxmanifest.lua und die Dokumentation des Erstellers, bevor du beginnst. Dateien, die nur für den Story-Modus, OpenIV oder ScriptHook erstellt wurden, können ohne eine autorisierte FiveM-Implementierung nicht als Serverressourcen behandelt werden.
Führe einen nützlichen Solo-Test durch
- Verwende einen neuen Charakter und einen bekannten Datenbankzustand.
- Teste das Starten, Stoppen und Neustarten der Ressource sowie einen vollständigen Serverneustart.
- Verbinde dich erneut und wiederhole die Hauptaktion, nachdem du nur den ressourcenspezifischen Testzustand gelöscht hast.
- Öffne die F8-Konsole und überprüfe die Serverkonsole auf Warnungen und Fehler.
- Teste Fehlerpfade wie fehlende Berechtigungen, fehlende Elemente und ungültige Eingaben.
Solo-Tests erkennen Verpackungs- und grundlegende Logikfehler. Damit lassen sich jedoch weder Performance, Synchronisation, Race Conditions noch Berechtigungsgrenzen bei mehreren Spielern nachweisen. Verschiebe erfolgreiche Änderungen auf einen separaten Staging-Server, bevor du sie in Produktion nimmst.
Halte den Test reversibel
Versioniere die Ressource und Konfiguration, sichere die Testdatenbank vor Migrationen und ändere jeweils nur eine Variable. Wenn eine Ressource den Start unterbricht, entferne ihre ensure Zeile, stelle die vorherigen Dateien und den Datenbankstatus wieder her und reproduziere von der letzten bekannten, funktionierenden Version.