User Guide

Information
BC2 Guardian is a software which helps to handle Battlefield Bad Company 2 servers.
The author of this lightweight and functional program is Anubis, a member of the G4G.pl gaming
community.
This was made by him alone, on the basis of technical documentation made available by DICE.
He create it for wide availability for players and companies involved in the professional game
hosting. This software was created without any funding from commercial firms.

It is forbidden to host files beyond the resources of G4G.pl.

Also hot links and administration of direct links to the files are prohibited.

Currently the program supports 100% of operating functions of the game server.
If any option is not working properly, it means that the problem occurs on server and it is not the
fault of BC2 Guardian.
Anubis has made every effort to ensure that the application has been stable, and minimally
burdened the users operating system.
BC2 Guardian application is in development phase. Its functionality will be changed along with the
improvements introduced by DICE.

Author provides the application as it is. Users are responsible for the consequences of using this
software.
Both Anubis and G4G.pl do not take responsibility for any consequences of use of the BC2
Guardian.
The program has been tested on G4G.pl servers.
If you have any questions regarding the program, you can ask on our forum.

Useful Links
• G4G homepage
• G4G forums
• BC2 Guardian homepage
• BC2 Guardian features
• BC2 Guardian Download latest version
• BC2 changelog
• Report Bugs
Installation
NO installation is required, simply unzip BC2G to any folder and run it.

Getting Started
Now before we get started you will need some information about your server, If you are the server
owner you should contact your server provider if you do not have the following information.
If you are not the server owner, you should contact the server owner as the server provider will not
release these details to anyone but the owner.
• Server IP number
• Admin port
• Admin password
note: You will not be able to connect without this information.

From here on each section will represent a TAB from BC2 Guardian.

Connection
Run BC2G and you will be presented with the connection page (fig-1)
Fig-1

you will need to add your server information so you need to fill out the settings on right (fig-1.2),
Fig-1.2 Fig-1.3

once filled out you can click connect or add, adding the server will add it to the server list (fig-1.3),
once added to the server list you can simply double click on a server to autofill the settings and
click connect, this is useful to admins with multiple servers.
Note: if you simply connect your settings will not be saved and you will need to fill out the settings
again.
Tip:Add your server before you connect.
If punkbuster is running you can leave the box checked for 'Use PB penalties (pban, ban, kick)'
otherwise uncheck this option.
This checkbox is just to use PB kick and ban ingame.
For example, if you check "Use PB penalties", and an admin use "@kick Preacher1970" then PB will do this
instead of game engine. Player will be kicked for 1 (ONE) minute with kick reason "Admin decision" - he will
really see the reason. It's similar with @ban

Welcome message
you can set a welcome message here (fig-1.4)
As stated in BC2G dont set timeout below 60 seconds (default), 90 seconds is a good setting and
most players will see the welcome message.
Fig-1.4

You can change the welcome text to whatever you want but you must do this before you connect,
you cannot change the message while your connected.
To display the users name just add %name% to the text, keep it short and sweet.
Server Status
The server status tab displays, yes you guessed it, yours servers status.
The left hand column shows (fig-2)
• Server Name
• Mode (the current mode your server is running in)
• Players/Max Players (shows the current number of players and the maximum number of
players.)
• Map (displays current map)
You cannot change any of the above from here, they are for information purposes only.
You can however 'Run next map' which will end the current round and start the the next map in
your map list, you can also 'Restart map' which will restart the current map.(fig-2.1).
Fig-2 Fig-2.1

The right hand column shows all connected players (fig-2.2).

You can view player information here such as:
• Clan Tag • Team ID
• Nick • Player GUID
• Squad ID • Player IP
• Slot Number • Deaths
• Kills • Ratio
• Country
Fig-2.2

You can also manage players here. (fig-2.3)

• Kick
• PBKick
• Ban
• For one round
• Permanently
• Timed (in seconds)
• Kick all players

Fig-2.3

To use these functions simply rightclick the player you wish to penalise, Select your required option
from the popup menu. The Update button is simply to update the server list if you wish to check
your kick was successful.
Copy to clipboard
You can also rightclick on any player and copy their GUID, IP or Nick directly to clipboard, useful
for checking a player.(fig-2.4)
Fig-2.4

Chat Consol
The Chat consol allows you to view all chat, you can also chat with players on the server.(fig-3).
• Chat to All • Chat to a Team
• Chat to a single player • Chat to a squad
Fig-3

