IT

Server di gioco

Come gestire i permessi ACE su FiveM

Comprendi gli ACE e i principal di FiveM, crea gruppi di amministrazione in un file dedicato, verifica ogni permesso dalla console e correggi gli errori Access denied.

7 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

FXServer controlla l'accesso ai comandi con un sistema di ACE (access control entries) e di principal. Questa guida ti spiega come decide, come creare i tuoi gruppi in un file separato, come verificare ogni permesso e come revocare un accesso.

Prerequisiti

  • Un server installato con la guida Creare un server FiveM
  • Un accesso a txAdmin, per Live Console, CFG Editor e l'elenco dei giocatori
  • L'identificatore del giocatore a cui vuoi dare dei permessi

Le nozioni da conoscere

Una regola si legge così: tale principal ha il permesso, o no, di accedere a tale oggetto.

Nozione Ruolo Esempi
Principal Chi riceve il permesso group.admin, identifier.license:abc123, resource.es_extended
Oggetto Ciò che è protetto command, command.quit, mioserver.garage
ACE Una regola allow o deny add_ace group.admin command allow
Ereditarietà Un principal riceve i permessi di un altro add_principal identifier.license:abc123 group.admin

I principal più comuni:

Principal Indica
identifier.license:... Un giocatore, tramite la sua licenza Rockstar. È l'identificatore più sicuro da usare
identifier.fivem:... Un giocatore, tramite il suo account Cfx.re
identifier.discord:... Un giocatore, tramite il suo account Discord, solo se Discord viene rilevato al momento della connessione
player.1 Il giocatore numero 1 della sessione in corso. Questo numero cambia a ogni connessione
group.nome Un gruppo che definisci liberamente
resource.nome Una risorsa, quando esegue essa stessa un comando
builtin.everyone Tutti

Come decide FXServer

Quattro regole bastano a prevedere il risultato:

  1. Senza regola, è negato. Un principal non ha accesso a nulla per impostazione predefinita.
  2. Un permesso copre i suoi sotto-oggetti. command copre command.quit, e mioserver.garage copre mioserver.garage.apri.
  3. Un deny prevale su un allow, indipendentemente dall'ordine delle righe.
  4. Un giocatore viene valutato identificatore per identificatore. Basta che uno solo dei suoi identificatori sia autorizzato perché abbia accesso.

La quarta regola ha una conseguenza importante: un deny applicato a identifier.license:abc123 non impedisce l'accesso se identifier.fivem:42, dello stesso giocatore, è autorizzato. Per togliere un permesso a un giocatore, toglilo dal gruppo invece di aggiungere un deny.

Passo 1: individuare l'identificatore del giocatore

Il giocatore deve essersi già connesso al server. In txAdmin, apri la sua scheda dall'elenco dei giocatori, poi la scheda IDs. Vi trovi valori come license:abc123 o fivem:42.

Per FXServer, aggiungi il prefisso identifier.: license:abc123 diventa identifier.license:abc123.

Passo 2: creare un file di permessi

Un file separato mantiene server.cfg leggibile. Individua la cartella del server, il cui nome termina con .base. Se compaiono più cartelle, quella giusta è indicata da Server Data Folder, in Settings, scheda FXServer:

Terminale
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'

Apri una sessione fivem, salva la configurazione, poi crea il file:

Terminale
sudo -iu fivem
BASE=/home/fivem/txData/NOME_CARTELLA.base
cp "$BASE/server.cfg" "$BASE/server.cfg.prima-permessi"
nano "$BASE/permissions.cfg"

Esempio con un gruppo di moderazione e un gruppo di amministrazione, da adattare:

Testo
# Permessi dei moderatori
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow

# Gli amministratori ereditano dai moderatori
add_principal group.admin group.moderator

# Permessi degli amministratori
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Membri del team
add_principal identifier.license:LICENZA_MODERATORE group.moderator
add_principal identifier.license:LICENZA_ADMIN group.admin

Esci dalla sessione con exit.

Passo 3: caricare il file

In CFG Editor, aggiungi questa riga accanto ai permessi già presenti:

Testo
exec permissions.cfg

Il percorso è relativo alla cartella del server. Salva, poi applica il file senza riavviare digitando lo stesso comando in Live Console. Verrà comunque riletto al prossimo avvio.

Un giocatore connesso riceve subito i nuovi permessi, senza doversi riconnettere.

Passo 4: verificare i permessi

Tutti questi comandi si digitano in Live Console. test_ace risponde true o false:

Testo
test_ace identifier.license:LICENZA_MODERATORE command.clientkick
test_ace identifier.license:LICENZA_MODERATORE command.quit
test_ace group.admin command.quit

Con l'esempio qui sopra, devi ottenere true, false poi false. La risposta ha questa forma:

Testo
identifier.license:LICENZA_MODERATORE -> command.clientkick = true

Per mostrare tutto ciò che è caricato:

