Sistema Whitelist di ADN

Sistema di Whitelist di ADN – Controllo Accessi Avanzato per Server FiveM

Il Whitelist System di ADN fornisce una gestione completa dell'accesso al server che va ben oltre il semplice controllo dei ruoli Discord. Questa soluzione di whitelisting di livello enterprise ti offre un controllo granulare su chi può unirsi al tuo server, a quali lavori possono accedere, quali funzionalità possono utilizzare e come le loro autorizzazioni evolvono man mano che progrediscono nella tua community. Sia che tu gestisca un piccolo server privato per amici o una community di roleplay con whitelist di oltre 200 giocatori, questo sistema scala per soddisfare le tue esigenze di controllo degli accessi pur rimanendo semplice da configurare e gestire.

What separates this from basic whitelist scripts is the depth of integration and flexibility. Instead of just “whitelisted” or “not whitelisted,” you can create tiered access levels, role-based lavoro permessi, sblocchi di funzionalità a tempo, automazione del flusso di lavoro delle applicazioni e persino concessioni di accesso temporaneo per periodi di prova. Il sistema si collega a Discord per l'autenticazione, si integra con il tuo database per la persistenza e fornisce strumenti di gestione sia in-game che esterni in modo da poter controllare l'accesso da qualsiasi luogo. È l'infrastruttura completa di gestione degli accessi di cui le comunità di roleplay serie hanno bisogno.

Cosa è incluso

Ricevi il sistema completo di whitelist con integrazione bot Discord, schema del database, controllo delle autorizzazioni lato server, componenti UI lato client, pannello di gestione amministrativa e file di configurazione estesi. Il pacchetto include flussi di lavoro di revisione delle applicazioni predefiniti, sincronizzazione automatica dei ruoli, strutture di autorizzazioni multi-livello e sistemi di registrazione che tracciano tutte le modifiche di accesso a scopo di audit. Tutto è costruito su principi di autenticazione sicura con crittografia, misure anti-spoofing e logica di fail-safe che espelle i giocatori se la verifica fallisce piuttosto che consentire l'accesso non autorizzato.

Funzionalità principali della Whitelist

• Integrazione Discord – Autenticazione automatica tramite Discord con sincronizzazione dei ruoli, garantendo che solo i membri approvati della community possano unirsi al tuo server
• Livelli di accesso multi-livello – Crea livelli di permessi illimitati (visitatore, civile, fidato, VIP, staff, ecc.) con diverse capacità per ogni livello
• Whitelist basata sui lavori – Control access to specific jobs and factions (Polizia Stradale, EMS, gang, attività commerciali) con flussi di lavoro di approvazione separati
• Sistema di Candidatura – Moduli di candidatura integrati con domande personalizzate, assegnazione dei revisori, flussi di approvazione/rifiuto e sistemi di notifica
• Accesso Temporaneo – Concedi uno stato di whitelist a tempo limitato per membri di prova, eventi speciali o periodi di prova con scadenza automatica
• Aggiornamenti Dinamici dei Permessi – Le modifiche ai ruoli Discord o allo stato della whitelist si applicano istantaneamente senza richiedere la riconnessione del giocatore
• Integrazione Priorità Coda – Compatibile con sistemi di coda di connessione per dare priorità ai giocatori in whitelist nell'accesso al server
• Autenticazione di Backup – Metodi di autenticazione di fallback garantiscono l'affidabilità del sistema anche se Discord API ha problemi

Capacità di Gestione Avanzata

• Pannello di amministrazione basato sul Web – Gestisci whitelist, revisiona candidature, regola permessi e visualizza log da qualsiasi dispositivo con un browser web
• Comandi Admin in gioco – Lo staff del server può concedere/revocare lo stato di whitelist, controllare i permessi dei giocatori e rivedere i log di accesso senza lasciare il gioco
• Strumenti di Gestione Massiva – Aggiungi o rimuovi grandi gruppi di giocatori contemporaneamente, utile per il reclutamento di fazioni o l'eliminazione di account inattivi
• Sincronizzazione automatica dei ruoli – Le modifiche ai ruoli Discord aggiornano automaticamente i permessi in gioco in base alle tue regole di mappatura configurate
• Registrazione di Audit – Log completi di chi ha aggiunto chi alla whitelist, quando e per quali ruoli, con cronologia ricercabile e funzionalità di esportazione
• Sistemi di notifica – Messaggi automatizzati Discord per aggiornamenti sullo stato delle applicazioni, concessioni, scadenze e revoche della whitelist
• Campi personalizzati – Aggiungi la raccolta di dati specifici del server alle richieste di whitelist (background dei personaggi, esperienza RP precedente, ecc.)
• Processo di appello – Sistema integrato per i candidati rifiutati per appellarsi alle decisioni con code di revisione separate

