Come connettere txAdmin a Discord (Guida 2025)

Obiettivo: Abilita l'integrazione nativa di Discord di txAdmin per gli incorporamenti di stato e (facoltativo) l'inserimento nella whitelist supportata da Discord.

Funziona con qualsiasi build FXServer che include txAdminNon è richiesto alcun hosting di terze parti o framework bot.

---

Prerequisiti

• Un server FiveM in esecuzione con txAdmin abilitato (Impostazioni → Globali mostra che il pannello è attivo).
• Autorizzazione a creare un'applicazione Discord nel tuo Portale per sviluppatori Discord.
• Modalità sviluppatore abilitato nelle impostazioni utente di Discord (in modo da poter copiare gli ID del server/canale/ruolo).
• IL ID gilda (server) e (facoltativamente) un ID canale dove il bot è autorizzato a postare.

---

Passaggio 1: creare l'applicazione Discord e il bot

1. Aprire il Portale per sviluppatori Discord e clicca Nuova applicazione.
2. All'interno dell'applicazione, vai a Bot → Reimposta token e copia il Token del botMantienilo segreto.
3. Sullo stesso Bot pagina, abilita INTENTO DEI MEMBRI DEL SERVER. Salva.

Suggerimento: non sono necessari gli intenti Presenza o Contenuto messaggio per le funzionalità integrate di txAdmin.

---

Passaggio 2: invita il bot sul tuo server Discord

1. Nel Portale Sviluppatori, apri OAuth2 → Generatore di URL.
2. Ambiti: seleziona robot E applicazioni.comandi (comandi barra).
3. Permessi: seleziona Visualizza canali, Invia messaggi, Incorpora link, Leggi la cronologia dei messaggi.
4. Utilizza l'URL generato per invitare il bot sul tuo server Discord.

Mantieni i permessi minimi. Il bot deve solo leggere/pubblicare e incorporare.

---

Passaggio 3: collegare il bot a txAdmin

