Contents of INI Files   


Note that each of the INI files has an [XMaps.Install] section, which records the version of XMaps installed against a Version key.  In addition to the Keys listed below, XMaps.ini also stores the metrics of each of the Setup windows in seperate sections.

[Click here to open the table in a new window]


XMaps.ini

Section Key Description
[XMaps.XMapsControl] XMapsMode The Map selection mode from the Setup window. Values:
0 = Random maps
1 = Extended Map List, in order
2 = Extended Map List, random order
3 = None
XMapsUseFavourites Use Favourites from the Setup window. Values:
True = Use Favourites on
False = Use Favourites off
XMapsSwitchGames Switch game types from the Setup window. Values:
True = Switch game types on
False = Switch game types off
XMapsLargeMenuFont Large HUD font from the Setup window. Values:
True = Use a large font in the in-game HUD menu
False = Don't use a large font in the in-game HUD menu
XMapsMapOverride Determines whether maps selected from the Maps Installed HUD menu option load without changing the game type or not. This setting also affects the caption of the menu option ('Maps Installed' becomes 'Game Override' when this option is on). Values:
True = Game Override on
False = Game Override off
XMapsMatchBots Match players from the Setup window. Values:
True = Match players on
False = Match players off
XMapsMatchScale The Match players slider from the Setup window. Only has an effect when Match players is on. Values:
0 = lowest
1 = lower
2 = average
3 = higher
4 = highest
XMapsNumBots Used internally to store the number of bots when player matching is on.
XMapsMinPlayers Used internally to store the minimum number of players when player matching is on.
XMapsHijackEarly Now redundant. Used to control the point at which XMaps hijacked the map list class of the game.
XMapsGameMRU[0..31] The implementation of the most recently used list of game types. Used by XMaps to ensure game switching doesn't pick the same game type too soon. As each game starts up, it's inserted at the beginning of the MRU.
XMapsGames[0..255] The game types set up for switching in the Game Switching tab of the Game Options window.
XMapsMaxGames The maximum number of games to play before switching to another game type. Controlled by the Switch game types slider in the Game Switching tab of the Game Options window.
XMapsMinGames The minimum number of games to play before switching to another game type. Controlled by the Switch game types slider in the Game Switching tab of the Game Options window.
XMapsWaitTime The time to wait at the end of a game before switching game types, in seconds. Note that any value less than 10 can cause problems with the timing of the announcer countdown.
XMapsAnnounceOff The Disable announcer countdown value from the Game Switching tab of the Game Options window. Values:
True = Announcer countdown disabled
False = Announcer countdown enabled
XMapsPlayFullAssault The Don't interrupt Assault games value from the Game Switching tab of the Game Options window. Values:
True = Play both parts of an Assault game during automatic game switching
False = Only play the first part
XMapsPauseForHUD Determines whether UT is paused when you use the in-game HUD menu. Values:
True = Pause UT when the in-game HUD is used
False = Don't pause UT when the in-game HUD is used
XMapsDontSavePasswords Used to record the 'Dont save passwords' value set in the Client Options window. Values:
True = Clients are not allowed to save server admin passwords
False = Clients are allowed to save server admin passwords
XMapsHUDCommandTimeout Used to record the HUD Command timeout from the Client Options window. The value is in game 'ticks', in the range 20 to 150, default 50.
XMapsHUDCreationTimeout Used to record the HUD Creation timeout from the Client Options window. The value is in game 'ticks', in the range 50 to 750, default 250.
XMapsAccessLevel Access Level from the Client Options window. Values:
0 = Any Admin user
1 = Any Admin user in the Client List
2 = Any Admin user not in the Client List
3 = Any user in the Client List
4 = Any user not in the Client List
XMapsUserList[0..127] The contents of the Client List from the Client Options window.
XMapsRestrictClientSetup Auto-open Client Setup for Authorised Users only, from the Client Options window. Values:
True = restrict the users that automatically get the Client Setup window
False = don't restrict the users that automatically get the Client Setup window
XMapsMaxRandomMaps The Maximum Random Maps setting from the Client Options - Limits window. Values in the range 100 to 1000, default 400.
XMapsExtendedCopied Used internally to record a successful update from an earlier version of XMaps.
XMapsFavouritesCopied Used internally to record a successful update from an earlier version of XMaps.
XMapsModeSet Used internally to record a successful update from an earlier version of XMaps.
XMapsModeSet2 Used internally to record a successful update from an earlier version of XMaps.
XMapsCopied Used internally to record a successful update from an earlier version of XMaps.
XMapsReloadFirstMap The 'Reload first map' setting from the Setup window. Values:
True = Reload first map is on
False = Reload first map is off
XMapsCheckMapFail The 'Skip failed maps' setting from the Setup window. Values:
True = Skip failed maps is on
False = Skip failed maps is off
XMapsExplicit Used internally to determine whether a map load has been requested by XMaps or elsewhere (to support XMapsReloadFirstMap).
XMapsServerIdleEnabled Specified whether the Idle Monitor is enabled (True) or not (False).
XMapsServerIdleTimeout The Idle Monitor timeout in seconds. Only has an effect when Idle Monitor is enabled.
XMapsServerIdleAction The action to take when the Idle Monitor times out. Only has an effect when Idle Monitor is enabled. Values:
0 = Skip current map
1 = Switch game types
2 = Switch to specific game type (XMapsServerIdleGameType)
3 = Switch to specific map list (XMapsServerIdleMapList)
XMapsServerIdleGameType The game type to process when the Idle Monitor times out. Only has an effect when Idle Monitor is enabled.
XMapsServerIdleMapList The internal index of the XMaps map list to process when the Idle Monitor times out. Only has an effect when Idle Monitor is enabled.
XMapsUserGroup[0..127] Stores the index of the user group for each user in the XMaps user list.
XMapsDefaultAccessGroup The index of the user group to use as the default. The use of this index depends on the XMapsAccessLevel configured.
XMapsAS Redundant - used to store the index of the Extended Map List for Assault games.
XMapsCNQ Redundant - used to store the index of the Extended Map List for Conquer games.
XMapsCTF Redundant - used to store the index of the Extended Map List for Capture the Flag games.
XMapsDOM Redundant - used to store the index of the Extended Map List for Domination games.
XMapsDM Redundant - used to store the index of the Extended Map List for Deathmatch games.
XMapsDTF Redundant - used to store the index of the Extended Map List for Dominate the Flag games.
XMapsFD Redundant - used to store the index of the Extended Map List for Flag Domination games.
XMapsSF Redundant - used to store the index of the Extended Map List for Strike Force games.
[XMaps.XMapsAccessGroups] GroupName[0..19] The names of the User Groups.
Roles[0..19] The roles assigned to each of the User Groups. These are internal codes; each letter in the string indicates a 'role' that a user in the group is allowed to perform. An empty string means no access at all.
[XMaps.XMapsExtendedGML] GameMapList[0..255] The Game Type to Extended Map List mapping. The value tells XMaps which Extended Map List to use for each game type, in the form <GameType>/<Index>, where Index is the index of the Extended Map List in the extended class storage array. The naming scheme for the extended classes means that the Extended Map List can be identified by the full class name XMaps.XMapsUL<Index + 1>.
So, a GameMapList value of BotPack.DeathMatchPlus/8, for example, would mean "use XMaps.XMapsUL9 for Tournament Deathmatch games". Note that the Extended Map Lists are stored in XMapsExtended.ini.
[XMaps.XMapsFavouritesGML] GameMapList[0..255] The Game Type to Favourites Map List mapping. This works in the same way as the [XMaps.XMapsExtendedGML] GameMapList, but the Favourites are stored in classes that start "XMaps.XMapsVL", in the XMapsFavourites.ini file.
[XMaps.XMapsSetupCW] AutoOpenOptionsWindow Auto-open Game Options window from the Game Options window. Values:
True = automatically open the Game Options window (when XMaps is selected from the Mod menu)
False = don't automatically open the Game Options window
[XMaps.XMapsFavouritesListCW] AutoPreviewExMaps The Auto preview control from the Available Maps list in the Favourites map list editing window. Values:
True = Auto preview on
False = Auto preview off
AutoPreviewIncMaps The Auto preview control from the Favourite Maps list in the Favourites map list editing window. Values:
True = Auto preview on
False = Auto preview off
[XMaps.XMapsExtendedListCW] AutoPreviewExMaps The Auto preview control from the Available Maps list in the Extended map list editing window. Values:
True = Auto preview on
False = Auto preview off
AutoPreviewIncMaps The Auto preview control from the Maps to Cycle list in the Extended map list editing window. Values:
True = Auto preview on
False = Auto preview off
[XMaps.XMapsMutators] Mutators[0..255] The list of mutators that XMaps should load for each game type. Each value is in the form <GameType>/<MutatorList>, where MutatorList is a comma-seperated list of mutator classes.
[XMaps.XMapsRandomExLists] ExLists[0..255] The Extended Lists used for cycling when the Map Selection mode is 'Random across Extended Lists'. Each value is in the form <GameType>/<list indexes>, where list indexes is a comma-seperated list of Extended List classes.