This publication is for Players of online games who are interested in using or finding out more about the PunkBuster Anti-Cheat system as integrated into Soldier of Fortune II by Activision and Raven Software.

A great effort has been made to make this publication useful for those new to PunkBuster and also for advanced users of PunkBuster.  Any comments or suggestions will be gladly received via email to docs@evenbalance.com.

If you wish to learn about using the PunkBuster Server software for running a game server, please see our related publication entitled 'PunkBuster for Server Administrators'.

In September of 2000, a handful of online computer game playing enthusiasts became concerned with the increased activity of cheating in online multiplayer gaming.  We decided to do something about the problem.  We were aware that a few attempts had been made in the past by others (including the makers of the games themselves) and that they were all generally considered to have failed for the most part.  We had a vision of a new way to approach the problem and decided to develop an experimental software system to see if our new approach would work.  We believed that once we had submitted and maintained a product for open use that the response from affected online communities would tell us whether or not the experiment was a success.  After several months of growth, much hard work, acceptance, and the appreciated beta testing and support of hundreds of thousands of users, we believe that we have a viable solution to fighting the problem of cheating in online multiplayer games: PunkBuster.

PunkBuster is an automatically self-updating client/server Anti-Cheat software system.  That means that players run the PunkBuster Client software while they are playing online games and also, PunkBuster Server software is running on the game server that players connect to for gameplay.  The PunkBuster system is designed to hold all participants accountable by scanning the game computers looking for known cheats, game hacks, and exploits similar to the way Anti-Virus software would scan a computer looking for a virus.  PunkBuster does not modify any files or settings on your computer even if it detects some type of violation, it reports what it finds and, in some cases, will remove offending players from the current game.  PunkBuster is optional.  A Server Admin who decides to run PunkBuster on his or her Game Server is simply choosing to limit players on said Game Server to players who have chosen to enable PunkBuster on their playing computers.  You do not have to enable PunkBuster if you are uncomfortable with the idea of such software.  However, PunkBuster is not "spyware" nor is it a trojan - it is designed for groups of honest people to use together in an effort to keep out players who are unwilling to subject their system to an objective third-party software system scanning their computer during gameplay.  The activities performed by PunkBuster are generally described on our website and we have also developed and published a Privacy Policy Statement.  We take the privacy and security of our users and their computers very seriously and there is no featured provision (documented nor undocumented) whatsoever in our software whereby anyone outside of your computer can gain control of your computer or view / change your private information with or without your knowledge.  Additionally, PunkBuster does not transmit your private data files to any other computer nor keep any type of centralized database that tracks any information about your personal files.  PunkBuster basically just looks for known cheats and game-hacks while you are playing a PunkBuster enabled game in an effort to authenticate your installation as "clean" for the purpose of consensual multiplayer online gaming.

In mid-2001, a privately funded corporation, Even Balance, Inc. was formed to handle the commercial application of the PunkBuster system.  We plan to offer several types of products and services to online gaming communities that are built up around the games we support.  We are actively seeking relationships with game software developers who would like to have us provide anti-cheat support for their online multiplayer game titles.

There is no cost for a personal, non-commercial license to use PunkBuster software.  Our End User License Agreement must be accepted on-screen before PunkBuster is installed.  If you wish to use PunkBuster in any type of commercial environment or in connection with any commercial event, a separate commercial licensing arrangement must be obtained from Even Balance, Inc.  To find out more about commercial licensing, send an inquiry via email to license@evenbalance.com.

More information about Even Balance, Inc. and the PunkBuster system can be found on our website at evenbalance.com.

From the main multiplayer game menu, click the 'Join Server' icon to get to the In-Game Server Browser.  On the In-Game Server Browser screen, make sure the 'PunkBuster Enabled' button says 'Yes'.  If not, click the button to change 'No' to 'Yes'.

The In-Game Server Browser

You are now ready to join any servers that are PunkBuster Enabled.  The far right column in the Server Selection table will show an asterisk for servers that are PunkBuster Enabled.  When PunkBuster needs to give you information, it will appear at the top of your playing screen briefly and then scroll off the top of the screen.  If you wish to review previous messages, press the tilde (~) key to bring down the game console.  From inside the game console, use the 'PageUp' and 'PageDown' keys to scroll the console text up and down if necessary.

