Modifying Game Server Configuration Files

You can modify the following Battlefield 2 game server configuration files on the remote host through the Parallels Plesk Panel:

Note: The listings and parameter selection guidelines for each game server configuration file are found at the end of this procedure.

To modify the game server configuration files, follow these steps:

  1. Go to the list of Battlefield 2 game servers available on an individual operator account (Modules > Operators > Battlefield 2 Game Servers of <operator account name>).
  2. Click the server access link in the Name column. The Configuring Game Server window opens that contains two tabs - Configuration and Configuration files.

    Note: If a game server in the list has not been configured yet (the game server access link is displayed as not configured in the Name column), you will have to fill out Configuration tab first to be able to select the Configuration files tab.

  3. Select the Configuration files tab. The tab displays three data sections: Configuration file serversettings.con, Configuration filemaplist.con, Configuration file banlist.con. Each data section has two scrollable frames. The left frame is an editable text box that displays the content of the corresponding config file. The right frame contains the parameter value selection guidelines for each configuration parameter displayed in the text box.
  4. Edit the configuration contents in the text boxes following the parameter value selection guidelines displayed in the explanation frames on the right.

    To edit a configuration file content, click within the text box and edit the text of the file as you would normally do with a Notepad text file.

    Note: The listings and parameter selection guidelines for each game server configuration file are found at the end of this procedure.

  5. Click Apply to save the changes and continue editing the configuration files. Click OK to save the changes and exit the screen.

The listings and parameter selection guidelines for each game server configuration file:

Parameter name and default values

Parameter value selection guidelines

sv.serverName "<server name>"

This is the name your server will be listed by in the Internet or LAN server browser.

sv.password "<password>"

If you set a password, players will need to enter it before connecting to your server.

sv.internet 0

Set this to report your server to the Internet server browser list.

sv.bandwidthChoke 0

Use this setting to limit the amount of network bandwidth your server is allowed to use.

 

sv.maxConnectionType <value>

Players who exceed this limit will n0t be allowed to connect to your server

sv.allowFreeCam 0

Allow players to use a free-roaming camera while waiting to spawn. Players can activate this camera using the JUMP key.

sv.allowExternalViews 1

Use this to enable or disable the use of 3rd person cameras in vehicles.

 

sv.allowNoseCam 1

Use this to enable or disable the use of nose-cam in certain vehicles (planes/helicopters).

sv.maxPlayers 32

The maximum number of players allowed on your server at once. This setting also determines whether the 16, 32 or 64 player configuration of maps is used.

sv.startDelay 15

This is the amount of time in seconds players are kept waiting for the game to start, once the minimum number of players has been reached.

sv.endDelay 15

This is the amount of time in seconds between when a round ends and a new round begins.

sv.spawnTime 15

This is the amount of time in seconds that players will wait to spawn in the game again after being killed.

sv.manDownTime 15

This is the amount of time players will wait to spawn in the game again after being incapacitated and able to be revived by a medic. We recommend that this is set to the same value as sv.spawnTime.

sv.ticketRatio 100

You can set the percentage of the normal number of tickets you wish to use.

sv.roundsPerMap 3

Set the number of rounds to complete before the map automatically changes to the next on the list.

sv.timeLimit 0

After this amount of time is reached, the round will end.

sv.soldierFriendlyFire 100

This is the percentage of direct damage that soldiers will receive from other players on the same team.

sv.vehicleFriendlyFire 100

This is the percentage of direct damage that vehicles will receive from other players on the same team.

sv.soldierSplashFriendlyFire 100

This is the percentage of splash damage that soldiers will receive from other players on the same team

sv.vehicleSplashFriendlyFire 100

This is the percentage of splash damage that vehicles will receive from other players on the same team.

sv.voteTime 90

This is the amount of time that a poll such as a kick vote or map vote stays open.

sv.minPlayersForVoting 2

This is the minimum number of votes needed for a poll to be sucessful.

sv.autoRecord 0

Enable or disable automatic demo recording.

sv.demoDownloadURL "<url>"

If demo recording is enabled, this should be set to the publicly accessible URL where the demo files can be downloaded.

sv.autoDemoHook "adminutils/demo/rotate_demo.py"

This is the application or script that is called on to manage demo recordings at the end of rounds.

sv.adminScript "default"

Set the path to a custom admin script to run.

sv.hitIndicator 1

This setting toggles whether or not players receive crosshair feedback indicating they have hit a target.

