Language

WhiteHeads

WhiteHeads

ModrinthSpigotMC

Whitelist and redlist based on UUID and IP.

7 downloads updated 27d ago
latest v0.2 Modrinth
Bukkit Paper Spigot 1.21 – 26.1.2 Utility

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>

Versions

Release
0.2
bukkit, spigot · 1.21, 1.21.1, 1.21.2 · 27d ago
- added a resume of all entries on load/change
5
Release
0.1
bukkit, paper, spigot · 1.21.11, 26.1, 26.1.1 · 1mo ago
First release.
2

Comments 0

No comments yet. Be the first to share your thoughts.

FAQ

How do I install WhiteHeads?

Download the file for your Minecraft version and loader from this page, then drop the .jar into your mods (or plugins) folder and launch the game.

Is WhiteHeads free?

WhiteHeads is free to download on Modgrid — we link straight to the official source, no paywall or bundled installer.

Which Minecraft versions does WhiteHeads support?

Works with Bukkit, Paper, Spigot. Supports versions 1.21–26.1.2. See the download section on this page for the full list of supported versions and loaders.

Download WhiteHeads

SpigotMC

Files are served directly from the original source. Modgrid does not host or modify them.