Creare una whitelist FiveM con Discord e txAdmin

Tempo stimato: 15 minuti
Difficoltà: Principiante ⭐
Server compatibili: FiveM su OuiPanel, canale Legacy (txAdmin)

📋 Introduzione

Una whitelist basata su un ruolo Discord è il metodo più semplice per un server RP. Solo i giocatori che hanno un ruolo preciso sul tuo Discord possono connettersi. Approvi una candidatura, il giocatore riceve il ruolo ed entra in città. Nessuna licenza da copiare, nessun comando da digitare.

Questa guida usa txAdmin, incluso con il tuo server FiveM su OuiHeberg, e Toscio, un bot Discord gratuito che gestisce le candidature. L'abbiamo preparata insieme al team di Toscio.

🎬 Guarda la configurazione in video (2 min 30 su YouTube, audio in francese).

✅ Cosa ti serve

Il tuo server FiveM OuiHeberg sul canale Legacy, che si avvia con la sua chiave di licenza (vedi la nostra guida Keymaster FiveM)
Un server Discord su cui hai il permesso Gestisci server
15 minuti

Per prima cosa attiva la modalità sviluppatore di Discord in Impostazioni utente → Avanzate. Ti permette di copiare gli ID che ti serviranno.

🎭 Passo 1: crea il ruolo che apre le porte

In Impostazioni server → Ruoli, crea un ruolo Whitelisted. Fai clic destro sul ruolo e scegli Copia ID ruolo. Tieni questo numero a portata di mano.

🤖 Passo 2: crea un bot Discord per txAdmin

txAdmin controlla i ruoli tramite un bot Discord che crei tu.

Sul portale sviluppatori di Discord, clicca su New Application.
Nella scheda Bot, clicca su Reset Token e copia il token. Tienilo segreto, perché dà il pieno controllo del bot.
Sempre nella scheda Bot, attiva Server Members Intent e salva. Senza questa opzione, txAdmin non vede i ruoli.
Nella scheda OAuth2 → URL Generator, spunta bot, apri il link generato e invita il bot sul tuo Discord.

🛡️ Passo 3: attiva la whitelist in txAdmin

Aprire txAdmin

Su OuiHeberg, txAdmin si apre nel browser, all'indirizzo IP del tuo server seguito dalla sua porta txAdmin. Trovi questa porta in OuiPanel.

In OuiPanel, apri il tuo server FiveM e poi Configurazione → Gestione porte. Il tuo server ha due porte. La porta principale serve ai giocatori, la seconda è quella di txAdmin.
In Configurazione → Impostazioni del server, verifica che TXADMIN_ENABLE valga 1 e che TXADMIN_PORT contenga questa seconda porta. Se cambi un valore, riavvia il server.
Apri l'indirizzo nel browser, con l'IP e la porta txAdmin del tuo server. Per esempio http://203.0.113.10:40120.
Al primo accesso, txAdmin chiede un codice PIN. Lo trovi nella Console del tuo server su OuiPanel.

💡 txAdmin esiste solo sul canale Legacy di FiveM. Sul canale Enhanced il server funziona senza txAdmin. Il canale si sceglie in Configurazione FiveM, su OuiPanel.

Collegare il bot e scegliere la modalità di whitelist

In txAdmin, apri Settings.

Scheda Discord: attiva Discord Bot, incolla il token in Token e l'ID del tuo server Discord in Guild/Server ID. Per ottenerlo, fai clic destro sul nome del server e scegli Copia ID server. Salva.
Scheda Whitelist: in Allowlist Mode, scegli Discord Server Roles. Incolla l'ID del ruolo in Allowlisted Discord Roles. In Allowlist Instructions, indica ai giocatori dove candidarsi. Salva.

⚠️ Assegna il ruolo Whitelisted a te stesso e al tuo staff prima di riconnetterti. Altrimenti txAdmin rifiuterà anche te.

📝 Passo 4: gestisci le candidature su Discord con Toscio

Resta da assegnare il ruolo ai giocatori accettati. Se ne occupa Toscio.

Aggiungi Toscio al tuo Discord da toscio.com.
In Impostazioni server → Ruoli, sposta il ruolo Toscio sopra Whitelisted. Un bot può assegnare solo i ruoli che si trovano sotto il suo.
Digita /toscio setup e scegli il modello di whitelist RP, il canale in cui i giocatori si candidano, un canale privato per il tuo staff e il ruolo Whitelisted.

I giocatori cliccano sul pulsante per candidarsi e compilano il modulo. Il tuo staff accetta, rifiuta con un motivo o apre un colloquio privato, per esempio per la dogana. All'accettazione, Toscio assegna il ruolo e avvisa il giocatore in messaggio privato. Può connettersi subito.

Le domande (età, personaggio, background, regolamento…) si modificano nella dashboard di Toscio. Per trovare idee, consulta queste 53 domande per la whitelist FiveM (in inglese).

🎁 1 mese di Toscio Premium in regalo per i clienti OuiHeberg. Su app.toscio.com, apri il tuo server, vai alla pagina Premium e inserisci il codice OUIHEBERG. Nessuna carta di credito richiesta.

❓ Problemi frequenti

“You do not have the discord identifier”

Il giocatore deve aprire l'app Discord sul PC, non la versione web, prima di avviare FiveM.

Un giocatore accettato viene comunque rifiutato

Controlla l'ID del ruolo nella scheda Whitelist di txAdmin. Verifica anche che il giocatore si connetta con lo stesso account Discord usato per la candidatura.

Toscio non riesce ad assegnare il ruolo

Sposta il ruolo Toscio sopra Whitelisted nei ruoli del tuo Discord.

txAdmin non salva le impostazioni Discord

Attiva Server Members Intent nella scheda Bot del portale sviluppatori di Discord.

La pagina di txAdmin non si apre

Verifica che il tuo server sia sul canale Legacy e che TXADMIN_ENABLE valga 1. Usa la porta txAdmin, non la porta di gioco, e un indirizzo in http://, non in https://.

Per gli altri casi, consulta la guida completa su toscio.com (in inglese).

🚀 Non hai ancora un server?

Il nostro hosting FiveM installa il tuo server in pochi minuti, con txAdmin e la versione di artifact che preferisci.

Hai bisogno di un server GTA/FiveM?

Scopri le nostre offerte di hosting GTA V / FiveM a partire da 2,99 €/mese, con il server pronto in 60 secondi.

Vedi le offerte