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**.