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

🔐 Permissions

Permissions are standard Bukkit permissions and work seamlessly with LuckPerms.