Einleitung: FiveM Framework Adapter – für Scripter

Dies ist ein FiveM Framework Adapter – für Scripter. Liefere eine einzige Ressource, die auf ESX, QBCore und QBOX läuft, indem du framework-spezifische Aufrufe hinter einem schlanken Adapter isolierst. Füge die shared/fw.lua und die framework-spezifischen Adapter in jede Ressource ein, rufe den stabilen Interface-Vertrag (FW.Player, FW.Job, FW.Money, FW.Inv, FW.Events) auf und halte die Geschäftslogik framework-agnostisch. Eine kleine Test-Matrix mit Stubs erkennt Konflikte, bevor du deployst.
Warum ein Adapter?
Framework-Unterschiede konzentrieren sich auf dieselben Stellen:
- Core Zugriff (ESX
getSharedObject, QBCore GetCoreObject, QBOX nur Exports)
- Player-Model (xPlayer vs Player/PlayerData)
- Identifiers (license/steam vs citizenid)
- Money & Inventory APIs
- Event-Namen bei Load/Login/Job-Update
Ein einheitliches Interface hält diese Unterschiede aus deiner Spiellogik heraus. Du tauschst den Adapter aus, nicht die Codebasis.
BTW: Unseren fertigen Adapter kannst du hier kostenlos nutzen:
Framework Adapter
Verwendung (Drop-in)
Verzeichnisstruktur (empfohlen):
my-resource/
├─ fxmanifest.lua
├─ shared/
│ ├─ adapters/
│ │ ├─ esx.lua
│ │ ├─ qb.lua
│ │ └─ qbox.lua
│ └─ fw.lua
├─ server/
│ └─ main.lua
└─ client/
└─ main.lua
fxmanifest.lua (Adapter zuerst laden, dann fw.lua, damit die Erkennung binden kann):
| fx_version 'cerulean' | game 'gta5' lua54 'yes' |
|