So migrierst du ESX → QBCore richtig

1. Tools
   1. GIT und ein separater Branch für die Migration.
   2. MariaDB oder MySQL 8 mit aktivierten vollständigen Backups.
   3. Ein Staging-Server, der die Produktion spiegelt.
   4. Server-Artifacts
      1. FXServer auf denselben Build wie Produktion aktualisiert.
      2. QBCore Basis-Framework und Standard-Ressourcen.
      3. Bibliotheken, die du verwenden wirst

         1. oxmysql für die Datenbank.

         2. ox_lib für Callbacks, UI-Helfer und Utility-Wrapper.

            ---

            Schritt 1. Einen Plan und einen Rollback-Punkt erstellen

            1. Produktionsänderungen einfrieren. Stoppt neue Skript-Installationen und DB-Schreibvorgänge, die nicht zum Testen erforderlich sind.
            2. Deine gesamte Datenbank als benannten Snapshot sichern.
            3. Dein Server-Repository branchen und einen dedizierten migrate-esx-to-qbcore-Branch erstellen.
            4. Ein Runbook schreiben. Enthält Befehle zum Starten und Stoppen des Staging-Servers, zur DB-Wiederherstellung und zur Ausführung von Health-Checks.

            ---

            Schritt 2. Eine saubere QBCore-Basis aufbauen

            1. Eine frische QBCore-Basis auf Staging deployen.
            2. Nur das Wesentliche aktiviert lassen. Jobs, Inventare und benutzerdefinierte Skripte deaktivieren, bis nach der DB-Migration.
            3. Diese Ressourcen zuerst installieren und starten

               1. qb-core

               2. qb-vehicles oder deine bevorzugten Ersetzungen

               3. oxmysql

               4. ox_lib

                  ---

                  Schritt 3. mysql-async durch oxmysql ersetzen

                  Wenn verbleibende ESX-Skripte noch MySQL.Async verwenden, konvertiere die Aufrufe zu oxmysql. Verwende einfaches Suchen und Ersetzen mit Überprüfung.

                  Häufige Konvertierungen

                        -- ESX mysql-async
                        MySQL.Async.fetchAll('SELECT * FROM users WHERE identifier = @id', {['@id'] = identifier}, function(rows)
                          -- ...
                        end)

                        -- QBCore oxmysql
                        local rows = MySQL.query.await('SELECT * FROM players WHERE citizenid = ?', { citizenid })
                        -- rows ist eine Lua-Tabelle; nil und Längenprüfungen direkt behandeln

                        -- ESX scalar Beispiel
                        MySQL.Async.fetchScalar('SELECT COUNT(1) FROM owned_vehicles', {}, function(count)
                          -- ...
                        end)

                        -- oxmysql scalar
                        local count = MySQL.scalar.await('SELECT COUNT(1) FROM player_vehicles')

                        -- ESX insert
                        MySQL.Async.execute('INSERT INTO addon_account VALUES (@owner, @name, @money)', {
                          ['@owner'] = identifier, ['@name'] = name, ['@money'] = money
                        })

                        -- oxmysql insert
                        MySQL.prepare.await('INSERT INTO player_accounts (citizenid, name, amount) VALUES (?, ?, ?)', { citizenid, name, amount })

Hinweise

1. Bevorzuge query.await, scalar.await und prepare.await für sauberen Ablauf.
2. Verwende prepared statements für Schreibvorgänge.

Schritt 4. ESX-Datenstrukturen auf QBCore mappen

| Du wirst Spieleridentitäten und Entities migrieren. Verwende diese Referenz zum Mappen von Tabellen. | ESX-Tabelle | Schlüsselspalte | QBCore-Tabelle | |

Launch faster

Compare curated bundles

Bundles shorten the path from planning to launch by grouping the highest-leverage scripts into a cleaner commercial starting point.