# \ud83d\udee1 EpicGuard
\n     <\/p>\n
A simple AntiBot plugin for newest Minecraft versions.<\/p>\n
## \u2705 Supported platforms \/ Latest release requirements
\n* Paper 1.20.1+ *(all paper forks are supported)*
\n* Velocity 3.3+
\n* Java **17**<\/p>\n
## \u2728 Features
\n* A total of **8** configurable antibot checks:
\n * Geographical check – country\/city blacklist or whitelist.
\n * VPN\/Proxy check – configurable services and caching.
\n * Nickname check – block certain nickname patterns using regex.
\n * Reconnect check – require re-joining the server with an identical pair of address and nickname.
\n * Server list check – require pinging the server before connecting (adding it to the server list).
\n * Settings check – make sure that player sends a settings packet after joining (vanilla client behaviour).
\n * Lockdown – temporarily block incoming connections if there are too many of them.
\n * Name similarity check (BETA)
\n * Account limit.
\n* SQLite\/MySQL support.
\n* Live actionbar statistics.
\n* Automatic whitelisting.
\n* Console filter.<\/p>\n
<\/p>\n
## \ud83d\udcda Commands & Permissions
\nTo be able to use commands, give yourself the **epicguard.admin** permission.
\nOn different platforms there are additional aliases available, such as **\/guardvelocity** or **\/epicguardpaper**<\/p>\n
| Command | Description | ## \ud83d\udd27 Using EpicGuard API in your project: “`kotlin “`groovy “`xml Make sure that EpicGuard is fully loaded before your plugin.<\/p>\n Click to see the API class<\/p>\n “`java \/\/ Checking user’s country: ## \ud83d\udd75\ufe0f Privacy disclaimers This is an updated version of EpicGuard for recent versions of Paper, Waterfall and Velocity. <\/p>\n","protected":false},"excerpt":{"rendered":" Bot protection system for Minecraft servers and proxies<\/p>\n","protected":false},"featured_media":65067,"template":"","meta":{"_minecraft_slug":"epicguard","_minecraft_project_id":"Z5ayyqQS","_minecraft_author":"4drian3d","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":14938,"_minecraft_follows":108,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"epicguard.zip","_minecraft_size_bytes":27492821,"_minecraft_version_count":24,"_minecraft_updated_at":"2026-05-16T01:05:52.975834Z","_minecraft_date_created":"2023-02-17T02:02:42.376703Z","_minecraft_date_modified":"2025-08-29T23:04:09.871678Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/epicguard","_minecraft_icon_attachment_id":65067,"_minecraft_imported_at":"2026-06-03T17:52:01+00:00","_minecraft_import_hash":"12cfa5447947de9037edc44235353337","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,873,126,90,127,128,123,92,985,992],"mod_loader":[131,132,133,986,993],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-65066","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n|———————————————-|————————————————————————|
\n| \/guard help | Displays all available commands. |
\n| \/guard reload | Reloads config and messages. |
\n| \/guard whitelist
\n| \/guard blacklist
\n| \/guard analyze
\n| \/guard status | Toggles live attack information on actionbar. |
\n| \/guard save | Forces save to the database. |<\/p>\n
\nThe api is not very advanced, and there is not much you can do with it for now.<\/p>\nGradle (Kotlin)<\/summary>\n
\nrepositories {
\n \/\/ Snapshots
\n maven(“https:\/\/s01.oss.sonatype.org\/content\/repositories\/snapshots\/”)
\n \/\/ Releases
\n mavenCentral()
\n}
\ndependencies {
\n compileOnly(“com.github.4drian3d:epicguard-api:[VERSION HERE]”)
\n}
\n“`
\n<\/details>\nGradle (Groovy)<\/summary>\n
\nrepositories {
\n maven {
\n url = ‘https:\/\/s01.oss.sonatype.org\/content\/repositories\/snapshots\/’
\n }
\n mavenCentral()
\n}
\ndependencies {
\n compileOnly ‘com.github.4drian3d:epicguard-api:[VERSION OR COMMIT ID HERE]’
\n}
\n“`
\n<\/details>\nMaven<\/summary>\n
\n
\n
\n
\n
\n
\n <\/repository>
\n <\/repositories>
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n <\/dependencies>
\n“`
\n<\/details>\nUsing the API<\/summary>\n
\n\/\/ Importing the API class.
\nimport me.xneox.epicguard.core.EpicGuardAPI;
\nimport me.xneox.epicguard.core.manager.AttackManager;
\npublic class EpicGuardAPIExample {
\n \/\/ Accessing the EpicGuardAPI instance.
\n EpicGuardAPI api = EpicGuardAPI.INSTANCE;
\n \/\/ Obtaining the AttackManager instance:
\n AttackManager attackManager = api.attackManager();
\n \/\/ Checking if server is under attack.
\n boolean isUnderAttack = attackManager.isUnderAttack();
\n \/\/ checking current connections per second.
\n int cps = attackManager.connectionCounter();<\/p>\n
\n String countryId = api.geoManager().countryCode(“127.0.0.1”);
\n}
\n“`
\n<\/details>\n
\n* This plugin connect to various external services, to fully work as intended.
\n * MaxMind’s Geolite2 databases (country and city) are downloaded at the first startup and updated every week. Geolocation of your users is checked locally on your server.
\n * *In the default configuration*, IP addresses of connecting users are sent to https:\/\/proxycheck.io\/ to check if they’re not using a proxy or a VPN.
\n * IPs and nicknames associated with them are stored in the local database *(as plain text(!))*.
\n * This plugin periodically checks the latest version released in this repository. *This feature can be disabled.*
\n * *There is no metrics system or any other kind of data collection.*<\/p>\n