Code konvertieren
Framework-Migration von ESX zu QBCore (oder umgekehrt): Converter-Tool, Event-Mapping und manuelle Anpassungen.
Framework-Unterschiede
Wichtige Unterschiede zwischen ESX und QBCore, die bei der Migration beachtet werden müssen.
| Framework | Events | Exports | Datenbank |
|---|---|---|---|
| ESX | esx:getSharedObject, esx:playerLoaded | ESX.GetPlayerFromId(), ESX.GetJobs() | users, jobs, items (MySQL) |
| QBCore | QBCore:Client:OnPlayerLoaded, QBCore:Server:OnPlayerLoaded | QBCore.Functions.GetPlayer(), QBCore.Shared.Jobs | players, jobs, items (MySQL) |
Migrations-Schritte
Converter-Tool nutzen
fivemx.com/converter verwenden: ESX-Code hochladen, QBCore als Ziel wählen, automatische Konvertierung starten. Ergebnis prüfen.
Events mappen
Manuell anpassen: esx:getSharedObject → QBCore.Functions.GetCoreObject(), esx:playerLoaded → QBCore:Client:OnPlayerLoaded.
Exports ersetzen
ESX-Exports durch QBCore-Äquivalente ersetzen: GetPlayerFromId, GetJobs, GetItems. API-Dokumentation beider Frameworks prüfen.
Testen & Debuggen
Auf Staging-Server deployen, alle Features testen, Logs prüfen. Häufige Fehler: fehlende Events, falsche Export-Namen, DB-Schema-Unterschiede.
Häufige Fallstricke
- Datenbank-Schema: ESX nutzt "users", QBCore "players" – Migrations-Script nötig.
- Item-System: Unterschiedliche Strukturen, manuelle Anpassung der Items-DB erforderlich.
- Job-System: ESX-Jobs vs. QBCore-Jobs haben andere Properties, Events anpassen.
- Inventory: ESX nutzt oft esx_inventory, QBCore qb-inventory – komplett andere API.
- Events-Timing: QBCore lädt später, OnPlayerLoaded-Handler anpassen.
- Exports-Cache: Nach Konvertierung Client/Server neu starten, Export-Cache leeren.
Migration abgeschlossen?
Teste gründlich auf Staging, bevor du live gehst. Bei Problemen: Framework-Docs konsultieren oder Support kontaktieren.
Verwandte Guides
FiveM Scripting
Lua Scripting Grundlagen
Server erstellen
Server-Setup und Framework-Auswahl
Leaks Compliance
Rechtliche Aspekte bei Code-Migration