Although there is code inside the Game to allow PunkBuster to be integrated tightly with the Game, the PunkBuster software is completely separate from the Game software.  It resides in its own folder called "pb" inside the game folder.  For example, if your game is installed into a folder called "c:\games\sof2", then the PunkBuster files will be in "c:\games\sof2\pb".  To remove or uninstall PunkBuster from your system, simply delete the "pb" folder using the explorer program on your computer.  PunkBuster does not modify the system registry nor hide files or other information anywhere else on your system.

There are only a few files in the "pb" folder when PunkBuster is first installed.  When the game is first launched after PunkBuster has been installed, PunkBuster will add new files and folders for later use.

Most people install to and run the game (and PunkBuster) from a local hard drive.  However, for players who run the game from a shared location such as a network file server, an extra step is required in setting up the game to run so that PunkBuster functions properly.  PunkBuster must have full control over its own files and subdirectories for each player.  If multiple players are running the game (and PunkBuster) from the same shared location, then PunkBuster is very likely to have problems authenticating one or more of the players and will eventually remove them from gameplay.  In order to function when running the game from a shared location, the fs_homepath game setting must point to a separate location for each player who runs the game from the shared location.  The easiest way to set this up is to copy the "pb" folder from the shared location to a folder on each player's local hard drive such as "C:\SOF2PB".  Then add +set fs_homepath c:\sof2pb to the end of the shortcut target (or other mechanism) that is used to launch the game for each player running from the shared location.

PunkBuster communicates to players by displaying information directly to the game screen and the game console.  A player can also communicate directly to PunkBuster by typing commands into the game console.  More advanced players may wish to use this ability to put PunkBuster commands into key bindings and game configuration scripts for personal convenience.

The Tilde Key

In general, to access the game's console, press the Tilde Key.  On most Qwerty keyboards, the tilde key is located directly under the Esc key and looks like this:  ~  .  Some non-American keyboard layouts do not have a tilde key and a different key such as the ½ key are the tilde equivalent on those keyboards.  Pressing the tilde key will bring down the Game Console.  The console is used to display several lines of textual information and also accept user input such as commands.  The bottom line of the console will always start out empty and have a ']' character to the far left which is where any typed keystrokes will appear.  To enter any Game or PunkBuster command type out the full command or a few letters of the command, then press the Tab key.  Pressing the Tab key after entering some text into the console tells the Game that you are entering a command.  If you only type a few letters of a command, then the Game will try to auto-complete the command for you by matching the text you have typed up to the point of pressing Tab with known commands in the software.  If there are multiple matches to the text you have typed, then a list of matching commands will be displayed.  For example, typing "PB_" and pressing Tab causes all of the available PunkBuster Client commands to be listed in the console.  The PageUp / PageDown keys can be used to scroll the console output backwards / forwards respectively if necessary to browse through previously displayed information that has already scrolled up past the top of the screen.

All PunkBuster Client commands and settings start with the three character sequence "PB_".  Specific PunkBuster commands and settings are described in a subsequent section of this publication.  Note that if you run your own Server, PunkBuster Server commands are preceded by the six character sequence "PB_SV_".  PunkBuster doesn't care whether commands and settings are typed in lower case, upper case, or in some combination.  ENABLE, enable, and EnAbLe are all the same as far as PunkBuster is concerned.  Any time PunkBuster needs to display a message, the message will be preceded by the words "PunkBuster Client:" or "PunkBuster Server:".  This is useful if you are running your own server so that the source of each message will be obvious.

The In-Game Server Browser

Players who like to join Game Servers from inside the game will notice that there are some PunkBuster friendly features built into the game's interface.  There is a column that shows whether each Game Server currently has PunkBuster On or Off.  There is also an option in the Filter Servers screen whereby users can choose to see only Servers with PunkBuster "On", only Servers with PunkBuster "Off", or both types of servers together.  Clicking on the PunkBuster column will also group all servers in the list together as a sort option.

There are two ways to Enable / Disable PunkBuster software.  One is by typing commands into the game console.  The other way is built into the game's user interface.  Both will be described below.  Note that when PunkBuster is Disabled, it will ignore commands and setting changes except for the specific command to Enable after which it will begin full and proper operation.

From the mutliplayer game's main screen, clicking the 'Join Server' icon moves to the in-game Server Browser and Selection Screen.  In the upper center portion of this screen will be a button that says either 'PunkBuster Enabled: Yes' or 'PunkBuster Enabled: No'.  Click this button to toggle the current status of PunkBuster. If you wish to change from a PunkBuster Enabled mode to Disabled mode, then the game must be restarted. Clicking the button to say 'PunkBuster Enabled: No' simply tells the game that you don't want PB enabled the next time the game is started.

