EpicGuard is a bot protection plugin for Minecraft servers, supporting bukkit, bungeecord and velocity environments. Highly configurable and customizable.
NOTE: This version of EpicGuard is outdated and new updates will not be released here. This version is intended for use on the legacy server and java versions. For the latest releases, see GitHub.
FEATURES
- Total of 8 antibot checks.
- All checks can be configured as you want, you can make them checking every time, only during an attack or disable some of them completely.
- Compatible with Spigot, PaperSpigot (and other forks), BungeeCord, Waterfall (and other forks), and Velocity.
- Block VPNs and proxies, using the proxycheck.io service (or other API, if you want).
- Allow or block specific countries/cities.
- Automatic whitelisting, so real players won't be affected during bot attack.
- Attack status displayed on the action bar.
- Filter unwanted console messages.
- Throttle connections to the server.
- Limit how many nicknames can be used by one IP address.
- Force users to ping the server or add it to their server list.
- Filter player nicknames using regular expressions.
Features unique to the Spigot version of EpicGuard:
These modules can be configured in the "plugins/EpicGuard/spigot.yml" file. Wiki page:
https://github.com/xxneox/EpicGuard/wiki/Spigot-Configuration
- Disable vanilla operator mechanics.
- Block namespaced commands (these which contains ':' symbol, like 'minecraft:me' or 'essentials:say').
- You can set up the list with the Trusted Operators - only people on this list can have operator permissions.
- Block specific commands that you don't want players/staff to execute.
- Configure a list of allowed commands that can regular players execute.
COMMANDS
- /guard - List of all commands.
- /guard stats - Some plugin statistics.
- /guard notifications - Toggle antibot notifications.
- /guard whitelist <adress> - Manually add the specified address to plugin whitelist (Removing from the blacklist if it is).
- /guard blacklist <adress> - Manually add the specified address to plugin blacklist.
- /guard reload - Reload plugin config and messages.
PERMISSIONS
- epicguard.admin - necessary permission for commands, and alerts.
- epicguard.protection.notify - permission to see alerts from OP-protection.
- epicguard.bypass.allowed-commands - allows you to bypass the "allowed-commands" module.
- epicguard.bypass.custom-tab-complete - allows you to bypass "custom-tab-complete" module.
- epicguard.bypass.blocked-commands - allows you to bypass "blocked-commands" module.
- epicguard.bypass.namespaced-commands - allows you to bypass "namespaced-commands" module.
CONFIGURATION
General configuration:
Code (YAML):
# ███████╗██████╗ ██╗ ██████╗ ██████╗ ██╗ ██╗ █████╗ ██████╗ ██████╗
# ██╔════╝██╔══██╗██║██╔════╝██╔════╝ ██║ ██║██╔══██╗██╔══██╗██╔══██╗
# █████╗ ██████╔╝██║██║ ██║ ███╗██║ ██║███████║██████╔╝██║ ██║
# ██╔══╝ ██╔═══╝ ██║██║ ██║ ██║██║ ██║██╔══██║██╔══██╗██║ ██║
# ███████╗██║ ██║╚██████╗╚██████╔╝╚██████╔╝██║ ██║██║ ██║██████╔╝
# ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝
# Created by xNeox (Discord: xNeox#0524)
# SpigotMC: https://www.spigotmc.org/resources/72369/
# Support Discord: https://discord.gg/VkfhFCv
# ╔════════════════════════════════════════════╗
# ║ Geographical Checks ║
# ╚════════════════════════════════════════════╝
# Country check will filter countries your players can connect from.
# NEVER (default) - check is disabled.
# ALWAYS - check will be always performed.
# ATTACK - check will be performed only during bot-attack.
# It is reccomended to ENABLE AND SETUP this check!
country-check-mode
: ALWAYS
# This will define if country-check should be blacklist or whitelist.
# BLACKLIST - countries below are blocked
# WHITELIST - only countries below are allowed
country-check-type
: WHITELIST
# List of country codes: https://dev.maxmind.com/geoip/legacy/codes/iso3166/
country-check-countries
:
- PL
# If some player's city is listed here, he will be blacklisted.
city-blacklist
:
- ExampleCity
# ╔════════════════════════════════════════════╗
# ║ Other AntiBot Checks ║
# ╚════════════════════════════════════════════╝
# Proxy check will define if user is connecting from Proxy/VPN.
# Change this option to save performance or increase accuracy
# NEVER - check is disabled.
# ALWAYS (default) - check will be always performed.
# ATTACK - check will be performed only during bot-attack.
proxy-check
: ALWAYS
# Recommended option!
# Register an account here: https://proxycheck.io/dashboard
# And get your FREE api key.
# Without key - 100 requests/24h
# With key - 1000 requests/24h
# Alternatively, you can set your own service
# at the botton of this configuration.
proxy-check-key
:
"your_key"
# How many accounts can be used
# per one ip address?
max-accounts-per-ip
: 3
# Reconnect check will force users to join the server again.
# NEVER - check is disabled.
# ALWAYS - check will be always performed.
# ATTACK (default) - check will be performed only during bot-attack.
reconnect-check
: ALWAYS
# Server-list check will force users to add your server.
# to their server list (and pinging it) before joining.
# NEVER - check is disabled.
# ALWAYS - check will be always performed.
# ATTACK (default) - check will be performed only during bot-attack.
server-list-check
: ATTACK
# Should every user (except if he is whitelisted)
# be disconnected when there is an bot attack?
# Enable for better protection, disable to allow NEW players during attack.
# DEFAULT: true
attack-deny-join
: true
# Shoud the auto-whitelist feature be enabled?
# Whitelisted players are exempt from every check.
auto-whitelist
: true
# Time in seconds the player must be online
# to be added to the EpicGuard's whitelist.
# Default: 240 (4 minutes)
auto-whitelist-time
: 240
# Rate-limit check will force users to wait some seconds.
# before joining the server again (configurable below).
# NEVER - check is disabled.
# ALWAYS - check will perform on every player always.
# ATTACK (default) - check will perform only during bot attack.
rate-limit-check
: ALWAYS
# How many seconds users will need to wait
# between joining the server again? (See check above).
rate-limit-seconds
: 10
# How many connections per second must be made,
# to activate attack mode temporally?
max-cps
: 6
# ╔════════════════════════════════════════════╗
# ║ Other Settings ║
# ╚════════════════════════════════════════════╝
# If you want to use other proxy/vpn checker
# than default (proxycheck.io), you can set it here.
# Available placeholders: %ip%
custom-proxy-check-url
:
"none"
# How long in minutes responses from proxy check should be cached?
proxy-check-cache-duration
: 30
# Change when the console-filter should be active.
# ALWAYS (default) - always filter console messages
# ATTACK - only filter console messages when there is an active attack
# NEVER - completely disable the console-filter feature.
console-filter-mode
: ALWAYS
# If log message contains one of these words, it will
# be hidden. This can save a lot of CPU on big attacks.
console-filter
:
- GameProfile
- Disconnected
- UUID of player
- logged in
- lost connection
- InitialHandler
# Set to false to disable update checker.
update-checker
: true
# Time in minutes before auto-saving data.
autosave-interval
: 10
# Enabling this will log positive bot detections in the console.
debug
: false
Messages configuration:
Code (YAML):
prefix
:
"&cEpicGuard &8» &7"
no-permission
:
"&cYou don't have permission for this command!"
usage
:
"&cCorrect usage: &6{USAGE}"
whitelisted
:
"&7Succesfully whitelisted address &a{IP}!"
blacklisted
:
"&7Succesfully blacklisted address &a{IP}!"
reload
:
"&7Succesfully reloaded config and messages!"
notifications
:
"&7You have toggled your notifications!"
unknown
:
"&cCommand not found. Use /guard for help."
command-not-in-allowed
:
"&fUnknown command. Type '/help' for help."
blocked-command
:
"&cThis command has been blocked."
operator-disabled
:
"&cOperator mechanics has been disabled on this server."
actionbar-monitor
:
"&cEpicGuard &8» &6%cps% &7connections/s &8| %status%"
actionbar-no-attack
:
"&7No attack..."
actionbar-attack
:
"&cAttack detected!"
kick-message-geo
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYour country/city is not allowed on this server."
kick-message-blacklist
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYour IP address is blacklisted on this server."
kick-message-attack
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cServer is under attack, please wait some seconds before joining."
kick-message-proxy
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYou are using VPN or Proxy."
kick-message-reconnect
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cJoin the server again."
kick-message-account-limit
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYou have too many accounts on your IP address."
kick-message-server-list
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYou must add our server to your servers list to verify yourself."
kick-message-rate-limit
:
-
"&8» &7You have been kicked by &bAntiBot Protection&7:"
-
"&8» &cYou must wait some seconds between joining again."
~~ Adversitiment ~~
Looking for Minecraft server hosting? Try ApexHosting! Click the image below to see more information.
SUPPORT
This version is no longer supported, see notice at the beginning of this page.