File Details

Download this file | Go to files list

Quick start

- Run the server installer and follow the instructions.

IMPORTANT:
Please note that if you choose to install the server over an existing installation the existing installation directory will be removed!

Example:
$ sh bf2_linuxded-x.y.z-installer.sh

- Modify mods/bf2/settings/serversettings.con to your taste.

Example:
$ cd /path/to/installation/bf2
$ vi mods/bf2/settings/serversettings.con

- Modify mods/bf2/settings/maplist.con to your taste.

Example:
$ cd /path/to/installation/bf2
$ vi mods/bf2/settings/serversettings.con

IMPORTANT:
Please see the information below to understand the new map list format.

- Run the server from within the top-level directory by typing
./start.sh [arguments] from a shell.

Example:
$ cd /path/to/installation/bf2
$ ./start.sh

- If you are starting the server from a remote connection you will need to encapsulate it inside a "screen" session to let it stay behind when you log out from the shell.

Example (to start the server):
$ cd /path/to/installation/bf2
$ screen ./start.sh
Now press Ctrl-A followed by Ctrl-D to detach the screen session, leaving it running in the background. You can now log out without affecting the server.

Example (to reconnect to the server status monitor):
$ screen -r

Please see the man page for screen to learn more about what it can do.

More information

Welcome to the Battlefield 2 dedicated server. For patch-specific information please refer to the generic read me file included with both the Linux and win32 distributions.

For discussion with the developers and other users of this server please subscribe to the bf1942 mailing list. To join the list, send a message to and follow the instructions given to you in the reply.

If you prefer to use a forum, there is one set up at the distribution site for the open beta series at http://www.bf1942.lightcubed.com . You can report bugs both in the forum and on the mailing list. Please don't send bug reports in private mail, use the forum or the list instead.

BattleRecorder

See ReadmeServer.txt located in the same directory as this file for information on what the BattleRecorder can do. To get this to work on linux you will need to have Python installed on your
machine. You can find python at http://www.python.org.

The file case confusion problem solved

The BF2 Linux server will read lower-case filenames ONLY. All file names encountered at runtime are lower-cased before a filesystem access is attempted. The only exception is Python-scripts. You should therefore make sure all files are lower-case when installing third-party modifications and maps.

To aid you with this there is an included python script called lowercaseDir.py which recursively changes the case of files and directories from the directory where it's run.

Usage:
lowercaseDir.py [--pretend] [--verbose]

You can simulate the actions of the script with these options:
$ ./lowercaseDir.py mods/yourMod --pretend

When you're certain it looks good run the conversion:
$ ./lowercaseDir.py mods/yourMod --verbose


Known issues

OVERLAY SERVERS
- You must set sv.allowNATNegotiation to 1 in order to broadcast all instances of overlay servers.

Option summary

The following information was included in the Win32 Server Launcher and is repeated here for your convenience.

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

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

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

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

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

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

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

sv.maxPlayers 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 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 This is the amount of time in seconds between when a round ends and a new round begins.

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

sv.manDownTime 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 You can set the percentage of the normal number of tickets you wish to use.

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

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

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

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

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

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

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

sv.minPlayersForVoting This is the minimum number of votes needed for a poll to be successful.

sv.autoRecord Enable or disable automatic demo recording.

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

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

sv.adminScript Set the path to a custom admin script to run.

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

sv.numPlayersNeededToStart 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 Enable the system through which players can punish teamkillers in an attempt to kick them from the server.

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

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

sv.voipEnabled Enable the use of VOIP for squad communication.

sv.voipServerRemote 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 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 This is the port the BF2 client uses for communication with the voip server.

sv.voipBFServerPort 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 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 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 Allow Network Address Translation negotiation. Try this if you use a router or gateway device and are having problems hosting a server.

sv.autoBalanceTeam 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 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 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.svPunkBuster Enable PunkBuster automatic cheat protection. Visit http://www.evenbalance.com for more information about PunkBuster.

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

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

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

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

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

sv.votingEnabled Enable or disable voting.

sv.communityLogoURL 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 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.

Have fun with your Linux server!

Andreas Andersson

Licensing information

The Battlefield 2 server is linked with the GNU C and C++ libraries which are under the LGPL license. By linking dynamically we ensure that you as a user can use this software with other versions of these libraries.

A statically linked binary also linked with these libraries is supplied purely for convenience should you not be able to run the dynamically linked binary.

The LGPL license text is included with this release and can be found on the web at http://www.gnu.org/licenses/lgpl.html.

Please note that the Battlefield 2 dedicated server itself is not covered by the LGPL license.

Download this file | Go to files list