1.0.0
release
IpApprove
An IP approval gate for offline-mode servers (small/private)
7
IpApprove
Description
IpApprove blocks player connections at pre-login until their IP address is approved by an administrator.
This is mainly useful for small private server for friends as a simple alternative to password/auth plugins when you run a small private server for friends. Not recommended for large public servers.
How it works
- If a player joins from an unknown IP, the server rejects the connection and records the attempt as pending. - An admin approves the IP via a command (permanent or time-limited). - Allowed IPs are stored in `plugins/IpApprove/allowed-ips.yml`.
Commands (permission: `ipapprove.admin`)
- `/ipapprove allow <ip> [minutes]` — allow an IP (permanent or timed) - `/ipapprove deny <ip>` — remove an IP from the allow-list - `/ipapprove list` — list allowed IPs + time remaining - `/ipapprove pending` — show recent blocked attempts - `/ipapprove info <ip>` — show status for one IP - `/ipapprove reload` — reload `allowed-ips.yml` from disk
Notes / limitations
- IP-based access control works best when players have relatively stable IP addresses. - If you use a proxy (Velocity/Bungee), configure forwarding properly so Paper sees the real client IP.
Русский перевод
Описание
IpApprove запрещает подключение игрока ещё до входа в мир, пока администратор не подтвердит его IP.
Это в первую очередь полезно для небольшой приватный сервер для друзей серверов как простая альтернатива паролям/авторизации, когда у тебя небольшой приватный сервер для друзей. Для больших публичных серверов не рекомендуется.
Как работает
- Если игрок заходит с нового IP — подключение отклоняется, попытка попадает в список pending. - Админ подтверждает IP командой (навсегда или на время). - Разрешённые IP хранятся в `plugins/IpApprove/allowed-ips.yml`.
Команды (permission: `ipapprove.admin`)
- `/ipapprove allow <ip> [minutes]` — разрешить IP (навсегда или на N минут) - `/ipapprove deny <ip>` — удалить IP из списка разрешённых - `/ipapprove list` — список разрешённых IP и оставшееся время - `/ipapprove pending` — последние заблокированные попытки входа - `/ipapprove info <ip>` — статус конкретного IP - `/ipapprove reload` — перечитать `allowed-ips.yml`
Ограничения
- IP-защита лучше всего подходит, когда IP у игроков меняется редко. - Если используешь прокси (Velocity/Bungee), настрой корректный forwarding, чтобы Paper видел реальный IP.
