EpicGuard | Advanced Server Protection [AntiBot & more] 3.8.1

Spigot & Bungee | Advanced server protection package!

  1. MrDiamondPL
    Native Minecraft Version:
    1.15
    Tested Minecraft Versions:
    • 1.8
    • 1.12
    • 1.14
    • 1.15
    Source Code:
    https://github.com/PolskiStevek/EpicGuard
    Contributors:
    iShift (Author), rusekh (Co-Dev)
    Languages Supported:
    English, Polish, Russian
    line.png
    EPICGUARD - ABOUT PLUGIN
    Securing your server is an very important thing, and this resource contains many features, to help your server be safe.

    If you need support, join our official discord server: https://discord.gg/VkfhFCv

    If you want to report issue/bug, do it on our discord or on GitHub issue tracker (We prefer GitHub, as it is easier to manage active issues)

    Supported versions: 1.8*, 1.12, 1.13, 1.14, 1.15(Spigot), BungeeCord (Waterfall, Travertine etc.).

    * 1.8 have strange issues, causing bots to join the server even after they got kicked. We have patched it, so bots can't pass, but this version is really bad at blocking bots. If you don't want to update, try using this plugin on the Bungeecord. Even if this version is like 5 years old - we will still continue to support it.

    line.png

    PLUGIN FEATURES
    • BungeeCord and Spigot (1.8.x - 1.15.x) support.
    • Highly configurable and customizable.
    • Almost no performance impact.
    • Blocking VPN services and proxies.
    • Country filter - allow or block specified countries.
    • Very fast attack detection, you can configure on which connect/ping speed attack will be detected.
    • Automatic whitelisting, so real players won't be detected by antibot, and they can join while bots can't.
    • Firewall commands support.
    • Anti ForceOP/Backdoor - only players added to the exclusive list can have operator permissions (it can also protect from PermissionsEx "*" permission).
    • See every player's address history (if you enabled this module).
    • Block commands that you don't want players/staff to execute.
    • Configure a list of allowed commands that can regular players execute.
    • Display custom tab-completions (on /<tab>), or completely disable tab completion.
    • Manage your server using GUI instead of annoying commands!
    • Filter console messages.
    • Cloud blacklist synchronizing.
    • ActionBar and/or Title notifications.
    line.png
    ~~ Advertisment ~~
    Looking for a good and quality hosting for your server? Try ApexHosting!
    [​IMG]

    Click image above!
    RECOMMENDED PLUGINS
    Spigot:
    • ProtocolLib - Required for block/display custom TabComplete.
    • ExploitFixer - Block many exploits, which can crash your server.
    BungeeCord:
    • QuietCord (Or any other console filtering plugin) - to disable "InitialHandler" console spam, when the server is attacked. The console filter is only working on spigot right now.
    line.png
    COMMANDS & PERMISSIONS
    • /guard - List of all commands.
    • /guard menu - Opens plugin GUI
    • /guard whitelist <adress> - Manually add specified address to plugin whitelist (Removing from blacklist if it is).
    • /guard blacklist <adress> - Manually add specified address to plugin blacklist.
    • /guard status - Toggle antibot notifications.
    • /guard oplist - Better list of opped players.
    • /guard player <player> - Some information about specific player.
    • /guard reload - Reload plugin config and messages.
    • 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.
    line.png
    SCREENSHOTS & VIDEOS
    [​IMG]
    [​IMG]
    line.png
    CONFIGURATION FILES
    Configuration file (this is how it looks on a spigot, bungee version has fewer options)
    Code (YAML):
    ###############################
    ##           Countries       ##
    ###############################

    countries
    :
     # This has three values:
      # WHITELIST = countries listed below CAN join, every other can't.
      # BLACKLIST = countries listed below CAN'T join, every other can.
      # DISABLED = disable this module.
      mode
    : WHITELIST
      # List of country codes:
      # https://dev.maxmind.com/geoip/legacy/codes/iso3166/
      list
    :
       - GB
        - DE
        - PL

    ###############################
    ##           AntiBot         ##
    ###############################

    antibot
    :
     # You can fully disable ALL antibot modules if you don't want them.
      # Disabling antibot will not disable country checking (look above)
      enabled
    : true
      # New players will need to rejoin the server to play!
      force-rejoin
    : false
      # If a player/bot's nickname contains one of the values below, he will be blocked.
      # This SHOULD be lower-case
      name-contains
    :
       - mcstorm
        - mcspam
        - bot
        - proxy
      # HIGHLY RECOMMENDED: Register on https://proxycheck.io/dashboard and get a free API KEY!
      # You can leave it empty, but your protection will be limited.
      # With key - 1000 requests/24h
      # Without key - 100 requests/24h
      api-key
    : "YOUR_KEY"

    ###############################
    ##        Settings           ##
    ###############################

    # Configuration of EpicCloud - synchronizing and calculating
    # between plugin local data, and plugin's cloud, to increase performance.
    cloud
    :
     # Should plugin enable this feature
      enabled
    : true
      # Time in seconds before next sync
      sync-every-seconds
    : 58800
      features
    :
       # Enable synchronizing blacklist (recommended)
        blacklist
    : true
        # Protection Requests.
        protection-req
    : true

    # Heurisitcs check, allows you to detect bots even faster and decrease bypasses,
    heuristics
    :
      enabled
    : true
      # Minimal difference between current attack speed and fastest attack speed detected
      # during current bot-attack. Default value is equal to speed.connection in 'config.yml'.
      # You can experiment with this value, and see what value is best for detecting attacks.
      min-difference
    : 7

    # If console log contains text listed below, it
    # will be hidden. This will decrease CPU usage.
    console-filter
    :
      enabled
    : true
      messages
    :
       - Disconnecting
        - lost connection
        - authlib
        - GameProfile

    # If a player doesn't send MC|Brand packet within the time provided below (delay) after joining,
    # he will be kicked. Normal clients send this packet after join, but bots don't.
    # WARN: Disable this if you have issues! (eg. when using ViaVersion or ProtocolSupport).
    channel-verification
    :
      delay
    : 40
      enabled
    : true
      punish
    : "kick {PLAYER} &cException occurred in your connection, please rejoin!"
    # If a player sends MC|Brand packet with a value listed below, he will be kicked.
    # Normal (Vanilla) clients use 'vanilla'
    blocked-brands
    :
      enabled
    : true
      punish
    : "kick {PLAYER} &cYour client is not allowed on this server!"
      list
    :
       - some_blocked_brand

    updater
    : true
    ###############################
    ##           Advanced        ##
    ###############################
    # You SHOULD configure it, to fit your server's player amount.
    # If you have small server, don't change it, or change it to smaller values

    speed
    :
     # How many connections per second should be made, to block connections to the server.
      # Whitelisted players still can join, if CPS is below this value, connection blocking will be disabled.
      # If deny-join is triggered, Proxy/VPN checking is skipped.
      connection
    : 7
      # How many pings per second should be made to block connections to the server.
      ping-speed
    : 10
      # How many successful joins per second should be made to block connections to the server
      join-speed
    : 5
      # Time (in ticks) before the antibot will disable.
      attack-timer-reset
    : 800

    # Block tab-complete packet using ProtocolLib.
    # Useful when using a multi-version server, because 1.13+ players
    # receive different packet than older version players.
    fully-block-tab-complete
    : false

    # When the server is attacked with PING method, server
    # MOTD and player slots, won't be displayed to optimize bandwidth
    bandwidth-optimizer
    : true

    auto-whitelist
    :
     # Enable automatic player whitelisting.
      # When a player is whitelisted, all checks are skipped (like a Proxy check).
      # Whitelisted players can join even when ATTACK_MODE is activated.
      enabled
    : true
      # How much time (in ticks), the player should be online to be added to the whitelist.
      # 20 ticks = 1 second
      time
    : 8400

    ###############################
    ##     Server Protection     ##
    ###############################

    ip-history
    :
      enabled
    : true

    op-protection
    :
      enabled
    : false
      # EXPERIMENTAL: Protection from backdoor using PermissionsEx "*" permission.
      # Enable this if you are using PEX plugin and you want additional protection.
      pex-protection
    : false
      # Permission to see alert: epicguard.protection.notify
      alert
    : "&cPlayer &6{PLAYER} &chas been banned for Force-OP."
      command
    : "ban {PLAYER} Force-OP"
      # List of players who can have OP
      list
    :
       - "Admin"

    # If someone tries to execute command listed here,
    # event will be canceled, and the player will see a custom message
    # defined in messages.yml

    command-protection
    :
      enabled
    : false
      list
    :
       - /op
        - /stop

    # If someone tries to execute a command not listed
    # in this module, and does not have bypass permission,
    # event will be canceled, and custom message will be shown

    allowed-commands
    :
      enabled
    : false
      # Permission for bypass this module.
      # Everyone with the permission below can use any command.
      bypass
    : "epicguard.command.bypass"
      # If someone execute command not listed below,
      # without permission to bypass, will get custom message
      # defined in messages.yml
      list
    :
       - /msg
        - /home

    ###############################
    ##           Firewall        ##
    ###############################

    firewall
    :
     # Don't use on free/shared hosting!
      # You need a private machine with IPTables (or something else) installed.
      enabled
    : false
      # Executed in /guard blacklist <player> OR while the player was detected as a BOT
      command-blacklist
    : "iptables -A INPUT -s {IP} -j DROP"
      # Executed in /guard whitelist <player>
      command-whitelist
    : "iptables -D INPUT -s {IP} -j DROP"
    Messages file:
    Code (YAML):
    # SpigotMC Link: https://www.spigotmc.org/resources/72369/
    prefix
    : "&8[&2EpicGuard&8] "
    actionbar
    :
      attack
    : "&8(&c&lBOT DETECTION&8) &6{NICK} &8[&c{IP}&8] &8| &7Detected for: &b{DETECTION}"
    attack-title
    :
     # {MAX} - Number of blocked bots during last attack.
      # {CPS} - Connections Per Second.
      title
    : "&cSERVER IS BEING ATTACKED &8[&6{CPS}/s&8]"
      subtitle
    : "&7Working... &b{MAX} bots &7blocked during last &e{TIME} seconds..."
    other
    :
      history-new
    : "&7Player &e{NICK} &7connected with &fNEW&7 IP Adress &8(&6{IP}&8)&7!"
      no-permission
    : "&cYou don't have permission! If you think this is an issue, report this to administrators."
      # This option is only one here
      # without "prefix" added before it!
      not-allowed-command
    : "&fUnknown command. Type /help for help."
      blocked-command
    : "&cThis command is blocked!"
    kick-messages
    :
      proxy
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7Our systems have detected, that you are using Proxy or VPN."
        - "&7Please disable VPN programs, and join server."
        - " "
        - "&7If you think this is an issue, contact our staff."
      blacklist
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7You have been detected, with following reason:"
        - " &8-> &cYour IP has been blacklisted on this server."
        - " &8-> &cBLACKLIST_DETECTION"
        - " "
        - "&7If you think this is an issue, contact our staff."
      attack
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7Our server is being attacked."
        - "&7Please wait some minutes before connecting."
        - " "
        - "&7If you think this is an issue, contact our staff."
      country
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7You have been detected, with following reason:"
        - " &8-> &cYour country is not allowed on our server."
        - " &8-> &cCOUNTRY_DETECTION"
        - " "
        - "&7If you think this is an issue, contact our staff."
      namecontains
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7You have been detected, with following reason:"
        - " &8-> &cYou are probably a bot, change your nickname."
        - " &8-> &cNAME_CONTAINS"
        - " "
        - "&7If you think this is an issue, contact our staff."
      rejoin
    :
       - "&8(&c&lANTIBOT DETECTION&8)"
        - " "
        - "&7You have been detected, with following reason:"
        - " &8-> &cPlease join server again to verify your connection."
        - " &8-> &cVERIFY"
        - " "
        - "&7If you think this is an issue, contact our staff."
    Translations: ru_RU, pl_PL
    line.png
    STATISTICS (SPIGOT)
    [​IMG]
    (Click image to view full page)
    line.png
    STATISTICS (BUNGEE)
    [​IMG]

    (Click image to view full page)
    line.png
    Arny and Jayy47 like this.

