EpicGuardPlus

Enhanced bot protection plugin for Minecraft servers with extended security features.

EpicGuardPlus is a maintained fork of EpicGuard, originally by xxneox, with integrated features from AntiVPN by funkemunky.

It provides configurable antibot and anti-VPN protection for Paper, Velocity, and Waterfall servers.

Features

• 8+ configurable antibot checks
• Geographical country/city blacklist or whitelist
• VPN/proxy detection with configurable services and caching
• Nickname regex checks
• Reconnect verification
• Server list ping verification
• Client settings packet verification
• Lockdown mode during heavy bot attacks
• Name similarity detection
• Account limit per IP address
• SQLite and MySQL database support
• Live actionbar attack statistics
• Staff alerts when a player is blocked
• Custom console commands on detection
• Automatic whitelisting for verified players
• Console filter to reduce attack log spam
• Bedrock prefix whitelisting

Supported Platforms

Platform	Support
Paper and forks	1.17+; newer Paper builds should be tested before production use
Velocity	3.1.0+; newer Velocity 3.x builds should be tested before production use
Waterfall / BungeeCord	1.17+; support depends on the proxy build

Requires Java 17 or higher.

Only install the jar that matches your platform:

• Paper/Purpur/Spigot-compatible server: EpicGuardPlusPaper-x.x.x.jar
• Velocity proxy: EpicGuardPlusVelocity-x.x.x.jar
• Waterfall/BungeeCord proxy: EpicGuardPlusWaterfall-x.x.x.jar

Do not install the Core jar. Core is bundled inside the platform jars.

Put the selected jar into your server or proxy plugins folder and restart.

Commands

Main command: /guard

Aliases: /epicguard, /guardpaper, /guardvelocity, /guardwaterfall

Available commands:

• /guard help
• /guard reload
• /guard whitelist <add/remove> <nick/address>
• /guard blacklist <add/remove> <nick/address>
• /guard analyze <nick/address>
• /guard status
• /guard save

Permissions

epicguard.admin

Access to all /guard commands and staff alerts.

epicguard.bypass

Bypasses antibot checks and can auto-whitelist the player's IP on join.

Privacy

EpicGuardPlus stores IP addresses and associated nicknames in the configured local database.

If proxy/VPN checks are enabled, IP addresses may be sent to the configured proxy detection service. The default service is proxycheck.io.

MaxMind GeoLite2 databases may be downloaded for local geolocation checks when configured.

The plugin may check this repository for updates. Metrics or telemetry are not collected.

Source and License

Source code: https://github.com/Sqouidly/EpicGuardPlus

Licensed under GPL-3.0.

Portions are derived from AntiVPN, licensed under Apache-2.0.