
ModsJava
WhiteHeads
Whitelist and redlist based on UUID and IP.
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
compiled using java 25 and spigot 1.21.11
:: Functions ::
White Heads and Red Heads list filtering.
- cooldown on prelogin for every UUID
- prelogin filtering (UUID, IP)
- ingame /white stop will stop the whitelist filtering, to let everyone in, except Red list players/ip (banned).
- it will autorestart after a config time lapse
- or /white start to restart the whitelist filtering earlier
- it will write three different files/logs
- errors
- logins
- actions
:: Installation ::
- copy paste in plugins.
:: How to ::
filter using IP: edit whiteIps/redIps .yml files
- it will automatically reload on file change
filter using UUID : edit whiteHeads/redHeads .yml files
- it will automatically reload on file change
- use ingame commands (need permission)
:: yml files ::
whiteHeads.yml and redHeads.yml
- add "UUID": comment
example:
"1234-5674-6543-1234": john
"6814-6543-6543-5674": old friend
whiteIps.yml and redIps.yml
- add "IP": comment
example:
"192_168_1_1": spammer
"192_168_1_10": allowed player
Replace the dots by underscores, for every IP.
:: Configuration ::
LOGIN_COOLDOWN_ENABLED: true
LOGIN_COOLDOWN_MINUTES: 1
COOLDOWN_TRIES_AUTORED: 10
COOLDOWN_AUTORED_ENABLED: true
WHITE_MAX_OFFLINE_IN_MINUTES: 10
LOG_SIZE_LIMIT_MB: 1
LOG_FILES:
ERROR: log_ERRORS.yml
LOGIN: log_LOGINS.yml
ACTION: log_ACTIONS.yml
:: Permission ::
For using ingame commands:
- whiteheads.admin
:: Commands ::
/white list
/white add <UUID> <comment>
/white remove <UUID> <comment>
/white help
/red list
/red add <UUID> <comment>
/red remove <UUID> <comment>
Verified by MCModsHub
- Ships as WhiteHeads_0-2.jar — drop this file into the mods folder
- Download size: 15 KB
- Download link checked 9 Aug 2026 — working
These come from our own check of the pack file, not from the source page.