If you wish to create a Game Server, there is a PunkBuster option in the list of Server options.  Set it to 'Yes' if you wish to have PunkBuster Server Software Enabled for the newly created Game Server and set it to 'No' otherwise.

There is no additional cost involved for using PunkBuster in a personal, non-commercial environment.  If you are playing in a prize tournament or any event (whether over the Internet or in a LAN environment) that charges an entry fee and/or awards prizes to participants, the organizers of that event are required to obtain a commercial license with Even Balance, Inc. if they wish to utilize PunkBuster Software during the event.  More information about this requirement can be obtained by emailing license@evenbalance.com.

The alternative method of Enabling and Disabling PunkBuster involves typing commands into the game console.  To Enable PunkBuster from the console, type in "PB_CL_ENABLE" without the quotes.  To Disable PunkBuster, type "PB_CL_DISABLE".  If you wish to run your own game server, you can Enable/Disable the corresponding PunkBuster Server software using similar commands: "PB_SV_ENABLE" and "PB_SV_DISABLE".

NOTICE: PunkBuster cannot be Disabled immediately during the middle of gameplay.  Choosing to Disable PunkBuster by any methods described above will set PunkBuster into Disabled mode but that does not take effect until the entire game is restarted.  Neither Players nor Server Admins can simply turn PunkBuster off and on during the middle of gameplay.  Once PunkBuster Client and/or Server has been Enabled for a gaming session, it stays Enabled regardless of how many times the Enabled/Disabled mode is toggled.  When the game is exited, the current PunkBuster status is saved and the next time the game is started, PunkBuster will initialize to the mode in which it was last set, either Enabled or Disabled.  That means players can Enable PunkBuster once and then never worry about it again if desired, as it will continue to be enabled from that point on even when the Game is exited unless specifically Disabled at some later point in time.

Most Players use some type of Game Browser to find Game Servers to join.  The Game itself has a very nice integrated Game Browser built in so that Players can usually find what they are looking for very easily.  Some Players prefer to use external Game Browsers such as the ones produced by GameSpy, Pingtool and Kali.

The In-Game Server Browser

For Players who use the in-game browser, a column is displayed that specifically shows whether or not each server listed currently has PunkBuster Enabled.

For external Game Browsers, some configuration may be required to display and/or filter servers based on whether or not they currently have PunkBuster Enabled.  First, a little background: while a Game Server is running, it sends a "heartbeat" packet of information every few seconds to several Master Game Servers located around the world.  This heartbeat packet tells the Master Game Servers that the Game Server is running, how many players are currently connected, and the current status of all sorts of things such as the Name of the server, the maximum number of players and what is commonly referred to as the "server rules".  One of the server rules returned by Game Servers is called sv_punkbuster.  If sv_punkbuster is set to "1" for a particular Server, then PunkBuster is Enabled on that Server.  Consult the documentation for your chosen external Game Browser to determine how to display and/or filter servers based on the value of sv_punkbuster.

One of the core aspects of the PunkBuster system is the automatic update feature.  As new versions of PunkBuster files are made available for download from our Internet-based Master PunkBuster Servers, the PunkBuster software running on Players' and Admin's computers will attempt to retrieve those new versions and perform an automatic "self-update" function in the background without interrupting gameplay.  For most users, this occurs automatically and seamlessly.  Since PunkBuster Servers require all connected Players to be running identical versions of all PunkBuster files in order to be authenticated for "clean" online play, the automatic update facility inside PunkBuster is an important component of the overall system.  PunkBuster will retain older versions in case there is ever a need to connect to a Server that is still running old versions of the PunkBuster software.

All PunkBuster update files are stored in special compressed HTM files and can be opened with any Internet Web Browser.  We have designed and implemented a robust method for securely delivering updates from our Master PunkBuster Servers to Regular PunkBuster Servers and then on to computers that have Enabled the PunkBuster Client software.  Great care has been taken to design and develop the system such that only authentic PunkBuster files will ever be accepted and used by the PunkBuster System during the auto-update process.

