EpicGuard

Modrinth

Bot protection system for Minecraft servers and proxies

17.5K downloads104 followersUpdated 1y ago

7.6.1 · MC 1.21.8 · Velocity

View on Modrinth

Files

7.6.1
release
EpicGuard Velocity 7.6.1
1.21.81.21.71.21.61.21.5+72velocity
2025-08-29 · 3.7K downloads
EpicGuardVelocity-7.6.1.jar · 155 KB
7.6.1
release
EpicGuard Paper 7.6.1
1.21.81.21.71.21.61.21.5+12foliapaperpurpur
2025-08-29 · 2.1K downloads
EpicGuardPaper-7.6.1.jar · 775 KB
7.6.0
release
EpicGuard Velocity 7.6.0
1.21.51.21.41.21.31.21.2+68velocity
2023-12-25 · 2.8K downloads
EpicGuardVelocity-7.6.0.jar · 152 KB
7.6.0
release
EpicGuard Paper 7.6.0
1.21.51.21.41.21.31.21.2+7foliapaperpurpur
2023-12-25 · 3.3K downloads
EpicGuardPaper-7.6.0.jar · 765 KB
7.5.2
release
EpicGuard Paper 7.5.2
1.20.41.20.31.20.21.20.1+1foliapaperpurpur
2023-11-29 · 297 downloads
EpicGuardPaper-7.5.2.jar · 765 KB
7.5.2
release
EpicGuard Velocity 7.5.2
1.20.41.20.31.20.21.20.1+61velocity
2023-11-29 · 199 downloads
EpicGuardVelocity-7.5.2.jar · 153 KB
7.5.1
release
EpicGuard Paper 7.5.1
1.20.21.20.1foliapaperpurpur
2023-11-04 · 282 downloads
EpicGuardPaper-7.5.1.jar · 764 KB
7.5.1
release
EpicGuard Waterfall 7.5.1
1.20.21.20.11.201.19.4+50waterfall
2023-11-04 · 340 downloads
EpicGuardWaterfall-7.5.1.jar · 118 KB
7.5.1
release
EpicGuard Velocity 7.5.1
1.20.21.20.11.201.19.4+59velocity
2023-11-04 · 210 downloads
EpicGuardVelocity-7.5.1.jar · 152 KB
7.5.0
release
EpicGuard Waterfall 7.5.0
1.20.21.20.11.201.19.4+50waterfall
2023-06-30 · 386 downloads
EpicGuardWaterfall-7.5.0.jar · 113 KB
7.5.0
release
EpicGuard Paper 7.5.0
1.20.21.20.1foliapaperpurpur
2023-06-30 · 548 downloads
EpicGuardPaper-7.5.0.jar · 117 KB
7.5.0
release
EpicGuard Velocity 7.5.0
1.20.21.20.11.201.19.4+59velocity
2023-06-30 · 408 downloads
EpicGuardVelocity-7.5.0.jar · 145 KB
7.4.1
release
EpicGuard Paper 7.4.1
1.20.11.201.19.41.19.3paperpurpur
2023-05-13 · 476 downloads
EpicGuardPaper-7.4.1.jar · 108 KB
7.4.1
release
EpicGuard Waterfall 7.4.1
1.19.41.19.31.19.21.19.1+47waterfall
2023-05-13 · 147 downloads
EpicGuardWaterfall-7.4.1.jar · 105 KB
7.4.1
release
EpicGuard Velocity 7.4.1
1.201.19.41.19.31.19.2+57velocity
2023-05-13 · 707 downloads
EpicGuardVelocity-7.4.1.jar · 135 KB
7.4.0
release
EpicGuard Waterfall 7.4.0
1.19.41.19.31.19.21.19.1+47waterfall
2023-03-22 · 172 downloads
EpicGuardWaterfall-7.4.0.jar · 2.2 MB
7.4.0
release
EpicGuard Velocity 7.4.0
1.19.41.19.31.19.21.19.1+56velocity
2023-03-22 · 151 downloads
EpicGuardVelocity-7.4.0.jar · 2.2 MB
7.4.0
release
EpicGuard Paper 7.4.0
1.19.41.19.3paperpurpur
2023-03-22 · 191 downloads
EpicGuardPaper-7.4.0.jar · 2.2 MB
7.3.0
release
EpicGuard Waterfall 7.3.0
1.19.41.19.31.19.21.19.1+47waterfall
2023-02-28 · 150 downloads
EpicGuardWaterfall-7.3.0.jar · 3.0 MB
7.3.0
release
EpicGuard Velocity 7.3.0
1.19.41.19.31.19.21.19.1+56velocity
2023-02-28 · 145 downloads
EpicGuardVelocity-7.3.0.jar · 3.0 MB

