Come diventare admin su FiveM: add_ace, add_principal, group.admin

Avvii il tuo server, vi entri, e i comandi admin non fanno nulla: nessun menu, nessun /car, il framework dice che non hai i permessi. Possiedi il server, ma il server non lo sa ancora. Devi dirgli chi sei.

FiveM ha un sistema di autorizzazioni chiamato ACE. Questa guida mostra come mettersi nel gruppo admin, come trovare il tuo identificatore, e cosa impostare in ESX e QBCore oltre a questo.

#Come funziona ACE

ACE (Access Control Entries) è integrato in FiveM. Due cose sono importanti:

• add_ace assegna un'autorizzazione a un gruppo o a una persona, per esempio "il gruppo admin può eseguire qualsiasi comando".
• add_principal aggiunge una persona, o un gruppo, in un altro gruppo.

Lo schema usuale è: definire cosa il gruppo admin può fare, poi aggiungere i giocatori con il loro identificatore. Tutto va in server.cfg.

#Passaggio 1: definire il gruppo admin

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

La prima riga permette al gruppo admin di eseguire tutti i comandi. La seconda rimuove un comando pericoloso, quindi un admin non può fermare il server con quit. Puoi aggiungere altre righe deny per i comandi che non vuoi nel gruppo.

#Passaggio 2: aggiungiti al gruppo

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Sostituisci il valore lungo con il tuo identificatore. Puoi aggiungere più di un giocatore, una riga per ognuno:

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

Il tipo di identificatore va prima dei due punti, e puoi usare qualsiasi tipo. Tutti puntano alla stessa persona, quindi una riga per persona è sufficiente.

#Passaggio 3: trova i tuoi identificatori

Hai bisogno del tuo identificatore dal punto di vista del server, quindi entra nel server almeno una volta.

• In txAdmin: apri la pagina Players, clicca il tuo nome, e apri le info del giocatore. Gli ID sono elencati lì (license, fivem, discord, steam e altri).
• In the server console: digita status. Elenca ogni giocatore connesso con i loro identificatori.

Quale usare:

• license: legato alla licenza Rockstar del giocatore. Presente per tutti, quindi è la scelta sicura.
• fivem: legato all'account Cfx.re. Stabile e buono per lo staff che usa più PC.
• discord: legato all'account Discord, e presente solo quando l'app Discord è aperta sul PC del giocatore quando entra. Non fare affidamento solo su questo.

Attenzione: copia l'identificatore dalla pagina del giocatore in txAdmin, non da uno screenshot che qualcuno ti ha mandato. Un identificatore sbagliato o vecchio dà i privilegi admin a un'altra persona o a nessuno.

#Passaggio 4: applicalo

server.cfg viene letto quando il server si avvia, quindi riavvia il server. Puoi anche incollare le righe nella console del server per applicarle senza riavvio:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Riconnettiti al server dopo, perché i tuoi permessi vengono controllati quando entri.

Per testarlo, esegui un comando che richiede autorizzazioni, o nella console F8 usa un comando che sai è limitato. Se riesci a usarlo, la regola funziona.

#Admin in ESX

ACE controlla i comandi. ESX ha anche i propri gruppi di giocatori, memorizzati nella colonna group della tabella users nel tuo database. Un giocatore è user per impostazione predefinita, e un admin è admin.

Dalla console del server puoi impostarlo con:

setgroup 1 admin

dove 1 è il tuo ID del server (vedi la lista dei giocatori in txAdmin). Puoi anche modificare la colonna group direttamente con uno strumento di database, poi riconnettersi. Alcuni script admin leggono il gruppo ACE, altri leggono il gruppo ESX, quindi imposta entrambi se uno di loro non funziona.

#Admin in QBCore

QBCore legge i suoi permessi da ACE. Il server.cfg predefinito di QBCore definisce gruppi come qbcore.god, qbcore.admin e qbcore.mod. Aggiungiti a quello che vuoi:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd qbcore.god

Se non vedi quelle righe di gruppo nel tuo server.cfg, controlla quello che è venuto con qb-core e copialo. Riavvia e riconnettiti, poi prova un comando admin.

Su QBox, i permessi sono anche basati su ACE. Segui l'esempio nella documentazione di qbx_core o il suo server.cfg predefinito, e usa la stessa forma add_principal con il tuo identificatore.

#Se ancora non funziona

• Nessun effetto: la riga è in un server.cfg che il server non carica, o è commentata. Controlla il percorso in cima alla console di txAdmin.
• Un errore di battitura nell'identificatore: confrontalo carattere per carattere con la pagina del giocatore in txAdmin.
• Non ti sei riconnesso: i permessi vengono applicati quando entri.
• Prefisso sbagliato: è identifier.license: con un punto, non identifier:license: o license:.
• Il framework dice ancora di no: imposta anche il gruppo ESX o QBCore, come sopra.

Per l'accesso al pannello txAdmin stesso, quello è un accesso separato, vedi txAdmin forgot password.

#Checklist