QBCore-Server aufsetzenDas moderne Rollenspiel-Framework einrichten

Veröffentlicht am 2. September 2026

QBCore oder ESX?

Beide Frameworks lösen dieselbe Aufgabe: Sie machen aus einer leeren Stadt ein Rollenspiel mit Charakteren, Jobs, Inventar und Wirtschaft. Die Unterschiede liegen im Aufbau und im Ökosystem.

• QBCore ist jünger, klarer geschnitten und arbeitet konsequent mit Modulen. Für eigene Entwicklungen ist der Einstieg meist angenehmer.
• ESX ist länger am Markt und hat dadurch die größere Auswahl fertiger Scripts - gerade im deutschsprachigen Raum.

Entscheidend ist weniger, welches du wählst, sondern dass du bei einem bleibst. Ein späterer Wechsel bedeutet praktisch einen Neuaufbau, weil sich die Datenbankstrukturen unterscheiden.

Voraussetzungen

Wie bei jedem Framework brauchst du drei Dinge, bevor es losgeht: eine MySQL-Datenbank - bei uns in jedem Tarif enthalten -, einen Lizenzschlüssel und eine aufgeräumte Ordnerstruktur im resources-Verzeichnis.

Wer den schnellen Weg bevorzugt: txAdmin bietet Deployer-Rezepte, die einen QBCore-Server automatisch aufsetzen und die Datenbank gleich befüllen. Für das Verständnis lohnt es sich trotzdem, den Ablauf einmal manuell nachvollzogen zu haben.

Der Aufbau in Schichten

QBCore ist ein Stapel aus vier Schichten, die in dieser Reihenfolge starten müssen:

1. Datenbank-Connector - üblicherweise oxmysql, die Grundlage für alles Weitere.
2. Der Kern - verwaltet Spieler, Charaktere, Konten und Jobs.
3. Bibliotheken und Basis-Module - Inventar, Zielsystem, Menüs und Werkzeuge, auf die andere Scripts zugreifen.
4. Job- und Zusatz-Scripts - Polizei, Rettungsdienst, Geschäfte, Fahrzeughändler.

Abgebildet wird das über die Reihenfolge der ensure-Zeilen in der server.cfg. Ein Sammelordner wie [qb] für die Kernbestandteile hält die Datei übersichtlich - wie das funktioniert, steht in Ressourcen installieren.

Installation Schritt für Schritt

1. Dateien hochladen. Kern, Bibliotheken und Module in einen Sammelordner, den Connector daneben. Per WebFTP oder - bei vielen Dateien schneller - per SFTP.
2. Datenbank vorbereiten. QBCore bringt eine .sql mit, die alle Tabellen anlegt. Die spielst du in phpMyAdmin ein, bevor der Server das erste Mal startet.
3. Verbindung eintragen. Die Verbindungszeichenfolge gehört ganz nach oben in die Konfiguration, vor jede ensure-Zeile.
4. Ladeordnung setzen. Connector, Kern, Bibliotheken, Rest - genau in dieser Reihenfolge.
5. Starten und Konsole lesen. Beim ersten Start meldet jede Ressource, ob sie sauber hochgekommen ist.

Nach dem ersten erfolgreichen Start erstellst du im Spiel deinen Charakter. Klappt das, steht das Fundament - alles Weitere sind Module.

Typische Stolpersteine

• Module ohne Bibliothek. Viele QBCore-Scripts setzen bestimmte Bibliotheken voraus. Fehlt eine, startet das Script nicht - die Konsole nennt sie beim Namen.
• ESX-Scripts auf QBCore. Sie sprechen eine andere Sprache. Es gibt Brücken-Ressourcen, sauberer ist ein passendes Script.
• Halb eingespielte Datenbank. Charaktere lassen sich nicht anlegen, obwohl der Server läuft - klassisch für einen abgebrochenen SQL-Import.
• Items ohne Bild. Neue Gegenstände brauchen sowohl einen Eintrag in der Item-Liste als auch ein Bild im Inventar-Ordner.

Nach dem Aufbau

Steht der Server, folgen zwei Dinge: Rechte für dein Team - über das ACE-System, beschrieben in Admin-Rechte vergeben - und ein regelmäßiger Datenbank-Export als Sicherung. Gerade in der Aufbauphase, in der täglich Scripts dazukommen, ist der Export der Unterschied zwischen einem Rückschritt von einer Stunde und einem von einer Woche.

Wächst der Server, wächst die Script-Last. Bevor du das nächstgrößere Paket buchst, lohnt der Blick auf die tatsächlichen Verbraucher: Server-Performance verbessern zeigt, wie du sie findest.

Häufige Fragen