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


