FiveM-Server von Legacy zu Enhanced migrieren

Einen FiveM-Server von Legacy zu Enhanced zu portieren ist kein Artefakt-Update: die Server-Binärdatei wechselt, die Laufzeit geht von Mono zu .NET, und ein Teil Ihrer Ressourcen muss angepasst werden. Diese Checkliste führt die Migration Ressource für Ressource durch - in der Reihenfolge, in der die Probleme tatsächlich auftreten.

⚙️ Voraussetzungen

• Ein Enhanced-Testserver, getrennt von der Produktion - siehe Server auf dem GTA-V-Enhanced-Build betreiben
• Eine vollständige Sicherung Ihrer Ressourcen und ein Dump Ihrer MySQL-Datenbank
• Die Liste Ihrer gekauften Skripte und der jeweiligen Shops
• Konsolenzugriff auf den Server, um Ladefehler zu lesen

⚙️ 1. Ressourcen inventarisieren

Sortieren Sie zuerst den Inhalt Ihres resources-Ordners in vier Stapel:

Dieses Inventar entscheidet, ob die Migration jetzt machbar ist - nicht die Leistung Ihres Servers.

⚙️ 2. Verschlüsselte Skripte: der Blocker

Asset Escrow ist auf Enhanced nicht implementiert. Eine auf Tebex gekaufte, geschützte Ressource lässt sich nicht entschlüsseln und startet nicht, unabhängig vom Server.

Drei Wege, nach Präferenz:

1. Beim Verkäufer eine Enhanced-kompatible oder für Bestandskäufer offene Version anfragen
2. Das Skript durch ein Open-Source-Äquivalent ersetzen, sofern es eines gibt
3. Auf Escrow für Enhanced warten und die Produktion auf Legacy halten

⚙️ 3. Lua: was wirklich zu prüfen ist

Anders als oft zu lesen, gibt es kein lua54 zu deklarieren. Die Cfx.re-Dokumentation ist eindeutig: die Einstellung ist veraltet und seit Juni 2025 laufen alle Lua-Skripte bereits mit 5.4. Ein Standard-Manifest genügt:

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

Die eigentliche Arbeit liegt woanders: Skripte, die auf Enhanced entfernte Natives aufrufen oder grafische Engine-Elemente anfassen, scheitern beim Laden oder mitten im Spiel. Fügen Sie Ihre Ressourcen einzeln hinzu, mit offener Konsole, und arbeiten Sie die Fehler laufend ab.

⚙️ 4. C#: für .NET neu kompilieren

Die Laufzeit wechselte von Mono zu .NET. Eine für Legacy kompilierte C#-Ressource lädt auf Enhanced nicht: Sie brauchen das Quellprojekt, ein aktualisiertes Ziel-Framework und aktualisierte Cfx.re-Referenzen, dann einen Neubau.

Für den Neubau brauchen Sie das .NET SDK auf Ihrem Entwicklungsrechner. Fehlen Ihnen die Quellen eines gekauften C#-Skripts, gilt dasselbe wie bei Escrow: nur der Autor kann eine kompatible Version liefern.

⚙️ 5. Frameworks: ESX, QBCore, QBox

Keines der drei läuft auf Enhanced Plug-and-Play; alle brauchen eine portierte Fassung. Prüfen Sie vor dem Portieren den Stand des Repositorys Ihres Frameworks und beginnen Sie mit einer sauberen Installation der portierten Fassung, in die Sie Ihre eigenen Ressourcen einspielen - statt eine zwei Jahre alte Legacy-Installation umzubauen.

Falls Sie noch bei der Basis schwanken: der Vergleich ESX und QBCore bleibt gültig, die Framework-Wahl ändert sich mit Enhanced nicht.

Die Datenbankverbindung selbst bleibt unverändert - siehe MySQL mit oxmysql verbinden.

⚙️ 6. Eigene Assets

Add-on-Fahrzeuge, MLOs und Kleidung müssen für die Enhanced-Engine konvertiert werden: Dateien für GTA V Legacy stellen sich nicht garantiert korrekt dar, und ein nicht konvertiertes Asset kann den Client der Spieler abstürzen lassen, statt einfach nicht zu erscheinen.

Ein Punkt, den man nicht übersehen darf: eine Ressource, die ihre Dateien aus einem stream-Ordner ausliefert, muss auf Enhanced stream_enhanced verwenden. Mechanische Arbeit, aber vergessen lässt sie Ihre Assets stillschweigend verschwinden.

Nehmen Sie sie zuletzt in Angriff, wenn der Server mit Ihren Skripten stabil läuft: ein Server, der ohne seine MLOs startet, ist weiterhin spielbar - umgekehrt nicht.

⚙️ 7. Voice: Mumble ist veraltet

Enhanced bringt ein neues Voice-System mit, das Mumble ersetzt und über serverseitige Natives gesteuert wird (CreateVoiceChannel, AddPlayerToVoiceChannel, SetPlayerMutedInVoiceChannel...). Mumble-Natives funktionieren weiterhin über dieses neue System, sind aber veraltet und werden entfernt. Als Übergang hält setr sv_mumble true die Mumble-Kompatibilität, während Sie Ihre Voice-Ressource portieren. Testen Sie sie mit mehreren gleichzeitig verbundenen Spielern, nicht allein auf dem Server.

⚙️ 8. Parallel testen, danach wechseln

Die richtige Reihenfolge:

1. Enhanced-Testinstanz, leerer Server
2. Portiertes Framework, noch ohne eigene Ressourcen
3. Eigene Lua-Ressourcen, eine nach der anderen, Konsole offen
4. Neu kompilierte C#-Ressourcen
5. Konvertierte Assets
6. Lasttest mit echten Spielern
7. Wechsel der Produktion, außerhalb der Hauptzeiten

Jeder Schritt wird in der Konsole geprüft: eine Ressource hinzufügen, neu starten, null Fehler. Zehn Ressourcen auf einmal einzuspielen heißt, die eine zu verlieren, die den Start blockiert.

✅ Fazit

Die Migration entscheidet sich an einer einzigen Zahl: wie viele verschlüsselte Ressourcen Ihr Server braucht. Der Rest - stream_enhanced, .NET-Neubauten, Assets - ist mechanische Arbeit, die parallel zur Produktion läuft. Den technischen Kontext liefert FiveM Enhanced: Server auf dem GTA-V-Enhanced-Build betreiben.

Bei LordHosting sind Legacy und Enhanced in allen FiveM-Angeboten verfügbar: Sie können Ihren RP-Server in Produktion halten und parallel eine Portierungsinstanz betreiben, ohne das Angebot zu wechseln.