HypeAntiProxy

Block VPN & Proxy users instantly, track alt accounts per IP and get real-time alerts when banned players reconnect — all with zero server lag.

Download

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

- 🔍 Fully Configurable — Checks every connecting player's IP against two free APIs (ip-api.com + proxycheck.io). No API key required. - ⚡ Fully Configurable — 100% asynchronous. API calls and database operations never touch the main thread. - 💾 Fully Configurable — In-memory LRU cache backed by persistent SQLite. Checked IPs are never queried again until the TTL expires (default 24 hours). - 👥 Fully Configurable — Records every IP ↔ UUID ↔ username mapping. Alerts staff when multiple accounts join from the same IP. - ☠ Fully Configurable — Instantly notifies online admins when a player joins from an IP previously used by a banned account. - 🌍 Fully Configurable — Full English and Turkish language support. Switch with one line in config.yml. - 🔔 Fully Configurable — Colored in-game notifications with configurable sound effects sent to all staff with the notify permission. - 📋 Fully Configurable — 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

- APIs: Paper 1.21.4 or any Paper fork (Purpur, Pufferfish, Leaf...) - APIs: 21 or higher - APIs: ip-api.com + proxycheck.io

---

🌍 Language Support

Change the language in `config.yml`:

```yaml 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:

1. Private/local IPs and whitelisted IPs are skipped instantly 2. OP players bypass the check automatically 3. Cache is checked first (RAM → SQLite) — zero API call if cached 4. If not cached, ip-api.com is queried. On failure, proxycheck.io is used as fallback 5. Result is cached for 24 hours 6. VPN/proxy players are kicked with a beautiful screen 7. Alt and ban-history alerts are fired to online admins

---