Chat to all players (by default) simply type in your message along the bottom, set the display time
and click Yell.
You can reselect all players from the player list if required.
Chat to a single player by selecting their Nick from the list on the right, type your message as before
set the display time and click Yell.
Follow the same instructions to chat to a team or squad.

Events (Fig-4)
The events tab displays all server events, from all players.
 • Connecting • Suicides
• Disconnecting • Squad Changes
• Kills • Team Changes
• TeamKills • Player Chat

Other events are logged, Ive just listed those of interest to admins.
Fig-4

Server Settings (Fig-5)

The server settings TAB allows you to view and set various server settings, to view all your current
settings click on the Get all variables button at the bottom.
This autofills all current settings with the exception of passwords.
• adminPassword • gamePassword
You can also save all your settings with the Set all Variables button.
Note: adminPassword and gamePassword will NOT be affected by Set all Variables, you must set
those individually using their own SET button if you wish to change them through BC2 Guardian.
All the server settings/visual settings can be changed manually by checking or unchecking the
corresponding checkbox and clicking the set button next to it.
Most of the settings are self explanetory, a checked box means the option is enabled.
Rank Limit should be left set to -1 (default) – This allows any player to join, setting this to
say '5' will limit the server to players with rank 5 or above.
Player Limit should be set to your servers player slot count (ie:If you have a 16 player
server then set it to 16)
 If you set the player limit to less than your servers slot count (10 for instance) only 10
players will be able to join your server.
Note: this does not include reserved slots, they will limit your server count even further!
Banner URL add some graphics to your server on load page, at the moment there is a limit
of (64 characters) so keep those urls short..

Fig-5

Fig-5.1 (just an example shot after Get all Variables)

1 final note on server settings:
Any Information you change here will be lost if you restart your server default settings will apply

Ban List (Fig-6)

There are 2 sections on the banlist TAB, Player Banlist and IP Banlist, they are identical in every
way except that column 1 is used to ban a player by their Nick and column 2 is used to ban players
IP.
Fig-6

So to use this you simply fill out the fields below the list, Use either Nick or IP, select duration
(Permanent or Seconds) If you select seconds the field below will become available, just put how
many seconds in the field.
Then click on Add and the player will be added to the banlist.
If you want to ban a player with a reason you need to put a check in the PB field which will make
the reason field available, then just type in your reason.
Again click on Add and the player will be added to the ban list.
To Unban a player double click their nNICK or IP from the banlist and hit Unban...
heres a little list of seconds in minutes to help when banning for a short time.
• 60 sec 1 minute
• 120 sec 2 minutes
• 300 sec 5 minutes
• 600 sec 10 minutes
If your on the server at the time you can also use the rban command coming up in the next section.
Note: If you restart your server your banlist will be lost!
Import/Export ban lists
You can now save your banlists before disconnecting guardian from your server thus saving those
bans for the next time you run it..
• Exporting (saving ban list)
• To export a list simply click the export button under your desired ban list (player
banlist or IP banlist)
• your presented with a save popup (fig-6.1.1)
• choose a file name
• choose a location
• hit save (and your done)
Fig-6.1.1

• Importing (using a saved ban list)

• To import a list simply click the import button under your desired ban list (player
banlist or IP banlist)
• your presented with a open popup (fig-6.1.2)
• choose the file name from your previously exported (saved file)
• Hit open and your banlist should now display your bans from the exported file.
 Fig-6.1.2

PB bans tab (attached to banlist tab)(Fig-6.1)

The Pbbans tab displays bans issued by Pbbans streaming services but you can also add bans for
your server here too and they are saved to the pbbans.dat file so you can restart Guardian and you
DONT loose your ban list.
Fig-6.1

To add bans to this banlist fill out all the fields as required (fig-6.2) and select either GUID or
MASK, GUID will allow you add the players GUID and IP, MASK will allow you to add IP only.
The click Add New Ban.
Fig-6.2
Server Buttons
• Get Banlist
• This will retrieve the banlist from the pbbans.dat file
• Clear Banlist
• As the popup info states (use with caution) This will clear your banlist
• Upd banfile
• This will update the pbbans.dat file with any bans you may of added, it will also
update from pbbans MBI

rightclick menu (Fig-6.3)

You can also use the rightclick menu in the PB bans tab to Unban or ReBan.
Fig-6.3

Ingame Commands (Fig-7)

