Om txAdmin te verbinden met Discord, maak je een speciale Discord-applicatie en bot aan, nodig je deze uit op de juiste server met alleen de benodigde rechten, kopieer je de bot-token naar de Discord-instellingen van txAdmin, en configureer je statusberichten en op rollen gebaseerde toegang als aparte functies. Houd de token privé: deze authenticeert de bot en mag nooit verschijnen in screenshots, clientbestanden of een openbare repository.
Beoordeeld op 12 augustus 2026 tegen de officiële Cfx.re txAdmin documentatie, Discord's applicatie-instellingen En OAuth2 documentatie. Labels kunnen verschuiven tussen txAdmin-releases, dus gebruik de instellingen die worden weergegeven door je geïnstalleerde versie.
Scheid de vier bewegende delen
| Deel | Doel | Typische storing |
|---|---|---|
| Discord applicatie en bot | Identiteit gebruikt door txAdmin | Verkeerde applicatie, uitgeschakelde bot of opnieuw gegenereerde token |
| Serverstatus | Publiceert of werkt status bij in een gekozen kanaal | Verkeerd kanaal of ontbrekende permissies om te bekijken/verzenden/embedden |
| Rollen of whitelist | Mapt Discord lidmaatschap/rollen naar de geconfigureerde toegangsregel | Verkeerde server-/rol-ID, rolhiërarchie of vereiste voor ledenintentie |
| txAdmin permissies | Regelt wie de FiveM server mag beheren | Discord rol aangenomen om txAdmin rechten automatisch toe te kennen |
Debug deze niet als één functie. Bewijs eerst dat de bot online is, bewijs dan dat hij toegang heeft tot één kanaal, voeg dan statusgedrag toe, en test pas daarna optionele rol- of whitelist-logica.
Stap 1: maak een speciale Discord applicatie aan
- Open de Discord Developer Portal en maak een nieuwe applicatie aan voor deze server.
- Voeg een bot toe aan de applicatie.
- Geef het een duidelijke naam zodat het personeel Productie kan onderscheiden van staging.
- Genereer of reset de token alleen als je klaar bent om deze veilig op te slaan.
Een bot token is een geheim, geen applicatie ID of publieke sleutel. Als deze wordt blootgesteld, reset deze dan in Discord en update txAdmin onmiddellijk. Sla de vervanging alleen op in de server-side instelling die bedoeld is voor de token.
Stap 2: nodig de bot uit met minimale permissies
Gebruik de Discord’s OAuth2 installatiestroom voor de applicatie en selecteer de bot-scope die vereist is door de huidige setup. Begin met de kleinste kanaaltoestemmingen die de functie bevredigen: bekijk het geselecteerde kanaal, stuur berichten, embed links en lees berichtgeschiedenis waar statusupdates dit vereisen. Vermijd Administrator, tenzij de officiële integratie dit expliciet vereist en je hebt beoordeeld waarom.
Beperk de bot indien praktisch tot een speciaal status- of administratiekanaal. Nadat je hem hebt uitgenodigd, bevestig je dat hij verschijnt op de beoogde Discord server. Het offline zijn is verwacht totdat txAdmin succesvol inlogt met de token.
Stap 3: configureer de bot in txAdmin
Open txAdmin als een geautoriseerde beheerder en zoek de Discord integratie-instellingen in je geïnstalleerde release. Plak de token in het tokenveld zonder aanhalingstekens of extra witruimte. Selecteer de beoogde Discord server en kanaal met behulp van de invoer die txAdmin biedt. Sla op, herstart vervolgens alleen de component of server als de interface dit vraagt.
Als je de FiveM kant vanaf nul bouwt, gebruik dan eerst het FiveM server setup pad . Discord kan een ongezonde FXServer of een onbereikbare txAdmin instantie niet repareren.
Configureer statusberichten afzonderlijk
Schakel de statusfunctie in en selecteer een kanaal waar de bot kan posten. Begin met een gewone testupdate voordat je aangepaste tekst of embeds toevoegt. Bevestig dat het bericht verandert wanneer de FiveM server start, stopt of het aantal spelers verandert volgens het gedrag gedocumenteerd door je txAdmin versie.
Als de bot inlogt maar er verschijnt geen status, controleer dan de geselecteerde kanaal-ID en kanaalspecifieke overrides. Een serverbrede rol kan toestaan te verzenden, terwijl een kanaal override dit ontzegt. Inspecteer ook de console/log output van txAdmin voor de Discord API reactie in plaats van herhaaldelijk de token te regenereren.
Configureer rollen of whitelist-regels afzonderlijk
Op rollen gebaseerde toegang vereist de exacte Discord-server- en roldefinitie-identifiers die door de integratie worden verwacht. Schakel de ontwikkelaarsmodus van Discord in om ID's te kopiëren wanneer de huidige instelling daarom vraagt. Rollenamen zijn geen stabiele identifiers en twee rollen kunnen een vergelijkbare naam hebben.
Test met één account dat de vereiste rol heeft en één dat dat niet heeft. Verwijder en voeg de rol opnieuw toe, maak opnieuw verbinding en bevestig wanneer de integratie het lidmaatschap vernieuwt. Ga er niet van uit dat een Discord-rol automatisch txAdmin-beheerdersrechten verleent; het eigen permissiemodel van txAdmin blijft een aparte controle, tenzij de gedocumenteerde functie ze expliciet koppelt.
Bescherm de token en de permissiegrens
- Plak de token nooit in Discord-chat, een ondersteuningsticket dat zichtbaar is voor anderen of een client-side resource.
- Commit deze niet naar Git en bewaar deze niet in een openbare screenshot.
- Beperk de toegang tot zowel de Discord Developer Portal-applicatie als de txAdmin-instellingen.
- Reset de token na blootstelling of wanneer een beheerder met toegang vertrekt.
- Controleer periodiek de server- en kanaaltoestemmingen van de bot.
Probleemoplossingschecklist
| Symptoom | Controleren |
|---|---|
| Bot blijft offline | Token behoort toe aan de juiste bot, bevat geen spaties, is niet gereset en txAdmin logs tonen een inlogpoging |
| Bot is online maar kan niet posten | Geselecteerd kanaal, machtigingen voor bekijken/verzenden/embedden en kanaal-specifieke instellingen |
| Status wordt nooit bijgewerkt | Statusfunctie ingeschakeld, correct kanaal, txAdmin/FXServer status en integratielog |
| Rollid wordt geweigerd | Correcte server/rol ID, rol daadwerkelijk toegewezen, vernieuwen/herverbinden gedrag en eventuele vereiste ledenintenties |
| Ongeldige lid wordt geaccepteerd | Fallback toegangsregels, meerdere toegestane rollen en server-side permissieconfiguratie |
| Het stopte na een token reset | txAdmin heeft nog steeds de oude token; sla de nieuwe op en herstart zoals vereist |
Laatste verificatie
- Bot logt in na een schone herstart zonder tokenfouten.
- Statusberichten worden alleen in het beoogde kanaal geplaatst.
- De minimale botrol kan het bericht bijwerken zonder bredere serverprivileges.
- De toegestane testgebruiker slaagt voor de rol/whitelist regel.
- De niet-toegestane testgebruiker faalt voor dezelfde regel.
- Noch Discord toegang, noch een verborgen UI knop omzeilt txAdmin's eigen beheerdersrechten.
Zodra deze controles onafhankelijk slagen, is de integratie gemakkelijker te onderhouden: één botidentiteit, één beschermd geheim, nauwkeurig afgebakende kanaaltoegang en expliciete regels voor status, whitelist en administratie.
