Auto Whitelist Cleanup - Remove inactive players from your whitelist!
SpigotMCAutomatically remove inactive players from your whitelist by a configurable time!
WhitelistCleanup - Automatic Whitelist Maintenance
Keep your Minecraft server whitelist tidy and up-to-date — automatically!
WhitelistCleanup is a lightweight utility plugin for Spigot and Paper servers that scans your whitelist on startup or command and removes players who haven't logged in within a configurable number of days. It also keeps a safe backup of all removed entries so you can restore them if needed.
✅ Features
- Automatic cleanup on server startup
- Manual cleanup via /whitelist cleanup command
- Removes players inactive for X days (configurable)
- Optionally remove players who have never joined
- Saves removed players to removals.json in the same format as whitelist.json
- Exclude specific players by username or UUID
- ️ Exclude players based on Vault permission groups (e.g., Admins, Moderators)
- ️ Optional broadcast to ops with summary after cleanup
- Highly configurable via config.yml
Installation
- Download the plugin JAR and drop it into your /plugins folder.
- Restart or reload your server.
- Configure the config.yml to your needs.
- Done!
Configuration
remove-players-who-never-joined: true
broadcast-cleanup-to-ops: true
exclude-by-players-enabled: true
excluded-players:
- Notch
- 069a79f4-44e9-4726-a5be-fca90e38aaf5
exclude-by-vault-groups-enabled: true
excluded-vault-groups:
- admin
- moderator
Commands
/whitelist cleanup - Manually trigger the whitelist cleanup
Requirements
- Java 17+
- Spigot, Paper, or forked servers
- (Optional) Vault + a supported permissions plugin for rank-based exclusions
- whitelist.cleanup — Allows manual execution of the cleanup command
Versions
FAQ
How do I install Auto Whitelist Cleanup - Remove inactive players from your whitelist!?
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 Auto Whitelist Cleanup - Remove inactive players from your whitelist! free?
Auto Whitelist Cleanup - Remove inactive players from your whitelist! is free to download on Modgrid — we link straight to the official source, no paywall or bundled installer.
Which Minecraft versions does Auto Whitelist Cleanup - Remove inactive players from your whitelist! support?
Supports versions 1.21–1.21. See the download section on this page for the full list of supported versions and loaders.
Comments 0
No comments yet. Be the first to share your thoughts.