The Ingame Commands TAB is where you add your admins, list of admins is displayed on the left
and a list of commands is displayed on the right.
On the bottom left is where you add your admins and select their access level, the bottom right is
for adding or removing commands and setting their access level.
Fig-7
Once a player is added here they can use ingame commands as show in the description field bottom
center simply by typing in chat.
Heres each with an example
• @say TEXT
• EX: @say Welcome to G4G BC2 server
• Displays: Welcome to G4G BC2 server in the center of the screen.
• @kick NICK
• EX: @kick Preacher1970
• Kicks the player with the nick Preacher1970
• @ban DURATION (in seconds) NICK
• EX: @ban 300 Preacher1970
• Bans the player with the nick Preacher1970 for 5 minutes
• @rban NICK
• EX: @rban Preacher1970
• Bans the player with the nick Preacher1970 till the round is over
• @restart
• simply restarts the current map
• @time
• Displays the current server time
• @nextmap
• Displays the next map
• @pbkick NICK DURATION (in seconds) REASON
• EX: @pbkick Preacher1970 300 you SUCK
 • kicks the player with the nick Preacher1970 for 5 minutes with reason you SUCK
• @startmatch
• will start a match
• @runnextmap
• Ends the current round and starts the next map in the list
• @psay <nick - partial as well> <message>
• EX: @psay Preach stop base raping or be kicked
• will send a message only to Preacher1970 saying “stop base raping or be kicked”
• @warn <nick, partial as well> <warn message> (3 warns = ban for a round)
• EX: @warn Preacher1970 stop being a dick
• sends a warning message, if you warn a player 3 times the player will banned till the
next round starts.
There are more commands but many untested as yet but im sure you'll figure them out
To add admins simply put their NICK in the Nick field, select their access level from the dropdown
and click Add.
To modify a user double click their Nick, this will autofill the admin info with their details, change
access level and click modify.
To delete a user double click their Nick, this will autofill the admin info with their details and click
Remove.
It may be good for me to point out here that you should never give admin status to players you dont
know very well, your simply asking for trouble, dont take the risk.

Reserved Slots (Fig-8)

The reserved slots tab allows you to add players to reserved slots, these slots will be deducted from
the public available slots, for example if you have a 20 man server and you have 5 players in your
reserved slot list the ammount of public slots would be 15, public players cannot fill reserved slots.
To add player to a reserved slot just type their NICK into the Player Field and click on Add.
• Load a list, simply click the load button.
• Handy if you edited your reservedslots.txt file in your CP
• You can save the list easily and clicking save will write the list to your reservedslots.txt file
• Get List will refresh the current list.
• Clear will clear the reservedslots.txt file.

Fig-8
Maplist (Fig-9)
On the map list tab you can set your GameMode using the dropdown, simply select your desired
gamemode and the maps available for that mode will be displayed on the right hand side
(Available maps for XXX mode), you then have to append (ADD) or Remove maps you wish to
run so they show up on the left hand side (Current maplist)
Then SET your selection.
Note: for changes to take effect you will need to restart your server.
Fig-9
Punkbuster (Fig-10)
The Punkbuster tab displays all punkbuster commands going through your server, if your running
PB and streaming to an anti cheat site such as Pbbans or PunksBusted you can set up a welcome
message (un tested) via your chosen anti cheat site.
There are a few predefined commands on the right for your use, an explanation of these commands
can be found in Punkbuster Commands in the next section.
Fig-10

Use the PB commands by simply typing the command into the field at the bottom of Punkbuster tab
and click send, the clear button simply clears the log from the pb_sv_command field.

Punkbuster buttons
Anubis has added a few extra buttons on the right hand side of the Punkbuster tab, these are just to
simplify the process of using pb.
Displays a list of connected players and their current status

Displays the list of bans in the consol, including kicks with a temporary
ban

Updates the specified ban file, (pbbans.dat is used by default if no file is

specified) with regard to recent unbans/rebans
 Empties the current ban list stored in memory

Loads a PB ban list from a specified file, if no filename is specified, the

default pbbans.dat is loaded

Displays the current bad name list for the game server (consult the
PunkBuster Commands section to add bad names)

Displays a list of PB tasks along with a task slot # for each task

Empties the list of tasks in the memory

Displays the current version of PunkBuster

Writes the current valuesof the punkbuster server setting to the local hard
drive

Restarts the punkbuster services, your game server will keep running