There may be times, however, when it is necessary to manually update a PunkBuster System.  For instance, if there is no Internet Access available and multiplayer gameplay is occurring in a LAN environment.  Or perhaps, there is a temporary routing problem causing locally running PunkBuster software to not be able to "find" any Master PunkBuster Servers whereby an update can be obtained.  There may also be times that the PunkBuster Team offers pre-release beta versions of PunkBuster software for manual download so that it can be tested before broad distribution.  For whatever reason that may come up that requires a manual update, we have prepared a separate section, called 'Manual Updates' on the Download page of our website at Even Balance.  Since all PunkBuster updates are stored in HTM (web browser compatible) files, there is no need to download archives or to run setup programs in order to update PunkBuster.  All that is required is opening our update files in a Web Browser and then performing the "Save As" function from the "File" menu of the Web Browser.  The instructions for where to save the HTM files on the local hard drive are displayed on the download page.  There are separate sets of files for each Operating System supported (i.e. Windows, Linux, and Macintosh).  After the "Save As" has been performed, PunkBuster knows how to update itself using the saved file(s).  For some manual updates to complete properly, the game may need to be exited and restarted with PunkBuster Enabled.

The use of PunkBuster commands and settings is optional.  This information is provided for advanced users who want to get more out of the PunkBuster software or who want to customize it.  A brief overview of using commands and settings is given, as well as a reference list of all available commands and settings along with explanations of their correct use.

The most common way to enter a command or to check / change a setting in PunkBuster is to bring down the Game Console and type away.  However, since PunkBuster is directly integrated into the game, PunkBuster commands and settings can also be treated just like any other game command or setting in that they can be placed into game script files, bound to keystrokes and used in aliases.

The easiest way to quickly test that your PunkBuster system is properly installed, Enabled, and working is to type "PB_VER" into the game console.  If PunkBuster is working properly, it will respond by displaying the version number that is currently installed and running.  If there is no response, then PunkBuster is either currently Disabled or there is a problem that may require some troubleshooting.  Consult the FAQ (Frequently Asked Questions) Appendix later in this publication for suggestions on ways to troubleshoot this type of problem.

Some commands are standalone and others may require or accept additional parameters.  For example, the command "PB_VER" is standalone, typing in "PB_VER" tells PunkBuster that you would like to know the currently running Version number.  The command "PB_LOAD" takes one parameter (a filename), typing in "PB_LOAD ABC.CFG" tells PunkBuster to load the configuration file called "ABC.CFG".

PunkBuster settings, sometimes also called variables, hold numbers or textual information that PunkBuster uses while it is operating.  Changing PunkBuster settings will affect the way PunkBuster runs in specific ways.  All PunkBuster settings start out with default values that are the recommended setting values for most users.  To find out the current value of a setting, simply type in the name of the setting all by itself.  For example, typing "PB_LOGTOFILE" will cause PunkBuster to display the current value.  Also displayed is the allowable range that the value can contain.  This particular setting can be set either to 1 or 0 and 0 is the default.  To set it to 1, type in "PB_LOGTOFILE 1", PunkBuster will then respond by showing the setting name along with its new value.  Trying to set a PunkBuster setting outside of its allowable range will cause PunkBuster to give the setting the closest allowable value to what was originally specified.

Listed below (in alphabetical order) is a list of PunkBuster Commands and Settings along with a general description and usage instructions where necessary.

PunkBuster issues several types of messages during gameplay.  These will appear at the top of the playing screen for a few seconds before scrolling off.  All messages also are logged to the console and old messages can be reviewed by bringing down the game console.  The game console can be scrolled up or down by using the PageUp or PageDown keys respectively.  During almost every game, there will be periods of inactivity where players are not actively playing the game.  This is a good time to review previous PunkBuster messages to see if you missed any important messages while playing.

The most useful PunkBuster command to get acquainted with is the pb_plist command.  By occasionally issuing a pb_plist command, you can view the PunkBuster status of all players in the game.  The status of each player can either be INIT, UPDT or OK.  The INIT status means that the PunkBuster Server is still initializing that player’s connection.  The UPDT status indicates that the PunkBuster Server is updating that player’s PunkBuster installation.  Other information is displayed by the pb_plist command such as the Auth Rate and RecentSS columns.  The Auth Rate of a player is how many times per minute the player’s PunkBuster has successfully authenticated with the PunkBuster Server.  Once each player has reached OK status, then the Auth Rate should never fall below 2.0.  If it does, that would indicate that PunkBuster is not functioning normally for some reason.  The RecentSS column indicates how many screenshots the PunkBuster Server has requested from each player during the past few minutes.

