Een Discord bot voor een FiveM server: wat de koppeling je echt oplevert

Bijna elke FiveM server heeft een Discord server ernaast. Meestal staan die twee los van elkaar naast elkaar: rollen worden in Discord uitgedeeld en daarna nog eens met de hand in de game, iemand houdt de whitelist bij in een tekstbestand, en een servercommando uitvoeren betekent toegang hebben tot het serverpanel.

De twee koppelen lost precies deze drie dingen op. Wat het niet oplost, staat verderop.

Wat je eerst nodig hebt

De koppeling loopt via een script op je FiveM server plus een geheime sleutel waarmee het script zich bij ons identificeert. Zonder die twee gebeurt er niets, ook niet bij de functies waar je het niet zou verwachten, zoals de meldingen in de game.

Eén ding is bij het genereren van de sleutel echt belangrijk: je ziet hem precies één keer. Kopieer hem meteen naar config.lua. Sluit je het venster, dan moet je een nieuwe genereren en die invullen, wat onschuldig is als je het weet en vervelend als je er tien minuten naar zoekt.

De volledige stap voor stap installatie staat in de documentatie van FiveM.

Rollen synchroniseren

De functie waarvoor de meeste mensen beginnen. Je maakt koppelingen aan, telkens een Discord rol aan een FiveM groep, en bij het verbinden krijgt de speler de bijbehorende groep. Wie nergens bij past, komt in user terecht.

Eén detail beslist hier tussen succes en verwarring: de koppelingen worden van boven naar beneden gecontroleerd, en de eerste treffer wint. Je beheerder heeft vrijwel zeker ook de supporterrol. Staat supporter hoger, dan is je beheerder in de game een supporter, en het zoeken naar de fout duurt precies zo lang als het duurt voordat iemand naar de volgorde kijkt.

Dus: hoogste rol bovenaan, en test daarna één keer met een account dat meerdere rollen heeft. Niet je eigen account, dat van jou heeft alles.

Whitelist

In plaats van een bijgehouden lijst met identifiers beslist de Discord rol wie mag verbinden. Voor roleplayservers met een aanmeldprocedure is dat de echte winst: wie wordt aangenomen, krijgt een rol, en dat was de hele procedure.

Het deel waarop de meeste mensen beknibbelen, is de afwijzingsmelding. Die verschijnt in het verbindingsvenster, en het is vaak het enige wat een afgewezen speler ooit van je server leest. "You are not whitelisted" is een doodlopende weg. Schrijf waar je je kunt aanmelden, het liefst met een link. Dat kost één keer twee minuten en bespaart je team dezelfde vraag in een ticket.

RCON vanuit Discord

Met /fivemrcon kan je team servercommando's direct vanuit Discord uitvoeren, zonder toegang tot het serverpanel.

Dit is de functie waarbij ik het meest zou aanraden om eerst na te denken voordat je hem aanzet. RCON is volledige toegang tot servercommando's. Twee dingen zijn daarom geen opties maar vereisten:

• Sta alleen groepen toe die je echt vertrouwt. Niet "het hele team", maar de groepen die de toegang toch al zouden hebben.
• Stel een logkanaal in. Elk uitgevoerd commando komt daar terecht. Zonder logkanaal heb je een manier gemaakt om je server te besturen waarbij niemand achteraf kan nagaan wie wat heeft gedaan.

Twijfel je bij een van beide vragen, laat RCON dan uit. De andere functies werken er los van.

De twee kleine extra's

Giveaways in de game. Als er in Discord een giveaway start, zien spelers een minuut lang een interface om mee te doen, en ook de winnaars worden in de game getoond. Handig, omdat het precies de mensen bereikt die aan het spelen zijn en daardoor niet naar Discord kijken.

Supportmelding in de game. Als iemand een spraakkanaal voor support binnenkomt, krijgt het team met de bijbehorende rol een melding in de game. De cooldown daar is niet als optioneel bedoeld: zonder cooldown wordt een speler die twee keer achter elkaar van kanaal wisselt een reeks meldingen.

Wat de koppeling niet is

Ze vervangt geen adminsysteem, geen economiebeheer en geen spelersdatabase. Ze verbindt identiteiten en machtigingen tussen twee systemen die anders apart bijgehouden moeten worden, en maakt een paar Discord gebeurtenissen zichtbaar in de game. Niet meer, en dat is bewust.

Begin je net, dan is dit de volgorde die zich heeft bewezen: eerst de rolsynchronisatie instellen en met een testaccount controleren, daarna de whitelist als je die nodig hebt, en RCON als laatste, als je het al gebruikt.