sv.numPlayersNeededToStart 2

The minimum number of players needed for a round to begin. Until this number of players have joined, the server stays in a "pre-game" state and neither team loses any tickets.

sv.tkPunishEnabled 1

Enable the system through which players can punish teamkillers in an attempt to kick them from the server.

sv.tkNumPunishToKick 3

When punishing is enabled, this sets the number of punished teamkills required to be kicked from the server.

sv.tkPunishByDefault 0

This sets whether or not a player is automatically punished for a teamkill.

sv.voipEnabled 1

Enable the use of VOIP for squad communication.

sv.voipServerRemote 0

Enable the use of an external BF2 VOIP Server, thereby disabling the integrated VOIP server.

sv.voipServerRemoteIP ""

When using an external VOIP server, this should be set with it's IP address.

sv.voipServerPort 55125

The VOIP server uses this port to receive BF2 server data. When using an external VOIP server, this should be set to the port associated with the shared password from the VOIP server's configuration.

sv.voipBFClientPort 55123

This is the port the BF2 client uses for communication with the voip server.

sv.voipBFServerPort 55124

The BF2 server uses this port to communicate with the VOIP server.

sv.voipSharedPassword ""

When using an external VOIP server, this should be set to the password associated with the VOIP Server port from the VOIP server's configuration.

sv.voipQuality 3

Use this to adjust the quality of VOIP audio. Raising the quality level will increase the amount of bandwidth your server uses. Recommended settings are 5 for LAN and 3 for Internet.

sv.gameSpyPort 0

Your server sends information about settings and status through this port. You only need to change this if it is in conflict with another port being used on your system. For best results, this value should stay between 29900 and 29950.

sv.allowNATNegotiation 0

Allow Network Address Translation negotiation. Try this if you use a router or gateway device and are having problems hosting a server.

sv.autoBalanceTeam 0

Enabling this will automatically move players to the team with less players when they die, and will prevent players from switching teams if it would cause then to be too unbalanced.

sv.teamRatioPercent 100

This ratio represents how autoBalanceTeam considers the desired ratio between team 1 and team 2. The percent represents what percent of team 1's current players is considered 'even' for team 2.

sv.sponsorLogoURL "<URL>"

Enter a URL to an image, and it will be displayed in the server browser when the server is highlighted. The image must be in PNG or JPG format, and should have a 4:1 aspect ratio for best results.

sv.PunkBuster 1

Enable PunkBuster automatic cheat protection. Visit http://www.evenbalance.com for more information about PunkBuster.

sv.useGlobalRank 1

This setting toggles whether or not players can use and show their official rank they have earned by playing on ranked servers.

sv.useGlobalUnlocks 1

This setting toggles whether or not players can use the unlocks they have earned by playing on ranked servers.

sv.welcomeMessage "<text>"

This text is displayed on the map load screen when connecting to the server.

sv.serverIP <ip address>

This setting allows you to set the network interface IP address for your server.

sv.serverPort 16567

This setting allows you to customize the port used for gameplay network traffic.

sv.votingEnabled 1

Enable or disable voting.

sv.communityLogoURL "<url>"

Enter a URL to an image, and it will be displayed in the loading screen when connecting to the server. The image must be in PNG or JPG format, and should have a 4:1 aspect ratio for best results.

sv.demoQuality 1

Set the quality of demo recording, if enabled, on the server. INCREASING THE VALUE OF THIS SETTING WILL SEVERLY IMPACT THE PERFORMANCE OF THIS SERVER.

 

Parameter name and default values

Parameter value selection guidelines

mapList.append <map name> <game mode> [number of players]

For example: mapList.append strike_at_karkand gpm_cq 32

Add a new map to the end of the map list. You must specify the map name and the game mode. Number of players is optional, if not specified will default to the current server setting.

Parameter name and default values

Parameter value selection guidelines

admin.addAddressToBanList <IP address> [<timeout>]

Adds a player's IP address to banned list. Where can take one of these formats:

  • Omitted or 'perm' meaning that the ban is permanent.
  • An integral number meaning the number of seconds the ban will be active (i.e. 3600 means one hour).
  • Round, meaning the ban is active until the next map.
  • An integral number prepended by a colon (i.e. :1234567), meaning the expiration time of the ban (number of seconds since 1 Jan 1970).

admin.addKeyToBanList <player's CD key> [<timeout>]

Adds a player's CD Key to banned list.