#------------------------------------------------------------#
# ____ __ _____ __ #
# / __ )____ / /_ / ___/___ ____ / /________ __ #
# / __ / __ \/ __/ \__ \/ _ \/ __ \/ __/ ___/ / / / #
# / /_/ / /_/ / /_ ___/ / __/ / / / /_/ / / /_/ / #
# /_____/\____/\__/ /____/\___/_/ /_/\__/_/ \__, / #
# /____/ #
# ___ __ _ #
# / __\ ___ _ __ / _|(_) __ _ #
# / / / _ \ | '_ \ | |_ | | / _` | #
# / /___| (_) || | | || _|| || (_| | #
# \____/ \___/ |_| |_||_| |_| \__, | #
# |___/ #
# #
# Developed by xDefcon & BlackDemonZyT #
# #
#------------------------------------------------------------#
# This is the default configuration file, we did our best to #
# achieve the settings that could fit almost any network. #
# In some cases, if your network is big for instance, you #
# may have to edit the values and do some tests by yourself #
# in order to find the most suitable way. #
##############################################################
# The name of your server(s) where players do /login and /register commands
auth-lobby:
- "lobby"
# Define that if in X seconds, Y connections are established, it will enable the AntiBot mode.
# You can also change the duration and ActionBar message.
antibot-mode:
seconds: 2
connections: 10
duration: 60
activated-msg: "&a&lAntiBot mode activated."
deactivated-msg: "&c&lAntiBot mode deactivated."
# Configure when an IP should be Banned using the Linux command specified below
# based on their N connection per X seconds.
# Format: "Connections;Seconds"
thresholds:
- "1;1"
- "2;2"
- "3;3"
- "30;60"
- "60;120"
- "75;140"
- "100;200"
# If one of the above criteria is met, then the rate limiter kicks in.
ratelimit:
enabled: true
# Should ban ip via linux command?
ban: true
# If set to true (recommended) the bans will be handled internally to the plugin (local cache and blacklist file)
# This is intended for a quick solution to huge bot attacks or if you don't have access to linux commands through the server.
local-blacklist-only: true
# The LINUX command that will be executed to ban IP addresses internally.
ban-command: "cmd /c netsh advfirewall firewall add rule name=blacklist dir=in interface=any protocol=TPC localport=25565 action=block remoteip={ip}/32"
# The LINUX command that will be executed to unban IP addresses internally.
unban-command: "cmd /c netsh firewall delete rule name=blacklist remoteip={ip}/32"
# Change the delay between unban of each IP (in milliseconds, recommended not to touch)
unban-delay: 75
# Every how many hours should the plugin unban all banned IPs?
reset-banned-hrs: 24
# This section is related to BotSentry checks and algorithms configuration.
# You basically don't need to understand the following, as it could result difficult or not clear.
#
# The default settings are set in order to define whether a client is a BOT or a clean USER.
# BotSentry uses the following to tune-up the detection, please keep those values updated with feature
# releases of the plugin.
#
# If you encounter difficulties or problems with bot attacks, please contact the developer on Discord (preferred).
bot-behaviour:
# The pattern check is enabled when the server starts, it is intended to learn the behaviour of clients and easily
# detecting when a bot attack occurs (in combo with anti-bot-mode). When an attack occurs, this check will be able
# to easily differentiate bots from clean users.
pattern:
enabled: true
tolerance: 7000
tolerance-b: 15000
# Section related to caching some data to improve performances.
# Do not edit this if not asked by the developer.
cache:
enabled: true
max-amount: 50
# This value should never be more than 3500. If you encounter false positives, please contact developers before
# playing with this value.
min-value: 2500
# This section is intended to check, during a bot attack, the number of new connections and compare them with a
# previous recorded "normal-behaviour"
# By default this is disabled as bot-behaviour.pattern is doing all of the needed calculations to avoid bots join.
consistency:
enabled: false
count: 20
delta: 11
# The following should be enabled when "consistency" is enabled too, it compares the previous data over a long period
# and adds some leniency in order to avoid false positives.
collection:
enabled: false
count: 21
leniency: 10
delay: 2000
# Do you want to kick bots from the specified authlobby after banning them via IPTables?
# We suggest to leave this as true, mainly because after blocking an address via firewall, the related connections
# will remain open for some time.
kick-authlobby: true
# The first join check will ask, during a bot attack, all new players to rejoin.
# The kick message will be displayed once ONLY for NEW players.
first-join:
enabled: false
time: 5000
kick-message: "&cWe're under attack&7, &cplease wait atleast &6{seconds} seconds &cbefore rejoining."
whitelist:
# After N seconds of playtime, the player is added to the BotSentry whitelist, and not checked anymore.
seconds-to-play: 120
# This check will limit how many players can play with the same IP address during an attack and not.
max-address:
# Toggle the check
enabled: true
threshold:
# Max ip addresses that are allowed to play in normal conditions
normal: 3
# Max ip addresses that are allowed to play during a bot attack
antibotmode: 1
# The following section will check all incoming connections in order to determine wheter a number of connection could be
# considered as bot attack (similar to "AntiBotMode").
networking:
# This value should be related to the average players' latency. We suggest to leave this as 45, and playing with
# leniency option. This value should never be changed with values over "52".
tolerance: 50
trigger: 2
leniency: 1.26
# Section related to actionbar messages - "botsentry.advice" permission.
actionbar:
# Toggle actionbar notification to admins.
enabled: true
msg: "&8[&a{ip}&8] &7has been detected as a &cBOT"
challenge: "&8[&a{username}&8] &7got kicked for &cCHALLENGE"
challenge-fail: "&8[&a{username}&8] &chas failed &cCHALLENGE"
challenge-success: "&8[&a{username}&8] &ahas passed &cCHALLENGE"
first-join: "&8[&a{username}&8] &7has been kicked for &cFIRST JOIN"
rejoin: "&8[&a{username}&8] &7has been kicked for &cREJOIN"
rejoin-success: "&8[&a{username}&8] &7rejoined &aSUCCESSFULLY"
whitelist: "&8[&a{username}&8] &7joined, he is in the &aWHITELIST"
whitelisted: "&8[&a{username}&8] &7has been &aWHITELISTED"
label: "&8[&a{username}&8] &7got kicked for &cLABEL"
pattern: "&8[&a{username}&8] &7got kicked for &cPATTERN"
collection: "&8[&a{username}&8] &7got kicked for &cCOLLECTION"
consistency: "&8[&a{username}&8] &7got kicked for &cCONSISTENCY"
collection-active: "&a&lCOLLECTION ENABLED"
consistency-active: "&a&lCONSISTENCY ENABLED"
# Section related to title message - "botsentry.advice" permission - sent every 10 seconds during an attack.
title:
enabled: true
title: "&c&lBot Sentry"
subtitle: "&e&l{num} &6&lbots IPTables banned in 10 seconds!"
# The message that is shown every connection to the console.
console-message: "&cBotSentry &7>> &7[&e{ip}&7] [&a{nickname}&7] &6has connected! &7[&eNum. {count}&7]"
# Plugin messages sent to players.
msg:
challenge:
kick-message: "&c[BotSentry] In order to join the server, please complete the following:\n\n {challenges}"
ping: "&a&lCHALLENGE {number}&7: \n&ePing the server in the server list and rejoin."
join: "&a&lCHALLENGE {number}&7: \n&eRejoin the server."
final-join: "&a&lFINAL CHALLENGE&7: \n&aRejoin the server one last time to play."
deny-banned-ip: "&cYour IP is banned from this server. Please contact a staffer if this is an error."
kick: "&6&l[Bot Koruması] &6yakaladım Seni &c&lBOT&6! \n &7Bot Degilsen Lütfen iletişime Gec\n &7Site Adresimiz! \n www.AlphaCraftTR.Net"
unbanning: "&aUnbanning IP addresses (this could take a while)..."
unbanned: "&aUnbanned {count} IP addresses."
reloaded: "&aPlugin reloaded."
insufficient-permissions: "&cInsufficient permissions."
ip-banned: "&aSuccessfully banned IP address."
banning-via-firewall: "&4BotSentry &7>> &aUsing Linux ban command: &b{ip} &7- &aThreshold: &b{threshold}"
toggled-notifications: "&aActionbar and title notifications turned {status}."
help: "&6&m--------------&c &lBOT SENTRY HELP &6&m--------------\n
&b \n
&9Aliases: &b/bs &7& &b/botsentry\n
&b \n
&7/bs advice &8> &eReceive actionbar notifications ingame\n
&7/bs stats &8> &eSee the total banned bots in life period\n
&7/bs ban &a{IP} &8> &eBan the specified IP via IPTables\n
&7/bs unban &a{IP} &8> &eUnban the specified IP via IPTables\n
&7/bs unban &aall &8> &eUnban all banned IPs via IPTables\n
&7/bs amode &aon/off &8> &eToggle the AntiBotMode\n
&7/bs details &8> &eGet info about the plugin\n
&b \n
&6&m-----------------------------------------------"