Configuration - config.xml

This section describes the configuration options in the main config.xml file:
  • <masteradmins>
    Previously named <admins>, this section should contain only those logins you want to have all admin rights. On TMN/TMF it should also contain the server owner's LAN login (with IP and port), if applicable, as those will be skipped by the /admin listmasters command. After each <tmlogin> field can be an <ipaddress> field, optionally specifying the IP address from which that login will be granted MasterAdmin abilities.

  • <colors>
    This section defines the colors and other text attributes that can be used in chat and ManiaLink panel messages (see Mania Tech Wiki for the codes).

  • <messages>
    This section defines the message strings for the main program and most plugins that don't come with their own configuration file. They can be customized or localized into other languages.

  • <welcome_msg_window>
    Set this to True to display the player welcome message in a window instead of the chat.

  • <lock_password>
    Defines the lock password for /admin and /jfreu commands, as an extra security measure beyond the IP address checks for admins. See the XASECO v1.03 release notes for more info.

  • <log_all_chat>
    Set this to True to log all players' chat lines, not just their use of chat commands.

  • <chatpmlog_times>
    Set this to True to show timestamps for all messages in the /chatlog, /pmlog and /admin pmlog outputs.

  • <cheater_action>
    Set this to an action value to determine how to handle a player that triggers one (or more) anti-cheat check(s). 0: Ignore; 1: Set to Spectator (only on TMF, falls back to 0 on TMN); 2: Kick; 3: Ban (implies Kick); 4: BlackList & Kick; 5: Blacklist & Ban. See the XASECO v1.05 release notes for more info.

  • <script_timeout>
    Defines the maximum time (in seconds) that one pass through the main loop is allowed to take, i.e. the combined time of all command and callback activity by all plugins that needs to be executed at a given time. Timeout problems should not be addressed by increasing this limit, but by finding and solving the reason for the timeouts.

  • <show_min_recs>
    Set this to the minimum number of records you'd always like to see at the start and end of tracks, and with the /liverecs command (which uses show_min_recs-2). Additionally, the records of all online players and the last ranked record are also shown in those situations. Finally, this value determines how many players in the rounds reports are shown with their time, the remainder is shown without. In essence this helps you control the average length of the output lines.

  • <show_recs_before>
    Set this to 2 to have the server display the existing records at the start of a track, similar to FAST. If 1, only the track record is shown as in the original ASECO, and if 0 no record is shown. On TMF/TM² you can add 4 to divert the message to the system message window, so 6 for the full report and 5 for the track record.

  • <show_recs_after>
    Set this to 2 to have the server display the (possibly) updated records at the end of a track, similar to FAST. If 1, then the old top-5 from the original ASECO is shown, and if 0 no records are shown. On TMF/TM² you can add 4 to divert the message to the system message window, so 6 for the full report and 5 for the top-5.

  • <show_recs_range>
    Set this to True to have the server display the records range before, during (with /liverecs) and after a track if there are no new records. If False, no range is shown.

  • <show_tmxrec> (X1) / <show_mxrec> (X2)
    Set this to 2 on TMF/TM² to have the server display the TMX/MX World Record before a track in the system message window, and to 1 to show it in the chat as before. If 0, no record is shown.

  • <show_playtime>
    Set this to 2 on TMF/TM² to have the server display the total track playing time after a track in the system message window, and to 1 to show it in the chat as before. If 0, then the playing time can still be shown with the /playtime command.

  • <show_curtrack> (X1) / <show_curmap> (X2)
    Set this to 2 on TMF/TM² to have the server display the current track info before a track in the system message window, and to 1 to show it in the chat. If 0, no info is shown.

  • <default_tracklist> (X1) / <default_maplist> (X2)
    This defines the default name of the matchsettings file used by /admin readtracklist / readmaplist and /admin writetracklist / writemaplist.

  • <writetracklist_random> (X1) / <writemaplist_random> (X2)
    Set this to True to add a <random_map_order> filter section to track lists written via /admin writetracklist / writemaplist, so that /admin readtracklist / readmaplist of such files randomizes the track list again. If False, no randomization will occur.

  • <help_explanation>
    Set this to True to add an extra explanation to the /help output to help new players. If False, no explanation is shown.

  • <lists_colornicks>
    Set this to True to use colored nicknames in all the various /top... lists, /active, /recs and /dedirecs. If False, nicknames will be stripped (recommended on TMN).

  • <lists_colortracks> (X1) / <lists_colormaps> (X2)
    Set this to True to use colored tracknames in all the various /list lists, /best, /worst, /jukebox display and /admin listdupes. If False, tracknames will be stripped (recommended on TMN).

  • <topclans_minplayers>
    Set this to the minimum number of ranked players that should be included in the computation of the /topclans ranking.

  • <global_win_multiple>
    Set this to a multiple at which a player's win (e.g. every 50 wins) results in a global congratulations message instead of the regular personal one.

  • <display_checkpoints>
    Set this to False to permanently disable checkpoint pop-ups (TMN) or panels (TMF/TM²) for all players while still tracking the checkpoints data internally. This allows you to keep plugin.checkpoints.php enabled for the Dedimania system when high player counts cause performance/crash problems.

  • <enable_cpsspec>
    Set this to True to allow players to use the /cpsspec command and view the checkpoint panels (TMF/TM²) of the player they're spectating. If False, /cpsspec is disabled.

  • <auto_enable_cps>
    Set this to True to automatically enable /cps for new players. Returning players will retain their previous setting. If False, /cps is initially disabled.

  • <auto_enable_dedicps>
    Set this to True to automatically enable /dedicps for new players. Returning players will retain their previous setting. If False, /dedicps is initially disabled.

  • <auto_admin_addip>
    Set this to True to automatically add the current IP address to the adminops.xml file for newly added admins and operators. If False, no IP address is added.

  • <adminops_file>
    This defines the name of the file with the admin/operator/abilities lists.

  • <bannedips_file>
    This defines the name of the file with the banned IPs list.

  • <blacklist_file>
    This defines the default name for the blacklist file used by /admin readblacklist and /admin writeblacklist.

  • <guestlist_file>
    This defines the default name for the guestlist file used by /admin readguestlist and /admin writeguestlist.

  • <trackhist_file> (X1) / <maphist_file> (X2)
    This defines the default name for the track/map history file.

  • <admin_client_version>
    On TMF/TM² this allows requiring the specified client version as the minimum version for admins to connect to the server.

  • <player_client_version>
    On TMF/TM² this allows requiring the specified client version as the minimum version for all players to connect to the server.

  • <default_rpoints>
    On TMF/TM² with plugin.rpoints.php enabled, this defines whether to initialize the server with a default Rounds points system at XASECO1/2 start-up. Set it to a custom system with specified values (X,Y,...,Z) or a common system by name (f1gp, motogp, etc), just like the parameters to the /admin rpoints command. If empty, the standard points system is initialized.

  • <afk_force_spec>
    Set this to True on TMF/TM² to automatically set a player that uses the /afk command into free spectator mode. If False, no mode is changed.

  • <clickable_lists>
    Set this to True to add clickable buttons to various lists on TMF/TM² (e.g. /list, /best and /worst for jukeboxing a track). If False, no buttons are added.

  • <show_rec_logins>
    Set this to True on TMF/TM² to include logins for the players in the /recs listing. If False, no logins are shown.

  • <recs_in_window>
    Set this to True on TMF/TM² to divert new/improved/equalled record messages to the system message window. If False, records are shown in the chat as before.

  • <rounds_in_window>
    Set this to True on TMF/TM² to divert round finish reports in Rounds mode to the system message window. If False, reports are shown in the chat as before.

  • <window_timeout>
    This defines the duration of displaying the system message window on TMF/TM² before and during a track whenever a new message is received, in seconds. During the scoreboard after a track, the same duration as the server's ChatTime setting is used.

  • <sb_stats_panels>
    Set this to True on TMF/TM² to display individual stats panels for each player during the scoreboard and disable the rank chat messages. If False, show only rank messages as before.

  • <window_style>
    This defines the default style for ManiaLink windows on TMF/TM². Must be a valid filename (without '.xml') in the styles/ directory. If empty, the original TMN-like style is default on TMF, and style 'Card' is default on TM².

  • <admin_panel>
    This defines the default admin panel on TMF/TM². Must be a valid filename (without '.xml') in the panels/ directory. If empty, the admin panel is absent by default.

  • <donate_panel>
    This defines the default donate panel on TMUF/TM². Must be a valid filename (without '.xml') in the panels/ directory. If empty, the donate panel is absent by default.

  • <records_panel>
    This defines the default records panel on TMF/TM². Must be a valid filename (without '.xml') in the panels/ directory. If empty, the records panel is absent by default.

  • <vote_panel>
    This defines the default vote panel on TMF/TM². Must be a valid filename (without '.xml') in the panels/ directory. If empty, the vote panel is absent by default.

  • <panel_bg> (X2 only)
    This defines the default panel background on TM². Must be a valid filename (without '.xml') in the panels/ directory. If empty, the default background is 'PanelBGCard'.

  • <tmserver>
    This section defines the settings to connect with the dedicated server. <login> should always be SuperAdmin, with the corresponding password in <password>. <ip> and <port> need to match those in the dedicated config. And <timeout> defines the maximum time (in seconds) that XASECO1/2 will keep trying to connect to the server until it reaches status 4 (Running - Play).
Last updated: 2022-12-12