To get a list of PunkBuster commands with brief usage help during gameplay, bring down the console (with the tilde ~ key) and type "PB_" then press the Tab key.  All PunkBuster Client commands will then be displayed and the PageUp / PageDown keys can be used to scroll the console text up and down.

After each map ends and a few seconds after the next one is starting, the PunkBuster Server will report some information to connected players about the Server log files.  This information gives players the filenames of the log files and also the Digital Signatures of the log files saved at the Server.  This is useful mostly in organized matches where Server Admins provide logs to administrators after each match.  The Digital Signatures that are reported to players keep the Server Admin or anyone else from being able to change or edit the log files without altering the reported Digital Signatures.  If a log file is changed at all, then its Digital Signature will no longer match what was broadcast to all players in the game. We have for download, on our website at evenbalance.com, a free utility called pbmd5 that will compute the Digital Signature (also known as MD5) of any file.  If you would like to "save" the Digital Signature of log files reported by a Server, we recommend bringing down the game console and then taking a screenshot of your playing screen while that information is displayed.  If desired, the PB_GETSS command can be used to save the screenshot.

This is a fairly advanced topic.  This section assumes that the reader is familiar with the concept of game variables (also known as cvars).

If you have used external game browsers such as GameSpy, Pingtool, or Kali, you may have noticed that there are many details about Game Servers that are reported.  Things like the maximum number of players, the current map, the gravity settings, etc. are displayed in the game browser so players can know how servers are set up before attempting to join them.  You may also know that there are many, many variable settings that are not reported by the Game Server to be viewed by persons who do not have access to the Game Server.  The PunkBuster Variable Monitoring Facility is designed to let players view the current value of almost all Server-side variables - the only exceptions are the variables that have the text "password" in them.

Server Admins have the option of disabling this feature for their Game Servers if they do not want players to be able to see the value of Server-side variables.  However, this facility is Enabled by default and if a particular Server Admin has Disabled the feature, players who try to check the value of Server-side variables will be informed that it is Disabled by the Server Admin.

To check the value of a Server-side variable, use the command called "PB_CVARVAL".  After the command, type in the name of the variable you wish to check.  For example, when connected to a PunkBuster Enabled Game Server, type "PB_CVARVAL timelimit" into your console and press the Tab key then the Enter key.  After a short pause, you should see a response similar to: SV_CVAR timelimit = "8".

At the time of this writing, there are over 350 different Server-side variables that may be configured by Server Admins.  If you want a list, start a Server and type 'cvarlist' into your console and the full list will scroll through the console.  It is beyond the scope of this publication to explain Game Server variables and their meanings.

The PunkBuster Screen Capture Facility allows Server Admins to request actual screenshots from players' screens while they are playing.  The screenshots are transferred over the network and saved by the Server Admins either for private use or possibly for publication to a website.  PunkBuster limits the filesize of the screenshots by setting a maximum number of pixels that can be captured.  PunkBuster also limits how many times a PunkBuster Server can request a screenshot within a few minutes to prevent Server Admins from taking screenshots one after another continuously.  All PunkBuster screenshots are saved in the PNG image format and therefore have the ".png" extension.  This format is similar to the JPEG format but does not reduce image quality during compression.  Most newer Web browsers can view PNG files directly.  Programs that convert PNG format images to and from other formats are widely available.  More information about the PNG format can be found at the PNG-Homepage.

There are two PunkBuster settings that can be used by players to track the activity of PunkBuster Servers that request screenshots from their system.  The settings are called PB_SSLOG and PB_SSSAVE.  If PB_SSLOG is set to 1 (which is the default), then PunkBuster will keep a log file on your hard drive in the "pb" folder called "pbsslog.htm".  This log can be viewed using any web browser such as Netscape or Internet Explorer.  The log contains information about each screenshot that was requested by a PunkBuster Server.  If PB_SSSAVE is set to 1 (note that 0 is the default), then PunkBuster will save the actual screenshot to your hard drive after the screenshot image has been transmitted to a PunkBuster Server.  Note that screenshot images vary in size usually between 40 and 80 thousand bytes.  If you play frequently, saving Screenshots to your hard drive can consume a lot of disk space after only a few days.  We don't recommend setting PB_SSSAVE to 1 unless you are sure that you will routinely view the screenshot images and remove them if they start to take up too much disk space for your system.

