Minecraft Server Whitelist instellen – alleen vrienden toestaan

Met een Minecraft-whitelist beperk je je server tot spelers die je expliciet hebt toegestaan. Dat is handig voor privé-survivalwerelden, bouwprojecten, events of communities waarbij je controle over toegang wilt houden. Drie punten zijn doorslaggevend: white-list=true, netjes beheerde spelersnamen en enforce-whitelist=true, zodat wijzigingen betrouwbaar worden toegepast.

Vereisten

Je hebt toegang nodig tot de serverconsole, OP-rechten in de game of toegang tot het bestand server.properties. Daarnaast moet je de exacte Minecraft-namen van de spelers kennen. Bij Java-accounts is de spelersnaam normaal gesproken genoeg. Als Bedrock-spelers via Geyser joinen, kan de naam afhankelijk van de Geyser-configuratie met een prefix verschijnen; in het voorbeeld wordt een punt gebruikt.

Als je de server op dit moment in de basis instelt, helpt de uitgebreide gids Minecraft Server huren en instellen – complete gids 2026. Voor extra co-op-setups met een vergelijkbaar toegangsprincipe vind je ook de Valheim Server huren en instellen – co-op-gids 2026.

Minecraft Whitelist instellen

Wat is de whitelist?

De whitelist is een toegangscontrole voor je server. Alleen spelers op de lijst kunnen joinen. Ze vervangt geen moderatie, maar voorkomt wel dat onbekende accounts zomaar via het serveradres joinen. Voor betaalde multi-game-hosting is dat extra praktisch, omdat je servertoegang, supportgevallen en operationele processen duidelijker kunt scheiden: wie niet op de lijst staat, komt er niet in.

Microsoft documenteert het bijbehorende Bedrock-commando als /allowlist; daar wordt /whitelist als alias genoemd en worden de acties add, remove, list, off, on en reload beschreven: Microsoft Learn over allowlist/whitelist. Voor Java-servers blijven de hieronder getoonde server.properties-regels en /whitelist-commando's de praktische basis.

Whitelist activeren

In server.properties:

white-list=true
enforce-whitelist=true

Nu je toch in server.properties bent: de motd-regel bepaalt je serverlijstvermelding — je kunt die kleurrijk vormgeven met onze gratis MOTD-generator.

Of via een ingame-commando:

/whitelist on

Als je het bestand direct bewerkt, stop de server dan vooraf of herstart hem daarna. Wijzigingen via commando's zijn tijdens gebruik handiger, omdat je niet elke keer naar het bestand hoeft te gaan.

Spelers toevoegen

/whitelist add <Spielername>

Voor Bedrock-spelers (via Geyser):

/whitelist add .<BedRockName>

Let op de spelling. Als een speler niet kan joinen terwijl je hem hebt toegevoegd, vergelijk de naam dan met de weergave bij de loginpoging of in de serverlogs. Bij Geyser-setups is het vooral belangrijk of er een prefix wordt gebruikt en hoe hoofdletters en kleine letters worden behandeld.

Whitelist beheren

Gebruik /whitelist list na elke grotere wijziging. Zo zie je meteen typefouten of per ongeluk dubbel beheerde namen. Als je een speler verwijdert, is enforce-whitelist=true belangrijk, zodat de uitsluiting niet pas bij de volgende verbindingspoging relevant wordt.

whitelist.json

De whitelist wordt opgeslagen in whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "SpelerNaam"
  }
]

Bewerk dit bestand alleen als je weet wat je doet. Voor normaal gebruik zijn commando's veiliger, omdat de server namen en UUID's passend beheert. Als je het bestand handmatig wijzigt, gebruik daarna /whitelist reload of herstart de server.

Resultaat controleren

Controleer eerst met /whitelist list of alle gewenste spelers erin staan. Daarna zou een geregistreerde speler moeten kunnen joinen. Een account dat niet op de lijst staat, zou geweigerd moeten worden. Controleer daarnaast de serverconsole: daar zie je of de joinpoging mislukt door de whitelist, een verkeerde naam of een ander probleem.

