Wie mache ich mich mit ACE-Permissions zum Admin auf meinem FiveM-Server?

Dein FiveM-Server läuft und du kannst dich über F8 verbinden, aber im Spiel bist du noch ein ganz normaler Spieler: kein Kick, kein Ban, kein Adminmenü. In dieser Anleitung machst du dich (und deine Teammitglieder) über zwei Wege zum Admin, die sich gegenseitig ergänzen: txAdmin-Admins für die Webverwaltung und ACE-Permissions in der server.cfg für Rechte im Server selbst. Sieh das als FiveM-Gegenstück zu unserer LuckPerms-Anleitung für Minecraft.

txAdmin oder ACE: wann nimmst du was?

txAdmin ist das Webpanel, mit dem du den Server verwaltest: Spielerliste, Live-Konsole, Bans, geplante Neustarts. Ein txAdmin-Admin loggt sich über den Browser ein und muss dafür nicht einmal im Spiel sein. ACE-Permissions bestimmen, was ein Spieler im Server darf: welche Commands er ausführen kann und welche geschützten Funktionen von Ressourcen (etwa ein Adminmenü) bei ihm funktionieren. Ein vollwertiger Administrator braucht meistens beides.

Weg 1: einen Admin in txAdmin hinzufügen

1. Öffne die txAdmin-Oberfläche im Browser und logge dich mit deinem Master-Account ein (angelegt beim ersten Setup). Läuft txAdmin noch nicht, folge zuerst unserer Anleitung zum Aktivieren von txAdmin.
2. Gehe im Menü auf Admins und klicke auf New Admin.
3. Wähle einen Benutzernamen und trage optional den Cfx.re-Benutzernamen und die Discord-ID des neuen Admins ein. Mit dieser Verknüpfung kann er sich künftig über den Cfx.re- oder Discord-Button statt mit einem Passwort einloggen.
4. Hake nur die Berechtigungen an, die die Rolle wirklich braucht. Für einen Moderator reicht die Spielerverwaltung (kick, warn, ban); Einstellungen, die Live-Konsole und das Verwalten anderer Admins behältst du für dich.
5. Speichere und teile das temporäre Passwort, das txAdmin anzeigt. Beim ersten Login wählt der neue Admin ein eigenes Passwort.

Deinen eigenen Identifier finden (license, steam oder discord)

ACE-Permissions hängst du an einen Identifier: einen eindeutigen Code, an dem FiveM deinen Account erkennt. So findest du ihn:

1. Verbinde dich mindestens einmal mit deinem eigenen Server, damit er deine Identifier kennt.
2. Öffne in txAdmin die Seite Players, klicke auf deinen eigenen Namen und sieh dir deine IDs an. Dort stehen unter anderem license:, discord: und (wenn Steam beim Verbinden lief) steam:.
3. Nutzt du txAdmin nicht? Tippe status in die Serverkonsole (Tab Console im Gamepanel); hinter jedem verbundenen Spieler steht ein Identifier.

Nimm am besten den license-Identifier: Er ist immer vorhanden und ändert sich nie. Die steam-Variante fehlt, wenn Steam nicht offen war, und discord erscheint nur, wenn Discord beim Verbinden aktiv war.

Weg 2: ACE-Permissions in der server.cfg setzen

1. Öffne im Gamepanel den Tab Files und navigiere zu der server.cfg, die dein Server tatsächlich lädt. Bei einem txAdmin-Deployment liegt sie meist in einem Unterordner von txData. Neu bei dieser Datei? Lies zuerst unsere server.cfg-Basics.
2. Füge den Block unten ans Ende der Datei ein und ersetze die Beispiel-Identifier durch deine eigenen Werte.
3. Speichere die Datei und starte den Server über den Tab Console neu (oder über txAdmin). ACE-Zeilen werden nur beim Start eingelesen.
4. Teste im Spiel, ob deine Adminrechte funktionieren, zum Beispiel mit dem Adminmenü deines Frameworks.

# --- Admins (ACE-Permissions) ---
add_ace group.admin command allow            # Admins dürfen alle Konsolen-Commands nutzen
add_ace group.admin command.quit deny        # aber den Server herunterfahren geht nur übers Panel

# Moderatoren bekommen nur, was du hier ausdrücklich erlaubst
add_ace group.mod command.clientkick allow   # Moderatoren dürfen Spieler kicken

# Hierarchie: jeder Admin erbt automatisch alle Mod-Rechte
add_principal group.admin group.mod

# Spieler mit Gruppen verknüpfen (achte auf das Präfix identifier.)
add_principal identifier.license:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b group.admin  # DeinName
add_principal identifier.discord:123456789012345678 group.mod                          # ModeratorName

So funktioniert die Hierarchie: add_ace gibt einem Principal (etwa der Gruppe group.admin) ein Recht, und add_principal X Y bedeutet „X erbt alle Rechte von Y“. Durch add_principal group.admin group.mod erben Admins also alles, was Mods dürfen — umgekehrt nicht. Einen Spieler machst du zum Admin, indem du seinen Identifier mit add_principal an group.admin hängst. Sei sparsam mit zusätzlichen add_ace … allow-Zeilen: Gib einer Ressource nur die Ace, die ihre Dokumentation nennt, und gib builtin.everyone (allen Spielern) nie mehr Rechte als unbedingt nötig.

Häufige Probleme

• Permissions verschwinden nach einem Neustart — Du hast add_ace oder add_principal in die Live-Konsole getippt (das gilt nur bis zum Neustart) oder in eine Datei geschrieben, die der Server nicht lädt. Setze die Zeilen in die server.cfg, die txAdmin wirklich nutzt; welchen Pfad sie hat, siehst du in den txAdmin-Einstellungen.
• Identifier falsch formatiert — In add_principal gehört das Präfix identifier. vor den Wert, ohne Leerzeichen: also identifier.license:…. Eine License hat 40 Hexadezimalzeichen, ein Discord-Identifier ist die numerische ID (nicht dein Benutzername) und ein Steam-Identifier ist der Hexwert, den der Server anzeigt, nicht deine SteamID64.
• „You do not have permission“ trotz group.admin — Frameworks wie ESX und QBCore haben zusätzlich ihre eigene Admin-Gruppe in der Datenbank oder Config. ACE regelt die Server-Commands; prüfe für Framework-Funktionen auch die Berechtigungen des Frameworks selbst.
• Plötzlich können alle Admin-Commands nutzen — Irgendwo steht eine zu weit gefasste Regel, etwa command allow auf builtin.everyone oder ein pauschales allow, das eine Ressourcen-Installation hinzugefügt hat. Durchsuche deine cfg-Dateien nach add_ace und entferne alles, was du nicht bewusst erlaubt hast.
• Login in txAdmin über Cfx.re oder Discord klappt nicht — Prüfe, ob der Cfx.re-Benutzername exakt stimmt und ob die Discord-ID die 17- bis 19-stellige Nummer ist. Mit Benutzername und Passwort kannst du dich immer noch einloggen.

Brauchst du Hilfe?

Mit einem txAdmin-Account und einer sauberen ACE-Gruppe in der server.cfg steht deine Adminstruktur langfristig. Kommst du trotzdem nicht weiter? Eröffne ein Ticket über unsere Supportseite und nenne deinen Servernamen und die Zeilen, die du hinzugefügt hast — teile niemals deinen License-Key.