Better IP Filter
Better IP Filter is a lightweight and efficient IP whitelist plugin designed for Minecraft Paper servers. It performs early IP validation during the login process and blocks connections from non-whitelisted IP addresses with minimal performance impact.
The plugin is intentionally minimalistic and focused on reliability, performance, and ease of use.
✨ Features
- IP whitelist filtering on player join
- Early connection check using
AsyncPlayerPreLoginEvent - Extremely lightweight and fast
- Toggleable filtering without server restart
- IPv4 validation
- Persistent storage (
ips.yml) - No external dependencies
- Fully compatible with LuckPerms (Bukkit permissions)
⚙️ How It Works
- Player IP is checked before the player fully joins the server
- Allowed IPs are stored in memory for O(1) lookup
- If the IP is not whitelisted, the connection is denied immediately
- Designed to add no noticeable overhead even on busy servers
🧾 Commands
| Command | Description |
|---|---|
/ipf add <ip> |
Add an IP to the whitelist |
/ipf remove <ip> |
Remove an IP from the whitelist |
/ipf list |
Show all whitelisted IPs |
/ipf on |
Enable IP filtering |
/ipf off |
Disable IP filtering |
🔐 Permissions
| Permission | Description |
|---|---|
betteripfilter.admin |
Full access |
betteripfilter.add |
Add IPs |
betteripfilter.remove |
Remove IPs |
betteripfilter.list |
View whitelist |
betteripfilter.toggle |
Enable / disable filter |
Permissions are standard Bukkit permissions and work seamlessly with LuckPerms.
