SMART BAN
Back
--------------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, 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.SmartBanKick]
bCenterText=True (True - text
alignment in windows that appear after a ban, kick or ACE-kick in the center)
BannLine1=BANNED
BannLine2=Breaking server rules
or cheats
BannLine3=Admin email:
KickLine1=KICKED
KickLine2=Breaking server rules
or cheats
KickLine3=Admin email:
AceLine1=For play need OS
Windows + ACE anti-cheat installed
AceLine2=Possible problems on
slow computers - need reconnect
AceLine3=Admin email:
NoNameLine1=Access is possible
NonameLine2=by having a correct
name
NoNameLine3=Change name in Player
Setup
[sbnXX.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
bNoLogFiles=False (Info below in LOGS)
bKickLogsOnly=True (Info
below in LOGS)
bNoHWID=False (True - if ACE anti-cheat is not
used on the server, False - if the server uses
ACE anti-cheat and you want to ban players also by ACE HWID)
HWIDWaitTimer=25 (Works if bNoHWID=False. 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.
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 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 anti-cheat
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. When first log in, this will happen after 25
seconds, when first
reconnecting
also after 25 seconds, when other reconnecting – instantly. 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--------------
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_Hwid Received.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..........: 2022.11.07-12.07.32
PlayerName.......: Test
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`
Developer: ProAsm
Idea and Tester: asosed