Skip to content
Connection Guard
Download

Anti-VPN for Paper and Spigot

Drop one JAR into your server's plugins folder and new players are checked for VPNs, proxies and country rules at login. Free, open source, no account.

5.4 MB JAR for every platform, from ModrinthOther download options

Install on
Your Paper or Spigot server
Java
8 or newer
Built against
Spigot API 1.8.8
Checked
At login

Single server or network?

  • On a single Paper or Spigot server, install Connection Guard in that server's plugins folder.
  • Running a network behind BungeeCord or Velocity? Install it on the proxy instead. The proxy sees the real player address and one installation covers every backend.
  • The plugin builds against the Spigot 1.8.8 API. 0.6.0 passed startup, help, reload and shutdown checks on Paper 26.3 build 159 and Folia 26.2 build 7 with Java 25, and on Paper 1.21.11 with Java 21. Build targets do not prove every intermediate version was tested.

Set up on Paper and Spigot

  1. Download the JAR

    The same file runs on every platform: Modrinth, Hangar, SpigotMC or GitHub.

  2. Put it into the server's plugins folder

    Remove older Connection Guard JARs first.

  3. Start the server

    New 0.6 installs protect right away with Connection Guard Intel and the keyless services. Upgrading keeps your mode, services and keys.

  4. Set it up

    Open the console link for the dashboard's setup assistant, or edit config.yml. To watch before blocking, set operation.mode to OBSERVE.

  5. Check an address

    Run the command below to see what each service reports for an address.

    /cg info 203.0.113.7
# plugins/…/config.yml: warn staff first, block later
behavior:
  vpn:
    kick-player: false
    notify-staff: true
  geo:
    kick-player: false
    notify-staff: true
    type: 'BLACKLIST'
    list: []
A partial example from the configuration guide. Keep every other generated setting.

New to anti-VPN plugins? Read how to block VPNs on a Minecraft server and how country rules work.

What you control

Own VPN lists
Connection Guard Intel: signed lists of VPN servers, Tor exits and privacy relays, checked on the server. No quota, and it works when every API is down. About Intel
Detection services, one after another
ProxyCheck, Blackbox, zowi, IPQuery and IP-API without a key; IPHub, VPNAPI, IPQualityScore or your own REST API with one. If one fails, the next answers.
Country rules
A blocklist or an allowlist of countries, with its own action and message.
Your response
Refuse the connection, alert staff in chat, post to a Discord webhook or run a console command.
Caching
With caching enabled, unexpired SQLite or Redis results can be reused for the same address, reducing repeat lookups.
Exemptions
Let trusted players or addresses through by UUID, IP or LuckPerms permission.
Inspect any address
/cg info shows what each service reported, so you can see why a player was flagged.

Security software shouldn't be a black box. Everything above is public code under the MIT license, so you can read exactly what runs at every login on your Paper or Spigot server. Read the source

Paper and Spigot questions

Which Minecraft versions are supported?

The 0.6.0 listings reach Minecraft 26.3. 0.6.0 passed startup, help, reload and shutdown checks on Paper 26.3 build 159 and Folia 26.2 build 7 with Java 25, and on Paper 1.21.11 with Java 21. These checks do not prove every server version or authenticated-account scenario.

Does it work on Folia?

Yes. 0.6.0 passed startup, help, reload and shutdown checks on Paper 26.3 build 159 and Folia 26.2 build 7 with Java 25, and on Paper 1.21.11 with Java 21. These checks do not prove every server version or authenticated-account scenario.

Is Connection Guard free?

Yes. The plugin is free and open source under the MIT license, and no Connection Guard account is needed. The detection services you choose have their own free plans and limits.

Will it slow down logins?

A new IP address is checked once during login with the services you enabled. With caching enabled, unexpired answers can be reused for the same address (VPN results for 24 hours and country results for 72 hours by default), reducing repeat lookups.

Can I warn staff instead of kicking players?

Yes. Set kick-player to false and notify-staff to true for VPN or country rules. Staff with connectionguard.notify.vpn or connectionguard.notify.geo then see an alert, and you can also post to a Discord webhook.

Can I let specific players through?

Yes. Add their UUID or IP address under behavior.vpn.exemptions and behavior.geo.exemptions. Permission-based exemptions use LuckPerms and need the matching use-permission-exemption switch.