Come funziona

Quando un giocatore tenta di unirsi al tuo server, il sistema intercetta la connessione e avvia l'autenticazione. Controlla il loro account Discord rispetto all'elenco dei membri del tuo server e verifica che abbiano i ruoli richiesti per l'accesso base al server. Se superano questo primo controllo, il sistema interroga il database per il loro stato di whitelist specifico – per quali lavori sono approvati, quale livello di permesso detengono e se si applicano restrizioni temporanee. Tutto questo avviene in millisecondi durante la normale stretta di mano della connessione.

Una volta in gioco, il sistema di whitelist monitora continuamente i permessi dei giocatori. Se un membro dello staff rimuove la whitelist della polizia di qualcuno tramite il pannello di amministrazione, tale modifica si propaga immediatamente e il giocatore perde l'accesso alle funzioni lavorative della polizia in tempo reale. Se qualcuno fa domanda per un lavoro e viene approvato, riceve una notifica Discord e può accedere immediatamente al ruolo appena concesso senza riconnettersi. Questo sistema di permessi live elimina il problema del “riavvia per aggiornare i permessi” che affligge gli script di whitelist più semplici.

Flusso di Lavoro della Candidatura

I giocatori inviano le candidature per la whitelist tramite comandi Discord, un portale web o UI in gioco a seconda della configurazione. Le candidature vengono instradate ai revisori designati in base a ciò che viene richiesto: le candidature per la whitelist civile vanno allo staff generale, le candidature per la polizia vengono instradate al comando PD, le candidature per le attività commerciali vanno agli amministratori delle attività, ecc. I revisori vedono tutte le informazioni inviate, possono richiedere dettagli aggiuntivi, controllare la cronologia del giocatore e approvare/rifiutare con messaggi personalizzabili.

Il sistema tiene traccia della cronologia delle candidature, mostrando quante volte qualcuno ha fatto domanda, i motivi dei rifiuti precedenti e le note del revisore. Ciò impedisce che lo stesso candidato problematico faccia domanda ripetutamente in diversi turni dello staff. Le candidature approvate aggiornano automaticamente il database, assegnano ruoli Discord, inviano messaggi di conferma e registrano la transazione a scopo di audit.

Installazione

1. Configura il bot Discord utilizzando il token del bot fornito e configurarlo con il tuo ID server Discord e gli ID dei ruoli
2. Importa lo schema del database nel tuo database MySQL del server utilizzando il file SQL fornito
3. Configura il principale config.lua file con le tue impostazioni Discord, credenziali del database e livelli di permesso
4. Configura il pannello web (opzionale) sul tuo server web con i file PHP/Node.js inclusi
5. Aggiungi la risorsa al tuo server.cfg e riavvia il tuo server
6. Testa il sistema unendoti con un account Discord e verifica che l'autenticazione funzioni correttamente
7. Configura i tuoi primi livelli di permesso e le whitelist di lavoro nel pannello di amministrazione

Opzioni di configurazione

• Impostazioni Discord – Token del bot, ID del server, mappature dei ruoli, canali di notifica e configurazioni webhook
• Livelli di autorizzazione – Definisci nomi dei livelli, ruoli Discord richiesti, capacità in-game e livelli di priorità
• Regole di Whitelist per i Lavori – Configura quali lavori richiedono l'approvazione della whitelist rispetto all'accesso aperto, flussi di lavoro di approvazione e restrizioni
• Moduli di candidatura – Personalizza domande, campi obbligatori, limiti di caratteri e opzioni di allegato per diversi tipi di candidatura
• Metodi di autenticazione – Autenticazione Discord primaria più metodi di backup come identificatori di licenza o riconoscimento basato su IP
• Accesso Temporaneo – Imposta tempi di scadenza predefiniti, processi di rinnovo e procedure di rimozione automatizzata
• Integrazione Coda – Connettiti con risorse di coda popolari per dare ai giocatori con whitelist la priorità di connessione
• Preferenze di Notifica – Controlla quali eventi attivano i messaggi Discord, chi li riceve e il formato dei messaggi

Compatibilità del framework

• ESX Eredità – Integrazione completa con il sistema di lavoro ESX, la struttura del database e i framework di permessi
• ESX 1.9.x – Compatibile con le versioni precedenti di ESX con adattamento automatico dello schema del database
• QBCore – Supporto nativo per la gestione dei lavori QBCore, il controllo dei permessi e le strutture dei comandi
• QBOX – Funziona con l'architettura del framework QBOX e i sistemi di permessi
• Standalone – Può essere adattato per framework personalizzati con esportazioni e integrazione basata su eventi

