ProxyTracer-AntiVPN

# ProxyTracer Blocks players joining with VPNs and proxies on Paper, Velocity, and Bungee.  ProxyTracer checks connecting player IPs against the [ProxyTracer API](https://proxytracer.com/dashboard). 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 | Your setup | JAR file | Where to install | |---|---|---| | Single Paper / Spigot / Purpur server | `proxytracer-bukkit-1.3.0.jar` | Game server `plugins/` | | Velocity network | `proxytracer-velocity-1.3.0.jar` | **Velocity proxy `plugins/` only** | | BungeeCord / Waterfall network | `proxytracer-bungee-1.3.0.jar` | **Bungee proxy `plugins/` only** | > **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](https://proxytracer.com/dashboard). 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 ` — Save key and reload - `/proxytracer status` — Show API status, cache count, and whitelist - `/proxytracer check ` — 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](https://proxytracer.com/dashboard)