Show more files (4 more)

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

About

🛡 EpicGuard

A simple AntiBot plugin for newest Minecraft versions.

✅ Supported platforms / Latest release requirements

Paper 1.20.1+ (all paper forks are supported)
Velocity 3.3+
Java 17

✨ Features

A total of 8 configurable antibot checks:
- Geographical check - country/city blacklist or whitelist.
- VPN/Proxy check - configurable services and caching.
- Nickname check - block certain nickname patterns using regex.
- Reconnect check - require re-joining the server with an identical pair of address and nickname.
- Server list check - require pinging the server before connecting (adding it to the server list).
- Settings check - make sure that player sends a settings packet after joining (vanilla client behaviour).
- Lockdown - temporarily block incoming connections if there are too many of them.
- Name similarity check (BETA)
- Account limit.
SQLite/MySQL support.
Live actionbar statistics.
Automatic whitelisting.
Console filter.

📚 Commands & Permissions

To be able to use commands, give yourself the epicguard.admin permission.
On different platforms there are additional aliases available, such as /guardvelocity or /epicguardpaper

Command	Description
/guard help	Displays all available commands.
/guard reload	Reloads config and messages.
/guard whitelist <add/remove> <nick/address>	Whitelist/unwhitelist an address or nickname.
/guard blacklist <add/remove> <nick/address>	Blacklist/unblacklist an address or nickname.
/guard analyze <nick/address>	Displays detailed information about the specified address or nickname.
/guard status	Toggles live attack information on actionbar.
/guard save	Forces save to the database.

🔧 Using EpicGuard API in your project:

The api is not very advanced, and there is not much you can do with it for now.

Gradle (Kotlin)

repositories {
    // Snapshots
    maven("https://s01.oss.sonatype.org/content/repositories/snapshots/")
    // Releases
    mavenCentral()
}
dependencies {
    compileOnly("com.github.4drian3d:epicguard-api:[VERSION HERE]")
}

Gradle (Groovy)

repositories {
    maven {
      url = 'https://s01.oss.sonatype.org/content/repositories/snapshots/'
    }
  mavenCentral()
}
dependencies {
    compileOnly 'com.github.4drian3d:epicguard-api:[VERSION OR COMMIT ID HERE]'
}

Maven

  <repositories>
    <!-- Only for Snapshots-->
    <repository>
      <id>sonatype-oss-snapshots1</id>
      <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
    </repository>
  </repositories>
  <dependencies>
      <dependency>
         <groupId>com.github.4drian3d</groupId>
         <artifactId>epicguard-api</artifactId>
         <version>[VERSION HERE]</version>
         <scope>provided</scope>
     </dependency>
  </dependencies>

Using the API

Make sure that EpicGuard is fully loaded before your plugin.

Click to see the API class

// Importing the API class.
import me.xneox.epicguard.core.EpicGuardAPI;
import me.xneox.epicguard.core.manager.AttackManager;
public class EpicGuardAPIExample {
  // Accessing the EpicGuardAPI instance.
  EpicGuardAPI api = EpicGuardAPI.INSTANCE;
  // Obtaining the AttackManager instance:
  AttackManager attackManager = api.attackManager();
  // Checking if server is under attack.
  boolean isUnderAttack = attackManager.isUnderAttack();
  // checking current connections per second.
  int cps = attackManager.connectionCounter();
  
  // Checking user's country:
  String countryId = api.geoManager().countryCode("127.0.0.1");
}

🕵️ Privacy disclaimers

This plugin connect to various external services, to fully work as intended.
- 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.
- 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.
- IPs and nicknames associated with them are stored in the local database (as plain text(!)).
- This plugin periodically checks the latest version released in this repository. This feature can be disabled.
- There is no metrics system or any other kind of data collection.

This is an updated version of EpicGuard for recent versions of Paper, Waterfall and Velocity.

EpicGuard

Files

7.6.1

7.6.1

7.6.0

7.6.0

7.5.2

7.5.2

7.5.1

7.5.1

7.5.1

7.5.0

7.5.0

7.5.0

7.4.1

7.4.1

7.4.1

7.4.0

7.4.0

7.4.0

7.3.0

7.3.0

About

🛡 EpicGuard

✅ Supported platforms / Latest release requirements

✨ Features

📚 Commands & Permissions

🔧 Using EpicGuard API in your project:

🕵️ Privacy disclaimers