Ein Roleplay-Server baut auf einem Framework auf: Es kümmert sich um Charaktere, Geld, Jobs, Inventar und Autos. Wir vergleichen die drei meistgenutzten (ESX Legacy, QBCore und Qbox), helfen Ihnen bei der Wahl und führen Sie durch die Installation mit einem txAdmin-Rezept, einschließlich der Einrichtung von Admins.
Was Sie brauchen
Was ein Framework ist#
Ein Framework ist eine Sammlung von Resources, die dem Server das grundlegende „RP-Spiel“ gibt: Charaktererstellung, Bargeld und Bankguthaben, Jobs und Ränge, Inventar, Fahrzeugbesitz und Speicherung in der Datenbank. Andere Skripte (Jobs, Shops, Telefon, Garagen) bauen dann auf den Funktionen des Frameworks auf.
Was das in der Praxis bedeutet:
- Ein Skript wird für ein bestimmtes Framework geschrieben. Ein Skript für ESX läuft nicht ohne Änderungen auf QBCore und umgekehrt. Suchen Sie also immer die Version eines Skripts, die für Ihr Framework gemacht ist.
- Ein Framework-Wechsel auf einem laufenden Server ist schwierig. Der Umstieg auf ein anderes bedeutet eine neue Datenbank und den Austausch Ihrer Skripte. Wählen Sie also gleich am Anfang sorgfältig.
- Ein Framework braucht eine Datenbank und die Resource
oxmysql.
Ein Server ohne Framework (Freeroam, Drift, Racing) kann auf dem Basisrezept von txAdmin laufen (FiveM Basic Server).
Grundbegriffe#
| Begriff | Was er bedeutet | Wo er gespeichert wird |
|---|---|---|
| Charakter | Ein Spieler kann mehrere Charaktere haben, jeder mit eigenem Namen, Geld und Job. Er wählt einen im Multicharacter-Bildschirm nach dem Verbinden. | ESX Tabelle users, QBCore und Qbox Tabelle players |
| Identifikator | Woran das Framework den Spieler erkennt. In der Regel die Rockstar-Lizenz (license). | Beim Charakter in der Datenbank |
| Konten | Bargeld, Bank und gegebenenfalls Schwarzgeld oder Krypto. | Beim Charakter |
| Job und Rang | Der Job des Charakters (Polizei, EMS, Mechaniker) und sein Rang mit Gehalt. Der Boss verwaltet die Angestellten. | ESX Tabellen jobs und job_grades, QBCore und Qbox Konfiguration |
| Gang | Das Gang-Gegenstück zum Job. | QBCore und Qbox |
| Items | Dinge im Inventar: Definitionen (Name, Gewicht) und wie viele der Charakter hat. | ESX Tabelle items, Konfigurationsdateien für ox_inventory und QBCore |
| Society | Das Firmenkonto eines Jobs, aus dem Gehälter gezahlt werden können. | Je nach Framework und Banking-Skript |
| Eigene Fahrzeuge | Vom Charakter gekaufte Autos, ihre Kennzeichen und Upgrades. | ESX Tabelle owned_vehicles, QBCore und Qbox Fahrzeugtabellen |
Wenn Sie das verstehen, lassen sich Probleme leichter finden: Wenn Geld oder ein Auto „verschwindet“, ist es ein Datenbankeintrag, den Sie nachschlagen und korrigieren können (zum Beispiel in HeidiSQL).
Vergleich#
| ESX Legacy | QBCore | Qbox | |
|---|---|---|---|
| Herkunft | Das älteste der drei, über viele Jahre entwickelt. | Ein eigenständiges Framework, von ESX inspiriert. | Begann als Fork von QBCore, mit neu geschriebenem Code. |
| Kern (Resource) | es_extended | qb-core | qbx_core |
| Bibliotheken | esx_lib, ox_lib, oxmysql | oxmysql, eigene qb-* | ox_lib, oxmysql |
| Inventar | in ESX eingebaut, optional ox_inventory | qb-inventory | ox_inventory |
| Targeting (Interaktion) | je nach Skripten | qb-target | ox_target |
| Datenbank | MariaDB (empfohlen) | MySQL oder MariaDB | nur MariaDB 10.9.0 oder neuer |
| Skripte für ein anderes Framework | nein | nein | die meisten QBCore-Skripte funktionieren über die eingebaute Bridge |
| Admin-Berechtigungen | Spielergruppe (/setgroup) | ACE-Gruppen qbcore.god, qbcore.admin, qbcore.mod | ACE-Gruppen group.admin, group.mod, group.support |
| txAdmin-Rezept | ESX Legacy | QBCore Framework | Qbox Framework |
| Dokumentation | docs.esx-framework.org (öffnet sich in einem neuen Fenster) | qbcore.org/docs (öffnet sich in einem neuen Fenster) | docs.qbox.re (öffnet sich in einem neuen Fenster) |
So wählen Sie#
- Möchten Sie die meisten fertigen Skripte und Anleitungen? ESX Legacy. Es ist am weitesten verbreitet, und Sie finden Skripte dafür für fast alles.
- Möchten Sie eine moderne Basis und QBCore-Skripte? Qbox. Es verwendet die Bibliotheken
ox_lib,ox_inventoryundox_target, hat strengeren Code und führt die meisten QBCore-Skripte über seine Bridge ohne Änderungen aus. - Haben Sie bestimmte kostenpflichtige Skripte für QBCore? QBCore oder Qbox (klären Sie mit dem Skriptautor, ob es auf Qbox funktioniert).
- Bauen Sie einen Server mit eigenen Skripten von Grund auf? Wählen Sie das, dessen Dokumentation Ihnen am besten liegt. Ihr Framework gut zu kennen ist wichtiger als die Wahl selbst.
Der sicherste Weg: Deployen Sie das Framework probeweise, testen Sie es im Spiel und kaufen Sie erst dann Skripte.
Vor der Installation#
- Legen Sie eine leere Datenbank in der Registerkarte Datenbank an (zum Beispiel
fivem, Erlaubte Verbindungen von%). Lassen Sie die Daten Datenbankname, Benutzer, Host und Passwort geöffnet. - Halten Sie Ihren License Key bereit (er beginnt mit
cfxk_). - Erstellen Sie ein Backup, wenn Sie bereits etwas auf dem Server haben (Registerkarte Backups, Anleitung), und exportieren Sie die Datenbank (Anleitung). Ein neues Deployment wird in einem neuen Ordner gespeichert, ein Rezept mit eingeschaltetem Delete Database würde die Datenbank jedoch löschen.
- Prüfen Sie die Artifacts. Frameworks erfordern eine aktuelle Serverversion. Aktualisieren Sie einen alten Server nach Artifacts aktualisieren.
Qbox und die Datenbankversion
Qbox unterstützt offiziell nur MariaDB 10.9.0 und neuer. Die Version des Datenbankservers finden Sie nach dem ersten Start in der Konsole in der Zeile […] Database server connection established! (in den eckigen Klammern). Wenn die Version niedriger ist oder es MySQL ist, kontaktieren Sie uns.
Installation mit einem txAdmin-Rezept#
Das Vorgehen ist für alle drei Frameworks gleich; nur das Rezept und einige Einstellungen nach der Installation unterscheiden sich. Wenn Sie in txAdmin bereits einen anderen Server deployt haben, starten Sie unter Settings › FXServer mit der Schaltfläche Reset neben dem Feld Server Data Folder einen neuen Assistenten. txAdmin kehrt zur Setup-Seite zurück und löscht die vorhandenen Dateien nicht.
- Geben Sie auf der Setup-Seite von txAdmin einen Server Name ein und klicken Sie auf Next.
- Wählen Sie bei Deployment Type die Option Popular Recipes.
- Wählen Sie das Rezept gemäß der Registerkarte unten.
- Behalten Sie den vorgeschlagenen Datenordner, klicken Sie auf Save und dann auf Go to Recipe Deployer.
- Klicken Sie in Step 1: Review Recipe auf Next.
- Füllen Sie in Step 2: Input Parameters den Server Registration Key aus und nach einem Klick auf Show/Hide Database options (advanced) auch die Datenbank: Database Host (die IP aus dem Feld Host), Database Port (der Port aus dem Feld Host), Database Username, Database Password, Database Name. Der Schalter Delete Database ist standardmäßig eingeschaltet; stellen Sie sicher, dass er auf Off steht. Jedes Feld ist in der txAdmin-Anleitung ausführlich erklärt.
- Klicken Sie auf Run Recipe und warten Sie, bis es fertig ist. Große Rezepte brauchen mehrere Minuten.
- Prüfen Sie in Step 4: Configure server.cfg, dass
endpoint_add_tcpundendpoint_add_udpden Port aus der Zeile Verbindungsadresse in der Registerkarte Netzwerk haben (das Rezept schreibt möglicherweise den Standard30120). Passen Sie dann die Einstellungen gemäß der Registerkarte unten an und klicken Sie auf Save & Run Server.
ESX
Rezept: Wählen Sie in der Liste Popular Recipes den Eintrag ESX Legacy.
Was das Rezept installiert: den Kern es_extended und weitere Resources im Ordner [core] (Charaktere, Menüs, Identität, Multicharacter), Add-ons im Ordner [esx_addons] (Jobs, Bank, Shops, Garagen …), oxmysql, ox_lib, den Voice-Chat pma-voice und die Interieur-Maps bob74_ipl.
Einstellungen in der server.cfg nach dem Deployment:
| Zeile | Was sie tut | Was einstellen |
|---|---|---|
sv_hostname und sets sv_projectName | Der Servername (in der Konsole und in der Serverliste). | Ihr Name. |
sets locale "root-AQ" | Die Serversprache in der Liste. | Ihre Sprache, zum Beispiel sets locale "de-DE" oder sets locale "cs-CZ" |
#setr esx:locale "en" | Die ESX-Sprache. Wenn sie auskommentiert ist, verwendet ESX die in txAdmin eingestellte Sprache. | Kommentar entfernen und Ihre Sprache setzen ("de" für Deutsch, zum Beispiel "cs" für Tschechisch), oder die Sprache txAdmin überlassen. |
#setr esx:identifier "license" | Welchen Identifikator ESX zum Erkennen der Spieler verwendet. | Nicht ändern. Eine Änderung auf einem etablierten Server „verliert“ alle Charaktere. |
sv_enforceGameBuild | Game Build (DLC). | Behalten Sie den Wert aus dem Rezept, sofern Ihre Skripte keinen höheren verlangen. |
add_ace resource.es_extended command.add_principal allow und ähnliche | Erlaubt ESX, Gruppen zuzuweisen. | Nicht löschen. |
Sicherheitseinstellungen aus dem Rezept
Das ESX-Rezept schaltet auch die Schutzoptionen sv_enableNetworkedSounds false, sv_, sv_ und sv_filterRequestControl 2 ein. Sie blockieren gängige Cheater-Tricks, behalten Sie sie also bei. Erklärt werden sie in der Anleitung server.cfg.
QBCore
Rezept: Wählen Sie in der Liste Popular Recipes den Eintrag QBCore Framework.
Was das Rezept installiert: den Kern qb-core, Dutzende qb-*-Skripte im Ordner [qb] (Multicharacter, Inventar, Polizei, EMS, Garagen, Telefon, HUD, Admin-Menü …), oxmysql, den Voice-Chat pma-voice und Maps.
Einstellungen in der server.cfg nach dem Deployment:
| Zeile | Was sie tut | Was einstellen |
|---|---|---|
sets locale "root-AQ" | Die Serversprache in der Liste. | Ihre Sprache, zum Beispiel sets locale "de-DE" oder sets locale "cs-CZ" |
setr qb_locale "en" | Die QBCore-Sprache. | de für Deutsch oder ein anderer Sprachcode, zum Beispiel cs (der Kern hat Tschechisch, manche Skripte nicht). |
setr UseTarget false | Ob Skripte Interaktionen über qb-target (das Auge) oder Tastenhinweise verwenden. | Anfangs false, true, wenn Sie Target-basierte Interaktionen möchten. |
sv_enforceGameBuild 3095 | Game Build (DLC). | Behalten Sie den Wert aus dem Rezept. |
add_principal qbcore.god group.admin und andere | Die Hierarchie der QBCore-Admin-Gruppen. | Nicht löschen. |
Beim ersten Start baut QBCore einige Resources (yarn-Ausgabe in der Konsole). Lassen Sie es fertig werden, auch wenn es mehrere Minuten dauert, und starten Sie den Server in der Zwischenzeit nicht neu.
Qbox
Rezept: Wählen Sie in der Liste Popular Recipes den Eintrag Qbox Framework.
Was das Rezept installiert: den Kern qbx_core, qbx_*-Skripte (Management, Polizei, EMS, Garagen, Immobilien, HUD, Admin-Menü …), die Bibliotheken ox_lib, ox_target, ox_inventory, ox_doorlock und oxmysql sowie das Telefon npwd. Die Einstellungen sind auf die Dateien server.cfg, permissions.cfg, ox.cfg, voice.cfg und misc.cfg verteilt.
Einstellungen nach dem Deployment:
| Datei und Zeile | Was sie tut | Was einstellen |
|---|---|---|
server.cfg: sets locale "root-AQ" | Die Serversprache in der Liste. | Ihre Sprache, zum Beispiel sets locale "de-DE" oder sets locale "cs-CZ" |
ox.cfg: setr ox:locale "en" | Die Sprache von ox_lib und den Skripten, die es verwenden (einschließlich qbx_core). | de für Deutsch oder ein anderer Sprachcode, zum Beispiel cs. |
server.cfg: setr qb_locale "en" | Die Sprache für QBCore-Skripte, die über die Bridge laufen. | Derselbe Sprachcode wie bei ox:locale. |
server.cfg: setr qbx:enableBridge "true" | Die Bridge für Skripte, die für QBCore geschrieben wurden. | Behalten Sie true, wenn Sie QBCore-Skripte verwenden. |
server.cfg: set qbx:discordLink "discord.gg/qbox" | Der Discord-Link, den der Server den Spielern zeigt. | Ein Link zu Ihrem Discord. |
server.cfg: set qbx:max_jobs_per_player 1 | Wie viele Jobs ein Charakter haben kann. | Mehr, wenn Sie Multijob möchten. |
ox.cfg: setr inventory:slots 50, setr inventory:weight 85000 | Die Anzahl der Inventar-Slots und die Tragfähigkeit (in Gramm). | Nach Ihren Serverregeln. |
server.cfg: setr loadscreen: | Der Ladebildschirm wird vom Multicharacter geschlossen. | Nur mit einem eigenen Multicharacter, der den Bildschirm nicht schließt, auf false ändern. |
Erste Schritte nach der Installation: Admin-Berechtigungen#
Ein Admin in txAdmin und ein Admin im Framework sind zwei verschiedene Dinge. Beim Deployment fügt txAdmin den Hauptadmin in der server.cfg zur Gruppe group.admin hinzu (die Zeile add_principal identifier.). Die Frameworks bauen darauf wie folgt auf:
ESX
ESX speichert die Gruppe direkt beim Charakter in der Datenbank (user, admin …). Der Hauptadmin aus txAdmin wird dank der Gruppe group.admin automatisch erkannt. Um einen weiteren Spieler zum Admin zu machen, verwenden Sie im Spiel oder in der Serverkonsole:
setgroup <SPIELER_ID> adminsetgroup– der ESX-Befehl zum Ändern einer Gruppe (im Spiel mit Schrägstrich:/setgroup).<SPIELER_ID>– die Server-ID des Spielers (die Zahl, die Sie in der Spielerliste in txAdmin oder im Spiel sehen).admin– die Gruppe. Um ihn wieder zum normalen Spieler zu machen, setzen Sie die Gruppeuser.
Die Gruppe wird in der Datenbank gespeichert und bleibt nach einem Neustart erhalten. Ein Spieler kann seine Gruppe mit dem Befehl /group prüfen.
QBCore
QBCore verwendet die ACE-Gruppen qbcore.god (alles), qbcore.admin und qbcore.mod. Einen Admin fügen Sie dauerhaft mit einer Zeile in der server.cfg hinzu (im CFG Editor, wenn Sie txAdmin verwenden):
add_principal identifier.license:<PLAYER_LICENSE> qbcore.godidentifier.– die Lizenz des Spielers. Sie finden sie in txAdmin: Players, auf den Spieler klicken, Registerkarte IDs.license: <PLAYER_ LICENSE> qbcore.god– die höchste Gruppe. Für weniger Berechtigungen verwenden Sieqbcore.adminoderqbcore.mod.
Im Spiel können Sie eine Berechtigung auch mit dem Befehl /addpermission <SPIELER_ID> god oder im Admin-Menü (/admin › Player Management › Spieler › Permissions) hinzufügen. Eine so hinzugefügte Berechtigung gilt nur, bis der Spieler die Verbindung trennt oder der Server neu startet; dauerhaft ist sie nur über die server.cfg.
Qbox
Qbox verwendet die ACE-Gruppen group.admin, group.mod und group.support (definiert in der permissions.cfg). Einen Admin fügen Sie dauerhaft mit einer Zeile in der permissions.cfg oder server.cfg hinzu:
add_principal identifier.license:<PLAYER_LICENSE> group.adminidentifier.– die Lizenz des Spielers aus txAdmin (Players › Spieler › Registerkarte IDs). Sie können auchlicense: <PLAYER_ LICENSE> identifier.verwenden.fivem: <FIVEM_ ID> group.admin– volle Berechtigungen.group.moderhält das Menü und Moderatoraktionen,group.supportnur Support.
Das Admin-Menü öffnen Sie im Spiel mit dem Befehl /admin. Der Befehl /addpermission existiert, ist aber veraltet und gilt nur, bis der Spieler die Verbindung trennt.
Starten Sie den Server nach dem Bearbeiten der server.cfg oder permissions.cfg neu.
Auf Qbox erfordern die Admin-Befehle des Kerns (zum Beispiel /addpermission, /setjob, /car) zuerst die Eingabe von /optin. Das können Sie mit der Option requireOptIn = false in qbx_ ausschalten.
Was Sie zuerst einstellen sollten#
Jedes Framework hat eine Hauptkonfigurationsdatei mit Wirtschaft, Spawn und Charakteren. Bearbeiten Sie sie bei gestopptem Server oder starten Sie den Server in txAdmin nach der Bearbeitung neu. Die Dateien finden Sie im Deployment-Ordner unter resources.
ESX
Datei resources/:
| Einstellung | Was sie tut | Standardwert | Wann ändern |
|---|---|---|---|
Config. | Das Geld, mit dem ein neuer Charakter startet, pro Konto (bank, money = Bargeld, black_money). | { bank = 50000 } | Nach Ihrer Serverwirtschaft. Gilt nur für neue Charaktere. |
Config. | Items für einen neuen Charakter (eine Tabelle) oder false. | false | Ein Starterpaket (Telefon, Wasser, Essen). |
Config.DefaultSpawns | Koordinaten, an denen ein neuer Charakter erscheint. Mehrere Zeilen = zufällige Auswahl. | eine Position in der Stadt | Ein eigener Spawn (Flughafen, Bahnhof). |
Config. | Welche Gruppen welchen ESX-Admin-Befehl verwenden dürfen (setjob, car, setgroup …). | owner und admin | Moderatoren nur einen Teil der Befehle geben. |
Datei resources/:
| Einstellung | Was sie tut | Standardwert |
|---|---|---|
Config.Slots | Wie viele Charaktere jeder Spieler erstellen kann. Slots für einzelne Spieler fügen Sie mit dem Befehl /setslots hinzu. | 3 |
Config.CanDelete | Ob ein Spieler seinen Charakter löschen kann. | true |
QBCore
Datei resources/:
| Einstellung | Was sie tut | Standardwert | Wann ändern |
|---|---|---|---|
QBCore. | Geldarten und Startbeträge (cash, bank, crypto). | { cash = 500, bank = 5000, crypto = 0 } | Nach Ihrer Wirtschaft. Eine hinzugefügte Geldart verschwindet nicht aus der Datenbank, auch wenn Sie sie aus der Konfiguration entfernen. |
QBCore. | Wie oft (in Minuten) Spieler bezahlt werden. | 10 | Ein längeres Intervall = eine langsamere Wirtschaft. |
QBCore. | Der erste Spawn-Ort (vector4(x, y, z, heading)). | nahe dem Flughafen | Ein eigener Spawn. |
QBCore., ThirstRate | Wie schnell Hunger und Durst steigen. | 4.2, 3.8 | Eine niedrigere Zahl = langsamer. |
QBCore. | Schließt den Server für alle ohne Berechtigung. | false | Wartung. |
QBCore.Config.Server.PVP | Ob Spieler aufeinander schießen können. | true | Server ohne PvP. |
QBCore. | Die Liste der Admin-Gruppen (jede braucht add_ace/add_principal in der server.cfg). | { 'god', 'admin', 'mod' } | Eigene Gruppen (zum Beispiel leo). |
Qbox
Datei resources/:
| Einstellung | Was sie tut | Standardwert | Wann ändern |
|---|---|---|---|
money.moneyTypes | Geldarten und Startbeträge. | { cash = 500, bank = 5000, crypto = 0 } | Nach Ihrer Wirtschaft. Eine hinzugefügte Geldart verschwindet nicht aus der Datenbank. |
money.paycheckTimeout | Gehaltsintervall in Minuten. | 10 | Nach Ihrer Wirtschaft. |
characters. | Wie viele Charaktere jeder Spieler hat. | 3 | Mehr Charaktere für alle. |
characters. | Ausnahmen für bestimmte Spieler nach Lizenz. | eine Beispielzeile | Mehr Charaktere für ausgewählte Spieler (VIP). |
requireOptIn | Admin-Befehle des Kerns erfordern /optin. | true | false, wenn es Ihre Admins stört. |
Datei resources/: characters. (eigener Multicharacter), characters. (Spieler können Charaktere löschen), characters. (Wahl einer Wohnung nach dem Erstellen eines Charakters).
Geld und Items werden in der Datenbank gespeichert. Eine Änderung der Startwerte betrifft nur neu erstellte Charaktere; bestehende bleiben, wie sie sind.
Kompatible Skripte#
- Laden Sie die Version für Ihr Framework herunter. Viele Autoren bieten ein Skript für mehrere Frameworks mit einer Option in der
config.luaan (zum BeispielConfig.Framework = 'esx','qb'oder'qbx'). - Die ox-Bibliotheken (
ox_lib,ox_inventory,ox_target) funktionieren sowohl mit ESX als auch mit Qbox. Machen Sie sich vor der Installation eines zweiten Inventars klar, welches Sie verwenden. Zwei Inventare gleichzeitig funktionieren nicht. - QBCore-Skripte auf Qbox laufen über die Bridge, wenn sie
qb-coreauf die dokumentierte Weise verwenden. Skripte, die direkt auf QBCore-Datenbanktabellen zugreifen, funktionieren nicht. - Konflikte: Zwei Skripte mit derselben Funktion (zwei HUDs, zwei Garagen, zwei Telefone) kommen sich in der Regel in die Quere. Schalten Sie das ursprüngliche aus (kommentieren Sie sein
ensureaus oder verschieben Sie es aus der Kategorie).
Die Installation einzelner Skripte behandelt FiveM-Resources.
Manuelle Installation (für Fortgeschrittene)#
Ein Rezept erledigt automatisch, was Sie sonst von Hand tun würden:
- Lädt den Framework-Kern und seine Abhängigkeiten (
oxmysql,ox_lib…) in bestimmten Versionen herunter. - Importiert die SQL-Datei des Frameworks in die Datenbank.
- Bereitet die
server.cfgmit der richtigenensure-Reihenfolge, ACE-Berechtigungen und dem Connection String vor.
Wählen Sie die manuelle Installation nur, wenn Sie jede Version unter Kontrolle haben möchten. Folgen Sie der offiziellen Dokumentation des Frameworks und halten Sie die Reihenfolge ein: oxmysql › Bibliotheken › Kern › Skripte. Auf einem StormHost-Server ist das Rezept deutlich schneller; Hunderte Dateien von Hand über die Registerkarte Dateien hochzuladen ist mühsam (für große Dateien kann der Support SFTP einrichten).
Framework aktualisieren#
- Sichern Sie die Dateien (Registerkarte Backups) und exportieren Sie die Datenbank (HeidiSQL, Anleitung).
- Lesen Sie die Versionshinweise (Changelog) auf dem GitHub des Frameworks. Achten Sie vor allem auf Datenbankänderungen (
.sql-Migrationsdateien) und Konfigurationsänderungen. - Stoppen Sie den Server.
- Ersetzen Sie die Ordner der aktualisierten Resources durch die neuen. Laden Sie Ihre
config.lua-Dateien vorher herunter und vergleichen Sie sie nach dem Update mit den neuen (neue Optionen könnten fehlen). - Führen Sie das Migrations-SQL aus, falls das Release eines enthält.
- Starten Sie den Server und beobachten Sie die Konsole. Prüfen Sie dann im Spiel Ihren Charakter, Ihr Geld und Ihr Inventar.
Aktualisieren Sie nicht nur den Kern ohne die übrigen Teile des Frameworks. Die Versionen von es_extended und den [esx_addons]-Skripten (oder qb-core und qb-*) sollten zusammenpassen.
Überprüfung#
- Die Konsole (oder Live Console in txAdmin) zeigt
Database server connection established!, und der Framework-Kern lädt ohne rote Fehler. - Nach dem Verbinden im Spiel erscheint die Charaktererstellung oder -auswahl.
- Der Befehl
/group(ESX) oder das Öffnen des Menüs/admin(QBCore, Qbox) bestätigt, dass Sie Admin-Berechtigungen haben.
Fehlerbehebung#
Meldungen, die Sie hier nicht finden, schlagen Sie in Häufige Fehler des FiveM-Servers nach.
Task Failed: Response code 403 (rate limit exceeded)#
Das Rezept lädt Dutzende Repositories von GitHub herunter, und GitHub hat die Anzahl der Anfragen vorübergehend begrenzt. Warten Sie etwa eine Stunde und führen Sie das Deployment erneut aus.
Das Deployment scheitert mit einem Datenbankfehler#
Die Daten passen nicht zur Registerkarte Datenbank (der Host aus dem Feld Host, nicht localhost; der Datenbankname genau wie in der Liste). Typische Meldungen und ihre Lösung stehen in Datenbank für FiveM.
ESX = nil (oder attempt to index a nil value (global 'ESX'))#
Das Skript hat keinen Zugriff auf ESX: Entweder startet es vor es_extended, oder es verwendet die alte Art, ESX zu laden. Setzen Sie sein ensure unter es_extended und aktualisieren Sie sowohl es_extended als auch das Skript auf die aktuelle Version.
No such export GetCoreObject in resource qbx_core#
Ein QBCore-Skript ruft den Qbox-Kern direkt auf. Auf Qbox sollte es exports['qb-core']: aufrufen (über die Bridge). Prüfen Sie, dass die Bridge eingeschaltet ist (setr qbx:enableBridge "true"), und korrigieren Sie das Skript oder laden Sie die Qbox-Version herunter.
Native … is not supported#
Das Framework oder ein Skript verwendet eine Funktion, die Ihre Serverversion noch nicht kennt. Aktualisieren Sie die Artifacts auf die neueste Version (Anleitung).
Ein Spieler hängt im Ladebildschirm#
- Meist ein Fehler im Multicharacter-Skript oder in der Datenbank. Sehen Sie in die Serverkonsole und die Client-Konsole (F8).
- Qbox mit eigenem Multicharacter: Setzen Sie
setr loadscreen:.externalShutdown false - QBCore nach dem ersten Deployment: Warten Sie, bis der Build der Resources (
yarn) abgeschlossen ist.
ESX Multicharacter couldn't connect to the database#
Die Datenbankverbindung funktioniert nicht. Prüfen Sie set mysql_connection_string in der server.cfg und die Zeile Database server connection established! in der Konsole.
Admin-Befehle funktionieren nicht#
- QBCore und Qbox: Die Zeile
add_principal …mit dem richtigen Identifikator fehlt, oder Sie haben sie hinzugefügt und den Server nicht neu gestartet. - ESX: Der Spieler hat nicht die Gruppe
admin. Prüfen Sie es mit/groupund setzen Sie sie mitsetgroup.
Zusammenfassung
- Wählen Sie Ihr Framework im Voraus: ESX Legacy hat die meisten Skripte, Qbox die modernste Basis plus Kompatibilität mit QBCore-Skripten, und QBCore ist der Klassiker mit eigenen
qb-*-Skripten. - Installation: leere Datenbank, txAdmin › Popular Recipes › Rezept, Datenbankdaten aus dem Feld Host, Run Recipe, Save & Run Server.
- Stellen Sie nach der Installation die Serversprache (
sets locale) und die Framework-Sprache ein und fügen Sie Admins dauerhaft über dieserver.cfg(QBCore, Qbox) odersetgroup(ESX) hinzu. - Laden Sie Skripte in der Version für Ihr Framework herunter. Sichern Sie Dateien und Datenbank vor einem Update.
Weiterführende Links#
- ESX Legacy: Dokumentation (öffnet sich in einem neuen Fenster)
- QBCore: Dokumentation (öffnet sich in einem neuen Fenster)
- Qbox: Dokumentation (öffnet sich in einem neuen Fenster)
- FiveM: Frameworks (öffnet sich in einem neuen Fenster)
- Liste der txAdmin-Rezepte (Popular Recipes) (öffnet sich in einem neuen Fenster)