Whitelist, operators en bans op een Minecraft-server

Drie basismiddelen om te bepalen wie er op je server mag en wat hij daar mag doen: de whitelist laat alleen geselecteerde spelers binnen, een operator krijgt alle commando's en een ban blokkeert wie de regels overtreedt. Je regelt alles vanuit de console in je klantaccount of in het spel.

De whitelist, operators en bans beheer je ook zonder commando's op het tabblad Spelers: draait de server, dan stuurt het portaal een commando naar de console, draait hij niet, dan past het portaal de bestanden rechtstreeks aan. Een ander operatorniveau dan het standaardniveau stel je alleen in als de server uit staat.

Whitelist#

De whitelist is een lijst met spelers die mogen verbinden. Staat hij aan, dan weigert de server alle anderen met de melding You are not white-listed on this server! (het spel toont die in de taal van de speler, op Paper en Purpur altijd in het Engels: You are not whitelisted on this server!). Handig voor privéservers met vrienden, voor testen of voor besloten evenementen.

De whitelist inschakelen#

1. Voeg eerst jezelf toe, zodat je jezelf niet buitensluit (operators kunnen wel altijd verbinden):

   whitelist add <NICK>

   • whitelist add – voegt een speler toe aan de whitelist. De speler hoeft niet online te zijn en hoeft ook nooit eerder verbonden te zijn geweest. De server zoekt zijn account zelf op.
   • <NICK> – de spelnaam van de speler, bijvoorbeeld Steve.

   [12:00:01 INFO]: Added Steve to the whitelist

2. Voeg alle andere spelers toe met hetzelfde commando.

3. Schakel de whitelist in:

   whitelist on

   [12:00:05 INFO]: Whitelist is now turned on

   De whitelist geldt meteen en de server schrijft white-list=true ook naar het bestand server.properties, zodat hij een herstart overleeft.

Hetzelfde resultaat krijg je met de instelling in je klantaccount: het tabblad Serverinstellingen › de groep Spelers › Whitelist inschakelen › Opslaan en herstarten.

Whitelist afdwingen#

Schakel je de whitelist in, dan blijven spelers die op dat moment verbonden zijn en niet op de lijst staan op de server. De optie Whitelist afdwingen (enforce-whitelist in server.properties) verbreekt hun verbinding zodra de whitelist wordt geladen. Je zet haar aan op het tabblad Serverinstellingen in de groep Spelers.

Commando's van de whitelist#

De lijst staat in het bestand whitelist.json in de hoofdmap van de server. Elke speler heeft in het bestand een UUID (de unieke identificatie van het account) en een naam. Handmatig aanpassen raden we af, de commando's zijn veiliger.

Bedrock-spelers (Geyser en Floodgate)#

Spelers van de Bedrock Edition voeg je toe met het commando van de add-on Floodgate. Typ de naam zonder voorvoegsel:

fwhitelist add <NICK>

Floodgate zet in het spel een voorvoegsel voor de naam van Bedrock-spelers (standaard een punt, bijvoorbeeld .Steve), zodat de namen niet worden verward met die van Java-spelers. Het commando fwhitelist vult het voorvoegsel zelf aan. Meer in het artikel Crossplay met Bedrock.

Operators#

Een operator (op) mag de commando's van de server gebruiken volgens zijn rechtenniveau. Het standaardniveau is 4, dus werkelijk alle commando's.

op <NICK>

[12:01:10 INFO]: Made Steve a server operator

deop <NICK>

[12:01:30 INFO]: Made Steve no longer a server operator

• op geeft een speler operatorrechten, deop neemt ze weer af. De wijziging geldt meteen.

Rechtenniveaus van operators#

Het niveau voor nieuwe operators stel je in op het tabblad Serverinstellingen › Spelers › Rechten van operators (op-permission-level, een waarde van 1–⁠4, standaard 4). Het niveau van een bepaalde operator staat in het bestand ops.json:

