How to Set Up a Discord Whitelist for Your FiveM Server (…

Pubblico: Proprietari e sviluppatori di server FiveM
Difficoltà: Facile → Intermedio
Risultato: Elenco consentito basato sui ruoli tramite i ruoli Discord (con blacklist facoltativa), manutenzione minima, feedback chiaro per i giocatori.

Nota sulle versioni: Il repository open source FAX/DiscordWhitelist È gestito dalla community e aggiornato l'ultima volta nel 2022. Funziona ancora su molti server. Esiste una versione commerciale mantenuta; se hai bisogno di supporto/SLA, prendila in considerazione. Questa guida riguarda la versione gratuita GitHub.

---

In breve

1. Crea un Discord Bot → abilita Intento dei membri del server → invitalo sul tuo Discord.
2. Copia il tuo ID gilda (server) E ID ruolo.
3. Scaricamento: FAX/DiscordWhitelist su GitHub → mettilo dentro risorse/ → configurare server.js.
4. Aggiungere assicurati DiscordWhitelist A server.cfg (oppure avviare in txAdmin).
5. Test: unisciti senza ruolo (bloccato) → aggiungi ruolo → unisciti nuovamente (consentito).

Tutorial correlati:
• FiveM Whitelist — Guida completa (txAdmin, script, DB)
• Come creare livelli di donazione su Discord

---

Perché la whitelist basata su Discord?

• Dinamico: Concedi/nega l'accesso aggiungendo/rimuovendo un ruolo Discord, senza modifiche ACE o DB.
• Scalabile: I moderatori possono gestire l'accesso da Discord sui dispositivi mobili.
• Verificabile: La cronologia dei ruoli + i registri di moderazione mostrano chi ha consentito a chi.

---

Prerequisiti

• Un server Discord (sei amministratore/proprietario).
• Server FiveM con txAdmin o controllo manuale.
• I giocatori devono avere il Applicazione desktop Discord in esecuzione quando ci si connette (quindi FiveM espone un discordia: identificatore).

---

Passaggio 1: crea un bot Discord e abilita gli intenti

1. Vai al Portale per sviluppatori Discord → Nuova applicazione → nominarlo (ad esempio, Bot della whitelist FiveMX).
2. Aggiungi un bot (Scheda Bot) → Reimposta token → copia il Token del bot (conservarlo in modo sicuro).
3. Sotto Intenti del gateway privilegiato, abilitare Intento dei membri del server(Non è richiesta l'intenzione di presenza.)
4. Invita il bot sul tuo Discord: OAuth2 → Generatore URL → Ambiti: robot; Permessi: minimi (nessuno può essere oltre l'iscrizione). Utilizza l'URL generato e aggiungilo alla tua gilda.

Sicurezza: Tratta il token del bot come una password. Fai non Invialo su Git o condividilo tramite screenshot. Ruotalo se trapelato.

---

Fase 2: Ottieni i tuoi ID (Gilda e Ruoli)

• Su Discord → Impostazioni utente → Avanzate → Modalità sviluppatore: SU.
• Fai clic con il pulsante destro del mouse nome del server → Copia ID server.
• Impostazioni server → Ruoli → fai clic con il pulsante destro del mouse sul ruolo che utilizzerai come whitelist (ad esempio, Inserito nella lista bianca) → Copia ID ruolo.
• (Facoltativo) Copia gli ID per tutti i ruoli che desideri lista nera (per esempio, Vietato).

Tieni a portata di mano:

• ID_GUILDA = 123456789012345678
• WHITELIST_ROLE_IDS = ["1111111111111111111", "22222222222222222"]
• BLACKLIST_ROLE_IDS = ["333333333333333333"]

---

Passaggio 3: scarica e installa la risorsa

1. Scaricamento il codice postale da FAX/DiscordWhitelist (GitHub).
2. Estrai sul tuo server all'indirizzo:
   risorse/[discord]/DiscordWhitelist
3. Verificare che la cartella contenga almeno:
   • fxmanifest.lua
   • server.js
   • pacchetto.json

server.cfg (o txAdmin Ricetta / Avvio):

# Inizia dopo i tuoi provider di identificatori e prima della logica di join che dipende da esso, assicurati che DiscordWhitelist

In txAdmin → Risorse, segno DiscordWhitelist per avviarsi all'avvio (se si gestiscono le risorse tramite interfaccia utente).

Stai pianificando la tua strategia di accesso? Leggi la nostra guida più ampia: FiveM Whitelist — Guida completa (txAdmin, script, DB) per le alternative (ACE, DB, ibrido) e quando utilizzarle.

---

Passaggio 4: configurazione server.js

Aprire risorse/[discord]/DiscordWhitelist/server.js e imposta il blocco di configurazione. Il file potrebbe già esporre un semplice oggetto di configurazione: regola i valori di conseguenza. Una configurazione tipica è la seguente:

// Configurazione DiscordWhitelist — esempio const config = { botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE", guildId: "123456789012345678", // ID del tuo server (gilda) // I giocatori devono avere almeno UNO di questi ID ruolo per unirsi alla whitelistRoles: [ "111111111111111111", // Inserito nella whitelist // "222222222222222222", // Staff (facoltativo) ], // Se un giocatore ha UNO di questi ruoli, rifiuta la connessione blacklistRoles: [ // "33333333333333333", // Banned ], // Memorizza nella cache i dati dei ruoli recuperati per ridurre le chiamate API di Discord (secondi) cacheMaxTime: 90, // Messaggi di rinvio messages: { noDiscord: "Apri Discord e rientra. La tua app Discord deve essere in esecuzione.", notWhitelisted: "Non sei nella whitelist. Unisciti al nostro Discord: discord.gg/yourinvite", blacklisted: "Accesso negato. Contatta lo staff.", welcome: "Benvenuto, sei stato verificato. Caricamento in corso…" }, };

Suggerimento per la monetizzazione: Se il tuo server utilizza vantaggi, abbinalo a Livelli di donazione Discord per automatizzare i vantaggi basati sui ruoli per i sostenitori/donatori.

Salva il file.

---

Passaggio 5: riavvia e testa

1. Ricomincia solo la risorsa o l'intero server: txAdmin → Riavvia la risorsa o console aggiornare Poi riavvia DiscordWhitelist.
2. Test negativo: Prova a connetterti senza ruolo whitelist → dovresti vedere il messaggio di rinvio ed essere espulso.
3. Test positivo: Concediti il ruolo di whitelist → riconnettiti → dovresti essere autorizzato ad entrare.

---

Facoltativo: ruoli multipli e bypass del personale

• Aggiungere diversi ruoli nella whitelist per consentire più imbuti (ad esempio, Donatore, Polizia Stradale, Servizio di emergenza medica).
• Aggiungere ruoli nella lista nera per blocchi rigidi indipendentemente dalla whitelist (ad esempio, Vietato).
• Puoi includere un ruolo del personale In ruoli nella whitelist per garantire l'accesso agli amministratori.

---

Suggerimenti operativi

• Automazione: Collega l'assegnazione del ruolo Discord al tuo moduli di domanda O approvazioni dei biglietti (ad esempio, con un bot, Google Forms → webhook → aggiunta ruolo).
• UX del lettore: Aggiungi un pin 1TP13Come aggiungere alla whitelist Pubblica con ✅ requisiti di ruolo e il tuo invito al server.
• Moderazione: Registra le modifiche di ruolo in un privato #mod-logs canale.

---

Risoluzione dei problemi

"Bot offline" o non aggiorna mai i ruoli

• Token errato o bot non invitato alla gilda corretta.
• Intento dei membri del server non abilitato.
• Il firewall blocca l'HTTPS in uscita dal tuo host di gioco (consente l'API Discord).

"Nessun identificatore Discord trovato" / tutti bloccati

• I giocatori devono eseguire il Applicazione desktop Discord Prima di avviare FiveM, chiedi loro di riavviare Discord e poi FiveM.

Le modifiche al ruolo si applicano solo dopo un riavvio

• Ridurre cacheMaxTime a 30–60 secondi.
• Se imposti un valore molto basso e continui a riscontrare ritardi, controlla i limiti di velocità ed evita di riavviare frequentemente.

Errore 403/Permessi durante il recupero dei membri della gilda

• Assicurati che il bot sia nella gilda di destinazione E L'intento dei membri del server è abilitato.
• Il bot fa non sono necessari permessi di amministratore per leggere i ruoli dei membri.

Elevato utilizzo dell'API/limitazione della velocità

• Aumento cacheMaxTimeEvita espulsioni/riavvii di massa che invadono le chiamate API.

---

Migliori pratiche di sicurezza

• Conservare il Token del bot Al di fuori del controllo di versione. Se si ospitano autonomamente le configurazioni, si consiglia di leggerle da una variabile d'ambiente o da una convar server.cfg, non in testo normale inviato a Git.
• Ruotare il token se trapelato.
• Limita chi ha accesso in scrittura alla risorsa.

---

Disinstalla / Disabilita

• Rimuovere assicurati DiscordWhitelist da server.cfg (o disattivarlo in txAdmin → Risorse).
• Rimuovi la cartella da risorse/ se lo stai dismettendo.

---

Domande frequenti

I giocatori hanno bisogno che Discord sia attivo?
Sì. Senza il discordia: identificatore, lo script non può verificare i ruoli.

Di quali intenti ho bisogno?
Soltanto Intento dei membri del server.

Posso utilizzare più ruoli whitelist?
Sì. L'accesso è concesso se l'utente ha Qualunque dei ruoli elencati.

Posso negare categoricamente determinati ruoli?
Sì. Aggiungili a ruoli nella lista nera.

Ha smesso di funzionare dopo che ho cambiato ruolo.
Inferiore cacheMaxTime, quindi esegui nuovamente il test. Assicurati che il bot sia online con il token e la gilda corretti.

Esiste una versione mantenuta?
Sì. Esiste un'edizione commerciale, mantenuta attivamente, se hai bisogno di aggiornamenti/supporto.

---

Appendice — Esempio server.cfg

# Discord whitelist assicura DiscordWhitelist # (Facoltativo) inserisci qui le risorse Discord correlate come blocco # assicura discord_perms # assicura discordrolesync

Appendice — Esempio di messaggio al giocatore (rinvii)

Mantieni i messaggi brevi e concreti:

messages: { noDiscord: "Apri Discord e rientra. La tua app Discord deve essere in esecuzione.", notWhitelisted: "Non inserito nella whitelist. Fai domanda in #how-to-whitelist → discord.gg/yourinvite", blacklisted: "Accesso negato. Contatta lo staff tramite ticket.", welcome: "Verificato — caricamento città…" }

---

Changelog (rivolto all'editor)

• v1.1 — Aggiunti link interni naturali ai livelli di donazione, alla guida completa alla whitelist di FiveM e al download di GitHub.
• v1.0 — Guida iniziale: creazione del bot, intenti, ID, installazione, configurazione, test, FAQ.