# HypeAntiProxy<\/p>\n
**Advanced VPN & Proxy Protection for Paper Minecraft Servers**<\/p>\n
—<\/p>\n
## \ud83d\udee1 What is HypeAntiProxy?<\/p>\n
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 \u2014 all with **zero lag** on your main thread.<\/p>\n
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.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83d\udd0d **VPN & Proxy Detection** \u2014 Checks every connecting player’s IP against two free APIs (ip-api.com + proxycheck.io). No API key required.
\n– \u26a1 **Zero Lag** \u2014 100% asynchronous. API calls and database operations never touch the main thread.
\n– \ud83d\udcbe **Two-Level Cache** \u2014 In-memory LRU cache backed by persistent SQLite. Checked IPs are never queried again until the TTL expires (default 24 hours).
\n– \ud83d\udc65 **Alt Account Tracker** \u2014 Records every IP \u2194 UUID \u2194 username mapping. Alerts staff when multiple accounts join from the same IP.
\n– \u2620 **Ban History Alerts** \u2014 Instantly notifies online admins when a player joins from an IP previously used by a banned account.
\n– \ud83c\udf0d **Bilingual Support** \u2014 Full English and Turkish language support. Switch with one line in config.yml.
\n– \ud83d\udd14 **Beautiful Admin Alerts** \u2014 Colored in-game notifications with configurable sound effects sent to all staff with the notify permission.
\n– \ud83d\udccb **IP Whitelist** \u2014 Whitelist specific IPs in-game instantly. Perfect for staff members who use VPNs.
\n– \ud83d\udd27 **Fully Configurable** \u2014 Every message, sound, limit, API toggle and TTL is customizable. Hot-reload with \/hypeap reload \u2014 no restart needed.<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
| Command | Description |
\n|—|—|
\n| \/hypeap check | Check any IP or online player |
\n| \/hypeap alts | List all known alt accounts |
\n| \/hypeap info | Show IP, ISP, country and VPN status |
\n| \/hypeap whitelist add\/remove\/list | Manage the IP whitelist |
\n| \/hypeap stats | View plugin statistics |
\n| \/hypeap reload | Hot-reload configuration |<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission | Description | Default |
\n|—|—|—|
\n| hypeap.admin | Full command access | OP |
\n| hypeap.notify | Receive in-game alerts | OP |
\n| hypeap.bypass | Skip VPN check on join | false |<\/p>\n
—<\/p>\n
## \u2699 Requirements<\/p>\n
– **Server:** Paper 1.21.4 or any Paper fork (Purpur, Pufferfish, Leaf…)
\n– **Java:** 21 or higher
\n– **APIs:** ip-api.com + proxycheck.io<\/p>\n
—<\/p>\n
## \ud83c\udf0d Language Support<\/p>\n
Change the language in `config.yml`:<\/p>\n
“`yaml
\nlanguage: EN # English
\nlanguage: TR # T\u00fcrk\u00e7e
\n“`<\/p>\n
Then run `\/hypeap reload`. No restart needed.<\/p>\n
—<\/p>\n
## \ud83d\udcc1 How It Works<\/p>\n
Every player login goes through a secure async pipeline:<\/p>\n
1. Private\/local IPs and whitelisted IPs are skipped instantly
\n2. OP players bypass the check automatically
\n3. Cache is checked first (RAM \u2192 SQLite) \u2014 zero API call if cached
\n4. If not cached, ip-api.com is queried. On failure, proxycheck.io is used as fallback
\n5. Result is cached for 24 hours
\n6. VPN\/proxy players are kicked with a beautiful screen
\n7. Alt and ban-history alerts are fired to online admins<\/p>\n
—<\/p>\n
## \ud83d\udcac Support<\/p>\n
Found a bug or have a suggestion? Open an issue on GitHub or contact **xXantares_peek1** on Discord.<\/p>\n
—<\/p>\n
*Made with \u2764 by xXantares_peek \u2014 Paper 1.21.4 | Java 21 | Free & Open Source*<\/p>\n","protected":false},"excerpt":{"rendered":"
Block VPN & Proxy users instantly, track alt accounts per IP and get real-time alerts when banned players reconnect \u2014 all with zero server lag.<\/p>\n","protected":false},"featured_media":82952,"template":"","meta":{"_minecraft_slug":"hypeantiproxy","_minecraft_project_id":"rvo60A6v","_minecraft_author":"xXantares_peek","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":61,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hypeantiproxy.zip","_minecraft_size_bytes":14478247,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:52:00.703496Z","_minecraft_date_created":"2026-03-19T21:05:45.831710Z","_minecraft_date_modified":"2026-05-02T16:30:17.404084Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hypeantiproxy","_minecraft_icon_attachment_id":82952,"_minecraft_imported_at":"2026-06-04T18:08:19+00:00","_minecraft_import_hash":"6afd5f8dc15e33605a5bb2536002fb14","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,90,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82951","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n