Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
HypeAntiProxy
Advanced VPN & Proxy Protection for Paper Minecraft Servers
๐ก What is HypeAntiProxy?
HypeAntiProxy is a powerful, lightweight and fully asynchronous anti-VPN plugin built for Paper 1.21.4 servers. It automatically detects and blocks players connecting through VPNs, proxies and TOR exit nodes โ all with zero lag on your main thread.
Whether you run a small survival server or a large competitive network, HypeAntiProxy keeps your community fair by preventing ban evasion, alt account abuse and anonymous connections.
โจ Features
- ๐ VPN & Proxy Detection โ Checks every connecting player's IP against two free APIs (ip-api.com + proxycheck.io). No API key required.
- โก Zero Lag โ 100% asynchronous. API calls and database operations never touch the main thread.
- ๐พ Two-Level Cache โ In-memory LRU cache backed by persistent SQLite. Checked IPs are never queried again until the TTL expires (default 24 hours).
- ๐ฅ Alt Account Tracker โ Records every IP โ UUID โ username mapping. Alerts staff when multiple accounts join from the same IP.
- โ Ban History Alerts โ Instantly notifies online admins when a player joins from an IP previously used by a banned account.
- ๐ Bilingual Support โ Full English and Turkish language support. Switch with one line in config.yml.
- ๐ Beautiful Admin Alerts โ Colored in-game notifications with configurable sound effects sent to all staff with the notify permission.
- ๐ IP Whitelist โ Whitelist specific IPs in-game instantly. Perfect for staff members who use VPNs.
- ๐ง Fully Configurable โ Every message, sound, limit, API toggle and TTL is customizable. Hot-reload with /hypeap reload โ no restart needed.
๐ Commands
| Command | Description |
|---|---|
| /hypeap check \ | Check any IP or online player |
| /hypeap alts \ | List all known alt accounts |
| /hypeap info \ | Show IP, ISP, country and VPN status |
| /hypeap whitelist add/remove/list | Manage the IP whitelist |
| /hypeap stats | View plugin statistics |
| /hypeap reload | Hot-reload configuration |
๐ Permissions
| Permission | Description | Default |
|---|---|---|
| hypeap.admin | Full command access | OP |
| hypeap.notify | Receive in-game alerts | OP |
| hypeap.bypass | Skip VPN check on join | false |
โ Requirements
- Server: Paper 1.21.4 or any Paper fork (Purpur, Pufferfish, Leaf...)
- Java: 21 or higher
- APIs: ip-api.com + proxycheck.io
๐ Language Support
Change the language in config.yml:
language: EN # English
language: TR # Tรผrkรงe
Then run /hypeap reload. No restart needed.
๐ How It Works
Every player login goes through a secure async pipeline:
- Private/local IPs and whitelisted IPs are skipped instantly
- OP players bypass the check automatically
- Cache is checked first (RAM โ SQLite) โ zero API call if cached
- If not cached, ip-api.com is queried. On failure, proxycheck.io is used as fallback
- Result is cached for 24 hours
- VPN/proxy players are kicked with a beautiful screen
- Alt and ban-history alerts are fired to online admins
๐ฌ Support
Found a bug or have a suggestion? Open an issue on GitHub or contact xXantares_peek1 on Discord.
Made with โค by xXantares_peek โ Paper 1.21.4 | Java 21 | Free & Open Source


