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
- Download the plugin JAR
- Place it into your server’s
plugins/folder - Start the server to generate config files
- Configure as needed
- 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.
📦 Установка
- Скачайте JAR-файл плагина
- Поместите его в папку
plugins/ - Запустите сервер для генерации файлов конфигурации
- Настройте плагин при необходимости
- Перезапустите сервер
