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.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Better IP Filter 1.4.5 1.4.5 |
26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.5 1.4.5 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.4 1.4.4 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.3 1.4.3 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.2 1.4.2 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.1 1.4.1 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.4.0 1.4.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.3.0 1.3.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.2.0 1.2.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.1.0 1.1.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
Better IP Filter 1.0.0 1.0.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |