Compatibility
Minecraft: Java Edition
1.21.11
Platforms
Tags
Creators
Details
Licensed MIT
Published 2 months ago
Description
IpApprove blocks player connections at pre-login until their IP address is approved by an administrator.
This is mainly useful for offline-mode servers (online-mode=false) 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— reloadallowed-ips.ymlfrom 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.
Это в первую очередь полезно для offline-mode (online-mode=false) серверов как простая альтернатива паролям/авторизации, когда у тебя небольшой приватный сервер для друзей. Для больших публичных серверов не рекомендуется.
Как работает
- Если игрок заходит с нового 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.