Voor privéprojecten is een korte routine handig: speler toevoegen, join testen, lijst tonen, wijziging documenteren. Vooral bij meerdere admins voorkomt dat dat supportvragen later onduidelijk blijven.

Troubleshooting

Speler staat op de lijst, maar kan niet joinen

Controleer de exacte naam, de spelmodus en mogelijke prefixes bij Geyser. Verwijder de vermelding bij twijfel met /whitelist remove <name> en voeg hem daarna opnieuw toe.

Verwijderde spelers blijven online

Zet enforce-whitelist=true en laad de lijst opnieuw met /whitelist reload. Zonder deze instelling kunnen verwijderde spelers afhankelijk van de serverstatus nog verbonden blijven tot ze de verbinding verbreken.

Wijzigingen in het bestand worden niet toegepast

Als je server.properties of whitelist.json handmatig hebt gewijzigd, laad de whitelist dan opnieuw of herstart de server gecontroleerd. Controleer ook of je echt het bestand van de actieve serverinstantie hebt bewerkt.

OPs en whitelist door elkaar halen

Operator-rechten zijn beheerrechten, geen nette toegangslijst. Houd OPs beperkt en beheer de whitelist apart. Zo blijft duidelijk wie mag beheren en wie alleen mag spelen.

Tips

• Enforce Whitelist: Activeer enforce-whitelist=true, zodat spelers worden gekickt wanneer ze van de lijst worden verwijderd
• Ops: Operators (OPs) kunnen ook zonder whitelist joinen als enforce-whitelist uit staat
• Automatisering: Gebruik plugins zoals EasyWhitelist voor webgebaseerd beheer

Controle, grenzen en veilige terugweg

De handleiding “Minecraft Server Whitelist instellen – alleen vrienden toestaan” geldt voor het servertype dat in het artikel wordt beschreven en de versiestand die op het controlemoment zichtbaar was. Menunamen, beschikbare versies, compatibiliteit van mods of plugins en benodigde resources kunnen na updates afwijken. Neem waarden daarom niet ongecontroleerd over naar een andere game-, loader- of serverversie.

Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een backup van de betreffende bestanden. Wijzig daarna slechts één samenhangende stap en test die met dezelfde client- en serverversie waarmee je later wilt spelen.

Een geslaagde afzonderlijke test is geen garantie voor prestaties of beschikbaarheid. Wereldgrootte, mods, plugins, spelersaantal, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.

FAQ

Heb ik na elke wijziging een herstart nodig?

Niet per se. Als je commando's zoals /whitelist add, /whitelist remove of /whitelist reload gebruikt, kun je de lijst tijdens gebruik beheren. Na handmatige bestandswijzigingen is een reload of herstart verstandig.

Is de whitelist beter dan een wachtwoord?

Voor Minecraft is de whitelist de gebruikelijkere manier, omdat die concrete accounts toestaat. Een wachtwoord beschermt niet tegen doorgestuurde toegangsgegevens, terwijl een whitelist aan spelersnamen of accounts hangt.

Moet ik enforce-whitelist=true altijd activeren?

Voor privéservers is dat meestal verstandig. De instelling zorgt ervoor dat verwijderde spelers na een reload niet online blijven, hoewel ze niet meer op de lijst staan.

Werkt de whitelist met mods en plugins?

Ja, de basis-whitelist is een serverfunctie. Plugins kunnen extra beheer bieden, maar moeten bewust worden gekozen en actueel worden gehouden.

Wat doe ik met Bedrock-spelers via Geyser?

Controleer hoe je Geyser-setup Bedrock-namen afbeeldt. In het voorbeeld wordt .<BedRockName> gebruikt. Als het joinen mislukt, controleer dan de naam die daadwerkelijk in console of logs wordt getoond.