Testo
list_principals
list_aces

list_principals mostra figlio <- genitore, e list_aces mostra principal -> oggetto = ALLOW o DENY.

Se un risultato ti sorprende, attiva il tracciamento dettagliato, ripeti l'azione, poi disattivalo:

Testo
se_debug true
se_debug false

La console indica allora ogni regola consultata, con righe TEST ACL [...] -> ALLOW o DENY.

Autorizzare un comando o una risorsa

Aprire a tutti i giocatori un comando con accesso limitato:

Testo
add_ace builtin.everyone command.miocomando allow

Autorizzare una risorsa a lanciare un comando. Quando una risorsa usa ExecuteCommand, è lei che deve avere il permesso. Concedi solo il comando necessario:

Testo
add_ace resource.mia_risorsa command.add_principal allow

Proteggere una funzione del tuo script. Crea un oggetto libero, poi verificalo lato server con IsPlayerAceAllowed:

Testo
add_ace group.moderator mioserver.garage allow
lua
if IsPlayerAceAllowed(source, 'mioserver.garage') then
    -- azione riservata
end

ACE e framework

I framework si appoggiano a questo sistema, ma ognuno ha il proprio metodo. Non rimuovere le righe add_ace resource... aggiunte dalla loro recipe: ne hanno bisogno per funzionare.

ESX Legacy

Il gruppo del giocatore è salvato nella colonna group della tabella users. A ogni connessione, ESX aggiunge automaticamente il giocatore a group.<suo gruppo>. Cambia quindi il gruppo con il comando previsto, in Live Console o in gioco, con il giocatore connesso:

Testo
setgroup 1 admin

Qui, 1 è il numero del giocatore nella sessione.

QBCore

QBCore usa i livelli god, admin e mod. Per un permesso duraturo, metti la licenza in permissions.cfg:

Testo
add_principal identifier.license:LICENZA_GIOCATORE qbcore.god

Il comando in gioco /addpermission 1 god agisce su player.1: va perso non appena il giocatore si disconnette.

txAdmin

Gli account dell'interfaccia txAdmin sono indipendenti dagli ACE. I loro permessi si gestiscono in Admins e sono salvati in admins.json. Dare group.admin a un giocatore non gli dà quindi accesso a txAdmin, e viceversa.

Revocare un permesso

Elimina la riga da permissions.cfg, altrimenti il permesso tornerà al prossimo avvio. Togliere una riga non basta per il server in corso, perché le regole restano in memoria. Digita anche in Live Console:

Testo
remove_principal identifier.license:LICENZA_MODERATORE group.moderator
remove_ace group.moderator command.say allow

Verifica poi con test_ace. Puoi anche riavviare il server, che riparte solo dai file.

Per annullare completamente le tue modifiche, rimuovi la riga exec permissions.cfg da CFG Editor, rimetti se necessario la copia server.cfg.prima-permessi, poi riavvia il server.

In caso di problemi

Access denied for command

Il messaggio Access denied for command xxx. indica chi non ha il permesso a seconda del contesto:

  • Un giocatore ha lanciato il comando: verifica il suo identificatore con test_ace identifier.license:... command.xxx.
  • Compare all'avvio di una risorsa, o senza azione di un giocatore: è la risorsa a non avere il permesso. Aggiungi add_ace resource.nome command.xxx allow.

Con ESX, un messaggio su add_principal o remove_principal segnala spesso che le righe add_ace resource.es_extended ... della recipe sono state rimosse.

No such config file: permissions.cfg

Il file non è nella cartella del server, o il suo nome è diverso. Deve trovarsi accanto a server.cfg ed essere leggibile dall'utente fivem. Nel dubbio, correggi il proprietario:

Terminale
sudo chown fivem:fivem /home/fivem/txData/NOME_CARTELLA.base/permissions.cfg

Access type needs to be 'allow' or 'deny'

La riga add_ace o remove_ace è scritta male. La sua forma è add_ace principal oggetto allow, senza altre parole.

test_ace risponde true, ma il giocatore non ha accesso

  • Verifica che si tratti dello stesso identificatore, nella scheda IDs della sua scheda.
  • Non usare identifier.discord se Discord non era aperto al momento della connessione: preferisci la licenza.
  • Verifica che il comando venga lanciato davvero come immagini. Un menu o uno script può applicare i propri controlli oltre agli ACE.

Un deny non blocca il giocatore

Il giocatore è probabilmente autorizzato da un altro dei suoi identificatori. Cercali con list_principals, poi toglilo dai gruppi interessati.

Il permesso è sparito dopo una riconnessione o un riavvio

È stato dato con player.N, oppure digitato solo nella console. Aggiungilo a permissions.cfg con identifier.license:....

Un permesso rimosso dal file funziona ancora

Le regole già caricate restano attive fino al riavvio. Usa remove_ace o remove_principal, oppure riavvia il server.