Wie man einen QBox-Server installiert: Rezept, Stack und erste Fehler

Du möchtest einen QBox-Server und du möchtest wissen, was im Stack ist, wie du ihn installierst und wie er sich von QBCore unterscheidet. Diese Anleitung gibt dir die Rezept-Route, die Stücke, die QBox ausmachen, die Unterschiede zum Überwachen und die ersten Fehler, die Leute treffen.

#Installiere mit dem txAdmin-Rezept

QBox ist für die Installation mit einem txAdmin-Rezept gemacht. Wähle im Setup von txAdmin das QBox-Template in den beliebten Rezepten (oder füge die Rezept-URL aus der Dokumentation des QBox-Projekts ein). Die Schritte sind die gleichen wie in txAdmin Setup und Rezepte: Lizenzschlüssel, Datenbankdaten, dann überprüfe server.cfg und starten.

Nimm immer das Rezept aus dem QBox-Projekt selbst. Seine Liste von Ressourcen ändert sich, während das Projekt wächst, und das Rezept bleibt aktuell.

#Der QBox-Stack

QBox ist eine Menge von Ressourcen, die um Overextended's Bibliotheken gebaut sind. Die Base-Stücke:

Auf der Spitze davon fügt das Rezept die qbx_-Ressourcen für Jobs, Fahrzeuge, Wohnen usw. hinzu, plus Standalone-Ressourcen wie Stimme.

Ein manuelles server.cfg sieht so aus:

set mysql_connection_string "mysql://user:password@localhost/qbox?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target
ensure [qbx]
ensure [standalone]

Das Rezept schreibt die genaue Liste für die Version, die es installiert, daher behandle dies als die Form, nicht den Inhalt. Die Reihenfolge ist wichtig: Siehe server.cfg ensure order.

#Was sich von QBCore unterscheidet

• Core Name. Das Framework ist qbx_core. Es gibt keinen qb-core-Ordner, und du darfst ihn nicht neben ihm behalten.
• Inventar. QBox verwendet ox_inventory. Gegenstände werden für ox_inventory definiert, nicht in der qb Shared-Items-Datei. Siehe ox_inventory add items.
• Bibliotheken anstelle von Helfern. Callbacks, Benachrichtigungen, Kontextmenüs und Fortschrittsbalken kommen von ox_lib. Siehe callbacks on ESX, QBCore and ox_lib und notifications and progress bars.
• Targeting. ox_target ist die Target-Ressource: ox_target add zone. Die Unterschiede mit dem QBCore-Target sind in qb-target vs ox-target.
• Exports. QBox hat seine eigenen Exports, z.B. auf dem Server:

local player = exports.qbx_core:GetPlayer(source)
if player then
    print(player.PlayerData.citizenid)
end

Der QBCore-Weg exports['qb-core']:GetCoreObject() antwortet immer noch durch die Kompatibilitätsschicht, weshalb viele QBCore-Skripte funktionieren. Für eine vollständige Konvertierung, siehe convert a QBCore script to QBox.

#Erste Überprüfungen

Starte den Server und lese die Konsole, bevor du beitrittst:

1. oxmysql verbindet sich.
2. ox_lib und qbx_core starten ohne Fehler.
3. ox_inventory startet. Es hat seine eigenen Überprüfungen beim Start und meldet Probleme deutlich, daher lese, was es druckt.
4. Du kannst beitreten, einen Charakter erstellen und spawnen.
5. Dein Inventar öffnet sich mit dem Schlüssel, den das Rezept konfiguriert.

Für Admin-Rechte verwendet QBox ACE-Principals in server.cfg, die gleiche Weise wie andere Frameworks. Siehe ACE permissions.

#Häufige erste Fehler

Ein QBCore-Skript kann den Core nicht finden. Wenn die Kompatibilitätsschicht nicht aktiv ist, oder qbx_core ist nicht gestartet, bekommst du:

No such export GetCoreObject in resource qb-core

Überprüfe, dass qbx_core ohne Fehler gestartet wurde, und dass kein veralteter qb-core-Ordner existiert. Siehe QBCore nil: the GetCoreObject fix.

ox_lib nicht geladen. Ein Skript, das lib aufruft, bevor ox_lib startet, schlägt fehl. Lege ensure ox_lib in der Nähe der Spitze und füge @ox_lib/init.lua zum Manifest des Skripts hinzu. Siehe ox_lib init.lua not found.

Datenbankfehler. Falsche Verbindungszeichenkette, oder die Datenbank wurde nicht erstellt. Siehe oxmysql connection error.

Zwei Inventare. Das Ausführen von qb-inventory neben ox_inventory verursacht doppelte und defekte Gegenstände. Behalte nur ox_inventory.

Ressource startet nicht. Could not find dependency sagt dir, was fehlt.

#Checkliste