BackNext

  Configure Bec

  This documentation is written with Bec 1.606 in mind. if youre using older versions, some of the setting might not work or have been changed.

  Bec is not limited to one server, but for each arma server a config file is needed.
  Lets start looking at a example file and go though it step by step.


  This File must be saved in the Config Directory.

C:\ServerTools\Bec\Config\Config.cfg



  Full Config Example

[Bec]
Ip = 127.0.0.1
Port = 2302
BePath = C:\SC1\Battleye
Admins = Admins.xml
Commands = Commands.xml

# Optional
[Misc]
AutoLoadBans = True
Ban = 3
BeCustomBanFiles = file1.txt, file2.txt
AsciiNickOnly = False
AsciiChatOnly = True
IgnoreChatChars = €,£,æ,Æ,ø,Ø,å,Å
NickFilterFile = C:\Path\BadNames.txt
WordFilterFile = BadWords.txt
WhiteListFile = WhiteList.txt
WhiteListKickMsg = Please contact us on our TS3 to be able to play here!!!
Warnings = 3
ServerExeName = myAwesomeServer.exe
ConsoleHeight = 65
ConsoleWidth = 130
Timeout = 40
KickLobbyIdlers = 300
Scheduler = Scheduler.xml
MinPlayerNameLenght = 3
MaxPlayerNameLength = 16
DisallowPlayerNameChars = [](){}<>/\^¨|§!"'#¤%&@£$€
ChatChannelFiles = true
SlotLimit = -1
SlotLimitKickMsg = The Server has reached its player limit.

# Optional
[ChatRestriction]
Global = 2
Side = -1
Group = -1
Vehicle = -1
Command = -1
Commander = -1
Direct = -1

# Optional
[ChatSpam]

Lobby = 0
Lobby_Time_Lower = 0
Lobby_Time_Upper = 0
Global = 0
Global_Time_Lower = 0
Global_Time_Upper = 0
Side = 0
Side_Time_Lower    = 0
Side_Time_Upper    = 0
Group = 0
Group_Time_Lower = 0
Group_Time_Upper = 0
Vehicle    = 0
Vehicle_Time_Lower = 0
Vehicle_Time_Upper = 0
Command = 0
Command_Time_Lower = 0
Command_Time_Upper = 0
Commander = 0
Commander_Time_Lower = 0
Commander_Time_Upper = 0
Direct = 0
Direct_Time_Lower = 0
Direct_Time_Upper = 0

# Optional
[Reporter]
User = username
Password = password


   

  Minimal Config Example

[Bec]
Ip = 127.0.0.1
Port = 2302
BePath = C:\SC1\Battleye
Admins = Admins.xml
Commands = Commands.xml 

 

 Real Life Config Example

[Bec]
Ip = 127.0.0.1
Port = 2302
BePath = c:\Server_1\Battleye
Admins = Admins.xml
Commands = Commands.xml

[Misc]
AsciiChatOnly = True
Timeout = 60
KickLobbyIdlers = 500


 
Explaining the options in each block

 [Bec]

  In the [Bec] block we define Rcon parameters such as Ip, port etc. All are needed for Bec to work.

  Ip = x.x.x.x
  if you can not use 127.0.0.1, set the ip to your game server.

  Port = int
  This is the port the game server is running on.

  BePath = string
  Set the full path to your Battleye directory for you current profile setup.
  This means the path to where your BeServer.cfg and bans.txt is located.
  If you have used -profiles or -bepath as startup parameters on your server you need to point it to that dir.

  Example:
  This is how arma is started.

  "C:\arma 2\arma2oaserver.exe" -config=C:\Server-1\serveroa.cfg -cfg=C:\Server-1\arma2oa.cfg -profiles=C:\Server-1 -port=2302

  You can see that -profiles is used and its pointing to another directory. this means my BePath needs to be like

BePath = c:\Server-1\BattlEye

 

  Admins = file.xml
  This is the file where you define your admin and the group level on your admins.
  This file does not need to be named Admins.xml. but to make it more understandeble, we call it Admins.xml for now.
  If you do not set full path to this file. it will look in the Config directory 1st.

  Valid methodes:

  Admins = Admins.xml
  Admins = C:\some\path\Admins.xml
  Admins = \some\path\Admins.xml

  Note. if last methode is used. Bec needs to be located on the same partition.
  Note. two server may use same admin file, but not same config file.

  Commands = file.xml
  This is the file where you create your commands.
  Set custom names and group level in this file.
  This file does not need to be named Commands.xml. but to make it more understandeble, we call it Commands.xml for now.
  If you do not set full path to this file. it will look in the Config directory 1st.

  Valid methodes:

  Commands = Commands.xml
  Commands = C:\some\path\Commands.xml
  Commands = \some\path\Commands.xml

  Note. if last methode is used. Bec needs to be located on the same partition.
  Note: two server may use same Commands file, but not same config file.


 [Misc]