If PB_SSSAVE is set to 1, PunkBuster saves the screenshots into the folder called "scrnshot" inside the "pb" folder.  The filename used is based on the date that the screenshot was taken.  For example, the first screenshot taken on March the 15th will have the filename "0315_000.png".  The next one would have "0315_001.png", etc.  If you exit the game and play again later the same day, PunkBuster will start over at 000 and overwrite the images taken in earlier sessions.  Please keep this in mind if you intend to keep all of your screenshot images.

When PunkBuster writes log lines to the "pbsslog.htm" file due to a screenshot request from a connected PunkBuster Server, the log lines will have the following format: "<local filename> <server filename> <time screenshot was taken> <MD5 of the screenshot> <address of the game server> <name of the game server>".  If the PB_SSSAVE setting is at 0, meaning that screenshot images are not saved locally, then the first item <local filename> is replaced by the date and the words "(Not Saved)".  The information called <MD5 of the screenshot> is a type of digital signature of the screenshot image.  Logging the MD5 is a way to protect players from unscrupulous Server Admins who would otherwise try to alter or create images in order to "frame" players by making it look like they are running some type of game hack or cheat.  If a screenshot image is modified, then it's MD5 will no longer match the MD5 that is saved to your log file.  For players who are very concerned about protecting themselves from this type of thing, we offer the Remote Logging Facility.

Even Balance, Inc. will soon be offering a premium, optional Name Registry hosting service for Players, Clans, Guilds and other groups who wish to take advantage of our facility for online identity verification.  Registered names are password protected so that only persons knowing the correct password will be designated as *Registered while playing on PunkBuster-Enabled Game Servers.  Subscribers will be able to Register Names either with Partial or Full matching.  Registered Names for Partial matching are designed for groups such as clans, guilds, etc. whose members wear a "tag" (usually at the beginning or end of each member's playing name).  For Partial type Names, the Registered Name can appear anywhere in the player's name to attain *Registered status.  Full matching Registered Names will require an exact match of the playing name to the Name Registration record in order to attain *Registered status.

Each Registered Name comes with a descriptive line of text (up to 80 characters) that is provided so that a website, email address, membership requirements, or other information describing the group or person represented by the Registered Name can be displayed to other players during gameplay.  The Name Registry is not exclusive with regards to unique Registered Names.  Different groups / players will be allowed to Register a Name that is already in the Registry.  All Registrations of a unique Name after the first will have a serial number automatically appended to the Name Registration so that different Registrations can be easily distinguished. When this Service is available, more information will be available on our website at evenbalance.com.

Even Balance, Inc. will soon be offering a premium, optional hosting service for Players who wish to remotely log screenshot signatures in real time for automatic publication to a fully and openly accessible website.  We will offer a similar service for Server Admins.  Each subscriber gets a separate page and each days' activity is further separated into web pages.  The subscription service is password protected so that players who play on multiple machines can log screenshot signatures from their various playing machines.  When this Service is available, more information will be available on our website at evenbalance.com.

PunkBuster software running on game servers and also on the computers of connected players during gameplay is continuously validating each player with respect to avoiding violations. A violation can be raised by PunkBuster for various types of things depending on how each Server Administrator chooses to configure PunkBuster on the game server. The various categories of violations are explained below.

When a violation is raised, PunkBuster announces this violation to all connected players in the game and then saves information about the violation into a PunkBuster log file on the server. In most cases, the player associated with the violation will also be removed from the server for a few minutes. It is up to each Server Admin whether or not to permanently ban players for violations raised by PunkBuster.

Note that some servers are non-dedicated. That means that one of the players is running the game server while also playing inside the game (known as a localhost player). If PunkBuster raises a violation on such a localhost player, the violation will be reported, but the localhost player will not be removed from the game. The other players will be alerted to the fact that PunkBuster is foregoing the kick due to the violation being raised on the localhost player.

Steps to resolve violations are given below with each violation category. Any player who has problems resolving a violation should visit our online web forum or send an email to support@evenbalance.com for assistance. When requesting assistance, be sure to specify the violation number raised and give as much additional information as possible.

Technical Violations: (Resolution: Reinstall PunkBuster from the latest game update patch)
#101 - Communication Failure
#102 - Communication Failure
#131 - Initialization Failure
#132 - Protocol Error
#141 - Distress (This indicates a problem trying to update to the latest version of PunkBuster - it may indicate a problem reaching one of our Internet-based Master PB Servers which can be caused by firewalls, router problems, etc.)

Miscellaneous Violations:
#111 - Bad Name (Resolution: Change player name or play on a different server)
#112 - Too Many Bad Names
#113 - Too Many Name Changes (Designed to eliminate name change spamming)
#114 - Protected Name (Resolution: Change player name or play on a different server)
#121 - Negative Score Too Low (usually from Killing Teammates)
#9001 - CVAR value failed range check (see the FAQ for more info)

Integrity Violations:
When PunkBuster is unable to verify that a player's gaming environment is functioning properly and/or has not been alterred, an Integrity violation is raised. This also involves the detection of modified game or PunkBuster files. These violation numbers are between 10000 and 29999.

Cheat/Hack Violations:
When PunkBuster detects a cheat or hack by repeated positive identification on a player's computer, a violation is raised. These violation numbers are 50000 and higher. Families of cheats are listed below. Resolution: Remove cheats and hacks from the computer.
#50000s - Aimbot
#60000s - Wallhack
#70000s - Multihack
#80000s - Gamehack
#90000s - 'Cheat' Video Drivers
#100000s - Speedhack
#110000s - Autofire

Why doesn't my PunkBuster Client work even though everything is installed properly?

Check the fs_homepath game cvar from the game console (enter "\fs_homepath"). Then, using the explorer program on your computer, verify that the path pointed to by fs_homepath does in fact have a "pb" subfolder that includes at least these three files: pbsv.dll, pbcl.dll and pbag.dll (or pbsv.so, pbcl.so, and pbag.so on Linux systems). If not, then either locate and copy the "pb" folder from your SOF2 installation into the fs_homepath location, or change the fs_homepath cvar to point to your SOF2 installation. Note that the "pb" folder must have read and write permissions. We realize this is a tricky topic. If you need further assistance, please visit our online web forum.

My computer locks up or "chugs" sometimes while I'm playing with PunkBuster Enabled, what can cause this?

PunkBuster "pushes" hardware and the Windows Operating System more than most software and uses functions in the Windows API (low level functions) that aren't used by most other programs. As such, there are a few cases where using PB can actually expose flaky hardware or other situations that don't cause problems for other software. Here are a few things that have helped other users make the lockups go away:
1) Make sure you are using the latest version of PunkBuster (the latest version is always on our Download page).
2) If you have trouble updating to the latest version, then try creating your own Server from the Multiplayer screen in the game, and let it idle (sit unused) for a couple of hours.
3) Never close other programs from your Task Manager before playing the game, either leave them running or close them through the proper interface - killing a process doesn't always work completely even if it stops showing in the Task Manager and renegade threads seem to conflict with PB more than other programs that may be running in memory.
4) Check the add/remove programs list in your Control Panel and uninstall any programs that you don't use or that you don't know what they are.
5) One program that seems to conflict with PB more than others is Norton Anti-Virus. If you have it installed, try uninstalling it to see if the lockups go away. Some players have reported that when this is the culprit, they can reinstall Norton Anti-Virus and the lockups don't come back.
6) Some players discovered that they had a computer virus and that the lockups vanished after it was fully removed.
7) Experiment with the pb_sleep setting ... try setting it to 20 or to 250 to see if that affects your game performance. A few players have reported that all the problems go away when they "tweak" this setting.
8) In extreme cases, a few users have reported that replacing their RAM (memory) or video/sound cards fixed the problem.

