Better IP Filter

---

Better IP Filter

Minecraft Paper servers 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 no noticeable overhead 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.