SMARTBAN
--------------DESCRIPTION--------------
Smart mod to ban (un-ban), kick and transfer players
in spectator mode.
The player will be banned by IP, by SmartBan ID (SBNID) and if
the server uses ACE anti-cheat (ACE), by ACE HWID.
SmartBan (SBN) has a graphical interface.
--------------UPDATE--------------
Copy the new sbnXX.u (XX - new
version SBN, YY - old version SBN) to games System
folder.
Change the all values sbnYY to sbnXX in the
files:
UnrealTournament.ini, SmartBan.ini, mapvote.ini (the name file may be different
depending on the mapvote you are using)
EXAMPLE:
UnrealTournament.ini:
ServerPackages=sbnYY --> ServerPackages=sbnXX
ServerActors=sbnYY.SmartBanActor --> ServerActors=sbnXX.SmartBanActor
SmartBan.ini:
[sbnYY.SmartBan] --> [sbnXX.SmartBan]
--------------INSTALLATION--------------
Copy files WinClient.u and sbnXX.u (XX - version
mod) to games System folder.
If using ACE anti-cheat on server copy also:
IACEv12.u and sbe12.u for ACE1.2x
IACEv13.u and sbe13.u for ACE1.3x
UnrealTournament.ini:
[Engine.GameEngine]
ServerPackages=sbnXX
ServerActors=sbnXX.SmartBanActor (or as a mutator: sbnXX.SmartBan)
After starting the server, the SmartBan.ini file with the mod settings is
created in the games System folder.
Description of settings:
[sbnXX.SmartBan]
bDebugLog=False
bNoLogFiles=False (Info below in LOGS)
bKickLogsOnly=True (Info below in LOGS)
bNoHWID=False (True - if ACE is not used on the server, False - if the server uses ACE and the ability to ban players also by ACE HWID)
HWIDWaitTimer=10 (Works if bNoHWID=False. This is the time during which SmartBan can receive HWID from ACE and if no HWID – kick player)
bHalfHWIDTimer=False (Works if bNoHWID=False. True - the HWIDWaitTimer is halved if
the player reconnects)
bBypassFiring=False (Works
if bNoHWID=False. False -
HWIDWaitTimer starts after Fire or Typing in chat. True - HWIDWaitTimer starts
immediadley after player joins)
bHideAdmin=False (True - hides broadcast message log in and log out server admin)
bCheckAce=True (Works
if bNoHWID=False. True
- quick check of ACE install on the client without HWID check, if there is no
ACE on the client then started HWIDWaitTimer and if no HWID – kick player)
BannedPlayer[0]=(Admin="",Name="",Id="",HW="",IP="",PC="",dy=0,Reason="")
(Banned player details)
[sbnXX.SmartBanKick]
bCenterText=True
bSmallFont=False
BannLine1=BANNED
BannLine2=Breaking server rules or cheats
BannLine3=Admin:
KickLine1=KICKED
KickLine2=Breaking server rules or cheats
KickLine3=Admin:
NoNameLine1=Access is possible
NonameLine2=by having a correct name
NoNameLine3=Change name in Player Setup
AceLine1=For play need OS Windows + ACE anti-cheat
AceLine2=Also problems - slow computers or bad connection
AceLine3=Admin:
--------------HOW TO USE--------------
1. Log as Administrator
2. To open the SBN graphics window type in console: mutate smartban
3. To record information about current players in the server log type in console: mutate sbninfo or in chatbox !sbninfo
BAN/KICK/SPECTATE:
In the Currents Player column, select the player you want to ban or kick
or transfer in spectator mode and click the corresponding button.
Admin can also ban a player for several days,
then change the value of Ban Days. If Ban Days = 0, then the ban will be
permanent.
Banned player goes to Banned Players column. The kicked player will be
kicked from the server before the end of the current match.
UN-BAN:
In the Banned Players column, select the player you want to un-ban and
click the un-ban button.
MADE SBN ADMIN:
An Options
Tab in the Currents Player column, select the
player you want made SBN admin,
optionally check the box "Allow Banning" and click the "Add New Admin" button. SBN admins goes to Current Admins column.
SETTINGS:
In the Config tab, the admin can change the SBN
settings.
In the Manual Ban tab, the admin can ban player manually.
In the Text
tab, the admin can change text in the window
that kicked players see.
--------------SBN Admin--------------
SmartBan includes the option of appointing up to 10 SBN Admin.
An Options Tab in the Menu is available only to the Server Admin.
Only the Server Admin can select or remove a SBN Admin.
SBN admin open graphics window type in console: mutate smartban
SBN Admin Operations:
1. The SBN Admin can only see the Kick/Ban Menu.
2. The SBN Admin can only Kick a Player or send the Player to Spectate.
3. The SBN Admin can Ban or Un-Ban a Player only if the Server Admin has ticked
the Allow Banning.
4. The SBN Admin is not a Server Admin and does not have any Server Admin
rights.
5. The SBN Admin is always an admin and does not need to login etc.
6. The SBN Admin uses SBNID as his/her login Key.
--------------INFO--------------
If ACE is installed on the server and bNoHWID=False in the SmartBan.ini settings, then players with
Linux/Mac, as well as players with Windows, who closed the ACE installation
window, will be kicked from the server. This is due to the fact that these
players do not have ACE installed and, accordingly, they can
use cheats.
About HWIDWaitTimer:
- If bCheckAce=False recommended value HWIDWaitTimer=35 and above. Result - player will be kicked if SBN does not receive HWID from ACE within 35 seconds. Decreasing HWIDWaitTimer can may result in kicked off players with slower computers or bad connections. Anyway the problem is that SBN does not always get HWID from ACE (ACE bug).
- If bCheckAce=True
recommended value HWIDWaitTimer=2 and bBypassFiring=False. Result - if the
player does not have ACE on client, then after ~2 seconds after closing the ACE installation window he will be kicked.
If a players user.ini has an empty name "Name=" SBN kicks the player
with a window in which text that can be changed in "NoNameLine"
An administrator can get information about a player in the SBN.ini file in the
local System folder by double-clicking the player name in the SBN window.
--------------LOGS--------------
There are two types of logs that will be written (depending on the settings) to the Servers\Logs folder:
1. Player Info – additional info about SBN activities.
Example: [SBN]_2022.11.07-12.15.43_PlayerName_Info.log
2. Player Kick – info about kick or ban.
Example: [SBN]_2022.11.07-12.15.43_PlayerName_Reason.log
If bNoLogFiles=False (Default) in the SmartBan.ini file then "Player Kick"
and "Player Info"
logs will be written.
If bKickLogsOnly=True (Default) in the SmartBan.ini file then only
"Player Kick" logs files
will be written.
These log files will be titled as follows and have contents similar to:
+--------------------------------------------------+
| Player Kick |
+--------------------------------------------------+
Date-Time......: 2024.08.25-20.48.51
PlayerName.....: ramis
PlayerIP.......: 86.100.13.211
SBNID..........: 202314205635172
HWID...........: 13E8579EC80FFA0617A50722F905EDCF
Reason.........: Banned
Computer Name..: DESKTOP9VH8PEG
Times Kicked...: 1
Admin..........:
Server
This indicates that the player tried to connect but was kicked by the Server.
If this was a direct kick initiated by the admin, the Admins name would appear
instead of `Server`
Developer: ProAsm
Idea and Tester: asosed