🚧️ Maintained fork can be found at: https://github.com/4drian3d/EpicGuard
🛡 EpicGuard 
A simple AntiBot plugin for newest Minecraft versions.
✅ Supported platforms / Latest release requirements
- Paper 1.17+ (all paper forks are supported)
- Velocity 3.0+
- BungeeCord (Waterfall required fork)
- 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 similiarity 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. |
⚠️ Current state of the project
I (xxneox) am basically the only maintainer of this project. I don't have time to work on it anymore, so it's only getting bugfixes and important changes. Support is only given for important issues. This repository might get archived at any time.
🔧 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 (Groovy)
```groovy repositories { maven { url = 'https://jitpack.io' } } dependencies { compileOnly 'com.github.xxneox:EpicGuard:[VERSION OR COMMIT ID HERE]' } ```Gradle (Kotlin)
```kotlin repositories { maven("https://jitpack.io") } dependencies { compileOnly("com.github.xxneox:EpicGuard:[VERSION OR COMMIT ID HERE]") } ```Maven
```xmlUsing the API
Make sure that EpicGuard is fully loaded before your plugin. [Click to see the API class](https://github.com/xxneox/EpicGuard/blob/master/core/src/main/java/me/xneox/epicguard/core/EpicGuardAPI.java) ```java // 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.
- Maxind'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.