****** Hevymetal's RCON/PB Setup Guide V1.06 1/11/06 ******
Ok this is the yet another revision of my guide it is getting better but I am still prone to keyboard dyslexia and insane digressions. It is still a work in progress. I will revise the content to correct and add things as time goes by. I can always use an extra set of eyes, if you see something that is wrong or an addition I need to make please let me know.
Please post any corrections/additions/comments in this thread to help me out.
PROCEDURES:
In order for players to execute RCON commands in game several conditions must be met. Follow these steps and you should be able to get PB_RCON working properly on your server.
Follow the numbered steps for official/non-official servers with FTP/Network access available. Follow the alpha-numbered steps for GOAA or official/non-official servers with no FTP/Network access available.
1. The server needs to have PB enabled. 1a. PB should be enabled by default on GOAA servers
To enable PB do 1 of the following
1. Join server as admin (type "open yourserverip?password=youradminpassword" without the quotes) 1a. Type "admin pb_sv_enable" 1b. Restart the server
OR
2. Edit the file pbsvgame.cfg file located in the System\pb directory on the server and add/or edit the line "sv_punkbuster 1" 2a. Save the changes to the file. 2b. Re-FTP the file to your server if you have downloaded it from a remote server 2c. Restart the server
2. Rename the following files on your server (You can do this remotely via an FTP client or if you have network access via windows file mangler, er, I mean manager) 2a. This step on a GOAA server may require a server rebuild through their web-interface. Will check for sure.
pbrcon.dat to pbrcon.bak pbpower.dat to pbpower.bak
This is to ensure we are starting with a clean slate and no residual crap is affecting our efforts.
3. Create a file with your favorite text editor called server_pb.cfg (Call it what you will this is what I call mine)(See sample file .cfg below) 3a. Create a file with your favorite text editor called server_pb.txt (See sample .txt file below)
4. Players that are going to be assigned ANY PB Power Points other than the default of 1 MUST have their corresponding GUID and playername locked.(DEFINE ALL PB CONFIGURATIONS WITH FULL GUID INFO, 8 DIGITS IS NOT GOOD ENOUGH!!!)(HINT: Type pb_myguid while in server if you dont know what your GUID is)
This is a security measure. It will prevent imposters from posing as namelocked players. In addition it will also prevent a name-changer from gaining playeradmin rights when ALL playeradmins have their GUIDs namelocked. When a hacker tries to assume a the identity of a player that has been namelocked, he is instantly kicked from the server. I reccommend you namelock ALL clan members. Use the following format in the .cfg/.txt file.
FTP/Network add to server_pb.cfg
pb_sv_namelock 9037e088606223522857a39d41d97c44 hevymetal_{PoT}
GOAA no FTP/Network add to server_pb.txt
admin pb_sv_namelock 9037e088606223522857a39d41d97c44 hevymetal_{PoT}
5. Assign PB_Power points to players (NOTE: NO PLAYER CAN HAVE 100 PB POWER POINTS ASSIGNED TO THEM OTHERWISE ALL RCON FUNCTIONALITY WILL BE DISABLED WHEN THAT PLAYER OR AN ADMIN IS ON THE SERVER!!!!)(DEFINE ALL PB CONFIGURATIONS WITH FULL GUID INFO, 8 DIGITS IS NOT GOOD ENOUGH!!!)
Define PB Power points in your .cfg/.txt via these example guidlines. (Going on the default assumption 10 PB_Points will kick a given player)
FTP/Network add to server_pb.cfg
pb_sv_powerguid 9037e088606223522857a39d41d97c44 99 hevymetal_{PoT}
(Only VERY trusted admins should be given 99 points. It basically will give FULL server control at this level)(DO NOT USE 100 POINTS!!!)(HINT: This is what you want to give yourself :P)
pb_sv_powerguid 339737b73966a06b4880c2d0879dc045 50 WILDJOKER69_{PoT}
(Trusted Real life friends whose ass you can kick when they get out of hand :) )
pb_sv_powerguid d2db4689dd6058b2ae83c910a9903e67 25 Franjeka_Re{PoT}ted
(Clan members)
pb_sv_powerguid d28796e5d817bee224f710d2e6fd9918 5 -=[EMC]=-CraZyAce (Trusted guests who frequent your server. Two 5 point players can combine their pb_points to pb_kick a player off the server with no other player votes required)
(The standard server player will recieve 1 PB_Power point with no intervention on your part)
pb_sv_powerguid 7b0e841529347daddfdff3be5e59f733 0 poorschmuck (A punishment for players that will strip them of any PB input)
GOAA no FTP/Network add to server_pb.txt
admin pb_sv_powerguid 9037e088606223522857a39d41d97c44 99 hevymetal_{PoT}
(Only VERY trusted admins should be given 99 points. It basically will give FULL server control at this level)(DO NOT USE 100 POINTS!!!)(HINT: This is what you want to give yourself :P)
admin pb_sv_powerguid 339737b73966a06b4880c2d0879dc045 50 WILDJOKER69_{PoT}
(Trusted Real life friends whose ass you can kick when they get out of hand :) )
admin pb_sv_powerguid d2db4689dd6058b2ae83c910a9903e67 25 Franjeka_Re{PoT}ted
(Clan members)
admin pb_sv_powerguid d28796e5d817bee224f710d2e6fd9918 5 -=[EMC]=-CraZyAce (Trusted guests who frequent your server. Two 5 point players can combine their pb_points to pb_kick a player off the server with no other player votes required)
(The standard server player will recieve 1 PB_Power point with no intervention on your part)
admin pb_sv_powerguid 7b0e841529347daddfdff3be5e59f733 0 poorschmuck (A punishment for players that will strip them of any PB input)
6. Define RCON commands that will be allowed and the amount of points required to execute them.
Add the RCON commands you want available to players on your server using the RCON command reference and sample .cfg/.txt below.
7. Save the server_pb.cfg file 7a. Save the server_pb.txt file 7b. Skip to step 13 for GOAA
8. open your pbsv.cfg file with your favorite text editor (If you get your checks here at ACI the one you download from Reaper)
9. Add the following line to the pbsv.cfg file (I prefer at the bottom)
pb_sv_load server_pb.cfg
10. Save the pbsv.cfg
11. FTP or copy both the pbsv.cfg and the server_pb.cfg file to your server's PB directory.
12. Reboot the server.
13. Join the server AFTER reboot. 13a. Join the server as either Admin or a Player Admin To join the server as admin type "open yourserverip?password=youradminpassword" without the quotes 13b. Open the console (~) 13c. Type exec "full path to server_pb.txt" exec c:\admin\scripts\server_pb.txt 13d. Exit then rejoin the server for the changes to take effect.
14. Type pb_power (Notice you now have 99 points)
15. Test a PB_RCON command
PB_RCON PB_Say say Hello dead people.
16. Enjoy :)
THINGS TO KEEP IN MIND WHEN USING PB_RCON
1. When entering PB_RCON commands the command is displayed to the whole server. No secret command issuing here, if you type it, they see it.
2. commands should not be case senstive however arguments are
pb_rcon pb_sv_kick somepoorschmuck 15 TKing
is the same as
pB_RcOn PB_SV_kIcK somepoorschmuck 15 TKing
however
pb_rcon pb_sv_kick SoMePoORrScHmUCK 15 TKING
Is different and may or may not work
3. The RCON command can extend to other PB commands and settings as well
PB_SV_CVAR PB_SV_GETSS pb_sv_powerkicklen PB_SV_MsgPrefix
4. When using the PB_SV_LOAD command to load a config file, that config file needs to end with the .cfg extension.
5. When executing a config file as admin with the admin exec command. The executed file must have a .txt extension.
6. PB and PB_RCON commands can be entered directly through the PB webtool utility WITHOUT being logged into the server.
7. In most instances it is MUCH easier for many routine commands and operations to be inserted directly into your pbsv.cfg or your server_pb.cfg rather then manually entering them via RCON
8. Note for GOAA owners: Every time the map is changed, the server is restarted or rebooted you will have to re-execute these scripts.
PB_RCON COMMAND REFERENCE
config commands and examples are structured as follows:
1st line: PB RCON Setting (To be added to your PB config file) pb_sv_rcon (Number of PB Power points required to execute that command) pb_sv_(PB Command) NOTE: For GOAA Preface all config commands with "admin" 2nd line: Console command syntax (Type this in the console)(Replace the quoted text with actual arguments) 3rd line: Result of RCON Command (This is what happens) 4th line: If it exists, An example of the command.
pb_sv_rcon 99 pb_sv_ | For FTP/Network admin pb_sv_rcon 99 pb_sv_ | For GOAA pb_sv_rcon pb_sv_"Any PB command not defined in the config" "Arguments for that command" |This is what you type in the console Allows execution of the specified PB_SV_ command | This is the result
pb_sv_rcon 99 PB_SV_AutoUpdBan pb_sv_rcon PB_SV_AutoUpdBan "0/1" Makes PB automatically update the permanent ban file (pbbans.dat) after each change to the banlist in memory (The defaullt is 0) pb_sv_rcon pb_sv_autoUpdBan 1 : Turns on Autoban Update
pb_sv_rcon 99 PB_SV_BadName
pb_sv_rcon PB_SV_BadName "grace in seconds" "text to badname"
Will kick any player that has the badnamed text in the defined grace period of seconds
pb_sv_rcon pb_sv_badname 0 {wTf} : Immediately kicks ALL {wTf} clan members
pb_sv_rcon 99 PB_SV_BadNameList pb_sv_rcon PB_SV_BadNameList Displays the current bad name list for the server
pb_sv_rcon 50 PB_SV_Ban pb_sv_rcon PB_SV_Ban "Player name or PB slot#" "Displayed ban reason" "Private ban reason" Player permanently banned from the server for specified reason. Also writes to pbbans.dat
pb_sv_rcon 99 PB_SV_BanEmpty pb_sv_rcon PB_SV_BanEmpty Empties the current ban list stored in memory
pb_sv_rcon 50 PB_SV_BanGuid pb_sv_rcon PB_SV_BanGuid "Player GUID" "Player name" "IP Address" "Ban reason" Player's GUID permanently banned from the server for specified reason.
pb_sv_rcon 99 PB_SV_BanList pb_sv_rcon PB_SV_BanList "text" Displays the list of bans in the console, including kicks with a temporary ban. "Text" filters the results to show ONLY results with matching text.
pb_sv_rcon 99 PB_SV_BanLoad pb_sv_rcon PB_SV_BanLoad "Filename" Loads a PB ban list from the specified file (pbbans.dat is loaded if no file is specified)
pb_sv_rcon 99 PB_SV_BanMask pb_sv_rcon PB_SV_BanMask "IP Address/Subnet Mask" Permanently ban players who attempt to join from the offendding IP Address/Subnet MaskIP/Subnet. NOTE: Wildcards and partails can be used to define subnets. Bans are written to the pbbans.dat. pb_sv_rcon PB_SV_BanMask 1.2.3.4 will ban a player from the IP 1.2.3.4 pb_sv_rcon PB_SV_BanMask 1.2.3. will ban players from the IP 1.2.3.* or a Class C Subnet (255.255.255.0) pb_sv_rcon PB_SV_BanMask 1.2. will ban players from the IP 1.2.*.* or a Class B Subnet (255.255.0.0) pb_sv_rcon PB_SV_BanMask 1. will ban players from the IP 1.*.*.* or a Class A Subnet (255.0.0.0)
pb_sv_rcon 99 PB_SV_Cvar pb_sv_rcon PB_SV_Cvar "section Cvar_name" "IN/OUT/INCLUDE/EXCLUD" "Parameter1" "Parameter2" Adds an automatic cvar check to the list of cvars in memory for the server to check for during gameplay.
pb_sv_rcon 99 PB_SV_CvarDel pb_sv_rcon PB_SV_CvarDel "Cvar slot#" Deletes a Cvar range check from the list of checks stored in memory.
pb_sv_rcon 99 PB_SV_CvarEmpty pb_sv_rcon PB_SV_CvarEmpty Empties the ENTIRE list of Cvar range checks that are active in memory.
pb_sv_rcon 50 PB_SV_CvarList pb_sv_rcon PB_SV_CvarList Displays all of the allowed cvar ranges for all cvars that the server is monitoring at the moment
pb_sv_rcon 99 PB_SV_CvarVal pb_sv_rcon PB_SV_CvarVal "section Variable_Name" "player name or PB slot#" Sends a request to all applicable connected players asking for the value of the specified variable. To specify a player name or substring you will need to surround the text with double-quote marks
pb_sv_rcon 99 PB_SV_Disable pb_sv_rcon PB_SV_Disable Disables PunkBuster, however the disabling does not take effect until the server is restarted
pb_sv_rcon 99 PB_SV_Enable pb_sv_rcon PB_SV_Enable Enables PunkBuster, however the enabling does not take effect until the server is restarted
pb_sv_rcon 99 PB_SV_File pb_sv_rcon PB_SV_File "filename" "o/s" "AA_Version" "filesize" "md5" "md5" This command is used to add checks for other files,. The "o/s" parameter is defined as w for win32, l for linux, m for mac, or a for all o/s. Multiple md5 hashes can be specified separated by spaces to signify multiple releases for a given file / AA_Version combination. pb_sv_rcon pb_sv_file AGP.dll w "2.5.0" 233472 D083A5AFB77F3138351AB4DC70C8EE00 | Checks to make sure that the file AGP.dll for Americas Army V2.5 for windows is 233,472 bytes in size and has an MD5 checksum of D083A5AFB77F3138351AB4DC70C8EE00
pb_sv_rcon 99 PB_SV_FileDel pb_sv_rcon PB_SV_FileDel "slot#" Deletes the specified file check from PB's active memory.
pb_sv_rcon 99 PB_SV_FileEmpty pb_sv_rcon PB_SV_FileEmpty Deletes the ENTIRE list of file checks in PB's active memory.
pb_sv_rcon 99 PB_SV_FileList pb_sv_rcon PB_SV_FileList Lists ALL the file checks in PB's active memory
pb_sv_rcon 25 PB_SV_GetSs pb_sv_rcon PB_SV_GetSs "player name or slot#" Sends a request to get a PB screenshot from the specified player. If no player is specified a request is sent to the whole server. pb_sv_rcon PB_SV_GetSs "somepoorguy" | Sends a request for a screenshot from somepoorguy NOTE: Include quotes when specifying text (PB slot# is usually easier)
pb_sv_rcon 99 PB_SV_IPGuard pb_sv_rcon PB_SV_IPGuard "IP Address" PunkBuster Servers automatically add suspicious IP Addresses to the IP Guard list when players join with a non-functioning PunkBuster client. Players joining from a guarded IP with an old version of PunkBuster are removed from the server. The PB_SV_IPGuard command allows admins to add their own suspicious IP Addresses to the list
And the one thats gonna probably be used the most by everyone.
pb_sv_rcon 25 PB_SV_Kick pb_sv_rcon PB_SV_Kick "Player name or PB slot#" "Minutes" "Displayed ban reason" "Private ban reason" Kicks a player from the server and bans him from rejoining until the specified minutes have elapsed or until the server is restarted, whichever comes first. NOTE: Maximum kick time is 999 minutes. NOTE" Partial names and wild cards may be used when kicking. pb_sv_rcon PB_SV_Kick sam 5 TKing The above example would not only kick sam, but it will also kick samantha and asampleplayer
pb_sv_rcon 99 PB_SV_Load pb_sv_rcon PB_SV_Load "File Name" Loads the specific PB config file containing commands and settings. NOTE: files to be loaded MUST end with a .cfg extension. pb_sv_rcon PB_SV_Load server_pb.cfg | loads the file called server_pb.cfg and runs any commands it may contain
pb_sv_rcon 50 PB_SV_NameLock pb_sv_rcon PB_SV_NameLock "GUID" "Name" Locks a player name to a specific GUID. If a player joins a server or changes his name while on the server to a name which is GUID locked and the GUID does not match the one that is assigned to that player, then that player is instantly kicked from the server.
pb_sv_rcon 99 PB_SV_NameLockEmpty pb_sv_rcon PB_SV_NameLockEmpty Empties the current list of nameLocks in active PB memory.
pb_sv_rcon 99 PB_SV_NameLockList pb_sv_rcon PB_SV_NameLockList Displays the list of current nameLocks in active PB memory to the server console.
pb_sv_rcon 99 PB_SV_NewLog pb_sv_rcon PB_SV_NewLog Will make PB close the current PB logfile and create a new one.
pb_sv_rcon 25 PB_SV_PList pb_sv_rcon PB_SV_PList Displays a list of currently connected players and their corresponding PB Slot#. NOTE: PB_Plist is the non-RCON evqivilent command.
pb_sv_rcon 99 PB_SV_Power pb_sv_rcon PB_SV_Power "Slot#" "PB_Power rating" Adds the player in the specified slot# to the local PB Player Power database with the specified PB_Power rating. NOTE: The command PB_Power is the non-RCON evqivilent available to ALL players, but it will ONLY display players assigned PB slot# and the current PB_Power points assigned to them. pb_sv_rcon PB_SV_Power 7 25 | Would give the player at PB Slot#7 25 PB_Power Points.
pb_sv_rcon 99 PB_SV_PowerGUID pb_sv_rcon PB_SV_PowerGUID "GUID" "PB_Power rating" "optional text" Adds a player with specified GUID to the local PB Player Power database with the specified PB_Power rating.
pb_sv_rcon 25 PB_SV_PowerList pb_sv_rcon PB_SV_PowerList "filter" Displays a list of players in the PB_Power database If a filter is specified, then only entries where the filter is either in the guid and/or name fields are displayed.
pb_sv_rcon 99 PB_SV_PowerPoints pb_sv_rcon PB_SV_PowerPoints "PB_Power slot#" "points to assign" Changes the number of PB_Power Points assigned to a PB_Power Player in the local PB database. NOTE: Use the PB_SV_PowerList command to get the PB_Power slot#
check her for more PB_RCON commands. I will do more in next revision. http://www.evenbalance.com/publications/aa-ad/
CONFIG FILE EXAMPLES
Sample server_pb.cfg file for FTP/Network Access server: (Actually a psuedo-snippet of mine, Feel free to copy/paste what you want/need to help you out :) One request though, copy the NAMELOCK section unaltered and add it to your .cfg :) I may just drop in your server someday)
; WebTool
pb_sv_httpPort 666 pb_sv_httpAddr 6.66.6.66 pb_sv_httpRefresh 60 pb_sv_httpKey "insertyourpasswordhere"
; Admin options
pb_sv_SsCeiling 999999 pb_sv_AutoSs 1 pb_sv_PowerMin 10 pb_SV_MaxConDls 6 pb_SV_MaxDlRate 8 pb_SV_PowerMin 8
;PB_RCON
pb_sv_rcon 99 pb_sv_ pb_sv_rcon 50 pb_sv_ban pb_sv_rcon 50 pb_sv_badname pb_sv_rcon 50 pb_sv_badnamelist pb_sv_rcon 99 pb_sv_say pb_sv_rcon 99 pb_sv_banlist pb_sv_rcon 25 pb_sv_ver pb_sv_rcon 25 pb_sv_kick
;Clan PB_NAMELOCK
pb_sv_namelock 9037e088606223522857a39d41d97c44 hevymetal_{PoT}
pb_sv_namelock e3a3f55a6c46af31b0554bfd97228ec5 0x04DEADBEEF_{PoT}
pb_sv_namelock f6877c65cd2b51f2b8fd27715ed4add9 0xC0FFEE_{PoT}
pb_sv_namelock 339737b73966a06b4880c2d0879dc045 WILDJOKER69_{PoT}
pb_sv_namelock d2db4689dd6058b2ae83c910a9903e67 Franjeka_Re{PoT}ted
pb_sv_namelock 15ad8b3c9c94cc7b04e09ffbe9a4a3c6 HiTmAn_{PoT}
;Guest PB_NAMELOCK
pb_sv_namelock d28796e5d817bee224f710d2e6fd9918 -=[EMC]=-CraZyAce
;Clan PB_POWER Points
pb_sv_powerguid 9037e088606223522857a39d41d97c44 99 hevymetal_{PoT}
pb_sv_powerguid e3a3f55a6c46af31b0554bfd97228ec5 99 0x04DEADBEEF_{PoT}
pb_sv_powerguid 339737b73966a06b4880c2d0879dc045 50 WILDJOKER69_{PoT}
pb_sv_powerguid d2db4689dd6058b2ae83c910a9903e67 25 Franjeka_Re{PoT}ted
;Guest PB_POWER Points
pb_sv_powerguid d28796e5d817bee224f710d2e6fd9918 5 -=[EMC]=-CraZyAce
Sample server_pb.txt file for GOAA no FTP/Network access server: (Feel free to copy/paste what you want/need to help you out :) One request though, copy the namelock section unaltered and add it to your .cfg :) I may just drop in your server someday)
; Admin options
admin pb_sv_SsCeiling 999999 admin pb_sv_AutoSs 1 admin pb_sv_PowerMin 10 admin pb_SV_MaxConDls 6 admin pb_SV_MaxDlRate 8 admin pb_SV_PowerMin 8
;PB_RCON
admin pb_sv_rcon 99 pb_sv_ admin pb_sv_rcon 50 pb_sv_ban admin pb_sv_rcon 50 pb_sv_badname admin pb_sv_rcon 50 pb_sv_badnamelist admin pb_sv_rcon 99 pb_sv_say admin pb_sv_rcon 99 pb_sv_banlist admin pb_sv_rcon 25 pb_sv_ver admin pb_sv_rcon 25 pb_sv_kick
;Clan PB_NAMELOCK
admin pb_sv_namelock 9037e088606223522857a39d41d97c44 hevymetal_{PoT}
admin pb_sv_namelock e3a3f55a6c46af31b0554bfd97228ec5 0x04DEADBEEF_{PoT}
admin pb_sv_namelock f6877c65cd2b51f2b8fd27715ed4add9 0xC0FFEE_{PoT}
admin pb_sv_namelock 339737b73966a06b4880c2d0879dc045 WILDJOKER69_{PoT}
admin pb_sv_namelock d2db4689dd6058b2ae83c910a9903e67 Franjeka_Re{PoT}ted
admin pb_sv_namelock 15ad8b3c9c94cc7b04e09ffbe9a4a3c6 HiTmAn_{PoT}
;Guest PB_NAMELOCK
admin pb_sv_namelock d28796e5d817bee224f710d2e6fd9918 -=[EMC]=-CraZyAce
;Clan PB_POWER Points
admin pb_sv_powerguid 9037e088606223522857a39d41d97c44 99 hevymetal_{PoT}
admin pb_sv_powerguid e3a3f55a6c46af31b0554bfd97228ec5 99 0x04DEADBEEF_{PoT}
admin pb_sv_powerguid 339737b73966a06b4880c2d0879dc045 50 WILDJOKER69_{PoT}
admin pb_sv_powerguid d2db4689dd6058b2ae83c910a9903e67 25 Franjeka_Re{PoT}ted
;Guest PB_POWER Points
admin pb_sv_powerguid d28796e5d817bee224f710d2e6fd9918 5 -=[EMC]=-CraZyAce
Back Home
© 2006 {PoT} Pipeline Operations Team
Last Page Update: