SMARTBAN
--------------DESCRIPTION--------------
Smart mod to ban (un-ban), kick, mute (un-mute) and transfer players in
spectator mode.
SmartBan (SBN) supports ACE ID
(HWID).
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)
bHideAdmin=False (True - hides broadcast message log in
and log out server admin)
bNoHWID=False (False - if ACE is installed on the
server, then ACE HWID will be used for ban)
bCheckAce=True (Works if bNoHWID=False. True - the player will be kicked if he does not install
ACE)
bLogAceInst=False (Info below in LOGS)
bKickEmptyName=True (True - The player will
be kicked if he has an empty name in user.ini or has not changed it after a
clean installation of UT)
BannedPlayer[0]=(Admin="",Name="",Id="",HW="",IP="",PC="",dy=0,Reason="") (Banned player details)
-
Admin – name of the admin who banned the
player;
-
Name – name of the banned player;
-
Id – unique id (SBNID);
-
HW – unique ACE ID (HWID);
-
IP;
-
PC – PC name;
-
dy – number of days the player
is banned (if 0, then infinite);
-
Reason – ban reason.
[sbnXX.SmartBanMuted]
MutedPlayers[0]=(Name="",Id="",HW="",PC="",IP="",Reason="") (Muted player details)
[sbnXX.SmartBanKick]
bCenterText=True
bSmallFont=False
BannLine1=BANNED
BannLine2=Breaking server rules or cheats
BannLine3=
KickLine1=KICKED
KickLine2=Breaking server rules or cheats
KickLine3=
NoNameLine1=Access is possible
NonameLine2=by having a correct
name
NoNameLine3=Change name in Player
Setup
AceLine1=FOR PLAY NEED:
AceLine2=1. OS WINDOWS or WINE
AceLine3=2. ACE (AntiCheatEngine)
install
[sbnXX.SmartBanAdmin]
SBNAdmin[0]=(Name="",Key="",bBan=False) (Admin
details)
--------------HOW TO USE--------------
1. Log as Server Admin.
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/MUTE/SPECTATE:
In the Current Player column, select the player you want to ban, kick,
mute 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.
In the Reason field can specify the reason for the ban, kick, etc.
Banned player goes to Banned Players column. The kicked player will be
kicked from the server before the end of the current match. Muted players
remain in the Current Players
column, but their color will be blue.
UN-BAN:
In the Banned Players column, select the player you want to un-ban and
click the un-ban button.
UN-MUTE:
In the Current Players column, select the player you want to
un-mute and click the un-mute button.
MADE SBN ADMIN:
In Admins tab in the Current Players
column, select the player you want made SBN Admin and click the "Add
Admin" button. SBN Admins goes to Current Admins column.
SETTINGS:
In the Configs tab, the Server Admin can
change the SBN settings.
In the Manual tab,
the Server Admin can ban or mute player manually.
In the Text tab, the Server Admin can change text in the window that kicked, banned, etc players
see.
--------------SBN ADMIN--------------
SmartBan includes the option for 10 SBN Admin.
Only the Server Admin can add or remove a SBN Admin.
By default, the SBN Admin does not have the Ban Rights. Server Admin can toggle
ban rights using the Ban Rights button.
SBN admin open graphics window type in console: mutate smartban
SBN Admin Operations:
1. The SBN Admin can only see the main tab Ban/kick.
2. The SBN Admin can only Kick, Mute, Un-Mute or send the Player to Spectate.
3. The SBN Admin can Ban or Un-Ban a Player only if have Ban Rights.
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--------------
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.
For manual ban/kick (when it is
impossible to catch a player online) it is possible to use the server log. Open
the log and find the player data there, example:
SmartBan: PlayerFirstLogin - Name = Jedrex
| SBNID = 2024111523835597 | PCName = DESKTOP8UA49DM
| IP = 81.30.129.62 | ACE = True | Time = 23.12.12
SmartBan: UpdatePlayerHWID
- Name = Jedrex | HWID =
E992897ED72EDDDE4C5969C06353400E | Time = 23.12.17
If use the bCheckACE=True
option, it means that SBN will check the ACE installation on the client and
kick the player if he closes the ACE installation window and decides to
continue playing. Also this means that players with Linux (without use WINE)
and MAC will always be kicked from the server, since ACE does not support these
OS.
Color players in
window:
Green – admins;
Black – regular players;
Red – banned players;
Purple – spectators;
Blue – muted players.
--------------LOGS--------------
If bNoLogFiles=False
the logs will be written to the Logs folder.
Example:
[SBN]_2022.11.07-12.15.43_PlayerName_Banned.log
[SBN]_2022.11.07-12.15.43_PlayerName_Kicked.log
[SBN]_2022.11.07-12.15.43_PlayerName_Muted.log
[SBN]_2025.05.12-16.34.34_ PlayerName
_Added_Admin.log
[SBN]_2022.11.07-12.15.43_PlayerName_ACE_not_Installed.log
[SBN]_2025.05.12-16.29.12_ PlayerName
_ACE_HWID_Received
etc
If bLogACEHWID=False
the logs ACE_not_Installed and ACE_HWID_Received
not will be written to the Logs folder.
Log inside example:
+--------------------------------------------------+
|
Player Info
|
+--------------------------------------------------+
Date-Time......: 2025.05.12-16.29.24
Player....: Gamer
PC........: PCHOME
IP..........: 10.11.27.231
SBNID..: 2025430144346596
HWID....: 7A6F734D5F4A6E8207797A51B909966F
Reason...: Kicked
Admin....: asosed
Admin Key......: 2025430144346596
Developer: ProAsm
Idea and Tester: asosed