ProxyTracer

Anti-VPN & Anti-Proxy for Paper, Folia, Velocity & BungeeCord

Block ban evaders and VPN joins. Free API key: https://proxytracer.com/dashboard

What ProxyTracer Does

ProxyTracer checks player IPs against proxytracer.com when they join. If a player uses a VPN or proxy, it can block them, alert staff in real-time, or log the join.

Features

• Runs async on network & region threads (0 impact on server TPS, native Folia support)
• Separate JARs for Paper/Spigot/Folia, Velocity, and BungeeCord
• Local memory cache to save API checks and speed up re-joins
• In-game colored chat alerts for staff (/proxytracer notify)
• Fail-open setting so players aren't blocked if the API is down
• Discord webhook alerts for staff channels
• In-game commands to whitelist player names or IPs
• Custom kick message with your site or proxytracer.com

Which JAR to Download

• Paper / Spigot / Purpur / Folia: https://github.com/ProxyTracer/proxytracer-minecraft/releases/tag/v1.4.0
• Velocity Proxy: https://github.com/ProxyTracer/proxytracer-minecraft/releases/tag/v1.4.0
• BungeeCord / Waterfall: https://github.com/ProxyTracer/proxytracer-minecraft/releases/tag/v1.4.0

Note: Install it on the proxy if you run a network. Don't install it on backend Paper servers at the same time.

Setup

1. Get a free API key at https://proxytracer.com/dashboard
2. Put the JAR into your plugins/ directory
3. Start your server once
4. Run /proxytracer set your_key_here in console or in-game
5. Check status with /proxytracer status

Commands

/proxytracer notify <on|off|toggle> - Enable or disable in-game staff alerts

/proxytracer notify add|remove|list - Manage staff usernames receiving alerts

/proxytracer set <key> - Set API key and reload

/proxytracer status - Show API status and cache count

/proxytracer check <ip> - Check an IP manually

/proxytracer cache clear - Clear IP cache

/proxytracer reload - Reload config

/proxytracer whitelist name|ip - Manage whitelists

Permissions

• proxytracer.admin (default: OP)
• proxytracer.bypass (default: false)
• proxytracer.notify (default: OP)

Fixing 127.0.0.1 IPs

If your console shows every player IP as 127.0.0.1, your proxy or host is hiding real IPs. If you use Paper, check config/paper-global.yml and turn on proxies.proxy-protocol: true (ask your host first). On networks, put the Velocity or Bungee JAR on the proxy gateway.

Free tier included for small servers. Paid plans start at €3/month. Get your key at https://proxytracer.com/dashboard