1. Apri il tuo txAdmin pannello web.
2. Vai a Impostazioni → Discord.
3. Attiva/disattiva Abilita il bot Discord.
4. Compila i campi:
   • Token del bot: incollare il token dal passaggio 1.
   • ID gilda: il tuo ID del server Discord (clicca con il tasto destro sull'icona del server → Copia ID).
   • ID canale annunci (facoltativo): un ID canale in cui txAdmin può pubblicare avvisi di stato/riavvio.
5. Salva.

Aggiungi lo stato live incorporato

• Nel canale Discord che hai scelto, digita: /stato aggiungi
• txAdmin pubblicherà un incorporamento persistente che si aggiorna automaticamente con le informazioni del server.

Personalizza lo stato incorporato (facoltativo)

• In txAdmin → Impostazioni → Discord, aprire Cambia Incorpora JSON per modificare titolo, descrizione, campi, miniature, pulsanti/link, ecc.

---

Passaggio 4 — (Facoltativo) Whitelist supportata da Discord in txAdmin

È possibile limitare l'accesso al server tramite l'appartenenza o il ruolo a Discord.

1. In txAdmin, vai a Impostazioni → Gestione giocatori.
2. Modalità whitelist: scegli uno tra:
   • Membro di Discord – chiunque nel tuo Discord può partecipare.
   • Ruolo di Discord – possono partecipare solo i membri con ID ruolo specificati.
3. Se si utilizza Ruolo di Discord, raccogliere gli ID dei ruoli (Impostazioni server → Ruoli → fare clic con il pulsante destro del mouse sul ruolo → Copia ID).
4. Aggiungere gli ID dei ruoli alle impostazioni della whitelist. Salva.

Approva/Gestisci richieste:

• Vai a Gestione giocatori → Lista bianca per esaminare richieste e approvazioni.

Per un maggiore controllo, preferisci la whitelist basata sui ruoli. Aggiorna di conseguenza il flusso di lavoro di assegnazione dei ruoli su Discord.

---

Risoluzione dei problemi

• Il salvataggio delle impostazioni di Discord scade → Garantire INTENTO DEI MEMBRI DEL SERVER è abilitato per il tuo bot nel Portale Sviluppatori Discord.
• I comandi slash (/status, /info) non vengono visualizzati → Invita nuovamente il bot con applicazioni.comandi ambito; assicurati che possa vedere il canale.
• Lo stato non viene pubblicato/aggiornato → Verifica i permessi del canale: il bot ha bisogno Visualizza canale, Invia messaggi, Incorpora link, Leggi la cronologia dei messaggi.
• Nessun messaggio da txAdmin → Ricontrolla il ID gilda/ID canale valori e che la modalità sviluppatore sia abilitata quando si copiano gli ID.
• Rumore nel canale degli annunci → Lasciare ID canale annunci vuoto in Impostazioni → Discord (txAdmin non pubblicherà automaticamente gli annunci).

---

Note di sicurezza

• Trattare il Token del bot come una password. Ruotalo se esposto.
• Evitare di concedere autorizzazioni di amministratore o non necessarie.
• Se possibile, limitare il bot a un singolo canale di pubblicazione.

---

Guide e risorse correlate

• txAdmin (sito ufficiale): https://txadmin.gg/
• Come impostare una whitelist Discord per il tuo server FiveM (FAXES/DiscordWhitelist) — fivemx.com: https://fivemx.com/discord-whitelist-fivem/
• Strumento di amministrazione ESX/Gestione lettori con integrazione Discord (prodotto) — fivemx.com: https://fivemx.com/esx-admin-tool-player-manager-discord-integration/

---

Lista di controllo rapida (copia/incolla)

• Bot creato; INTENTO DEI MEMBRI DEL SERVER abilitato
• Bot invitato con bot + applicazioni.comandi ambiti
• Permessi: Visualizza, Invia, Incorpora, Leggi cronologia
• Token del bot + ID della gilda (e facoltativo ID canale) salvato in txAdmin
• /stato aggiungi eseguito nel canale di destinazione
• (Opzionale) Modalità Whitelist impostato su Membro/Ruolo Discord; ID ruolo salvati

Lista di controllo pratica

Utilizzate questa guida come checklist di preparazione prima di apportare modifiche a un server FiveM in produzione. Verificate la versione corrente dell'artefatto del server, la versione del framework, le dipendenze delle risorse, le modifiche al database e tutti i file lato client prima di applicare la modifica.

• Eseguire il backup dei file di configurazione e delle tabelle del database interessati.
• Applica la modifica prima su un server di test.
• Monitorare la console del server e la console F8 del client per rilevare eventuali errori.
• Verifica se la modifica influisce su lavori, inventario, veicoli, mappe, voce, permessi o dati dei giocatori.
• Documenta esattamente il file, il comando o l'impostazione che hai modificato, in modo da poterli ripristinare rapidamente.

Test prima della produzione

Dopo il primo test, accedi con un account giocatore normale e ripeti il flusso dal punto di vista del giocatore. Se l'argomento riguarda le prestazioni, misura prima e dopo con lo stesso numero di giocatori, percorso e set di risorse. Se riguarda strumenti di amministrazione o autorizzazioni, verifica sia gli utenti autorizzati che quelli a cui è negato l'accesso.

Errori comuni

La maggior parte dei problemi con FiveM deriva da dipendenze mancanti, cache obsoleta, nomi di cartelle errati, incompatibilità del framework o configurazione copiata da un altro server. Evita di modificare più sistemi contemporaneamente; apporta una modifica, testala e poi continua.

Risorse correlate

Per le risorse pronte per la produzione, confronta le risorse a pagamento nel Negozio FiveMX. Per risorse gratuite, sfoglia script gratuiti FiveM e testare ogni risorsa prima di utilizzarla pubblicamente.

Note di avvio della produzione

Before using this guidance on a live FiveM server, define the exact outcome you expect from the change. For How to Connect txAdmin to Discord (2025 Guide), that means checking which resource, setting, command, or workflow is affected and confirming that the change fits your current framework, artifact version, and server rules. Keep the rollout small enough that you can reverse it quickly if players report errors.

Utilizza un server di staging con lo stesso framework, schema del database, ordine delle risorse e dipendenze chiave dell'ambiente di produzione. Se la modifica riguarda il gameplay, i permessi, la grafica, le voci, i veicoli, le mappe, l'inventario o il comportamento dell'economia, esegui dei test con almeno un account amministratore e un account giocatore normale. Monitora l'output della console del server, i log F8 del client e i tempi di utilizzo delle risorse, ripetendo esattamente il flusso di gioco che si verificherà sul server di produzione.

Lista di controllo per il rollback

• Prima di apportare qualsiasi modifica, salva il file di configurazione precedente, la cartella delle risorse e lo stato del database.
• Annota la versione della risorsa, il commit, la pagina di download o il valore dell'impostazione che hai testato.
• Se possibile, riavvia prima solo la risorsa interessata, poi riavvia l'intero server se le dipendenze lo richiedono.
• Se si verificano errori, ripristinare la singola risorsa o impostazione modificata prima di provare un'altra soluzione.

Guida alla manutenzione

Rivedete questa configurazione dopo gli aggiornamenti degli artefatti FiveM, gli aggiornamenti del framework o le modifiche sostanziali alle risorse. Una configurazione che funziona oggi potrebbe smettere di funzionare dopo gli aggiornamenti delle dipendenze, la ridenominazione delle esportazioni, la modifica degli eventi o le migrazioni del database. Conservate le note insieme alla documentazione del server in modo che i futuri amministratori possano comprendere cosa è stato modificato, perché è stato modificato e come verificarlo nuovamente.

Revisione in corso

Recheck How to Connect txAdmin to Discord (2025 Guide) after major FiveM artifact updates, framework changes, or resource migrations. Confirm that the advice still matches current server behavior, that any linked source remains available, and that installation steps still match the files a server owner will actually download or configure.

Per i server pubblici, tenete un breve registro delle modifiche accanto alla documentazione del server. Annotate cosa è stato testato, cosa è cambiato, quali account sono stati utilizzati per la verifica e come ripristinare la versione precedente. Questo velocizza la manutenzione futura ed evita che le vecchie note di configurazione diventino poco chiare o pericolose per i giocatori.