Wikia

OpenArena

Configuration examples

370pages on
this wiki
Talk0

Here you can find some particular server configuration examples, to enable particular gaming styles. You can create your own cfg files mixing these examples with the standard configuration you can find in Servers#Server config example.

Remember! Your own map rotation script can be used to change A LOT of things between matches! Not only map, but also gametype, fraglimit, timelimit, capturelimit (very useful if you have to switch from Capture The Flag to Domination mode or vice-versa), players' speed, dmflags, instant-gib option, etc. etc. etc.

ExplanationEdit

You could find them useful when playing offline or when starting your own server. They require you know a bit how to use the game's console commands, and how to manage custom configuration files (you can create such files with a plain text editor, give them a name -for example, test.cfg-, place them in your baseoa folder, launch OpenArena and execute that configuration with \exec <filename> command -for example, \exec test.cfg-... for from your Operating System command line, like OpenArena.exe +exec test.cfg under Microsoft Windows).

Please read Manual/Multiplayer and Servers pages for more informations about how to start a server. They could be a good read, before trying the particular game styles you can find here.

The main example of a server configuration is the one you find here: Servers#Server config example. It should be updated for the latest OpenArena releases, and cover all the main settings, like the server name, the maximum and minimum pings allowed, etc.

In these configuration files, we suggest to set the variables using set (usually) or sets (to have them shown in the server status), because some of them (like g_elimination) could not be recognized until you start a match. Typing \g_elimination 1 in console directly from the main menu could give "Unknown command g_elimination" error; typing \set g_elimination 1 everything should work correctly.

When you add a new example to this page (please use a sub-page of this one for each example. Of course, you can put more variants of the same concept in a single page) to show a nice custom configuration, please remember to explain if that server configuration is "complete" or it talks only about the settings really related to the specific customization, and the user should integrate that configuration with the values he can find in the main server config example. The second one needs a little more work for the final user, but is advisable because it removes the need to update that generic configuration parts each time also here, other than in the main example. It would be a nice thing to include also a section to "restore standard configuration" to allow users to create a separate custom configuration file to execute to undo the changes previously applied to variables that are stored (for example, if your example sets g_elimination 1, it would be nice to have another cfg file that sets it to 0 -its default- again)[1]. If you know that some functions do not work (or behave differently) with some versions of OpenArena, it could be a nice idea to write it. You can also suggest to the users some names they could use when creating the cfg files copy-pasting the text from your examples here to their text files.

You can mix various Gametypes with various Special game options.
You can also write a configuration to use with a specific mod instead of baseoa: in this case, please be sure to specify the mod name in the name of the page you create here (for example "Configuration examples/Capture the Flag under Insta-RJ mod" could be a clear page name), and remember to specify the mod's version in the page, and to add a link to the mod's page that is under Mods or ModCompat section (and you can add a link from the mod's description page to its configuration example here, too).

Hint: Are you bored to play always the same sequence of maps? Do you wish to play on various maps, without having to lose time creating your own map rotation scripts, or without manually load each map? Are you searching for a way to play on randomly-picked maps? G_autonextmap feature (introduced with OA 0.8.8) may be what you are searching for!
Warning: Please notice that g_autonextmap would ignore your map rotation script, so if you planned to use the rotation script to automatically change some settings (e.g. gravity or Elimination mode starting ammo) between matches, that would not work when "auto change map" option is enabled. Settings that are not part of the map rotation script will work normally.

Configuration examplesEdit

NotesEdit

  1. It is a good idea to specify from which OpenArena version you took the default values: since defaults can change from a version to another, there could be the need to update them later. Writing a variable name in your command console without setting its value will return the present value, and often also its "default" value. Warning: you should check default values after starting a match... if you check them from main menu, before having entered a match, previous value stored in your config file may be erroneusly indicated as "default" one, and some variables could even be referred as not existent.

External linksEdit

  • Notepad++, a good text editor for Microsoft Windows, free and open source. Wikipedia article. It handles some existing q3config.cfg files better than the standard notepad application (that may show squares instead of going to "new line"). No need to convert the format of existing q3config.cfg files, if Notepad++ asks for it.

See alsoEdit

Around Wikia's network

Random Wiki