SMART BAN
--------------DESCRIPTION--------------
Mod to ban (un-ban), kick and transfer players in spectator mode.
The player will be banned by IP, by SmartBan IDs and, if the server uses ACE
1.2x anti-cheat, by ACE HWID.
SmartBan (SBN) has a graphical
interface.
--------------UPDATE--------------
Copy the new sbn12X.u (X - new version SBN, Y - old version SBN) to games System folder.
Change the all values sbn12Y to sbn12X 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=sbn12Y --> ServerPackages=sbn12X
ServerActors=sbn12Y.SmartBanActor --> ServerActors=sbn12X.SmartBanActor
SmartBan.ini:
[sbn12Y.SmartBan] --> [sbn12X.SmartBan]
--------------INSTALLATION--------------
Copy files WinClient.u, IACEv12.u and sbn12X.u (X - version mod) to games System folder.
NB: The IACEv12.u needs to be in the servers System folder, whether you use ACE or not.
UnrealTournament.ini:
[Engine.GameEngine]
ServerPackages=sbn12X
ServerActors=sbn12X.SmartBanActor (or as a mutator: sbn12X.SmartBan)
After starting the server, the SmartBan.ini file with the mod settings is
created in the games System folder.
Description of settings:
[sbn12X.SmartBanKick]
bCenterText=True (True - text alignment in windows that appear after a ban, kick or ACE-kick in the center)
[sbn12X.SmartBan]
AdminEmail= (The email field that will be displayed to players after a
ban or kick. If the field is empty then email for contact will be taken from
UnrealTournament.ini)
bDebugLog=False
bUseACE=False (False - if ACE anti-cheat is not used on the server, True - if the server uses ACE anti-cheat and you want to ban players by ACE HWID)
bNoLogFiles=False (info below in Logs)
bKickLogsOnly=True (info below in Logs)
HWIDWaitTimer=25 (Works if bUseACE=True. This is the time allowed for a ACE player to be scanned by ACE before sending the HWID key to SmartBan. Decreasing HWIDWaitTimer may result in kicked off players with slower computers.)
BannedPlayer[0]=(Name="",Id="",RT="",HW="",IP="")
(Banned player details)
BannedPlayer[1]=(Name="",Id="",RT="",HW="",IP="")
BannedPlayer[2]=(Name="",Id="",RT="",HW="",IP="")
............
BannedPlayer[100]=(Name="",Id="",RT="",HW="",IP="")
--------------HOW TO
USE--------------
1. Log as Administrator or StealthAdmin
2. To open the SBN graphics window type in console: mutate smartban
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.
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.
SETTINGS:
In the CONFIG tab, the admin can change the SBN settings.
--------------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 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 his HWID (Ace Server) or SBNID as his/her login Key.
--------------INFO--------------
If ACE 1.2x is installed on the server and bUseACE=True 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. When first
log in, this will happen after 25 seconds, when reconnecting - after 5 seconds.
This is due to the fact
that these players do not have ACE anti-cheat installed and, accordingly, they can use cheats.
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--------------
If the Admin has bNoLogFiles=False (Default) in the SmartBan.ini file then several log files will appear in the Servers\Logs folder.
Whereas if bKickLogsOnly=True (Default) in the SmartBan.ini file only kick/ban/no ace information will be logged.
These log files will be titled as follows: [SBN]_2022.11.07-12.14.43_Nickname_Reason.log and have contents similar to:
-------------------------------------------------------------------------
Player Kick
-------------------------------------------------------------------------
Date-Time..........: 2022.11.07-12.07.32
PlayerName.......: Nolly
PlayerIP.............: 192.168.8.189
SBNID..............: 20226201057536
HWID...............: F413F294AF86A5AF524CB4DB808D82E4
Reason..............: Kicked
Times Kicked...: 3
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` and the title may be `Player Info`
Developer: ProAsm
Idea and Tester: asosed