---

EN

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.

---

📦 Installation

1. Download the plugin JAR
2. Place it into your server’s plugins/ folder
3. Start the server to generate config files
4. Configure as needed
5. Restart the server

---

RU

Better IP Filter

Better IP Filter - лёгкий и эффективный плагин IP-whitelist’а для Minecraft Paper-серверов.
Он выполняет раннюю проверку IP-адреса на этапе входа и блокирует подключения с неразрешённых IP с минимальной нагрузкой на сервер.

Плагин намеренно сделан минималистичным и сфокусирован на надёжности, производительности и простоте использования.

---

✨ Возможности

• Фильтрация по IP при входе игрока
• Ранняя проверка подключения через AsyncPlayerPreLoginEvent
• Максимально лёгкий и быстрый
• Включение и отключение фильтра без перезапуска сервера
• Проверка IPv4-адресов
• Постоянное хранение данных (ips.yml)
• Без внешних зависимостей
• Полная совместимость с LuckPerms (Bukkit-права)

---

⚙️ Принцип работы

• IP-адрес игрока проверяется до полного входа на сервер
• Разрешённые IP хранятся в памяти для поиска за O(1)
• Если IP отсутствует в whitelist - соединение сразу отклоняется
• Плагин не создаёт заметной нагрузки даже на загруженных серверах

---

🧾 Команды

Команда	Описание
/ipf add <ip>	Добавить IP в whitelist
/ipf remove <ip>	Удалить IP из whitelist
/ipf list	Показать все разрешённые IP
/ipf on	Включить IP-фильтрацию
/ipf off	Отключить IP-фильтрацию

---

🔐 Права доступа

Право	Описание
betteripfilter.admin	Полный доступ
betteripfilter.add	Добавление IP
betteripfilter.remove	Удаление IP
betteripfilter.list	Просмотр whitelist’а
betteripfilter.toggle	Включение / отключение фильтра

Используются стандартные Bukkit-права, полностью совместимые с LuckPerms.

---

📦 Установка

1. Скачайте JAR-файл плагина
2. Поместите его в папку plugins/
3. Запустите сервер для генерации файлов конфигурации
4. Настройте плагин при необходимости
5. Перезапустите сервер