Recent Reviews

  1. wormecode
    wormecode
    5/5,
    Version: 3.7.0
    Absolutely awsome, antibot protaction working pretty good for a free plugin, Features very unusual and useful, thenks so match for perfect job!
  2. Xanter
    Xanter
    3/5,
    Version: 3.6.0
    1. MrDiamondPL
      Author's Response
      Thanks for the review, fixed on the latest version! :)
  3. nikv2
    nikv2
    5/5,
    Version: 3.6.0
    Best anti-bot out there! easy to configure and blocks any type of anti bot attack, Highly recommended for production servers ! Please keep updating!
  4. Khax_Bridge
    Khax_Bridge
    5/5,
    Version: 3.5-b1
    Forgive me for commenting that this is really one of the few good plugins! Because I don't have to adjust the configuration of players!
  5. dinoboss2001
    dinoboss2001
    5/5,
    Version: 3.4.0-b1
    TIENE FUTURO LE FLATA TRABAJO DE ERRORES PERO ESTA BASTANTE BIEN UN SALUDO . Y GRACIAS POR TRAER ALGO NUEVO A SPIGOT.
  6. icansc187
    icansc187
    1/5,
    Version: 3.3.0-b2
    Whitelist country indonesia not working sir help me
    [10:49:59 INFO]: [EpicGuard] Exception occurred in Tereliye's connection!
    [10:49:59 WARN]: handleDisconnection() called twice
    1. MrDiamondPL
      Author's Response
      You didn't even contacted me, how can I help you then? Please disable 'channel-verification' in brand.yml file. If you have any other problems or questions, just contact me. Join my discord server, if you don't have discord, then just PM me here on spigotmc.
  7. wormecode
    wormecode
    5/5,
    Version: 3.2.0
    EpicGuard grant really good protaction aganist bot for a free plugin. It s really good feature, that this plugin blockonly bots and not effect players like AntiBotUltra. Keep up good work!
  8. Nemezis
    Nemezis
    5/5,
    Version: 3.0.2
    Very good plugin. The plugin blocked many bots attacks. PlayerLogger is the best!
  9. OR3O
    OR3O
    2/5,
    Version: 3.0.0
    Everything works apart from the "antibot" part of the plugin, all it does is show the alert message without actually kicking the player or doing anything else.

    https://imgur.com/a/ZkJNnWa (this was from about 5 minutes)
    1. MrDiamondPL
      Author's Response
      I think you need to configure plugin correctly to block bot attacks. I tested default configuration before release, and attack was blocked. Remember, that this plugin can't block very fast bot attacks (like mcspam, mcstorm) because for this type of attacks, antibot need to be used on bungeecord, and this plugin was designed in small servers in mind.
  10. Awe3someBozZ
    Awe3someBozZ
    2/5,
    Version: 2.0.0
    My server lagg when my friend bot my server

    Can you fix it

    Its very nice when you fix the bug
    1. MrDiamondPL
      Author's Response
      Can you send me information about your server (ram amount etc) and how many bots is joining, so i can help you with configuring this plugin?