Cosa lo fa risaltare

La maggior parte degli script di whitelist sono semplici sistemi “controlla se il ruolo Discord esiste” senza sfumature. Il Sistema di Whitelist di ADN fornisce un controllo degli accessi di livello enterprise che rivaleggia con le piattaforme commerciali di gestione dei server. La sola automazione del flusso di lavoro delle applicazioni fa risparmiare centinaia di ore di amministrazione sui server di grandi dimensioni – niente più tracciamento manuale di fogli di calcolo di candidati o copia-incolla di ID Discord in tabelle di database. Il sistema di permessi multi-livello consente un accesso graduale alla community piuttosto che un binario sì/no, creando percorsi di progressione che migliorano la fidelizzazione dei giocatori.

The live permission updates are game-changing for administration. Fire a cop for corruption? Remove their whitelist instantly and they lose badge access immediately. Promote a player to gang leadership? Grant elevated permissions in real-time. No more “relog to update” messages, no server restarts to apply changes. And the comprehensive logging means you always know who authorized what, when, and can trace any access issues back to their source.

Funzionalità di sicurezza

• Anti-Spoofing – Strati di verifica multipli impediscono ai giocatori di falsificare le identità Discord o di aggirare l'autenticazione
• Comunicazione crittografata – Dati sensibili trasmessi tra il server di gioco e Discord utilizzano canali crittografati
• Limitazione della velocità – Protezione contro applicazioni di spam o tentativi di autenticazione brute force
• Logica di Sicurezza – Se l'autenticazione non può essere verificata (Discord non disponibile, database irraggiungibile), i giocatori vengono negati piuttosto che ammessi
• Validazione della Sessione – La verifica continua durante il gioco impedisce il dirottamento della sessione o lo sfruttamento dei permessi a metà partita
• Tracciamento IP – Registrazione IP opzionale per analisi di sicurezza e rilevamento dell'evasione dei ban

Scenari di distribuzione comuni

I nuovi server iniziano con una whitelist civile di base che richiede solo l'appartenenza a Discord e una semplice applicazione. Man mano che la community cresce, vengono aggiunte whitelist di lavoro per polizia, EMS e aziende. I server consolidati utilizzano sistemi multi-livello con lo stato “fidato” che sblocca la proprietà immobiliare, lo stato “VIP” che offre priorità in coda e livelli “staff” che forniscono capacità di amministrazione. Le grandi community delegano l'approvazione della whitelist: i leader delle gang approvano i loro reclute, l'alto comando della polizia gestisce le candidature degli ufficiali, i proprietari delle aziende esaminano i dipendenti.

Esperienza del giocatore

Dal punto di vista del giocatore, il processo di candidatura è semplice: invia il modulo, attendi la revisione, ricevi la notifica di approvazione. L'integrazione Discord significa che utilizzano il loro account community esistente anziché crearne di separati per il gioco. I giocatori approvati apprezzano la priorità in coda e sanno che il requisito della whitelist filtra i giocatori problematici. La trasparenza del sistema (controllare il proprio stato di whitelist tramite comandi) riduce la confusione sul motivo per cui non è possibile accedere a determinati lavori.

Vantaggi Amministrativi

I proprietari dei server ottengono un controllo centralizzato sull'accesso alla community senza dover modificare manualmente le tabelle di database o riavviare i server per le modifiche ai permessi. Il sistema di applicazioni crea una traccia cartacea per tutte le concessioni di accesso – cruciale per risolvere le controversie su chi ha approvato giocatori problematici. La struttura a livelli consente livelli di fiducia graduali piuttosto che un accesso tutto o niente. E l'automazione riduce drasticamente il carico di lavoro dell'amministratore rispetto alla gestione manuale delle whitelist.

Possibilità di personalizzazione

Il design modulare del sistema supporta un'ampia personalizzazione. Aggiungi domande personalizzate specifiche per la lore del tuo server, integra con sistemi di creazione del personaggio per l'approvazione automatica della backstory, connettiti a sistemi di donazione per l'assegnazione automatica di whitelist VIP o crea livelli di permessi personalizzati per funzionalità specifiche del server. Il sistema di esportazione simile a API semplifica il controllo dello stato della whitelist da altre risorse.

Supporto e documentazione

ADNS Tech fornisce una documentazione completa che copre installazione, configurazione, scenari comuni e risoluzione dei problemi. Il supporto è disponibile per assistenza alla configurazione, domande sull'integrazione e risoluzione di problemi tecnici. Il sistema riceve aggiornamenti regolari per la compatibilità con FiveM, modifiche Discord API e miglioramenti della sicurezza. La community attiva Discord offre supporto tra pari e condivisione delle configurazioni.