Better IP Filter

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.