Download Connection Guard
One JAR runs on every supported platform. Pick whichever site you already use; the file is the same everywhere.
v0.6.1Released 13 October 2026What changed
In the open benchmark's stress test it checked all 1,000 players joining at once. See the results
Download sources
- ModrinthRecommendedShows every version and its changelog.3,569 downloads
- HangarPaperMC's plugin directory.103 downloads
- SpigotMCThe classic resource page.1,114 downloads
- GitHubRelease files built by CI, with checksums.696 downloads
Security software shouldn't be a black box.
Every check the plugin runs is public code under the MIT license, built in public CI. GitHub releases ship with SHA-256 checksums: compare sha256sum connection-guard-0.6.1-all.jar with the SHA256SUMS file of the release. Plugin source ยท Dashboard source
Where it goes
Paper / Spigot
- Folder
- plugins/
- Java
- Java 8 or newer
Built against the 1.8.8 API. Use the Java version your server software needs.
BungeeCord / Waterfall
- Folder
- plugins/
- Java
- Java 8 or newer
Install on the proxy. Backend servers behind it don't need a copy.
Velocity
- Folder
- plugins/
- Java
- Java 17 or newer
Targets the Velocity 3.3 API. Install on the proxy only.
Build targets don't prove every server version was tested. 0.6.0 passed startup, help, reload and shutdown checks on Paper 26.3 build 159, Folia 26.2 build 7 and Velocity 4.2.0 build 30 with Java 25, and on Paper 1.21.11 and Velocity 3.4.0 with Java 21. These checks do not prove every server version or authenticated-account scenario.
Install
Stop the server.
Or the proxy, on a network.
Put the JAR into the plugins folder.
Remove older Connection Guard JARs first.
Start the server.
New 0.6 installs protect right away: Connection Guard Intel and the keyless services, no API key needed. Country lookups stay off until you add a country rule. Upgrading keeps your mode, services and keys.
Set it up.
Open the link from the console for the dashboard's setup assistant, or edit config.yml. Run /cg doctor and /cg explain <IP> to inspect your setup and decisions. Prefer to watch first? Set operation.mode to OBSERVE, then /cg reload.
Need help?
Share your plugin, platform and Java versions and what you expected. Remove API keys, webhook URLs and player IPs before posting.