Een openbare FiveM server kan snel vollopen met spelers die de sfeer verstoren. Een whitelist houdt je community beheersbaar, terwijl een priority queue ervoor zorgt dat je vaste kern niet hoeft te wachten wanneer de server vol zit. Beide systemen zijn onmisbaar voor serieuze roleplay-servers. Hier lees je hoe je ze instelt.
Waarom een whitelist?
Zonder whitelist kan iedereen met FiveM je server betreden. Dat klinkt goed voor de groei, maar op een roleplay-server leidt het al snel tot problemen. Random spelers die niet weten hoe roleplay werkt, trolls die bewust de boel verstoren en een moderatieteam dat het niet meer bijhoudt. Een whitelist filtert aan de voordeur: alleen goedgekeurde spelers komen binnen.
De meeste serieuze RP-communities vragen potentiele spelers om een sollicitatie in te vullen. Vragen over roleplay-ervaring, karakterachtergrond en beschikbaarheid helpen je inschatten of iemand bij de server past. Pas na goedkeuring wordt de speler op de whitelist geplaatst.
Handmatige whitelist via server.cfg
De eenvoudigste whitelist werkt met Steam Hex-identifiers. In je server.cfg schakel je de whitelist in:
set sv_whitelist_enabled true
Vervolgens voeg je spelers toe via de server console met add_ace identifier.steam:hexwaarde group.user allow. Dit is werkbaar voor kleine servers met tien tot twintig spelers, maar wordt onpraktisch zodra je community groeit.
Whitelist via een resource
Voor grotere servers gebruik je een whitelist-resource die identifiers opslaat in een database. Populaire opties zijn:
- EasyAdmin: combineert whitelist met banlijst en moderatietools. Spelers beheer je via een in-game menu of via Discord-commando's.
- vMenu whitelist: als je vMenu al gebruikt kun je de ingebouwde whitelist-functionaliteit activeren per submenu.
- Custom Lua-script: een simpel script dat bij het verbinden de speler-identifier vergelijkt met een MySQL-tabel. Staat het ID er niet in, dan wordt de verbinding geweigerd met een nette foutmelding.
Het voordeel van een database-oplossing is dat je whitelist-aanvragen kunt automatiseren. Een Discord-bot accepteert sollicitaties en na goedkeuring door een stafflid wordt de identifier automatisch aan de database toegevoegd.
Discord-verificatie als whitelist
Veel FiveM-servers koppelen hun whitelist aan Discord. De speler moet lid zijn van de Discord-server en een bepaalde rol hebben om te kunnen verbinden. Resources zoals Badger_Discord_API of Discord Perms controleren bij het verbinden of de speler de juiste Discord-rol bezit. Geen rol, geen toegang.
Dit systeem is bijzonder effectief in combinatie met een sollicitatieproces. Nieuwe leden dienen een sollicitatie in via een Discord-formulier. Na goedkeuring krijgen ze automatisch de whitelist-rol. Het scheelt handmatig beheer en de koppeling blijft altijd actueel: verlaat iemand de Discord, dan verliest diegene automatisch toegang tot de server.
Priority queue instellen
Als je server regelmatig vol zit (bijvoorbeeld 64 van de 64 slots), wil je dat je vaste spelers, donateurs en staffleden niet in dezelfde wachtrij staan als nieuwe leden. Een priority queue regelt dat.
Het principe is eenvoudig: elke speler krijgt een prioriteitswaarde. Hoe lager het getal, hoe eerder je aan de beurt bent. Staff krijgt prioriteit 1, donateurs prioriteit 10 en reguliere spelers prioriteit 100. Bij een volle server schuiven spelers met hogere prioriteit naar voren in de wachtrij.
Veelgebruikte priority-systemen
De volgende resources bieden priority queue-functionaliteit:
- txAdmin priority: als je txAdmin gebruikt (de standaard FiveM-serverbeheerder) kun je via de configuratie prioriteitslijsten instellen op basis van identifiers.
- Adaptive Card queue: toont een visuele wachtrij aan de speler met positie en geschatte wachttijd, terwijl het prioriteiten afhandelt op de achtergrond.
- Custom priority via MySQL: sla prioriteitswaarden op in dezelfde database als je whitelist. Een enkel Lua-script leest bij het verbinden de prioriteit uit en plaatst de speler in de juiste positie van de wachtrij.
Priority koppelen aan Discord-rollen
De slimste aanpak combineert priority met Discord-rollen. Definieer in je resource welke Discord-rollen welke prioriteit krijgen. Bijvoorbeeld: de rol "VIP" geeft prioriteit 10, "Booster" geeft prioriteit 20 en leden zonder speciale rol krijgen de standaardprioriteit. Zo hoef je geen individuele identifiers te beheren en verandert de prioriteit automatisch mee wanneer iemand een rol krijgt of verliest.
Slots reserveren
Een alternatief voor een priority queue is het reserveren van slots. Stel je maximale spelers in op 64, maar reserveer 4 slots voor staff. Reguliere spelers kunnen maximaal slot 60 vullen; de laatste vier zijn exclusief voor staffleden. Verschillende resources ondersteunen dit via een sv_reserved_slots-instelling of een eigen configuratieoptie.
Tips voor een soepele wachtervaring
- Toon de wachtrijpositie en een geschatte tijd aan de wachtende speler. Niets is frustrerender dan een leeg laadscherm zonder informatie.
- Stel een AFK-kick in zodat inactieve spelers na een bepaalde tijd automatisch worden verwijderd. Dat maakt ruimte voor wachtenden.
- Communiceer transparant over je priority-systeem. Spelers accepteren een wachtrij beter als ze weten hoe het werkt.
Kan ik een whitelist combineren met een priority queue?
Absoluut, en dat is de aanbevolen aanpak voor serieuze RP-servers. De whitelist bepaalt wie mag verbinden; de priority queue bepaalt de volgorde wanneer de server vol zit. Beide systemen vullen elkaar aan zonder te conflicteren.
Hoeveel slots moet ik instellen op mijn FiveM server?
Dat hangt af van je hardware en het type server. Een roleplay-server met zware scripts draait comfortabel op 48 tot 64 spelers. Een deathmatch- of racingserver kan vaak meer aan omdat de scripts lichter zijn. Begin conservatief en verhoog het aantal slots als de prestaties het toelaten.
Wat gebeurt er als ik de whitelist uitzet?
Dan kan iedereen met FiveM je server betreden, mits er een vrij slot is. Alle eerder ingestelde whitelist-data blijft bewaard in je database, dus je kunt de whitelist later weer activeren zonder opnieuw te beginnen.
Op zoek naar een stabiele FiveM server waar je dit direct kunt instellen? Bekijk onze FiveM hosting met txAdmin, volledige toegang en snelle support.
