ProxyTracer-AntiVPN

ProxyTracer

Blocks players joining with VPNs and proxies on Paper, Velocity, and Bungee.

ProxyTracer checks connecting player IPs against the ProxyTracer API. You can set it to block, warn staff, or just log joins.

Quick summary

• No TPS drops: IP checks run asynchronously off the main thread.
• Proxy support: Standalone JARs for Velocity and Bungee check IPs once at the network proxy so backend Paper nodes don't repeat lookups.
• Cache: Stores IP results locally in memory so returning players don't use up your API checks.
• Fail-open: If the API fails or times out, players are still allowed in by default so your server stays online.
• Discord logs: Optional webhooks to send alerts to staff channels.

Which JAR to use

Rule: Install it where the real IP is visible. If you run Velocity or Bungee, install it on the proxy, not backend Paper servers.

Installation

1. Get a free API key at proxytracer.com.
2. Put the right JAR into your plugins/ folder.
3. Start the server once.
4. Set your API key: /proxytracer set your_key_here
5. Check if it's working: /proxytracer status

Commands & Permissions

• /proxytracer set <api_key> — Save key and reload
• /proxytracer status — Show API status, cache count, and whitelist
• /proxytracer check <ip> — Check an IP manually
• /proxytracer cache clear — Clear local IP cache
• /proxytracer reload — Reload config
• /proxytracer whitelist name|ip — Add/remove whitelist entries

Permissions:

• proxytracer.admin (default: OP) — Manage plugin commands
• proxytracer.bypass (default: false) — Bypass IP checks
• proxytracer.notify (default: OP) — Get staff alerts in chat

Console Detection Log

Seeing 127.0.0.1 in logs?

If every player shows up as 127.0.0.1, your host or proxy isn't passing the real IP.

• On Velocity networks: Install proxytracer-velocity.jar on the proxy and enable modern forwarding.
• On Paper shared hosts: Check config/paper-global.yml and enable proxies.proxy-protocol: true if your host supports Proxy Protocol.

API Keys & Free Tier

The plugin is free. API checks use proxytracer.com:

• Free tier: Includes free checks every month for smaller servers.
• Paid plans: Start at €3/month for larger networks.

Get a free key: https://proxytracer.com