[
  {
    "uuid": "<PLAYER_UUID>",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]

• uuid – de unieke identificatie van het account. De server vult die zelf in bij op.
• name – de spelnaam (alleen voor het overzicht, het UUID is bepalend).
• level – het niveau 1–⁠4 volgens de tabel hierboven.
• bypassesPlayerLimit – true betekent dat de operator ook op een volle server kan verbinden.

Pas het bestand alleen aan als de server uit staat, anders overschrijft de server het bij het opslaan.

Bans#

Voorbeeld:

ban Griefer123 Bouwwerken bij de spawn vernield

[12:02:00 INFO]: Banned Griefer123: Bouwwerken bij de spawn vernield

Een gebande speler ziet bij het verbinden You are banned from this server (in het spel in de taal van de speler) en de reden. De bans staan in de bestanden banned-players.json en banned-ips.json.

Tijdelijke ban#

Vanilla Minecraft kent geen tijdelijke bans. Met de plugin EssentialsX (Paper, Purpur) gebruik je:

tempban <NICK> <duur> [reden]

• <duur> – bijvoorbeeld 30m (minuten), 12h (uren), 3d (dagen), 1w (week), 1mo (maand). Combinaties zoals 1d12h kunnen ook.
• Voorbeeld: tempban Steve 3d Spam in de chat.

De installatie van EssentialsX staat in het artikel Aanbevolen plugins.

Kicken (kick)#

kick <NICK> [reden]

Verbreekt de verbinding met de speler, maar hij kan meteen opnieuw verbinden. Handig als waarschuwing. Uitvoer: Kicked Steve: reden.

Online-mode en veiligheid#

De optie Accountverificatie (online-mode) op het tabblad Serverinstellingen bepaalt of de server bij Mojang controleert of de speler een origineel account bezit.

• Aan (aanbevolen): elke naam hoort bij een echt account. De whitelist, op en bans werken betrouwbaar.
• Uit: iedereen kan verbinden onder elke gewenste naam, ook onder de namen van operators. Je klantaccount waarschuwt daarvoor: “Met de verificatie uitgeschakeld kan iedereen onder elke naam verbinden, ook onder de naam van een operator.” Uitschakelen is alleen zinvol achter een proxy (Velocity) die de verificatie zelf doet, zie Een servernetwerk met Velocity.

Controle#

• whitelist list toont de spelers op de whitelist.
• banlist toont de bans.
• Een verbindingspoging van een speler die niet op de whitelist staat, eindigt met de melding over de whitelist.

Als iets niet werkt#

Een speler staat op de whitelist, maar de server laat hem niet binnen#

• Er zit een typfout in de naam, of de speler heeft zijn naam gewijzigd. Controleer whitelist list en voeg hem opnieuw toe.
• Een Bedrock-speler moet worden toegevoegd met fwhitelist add.
• De server draait met online-mode uit en de whitelist bevat het UUID van het originele account. Met uitgeschakelde verificatie heeft de speler een ander UUID. Voeg hem opnieuw toe.

That player does not exist#

De server heeft bij Mojang geen account met deze naam gevonden. Controleer de exacte schrijfwijze van de naam.

Nothing changed. The player is already an operator#

De speler is al operator. Wil je zijn niveau wijzigen, pas dan level aan in het bestand ops.json terwijl de server uit staat.

De whitelist stond na een herstart uit#

Waarschijnlijk heb je hem ingeschakeld op het tabblad Serverinstellingen maar niet opgeslagen, of je was tegelijk server.properties aan het bewerken en de server heeft dat bestand bij het starten overschreven. Schakel hem opnieuw in met het commando whitelist on en controleer of Whitelist in Serverinstellingen aan staat.

Een speler van wie de ban is opgeheven kan nog steeds niet verbinden#

Waarschijnlijk heeft hij ook een IP-ban. Controleer banlist ips en hef die op met het commando pardon-ip <IP>. Tijdelijke bans van EssentialsX hef je op met het commando unban <NICK>.

Meer bronnen#

• Minecraft Wiki: whitelist (opent in een nieuw venster)
• Minecraft Wiki: ban (opent in een nieuw venster)
• Minecraft Wiki: rechtenniveaus (opent in een nieuw venster)
• Floodgate: functies en fwhitelist (opent in een nieuw venster)