How do I know if I am PunkBuster Authenticated?

Old versions of PunkBuster went through "Authentication" procedures every few minutes and announced when each player had been Authenticated.  The newer, integrated version is constantly Authenticating players during gameplay.  To check your current status, press the tilde key (~) to bring down the Game Console.  Enter "pb_plist" into the Game console (without the quotes) and then press the Tab key so the Game knows you are entering a command, then press the Enter key.  The current PunkBuster status of all players will be displayed - use the PageUp / PageDown keys if necessary to scroll the console text up and down.  There are 3 modes of PunkBuster status: INIT, UPDT, and OK.  If it says OK next to a player's name, then that player is currently Authenticated.

What is a guid?

In general, GUID is an acronym that stands for “globally unique identifier”.  The guid inside PunkBuster is used to identify players with something more solid than their playing name or IP address.  Your guid is loosely based on the cdkey that was used to install the game on your computer.  When Server Admins kick or ban a player from their server(s), PunkBuster uses the player's guid to enforce the kick/ban.  Since it is based on the game installation, it is a better way to identify individual players than by looking at their IP address or playing name.  For those concerned about privacy, PunkBuster uses a 128-bit one-way hash (a mathematical function) to generate the guid from the cdkey so that no one can figure out or compute your cdkey by knowing your guid.