This Block is optional with 1 exception. In cases where you have renamed your exe file and need to use ServerExeName.

  AutoLoadBans = bool
  Auto run loadbans when ban file(s) changes if set to 1.
  1 or True will turn it on.
  0 or False will turn it off.
  If this parameter is not defined it will use False as default.

  Ban = int
  This parameter will define if you will ban people for GameHack, BattlEye Hack, Both or No banning at all
  You need to spesify the value in range 0 til 3

  0 = No ban will occure on GameHack or BattlEye Hacks
  1 = Will only ban on GameHacks
  2 = Will only ban BattlEye Hacks
  3 = Will ban both GameHack and BattlEye Hacks.

  Note: If you have a reporer account and use it. you will still report in GameHacks & BattlEye Hacks regardless of your setting.
  However, when you check guid's against the database. it will only kick out people according to you setting.
  This means, if you have set it to value 1. people caught for battleye hacks will be able to join your server.


  If the parameter is not define. Bec will use value 3 as default.

  BeCustomBanFiles = file1.txt, file2.txt
  Set the names of your custom ban files, Separate each file with "," (comma): file1.txt, banfile2.txt, newfile.txt
  If you do not use any custom ban files. delete this option or leave this option commented.
  This option will check ban files for changes and automatic do a loadbans file when a file gets changed
  Do not specify the default bans.txt file here.
 
  AsciiNickOnly = Bool
  If this is enabled, Bec will auto kick all players who connects with none ASCII chars in their nickname.
  Kick happens instant on connect.
  If this parameter is not defined, AsciiNickOnly will be set to False by default

   AsciiChatOnly = Bool
  A warning will be send to the player who does not use Ascii on chat.
  You will need to set parameter Warnings to 0 or higher for this option to work.
  If this parameter is not defined, AsciiChatOnly will be set to False by default.

  IgnoreChatChars = String
  This Option will only work if AsciiChatOnly is set on.
  Add in chars/symbols that is not listed in the ASCII table.
  Example you might want to have no German/Russian chars. but Norwegian,  then you can do it like.

  AsciiChatOnly = True
  IgnoreChatChars = £,€,æ,Æ,ø,Ø,å,Å

  You might also add in some other symbols that are not in the ascii table. such as £€ or any other that comes into your mind.
  To see which symbols are in the ascii table. check the wiki about ascii table
  Remember to seperate each char with a ,

  Note: do save the config file as UTF8  when setting none ASCII chars on this parameter,
  its reccomended that you use a proper editor like Notepad++

  NickFilterFile = Path
  Here you can define player names you do not want to allow on your server.
  If a players nick matches any lines in the file, he will be auto kicked upon connection
  If this parameter is not defined, NickFilterFile will be disabled by default.
  If you do not set full path to this file. it will look in the Config directory 1st.

  Valid methodes:

  NickFilterFile = BadNames.txt
  NickFilterFile = C:\some\path\BadNames.txt
  NickFilterFile = \some\path\BadNames.txt
  Note. if last methode is used. Bec needs to be located on the same partition.

  WordFilterFile = Path
  Here you can define words you do not allow on your chat.
  If a players chat matches any lines in the file, he will be sent a warning.
  You will need to set parameter Warnings to 0 or higher for this option to work.
  Auto Kick will happen when he|she reaches the set value.
  If this parameter is not defined, WordFilterFile will be disabled by default.

  Valid methodes:

  WordFilterFile = BadNames.txt
  WordFilterFile = C:\some\path\BadWords.txt
  WordFilterFile = \some\path\BadWords.txt

  Note: if last methode is used. Bec needs to be located on the same partition.

  WhiteListFile = Path
  In this file you define player guids, One guid per line.
  Only players listed in this file will be able to play on the server
  Players who are not listed in this file will be kicked from the server.

  WhiteListKickMsg= string
  Here you can set the kick message for players who are not whitelisted on your server

   Warnings = Int
  This is the number of warning a player should get before autokick happens.
  There are 3 functions that uses this parameter.

  1 * AsciiChatOnly
  2 * WordFilterFile
  3 * Warn "command in Commands.xml file"

  Example of reply message from Bec:
  22:21:24 : (Global) SomeDude:fucking noob.
  22:21:25 : RCon admin #0: (To SomeDude) Watch your language. Warnings left:2

  Set this to -1 to diable warnings/warnkick functions.
  1 * AsciiChatOnly
  2 * WordFilterFile
  3 * Warn "command in Commands.xml file"

  Setting the value to 0 means Instant kick without warning.
  The player will then only get a message on the kick reason why kick happened.
  Also take a note, the command "warn" in Commands.xml will only work if this value is set higher than 0.
  Since there is no point in sending a warning when the value is 0 "instant kick". We use !kpl or other names you defined.

  Note: if you do not define this parameter. it will be det to -1 by default.
  All 3 depending functions will then be disabled by default.

  ServerExeName = name.exe
  This is only used in cases where you have renamed your arma server exe files.

  ConsoleHeight = int
  Set the height of Bec's console window.

  ConsoleWidth = int
  Set the width of Bec's console window.

  Timeout = Int
  If your server for some reason needs longer than 30 seconds to start up.
  You can then set custom timeout with this parameter.
  Timeout = 60
  The number is set in seconds.

  KickLobbyIdlers  = Int
  Auto kick lobby idlers who take up a slot without playing. lowest timeout value is 180 sec.
  If you set this to 0 it will be disabled or if you don't define this parameter at all it will be ignored.

  KickLobbyIdlers = 300
  This will kick a player who has been idling in the lobby for 300 sec. 5min
  Value is set in seconds.

  Scheduler = file.xml
  Set the path to your schedule file.

  Valid methodes:

  Scheduler= Scheduler.xml
  Scheduler= C:\some\path\Scheduler.xml
  Scheduler= \some\path\Scheduler.xml

  Note: if last methode is used. Bec needs to be located on the same partition.
  For more info about this. read the Setting up the Scheduler page

  MinPlayerNameLength = Int
  Set the min lenght a player name can have.
  Players connecting with a name shorter than defined in this parameter will be kicked from the server.

  MaxPlayerNameLength = Int
  Set the max lenght a player name can have.
  Players connecting with a name longer than defined in this parameter will be kicked from the server.

  DisallowPlayerNameChars = String
  Limits chars a player can have in the nick

  DisallowPlayerNameChars = [](){}<>/\^¨|§!"'#¤%&@£$€
  Players connecting and have any chars set in this parameter in their player name will be kicked from the server.

  ChatChannelFiles
  If enabled. it will create additional chat files. once for each channel.
  Files will only be created if there is chat in channels.

  SlotLimit
  Set the amount of Normal players who can connect. Set it to -1 to disable it.
  If set to 0 it means only players who are listed in the Admins.xml, (or whatever you call it) will be able to connect to the server.
  Quick Example 1: server can holed 50 players. and you want to reserve 5 slots for admins. then set SlotLimit to 45.
  Quick Example 2: server can holed 50 players. and you want to reserve 5 slots for admins and 5 slots for friends. then set SlotLimit to 40,
  AND edit your admins.xml. ADD in all your frineds guid and remaining data, put them in group example 100. or whatever you feel likt.
  by using this method you can give some of your friends some access to some commands if you like.
  in general this is works like .Whitelisting X player slots for admins and friends, while leaving the remaining Y slots for public.

  SlotLimitKickMsg
  Set the kick message players will get when the SlotLimit has reached its limit.


 [Reporter]

  In the [Reporter] block we add in account data so that GameHacks & Battleye Hacks gets automatically reported to a central ban database.
  You will need an account for this to work. You can signup here for a reporter account.
  If you don't have one or don't want to create one, just remove this block since its fully optional.
 
  If its enabled it will also check Ban/status on a Guid.
  Every player that connects is checked against the database when this is enabled.

  If a guid check returns as a bad guid. "listed guid" the player will be auto kicked and the guid automatically added to your bans.txt file

  User = string
  Add in your account name to the central ban database.

  Password = string
  Add in your password to the central ban database.


 [ChatRestriction]
 

  Here you can set max message that is allowed for each channel.
  If you want to restrict usage of example global chat.

  [ChatRestriction]
  Global = int

  Global = 10
  This will autokick a player after the 10th message in global channel.
  Setting the value to 0 means instant kick..
  Setting the value to -1 means its disabled.

  The player will receive Warning's when typing in the global chat.

  [ChatRestriction]
  Global = 10
  Side = -1
  Group = -1
  Vehicle = -1
  Command = -1
  Commander = -1
  Direct = -1

  Is the same as:

  [ChatRestriction]
  Global = 10
 
  So if you don't need any channels to be restricted. you can delete the hole block [ChatRestriction]
  Note: This is will not use the Warnings Parameter for its counter.


 [ChatSpam]


 
  Set max amount of chat lines per channel allowed within given time frame. (seconds)
  Set the values to 0 to disable this function(s)

  Quick Example:
  Lobby = 5
  Lobby_Time_Lower = 10
  Lobby_Time_Upper = 15

  If the time between each new chatlines from a player is less than CHANNEL_Time_Lower the spam counter increases by + 1.
  Consider the CHANNEL (Lobby) as the spam counter.
  When a player has (CHANNEL - 1) in spam counting. a warning will be sent to whom it may consern.
  If the time between each new chatline from the player is Greater than CHANNEL_Time_Lower and Less than CHANNEL_Time_Upper the spam counter stay as it is.
  If the time since the last chatline is greater then CHANNEL_Time_Upper the spamcounter is reset to 1.
  To get optimal result play around a bit with the values on your server.


Back
Define Admins