Hoe maak ik mezelf admin op mijn FiveM-server met ACE-permissies?

Je FiveM-server draait en je kunt via F8 verbinden, maar in-game ben je nog een gewone speler: geen kick, geen ban, geen adminmenu. In deze gids maak je jezelf (en je teamleden) admin via twee sporen die elkaar aanvullen: txAdmin-admins voor het webbeheer en ACE-permissies in server.cfg voor rechten in de server zelf. Zie dit als het FiveM-equivalent van onze LuckPerms-gids voor Minecraft.

txAdmin of ACE: wanneer gebruik je wat?

txAdmin is het webpaneel waarmee je de server beheert: spelerslijst, live console, bans, geplande herstarts. Een txAdmin-admin logt in via de browser en hoeft daarvoor niet eens in-game te zijn. ACE-permissies bepalen wat een speler ín de server mag: welke commands hij mag uitvoeren en welke beschermde functies van resources (zoals een adminmenu) voor hem werken. Een volwaardige beheerder heeft meestal beide nodig.

Spoor 1: een admin toevoegen in txAdmin

1. Open de txAdmin-interface in je browser en log in met je master-account (aangemaakt tijdens de eerste setup). Draait txAdmin nog niet, volg dan eerst onze gids om txAdmin aan te zetten.
2. Ga in het menu naar Admins en klik op New Admin.
3. Kies een gebruikersnaam en vul optioneel de Cfx.re-gebruikersnaam en het Discord-ID van de nieuwe admin in. Met die koppeling kan diegene voortaan inloggen via de Cfx.re- of Discord-knop in plaats van met een wachtwoord.
4. Vink alleen de permissies aan die de rol echt nodig heeft. Voor een moderator volstaat spelersbeheer (kick, warn, ban); instellingen, de live console en het beheren van andere admins houd je voor jezelf.
5. Sla op en deel het tijdelijke wachtwoord dat txAdmin toont. Bij de eerste login kiest de nieuwe admin een eigen wachtwoord.

Je eigen identifier vinden (license, steam of discord)

ACE-permissies koppel je aan een identifier: een unieke code waarmee FiveM jouw account herkent. Zo vind je hem:

1. Verbind minstens eenmaal met je eigen server, zodat die je identifiers kent.
2. Open in txAdmin de pagina Players, klik op je eigen naam en bekijk je ID's. Daar staan onder andere license:, discord: en (als Steam draaide tijdens het verbinden) steam:.
3. Gebruik je txAdmin niet? Typ dan status in de serverconsole (tabblad Console in het gamepaneel); achter elke verbonden speler staat een identifier.

Gebruik bij voorkeur de license-identifier: die is er altijd en verandert nooit. De steam-variant ontbreekt als Steam niet openstond en discord verschijnt alleen als Discord actief was tijdens het verbinden.

Spoor 2: ACE-permissies instellen in server.cfg

1. Open in het gamepaneel het tabblad Files en navigeer naar de server.cfg die je server daadwerkelijk laadt. Bij een txAdmin-deployment staat die meestal in een submap van txData. Nieuw met dit bestand? Lees eerst onze server.cfg-basics.
2. Plak onderaan het bestand het onderstaande blok en vervang de voorbeeld-identifiers door je eigen waarden.
3. Sla het bestand op en herstart de server via het tabblad Console (of via txAdmin). ACE-regels worden alleen bij het opstarten ingelezen.
4. Test in-game of je adminrechten werken, bijvoorbeeld met het adminmenu van je framework.

# --- Admins (ACE-permissies) ---
add_ace group.admin command allow            # admins mogen alle console-commands gebruiken
add_ace group.admin command.quit deny        # maar de server afsluiten mag alleen via het paneel

# Moderators krijgen alleen wat je hier expliciet toestaat
add_ace group.mod command.clientkick allow   # moderators mogen spelers kicken

# Hierarchie: iedere admin erft automatisch alle mod-rechten
add_principal group.admin group.mod

# Spelers aan groepen koppelen (let op het voorvoegsel identifier.)
add_principal identifier.license:1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b group.admin  # JouwNaam
add_principal identifier.discord:123456789012345678 group.mod                          # ModeratorNaam

Zo zit de hiërarchie in elkaar: add_ace geeft een principal (zoals de groep group.admin) een recht, en add_principal X Y betekent "X erft alle rechten van Y". Door add_principal group.admin group.mod erven admins dus alles wat mods mogen — andersom niet. Een speler maak je admin door zijn identifier met add_principal aan group.admin te koppelen. Wees zuinig met extra add_ace … allow-regels: geef een resource alleen de ace die zijn documentatie noemt, en geef builtin.everyone (alle spelers) nooit meer rechten dan strikt nodig.

Veelvoorkomende problemen

• Permissies verdwijnen na een herstart — Je hebt add_ace of add_principal in de live console getypt (dat geldt alleen tot de herstart) of in een bestand gezet dat de server niet laadt. Zet de regels in de server.cfg die txAdmin echt gebruikt; welk pad dat is zie je in de txAdmin-instellingen.
• Identifier verkeerd geformatteerd — In add_principal hoort het voorvoegsel identifier. vóór de waarde, zonder spaties: dus identifier.license:…. Een license is 40 hexadecimale tekens, een Discord-identifier is het numerieke ID (niet je gebruikersnaam) en een steam-identifier is de hexwaarde die de server toont, niet je SteamID64.
• "You do not have permission" ondanks group.admin — Frameworks zoals ESX en QBCore hebben daarnaast hun eigen admin-groep in de database of config. ACE regelt de servercommands; controleer voor framework-functies ook de permissies van het framework zelf.
• Iedereen blijkt admin-commands te kunnen gebruiken — Ergens staat een te ruime regel, zoals command allow op builtin.everyone of een blanco allow die een resource-install heeft toegevoegd. Zoek in je cfg-bestanden naar add_ace en verwijder wat je niet bewust hebt toegestaan.
• Inloggen in txAdmin via Cfx.re of Discord lukt niet — Controleer of de Cfx.re-gebruikersnaam exact klopt en of het Discord-ID het 17- tot 19-cijferige nummer is. Je kunt altijd nog met gebruikersnaam en wachtwoord inloggen.

Hulp nodig?

Met een txAdmin-account en een nette ACE-groep in server.cfg staat je adminstructuur voor de lange termijn. Kom je er toch niet uit? Open een ticket via onze supportpagina en vermeld je servernaam en de regels die je hebt toegevoegd — deel nooit je license key.