From e6f6584f6e7645908bc28fc1234b3d9212d351a4 Mon Sep 17 00:00:00 2001
From: Lucas Dijk <91026661+bullishlucas@users.noreply.github.com>
Date: Sun, 18 Oct 2026 01:27:50 +0300
Subject: [PATCH] Clarify Java whitelist console commands and group additions

---
 docs/games/minecraft/create-whitelist.md | 33 +++++++++++++++++++-----
 1 file changed, 27 insertions(+), 6 deletions(-)

diff --git a/docs/games/minecraft/create-whitelist.md b/docs/games/minecraft/create-whitelist.md
index 61a95f4..fbd39b1 100644
--- a/docs/games/minecraft/create-whitelist.md
+++ b/docs/games/minecraft/create-whitelist.md
@@ -13,13 +13,34 @@ You can use whitelist function of your Minecraft server to allow only whiteliste
 
 ![Whitelist](images/whitelist.png)
 
-3. Start the server and run the following command in-game as operator or in the console:
-```
-/whitelist add yourUsername
+3. Start the server. In the panel console, add a player with this command, replacing `yourUsername` with their Java username:
+
+```text
+whitelist add yourUsername
 ```
-To remove person from the whitelist, you can use this command:
+
+To run the same command in-game, use `/whitelist add yourUsername` as an operator. Console examples below omit the leading `/`; add it when running them in-game.
+
+To remove a player:
+
+```text
+whitelist remove yourUsername
 ```
-/whitelist remove yourUsername
+
+![Whitelist add](images/whitelist-add.png)
+
+## Adding a group of Java players
+
+Run one add command per player, checking the server's reply after each command. Then check the current list:
+
+```text
+whitelist add PlayerOne
+whitelist add PlayerTwo
+whitelist list
 ```
 
-![Whitelist add](images/whitelist-add.png)
\ No newline at end of file
+Replace the example names with the players' Java usernames. This keeps existing whitelist entries and avoids editing UUIDs or JSON by hand.
+
+For a longer roster, you can use the optional [ServerBuddy whitelist command generator](https://serverbuddy.net/tools/minecraft-whitelist-command-generator) to remove duplicates and flag invalid name syntax. Review the names, copy only the `whitelist add` lines, and remove their leading `/` for the console. Syntax validation does not verify that an account exists; check the server's replies and the final list.
+
+These examples are for Java Edition. Bedrock uses a separate `allowlist` command.