Punkbuster Commands
This List of PB commands is as yet untested, I will however update these commands removing any
that do NOT work, those already tested are highlighted in green.
• pb_sv_Enable-EnablePunkBuster
• pb_sv_Disable-DisablePunkBuster
• pb_sv_Load[filename]-LoadPBconfigfile
• pb_sv_Ver-DisplaycurrentPBServerversioninformation
• pb_sv_Plist-Displaylistofcurrentlyconnectedplayers
• pb_sv_BanList[optionalsearchtext]-Displaylistofbans/kicks
• pb_sv_Ban[slot#/name][reason|private]-PermBanGUID
• pb_sv_Kick[slot#/name][minutes][reason|private]-Kickplayer
• pb_sv_GetSs[slot#or"searchtext"]-RequestScreenshot(s)
• Although pb_sv_GetSs does work, at this time all screenshots will be returned as
error code B0, for more info on this check with your anti cheat streaming site
• pb_sv_BadName[graceseconds][bannedtext]-AddBadname
 • pb_sv_BadNameList-DisplaylistofBadNames
• pb_sv_BadNameDel[slot#]-DeleteBadName
• pb_sv_CvarList-DisplaylistofallowedCvarRanges
• pb_sv_CvarVal[Cvarname][player]-RequestvalueofCvar
• pb_sv_Cvar[Cvarname][type][range]-AddCvarRange
• pb_sv_BindSrch[searchtext][player]-Requestmatchingbinds
• pb_sv_CvarSrch[searchtext][player]-RequestmatchingCvars
• pb_sv_CvarUser[player]-Requestlistofuser-definedCvars
• pb_sv_CvarChanged[player]-Requestlistofnon-defaultCvars
• pb_sv_WriteCfg[filename(default=pbsv.cfg)]-Savesettings
• pb_sv_BanEmpty-Emptybanlistinmemory
• pb_sv_BanLoad[optionalfilename]-Loadsbansfromfile
• pb_sv_UnBan[banslot#]-Unbanaguidinmemory
• pb_sv_ReBan[banslot#]-RebananunbannedGUIDinmemory
• pb_sv_UpdBanFile[optionalfilename]-updatesbanfile
• pb_sv_CvarEmpty-Emptycvarlistinmemory
• pb_sv_CvarDel[Cvarslot#]-removesacvarcheckfrommemory
• pb_sv_Restart-RestartPBServer
• pb_sv_Update-ForcePBServertocheckforUpdates
• pb_sv_Power[slot#][powerrating]-Addplayerpowerrecord
• pb_sv_BanGuid[guid][name][ip][reason]
• pb_sv_UnbanGuid[guid]
• pb_sv_PowerList[guid/namefilter]
• pb_sv_PowerPoints[playerpowerslot#][points]

Censor (Fig-11)
The censor Tab is simply a bad word filter, even if you delete all the words from here Bad Company
2 has its own built in word censor (yes it sux and we should be allowed to disable it).
To delete a word from list double click the word, it will then autofill the fields at the bottom, from
there you can Modify or Delete it.
If your modifying a word simply select the penalty you want from the dropdown list.
Options are
• Kick (will simply kick the player and they can rejoin immediately)
• Seconds [define how many seconds] (will kick for XX seconds)
• Round (will kick and the player cannot return till the round is over)
 • Perm (will ban the player from your server)
Fig-11

To add bad words to the censor you'll need to some knowledge of REGEX I cannot help here and
since I cleared out all the bad words (cos I dont use it) I wont be updating this information any time
soon..
I will get you started though just in case you want to add any words....
• REGEX
• REGEX wiki

Scheduler (Fig-12)
From the scheduler tab you can send scrolling messages such as server rules, website address,
teamspeak IP...etc basically anything.
You can also set a schedule to change game type or to run a PB command.
Note:You should not abuse it with things like, 'So & so sucks at BC2' messages like this will put
players off since its using the YELL command and is displayed in center of the screen.
As you can see from (Fig-12) I have some message already setup and displaying every 300 seconds
(5 minutes).

(Fig-12)
Server messaging (fig-12)
So lets start with server messaging since I know thats what the one admins will be the most
interested in..
At the bottom of the scheduler Tab is where you add all your scheduled messages and game mode
changes and punkbuster commands.

To add a message
1. Select yell from the Action dropdown
2. Type in your message in the message field
3. choose a duration (in seconds) [5 is good option]
4. check the Time Span radio button
5. choose how many seconds between each time the message is displayed [300 is a good
option]
6. choose a delay period (the delay period should be (+5 minimum) for each message to
prevent overlapping of messages which will in turn not display all messages. You should
also take into account the duration of the message..
7. Now click on Add to add it to the schedule.
Delay period notes:
Your delay period must reflect your duration, I will try to explain..
the duration also plays a factor towards the delay, so if the duration to display was 10 seconds then
the the delay would really have to set at +10 or +15 for each new message.
Setting it at +10 would give you messages constantly on screen.
Check out my example in Fig12,
Once I start Guardian up I will get the 1st message after 300 seconds (5 minutes) and it will display
for 5 seconds, The 2nd message displays 15 seconds later and the 3rd 15 seconds after that, then the
guardian will wait 300 seconds (5 minutes) before repeating the process.

Scheduling other tasks (Fig-12.1)

All the other tasks are best scheduled using Exact Time radio button..
Since its virtually impossible to determine what the server will be doing at any given time setting
these to run using Time Span could cause you problems.
1. Select the Action you wish to take from the dropdown.
2. Check the Exact Time radio button
3. Specify a Time
4. Click Add
Fig-12.1

I create 1 of each Action in fig-12.1 as an example.

• pb_sv_command
• To use the pb_sv_commands select it from the dropdown.
• You are then presented with pb_sv_ in the field below Action
• you need to finish off the command with whatever PB command you want to run (I
 just used GetSs as an example) which will run at 5am every day taking a screenshot
of players connected at that time.
• Select Exact Time radio button and choose time
• Then Add it.
• Gametype_ [Rush/Conquest/SquadDM/SquadRush]
• Again simply select which mode you wish to run
• Select Exact Time radio button and choose time
• Click Add

Simply repeat the process for each new command or gamemode you wish to run.

Automation (Fig-13)
The Automation tab allows you to configure certain values to help keep your server balanced, to
change any values and settings you must first uncheck the Autobalance enabled box.
Note: at this moment in time EA have not implemented or fixed any autobalance options so in order
to balance a server players will be kicked for a specified period of time (they will receive several
warnings before hand to switch teams).
Fig-13
Actions
• Check balance each
• Set how many minutes between each check for unbalanced teams
• (default is (1 minute))
• Allow difference of
• Select how many more players are on the larger team before the autobalancer starts
acting to balance the teams.
• Warn Larger team
• you should leave this option checked or players from either side will receive the
message.
• Select how many times the team should be warned before the autobalance starts it
process. (default is (3 times)) which should be enough.
• With message
• [%counter%/3] Balance teams or kick!
• You should leave [%counter%/3] in place and the /3 should be changed to reflect
how many times to warn larger team..
• So if you set the Warn larger team to 5 minutes then the /3 should be changed to /5.
• Then
• you have a few options available here
• Do nothing (this option is handy if your online and want balance the teams
yourself, as the option implies, nothing will happen the team will just receive
the messages)
• Kick last (team) joined player (this option will kick only the last player who
joined the larger team (teams may still be unbalanced if the larger team is say
+3)
• Kick last (team) joined players (this option will kick all the last joined
players from the larger team (If teams are unbalance by 3 players, the last
players from the larger team will be kicked)
• Ban last (team) joined player (this option will ban only the last player who
joined the larger team (teams may still be unbalanced if the larger team is say
+3)
• Ban last (team) joined players (this option will ban all the last joined
players from the larger team (If teams are unbalance by 3 players, the last
players from the larger team will be banned)
• Kick lowest kills player (this option will kick the player with lowest amount
of kills from the larger team)
• Kick lowest ration player (this option will kick the player with lowest
Kill/Death ratio from the larger team)
• Use PB
• If you check the Use PB radio button the auobalance can then be set with a reason
 and duration.
• Ban/Kick reason (type your reason in the field)
• Duration (set how many minutes the ban or kick lasts before the player can
return)
• Use game penalties
• This can only be used with the Ban last (team) joined Player/s options
• you can set this to ban for a round or ban for XX minutes.

Ingame commands for autobalancer

You can now check the status of the autobalancer and turn it on/off while ingame, handy if your
running guardian on the same machine that you use to play games on.
• @balon - Guardian autobalance ON
• @baloff - Guardian autobalance OFF
• @balst - Guardian autobalance status

Immunity (whitelist)
The Immunity list is where you add players that you want the autobalancer to ignore commonly
known as a whitelist.
Simply type in the nickname of the player you want to protect in the Nick field and click Add

tray icon
You can now minimize/maximize Guardian with the tray Icon leaving your desktop free for
whatever else your doing.

Bad Company 2 useful links

• PunkBuster Support
• Bad Company 2 Official site
• Bad Company 2 EA
• Bad Company 2 Wiki
• Check your Bad Company 2 Stats
• Create a dynamic Stats SIG

This PDF userguide was created by Preacher1970 with permission from Anubis (BC2 Guardian creator).