So machst du dich selbst zum Admin auf einem FiveM-Server: add_ace, add_principal, group.admin

Du startest deinen eigenen Server, trittst bei und die Admin-Befehle funktionieren nicht: kein Menü, kein /car, das Framework sagt dir, dass du keine Berechtigung hast. Du besitzt den Server, aber der Server weiß das noch nicht. Du musst ihm mitteilen, wer du bist.

FiveM hat ein Berechtigungssystem namens ACE. Diese Anleitung zeigt dir, wie du dich selbst zur Admin-Gruppe hinzufügst, wie du deine Kennung findest und was du zusätzlich in ESX und QBCore einstellst.

#Wie ACE funktioniert

ACE (Access Control Entries) ist in FiveM integriert. Zwei Dinge sind wichtig:

• add_ace gewährt einer Gruppe oder einer Person eine Berechtigung, zum Beispiel „die Gruppe admin darf jeden Befehl ausführen".
• add_principal fügt eine Person oder eine Gruppe in eine andere Gruppe ein.

Das übliche Muster ist: Definiere, was die Admin-Gruppe darf, und füge dann Spieler mit ihrer Kennung hinzu. Alles wird in server.cfg eingegeben.

#Schritt 1: Definiere die Admin-Gruppe

add_ace group.admin command allow
add_ace group.admin command.quit deny

Die erste Zeile erlaubt der Gruppe admin, alle Befehle auszuführen. Die zweite entfernt einen gefährlichen Befehl, sodass ein Admin den Server nicht mit quit stoppen kann. Du kannst mehr deny-Zeilen für Befehle hinzufügen, die du nicht in der Gruppe haben möchtest.

#Schritt 2: Füge dich selbst zur Gruppe hinzu

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Ersetze den langen Wert durch deine eigene Kennung. Du kannst mehr als einen Spieler hinzufügen, eine Zeile pro Spieler:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.discord:123456789012345678 group.admin

Der Kennungstyp steht vor dem Doppelpunkt, und du kannst jeden davon verwenden. Sie alle zeigen auf die gleiche Person, daher ist eine Zeile pro Person ausreichend.

#Schritt 3: Finde deine Kennungen

Du brauchst deine Kennung aus der Perspektive des Servers, also tritt zuerst einmal dem Server bei.

• In txAdmin: Öffne die Seite Spieler, klicke auf deinen Namen und öffne die Spielerinformationen. Die Kennungen sind dort aufgelistet (license, fivem, discord, steam und andere).
• In der Serverkonsole: Gib status ein. Es listet jeden verbundenen Spieler mit seinen Kennungen auf.

Welche du verwenden solltest:

• license: Gebunden an die Rockstar-Lizenz des Spielers. Für jeden vorhanden, daher ist dies die sichere Wahl.
• fivem: Gebunden an das Cfx.re-Konto. Stabil und gut für Mitarbeiter, die mehrere PCs verwenden.
• discord: Gebunden an das Discord-Konto und nur vorhanden, wenn die Discord-App auf dem PC des Spielers läuft, wenn dieser sich verbindet. Verlasse dich nicht allein darauf.

Achtung: Kopiere die Kennung von der txAdmin-Spielerseite, nicht aus einem Screenshot, den dir jemand anderes geschickt hat. Eine falsche oder alte Kennung gibt Admin an eine andere Person oder an niemanden.

#Schritt 4: Wende es an

server.cfg wird beim Start des Servers gelesen, daher starte den Server neu. Du kannst die Zeilen auch in die Serverkonsole einfügen, um sie ohne Neustart anzuwenden:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Verbinde dich danach wieder mit dem Server, da deine Berechtigungen überprüft werden, wenn du beitrittst.

Zum Testen führe einen Befehl aus, der Berechtigung benötigt, oder verwende in der F8-Konsole einen Befehl, von dem du weißt, dass er eingeschränkt ist. Wenn du ihn verwenden kannst, funktioniert die Regel.

#Admin in ESX

ACE steuert Befehle. ESX hat auch seine eigenen Spielergruppen, die in der Spalte group der Tabelle users in deiner Datenbank gespeichert sind. Ein Spieler ist standardmäßig user, und ein Admin ist admin.

In der Serverkonsole kannst du dies mit folgendem Befehl festlegen:

setgroup 1 admin

wobei 1 deine Server-ID ist (siehe die Spielerliste in txAdmin). Du kannst die Spalte group auch direkt mit einem Datenbanktool bearbeiten und dann die Verbindung wiederherstellen. Einige Admin-Skripte lesen die ACE-Gruppe, andere lesen die ESX-Gruppe, daher stelle beide ein, wenn eine davon nicht funktioniert.

#Admin in QBCore

QBCore liest seine Berechtigungen aus ACE. Die Standard-server.cfg in QBCore definiert Gruppen wie qbcore.god, qbcore.admin und qbcore.mod. Füge dich selbst zu einer davon hinzu:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd qbcore.god

Wenn du diese Gruppenzeilen nicht in deiner server.cfg siehst, überprüfe die, die mit qb-core kam, und kopiere sie. Starte neu und verbinde dich erneut, dann versuche einen Admin-Befehl.

Bei QBox basieren Berechtigungen auch auf ACE. Folge dem Beispiel in der qbx_core-Dokumentation oder ihrer Standard-server.cfg, und verwende die gleiche add_principal-Form mit deiner Kennung.

#Wenn es immer noch nicht funktioniert

• Überhaupt keine Wirkung: Die Zeile befindet sich in einer server.cfg, die der Server nicht lädt, oder sie ist auskommentiert. Überprüfe den Pfad oben in der txAdmin-Konsole.
• Ein Tippfehler in der Kennung: Vergleiche ihn Zeichen für Zeichen mit der txAdmin-Spielerseite.
• Du hast dich nicht wieder verbunden: Berechtigungen werden angewendet, wenn du beitrittst.
• Falsches Präfix: Es ist identifier.license: mit einem Punkt, nicht identifier:license: oder license:.
• Das Framework sagt immer noch nein: Stelle auch die ESX- oder QBCore-Gruppe ein, wie oben.

Für den Zugriff auf das txAdmin-Panel selbst handelt es sich um eine separate Anmeldung, siehe txAdmin-Passwort vergessen.

#Checkliste