What do the AuthRate and RecentSS columns mean in the pb_plist output?

The AuthRate column shows how many times per minute PunkBuster has successfully Authenticated each Player.  This value should normally settle to between 2 and 3 for all players after they have a status of "OK".  The RecentSS column indicates how many screenshots the PunkBuster Server has requested from each player during the past few minutes.  This value is available to all players so that "home team" Server Admins don't abuse the screenshot facility, for example by only capturing screenshots of opponents.

Why do I get a message on some servers asking me to change my name and how do I do that while playing?

PunkBuster includes a "BadName" Facility that some Server Admins use to prevent players from including "bad" words (such as racial slurs or profanity) in their playing names.  If you wish to play on such servers and you get a message asking you to change your name, then you will need to change your name quickly to avoid being removed from the Server.  There are 2 easy ways to change your name while playing.  One way is to just click on your name on the Game's Limbo Screen and just edit the name directly.  Another way is via the console, press the tilde (~) key to bring down the game console, and change your name by entering "name new_name" without the quotes, then press the "Tab" key, and finally the "Enter" key.

Why do I get messages on some servers telling me that I have cvar violations and what should I do about it?

A cvar is a game setting.  Cvars can be used to customize the game, but cheaters sometimes abuse cvars to exploit holes or bugs in the game in order to cheat.  Admins of PunkBuster Servers have the ability to add specific recurring checks for players' cvar values during gameplay.  If you have downloaded or written game scripts to automate tasks, then those scripts almost certainly will add and/or change cvars in your system.  You will receive a warning if a cvar on your system is not in the range allowed by the Admin of the Game Server to which you are currently connected - the warning will also include the allowed range of values for the specified cvar.  If you do not heed the warning, then after a few seconds or minutes, the PunkBuster Server will raise a violation and remove you from the Game Server.  To change the current value of any cvar, press the tilde (~) key to bring down the game console, and then type the cvarname followed by a space and the new value, then press the Tab key and then the Enter key.  For example, entering "cg_shadows 0" as a command will set your cg_shadows cvar to the value of 0.  The Game automatically saves most cvar changes so that the next time you play, any changes from a previous session will still be in effect. You may request a list of all checked cvar rangess from the server using the “pb_cvarlist” command. You will see all checked cvars, the allowed ranges and also any of your cvars that are currently set outside the allowed ranges.

What does "New Security Information Received" mean?

During gameplay, the PunkBuster Client will be contacting the Master PunkBuster Servers about new PunkBuster system, database and data files (see section PB Subdirectory and File Information for more information about these file types) as well as other crucial information.  This message states that the new information has been received successfully from the Master PunkBuster Servers.  If new versions of PunkBuster are transferred to the PunkBuster Client from the PunkBuster Server to which the player is connected, the received files will be validated for integrity based on this Security Information.  PunkBuster Server software also confirms the integrity of newly obtained files based on similar Security Information.  This is all part of a complicated system designed to prevent Server Admins (and other people) from sending viruses or other unwanted files to your computer using the PunkBuster auto-update system.

How can I turn off PunkBuster Messages?

By default, PunkBuster outputs to both the top of the playing screen and also to the game console.  If you want to prevent PunkBuster from sending output to the playing screen, add the "at-sign": @ to the beginning of your pb_msgprefix setting (see Settings for more info).  Output will only be sent to your game console in this case.

Do I have to re-configure my firewall or proxy to use PunkBuster?

In general, if a connection can play the Game online successfully without PunkBuster, then there will be no need to make any changes to a firewall or proxy that may be in use when PunkBuster is Installed and Enabled.  PunkBuster communicates over the Internet (and in LAN environments) using the same network channels created and used by the Game, and therefore requires no changes. If, however, you had to adjust your firewall to use the game in the first place, you may need to extend that adjustment to include ports used by PB's auto-update feature. PunkBuster Clients use outgoing UDP Port 24347 to get security info from the PunkBuster Master Servers.

How do I uninstall PunkBuster?

If you do not wish to use PunkBuster any longer, you may remove the entire “pb” folder inside your game folder.  By removing this folder, the PunkBuster software will no longer be available.  PunkBuster does not save information to other locations of your hard drive, nor does it change your system registry.

Can I link to your site?

Yes, but please do not mirror our download files.  One of the following buttons can be used to link to us if you like.

   

Other questions? Visit our online forum at evenbalance.com