|
XASECO stands for Xymph's ASECO and is the new name
for the system formerly known as ASECO/RASP for TMN. It now supports
TrackMania Forever as well.
ASECO is an abbreviation of "Automatic SErver
COntrol", a system for TrackMania Original, Sunrise
and (especially) Nations and Forever servers to keep
track of player records and provide useful player and admin commands.
RASP is a sizable set of plugins for ASECO that adds server
ranks, a track jukebox, a karma voting system, and lots more.
As evidenced by the many TrackMania (Nations) servers running it, the ASECO/RASP system for TMO/TMS/TMN remained a very popular package to keep track of records and offer players various useful commands and features. But its original authors have moved on to TM United, so I have been working at the system on my own since May 2007 to improve and expand it. The number of changes is so large that I decided (somewhat presumptuously perhaps) to call this system XASECO version 0.8, subsequently updated to v1.03, many major releases since ASECO 0.61b and RASP 1.5 that together combined into version 0.7. TrackMania Forever is also supported since XASECO v0.96. I don't believe there's a point in running a barebones (X)ASECO system without at least the RASP plugins because those add so many basic and useful features and commands which players enjoy, so they are not released separately like before but as one combined system. The remaining plugins included in this v1.03 release (Mistral's idle-kick, and Jfreu's plugins) are however optional, as are the series of new plugins I developed myself. My overall goal remained to stick to 'core functionality' as much as possible, rather than include into the base system any of the variety of 'niche' plugins that exist out there, while still providing a complete and integrated solution for server control. For a high-level outline of all of XASECO's features and plugins, see the Overview page. For a complete overview of the new stuff, see the v0.8 initial release notes, v0.81 - v0.95 older release notes, and v0.96 - v1.03 current release notes. And here is a complete overview of all available commands in HTML and Word. |
|
Note on upgrading from versions prior to v0.8: This release, when first run, will automatically rename the 'trackID' column in the rs_times table in your ASECO database to 'challengeID' for consistency with all the other tables. This means that if you ever want to downgrade to v0.7, you'll need to manually rename that column back by entering the following command in your database (via PhpMyAdmin, the MySQL command prompt, or similar): ALTER TABLE rs_times CHANGE challengeID trackID mediumint(9) NOT NULL default 0
|
<tmserver> and <masteradmins>
(renamed from the original <admins>) sections, the
MySQL settings in localdatabase.xml, and the flags and variables in
includes/rasp.settings.php. For details on the new settings in v0.8 -
v1.03, see Configuration options below. To get
up to speed, you can first check this TMN
& XASECO quick start guide or alternatively the TMF & XASECO quick start guide.
<masterserver_account> section from your
server's dedicated.cfg (TMN) or dedicated_cfg.txt (TMF) file into
the corresponding section of the dedimania.xml file, and add
the 3-character nation abbreviation. Instead of the password
you can also use the community code for your server by using
the server login/password on the official
site for your game (TMO/TMS/TMN) or on this page for
TMF. Also, open ports 8003, 8006, 8007, 8011, 8012 and 8013 on
your firewall/router for communication with the central Dedimania
server (if that's not possible, the system falls back on port 80).
<masterserver_account> section from your
server's dedicated.cfg (TMN) or dedicated_cfg.txt (TMF) file into
the corresponding section of the dedimania.xml file, and add
the 3-character nation abbreviation. Instead of the password
you can also use the community code for your server by using
the server login/password on the official
site for your game (TMO/TMS/TMN) or on this page for
TMF.
ABBREV_COMMANDSINHIBIT_RECCMDSMONTHLY_LOGSDIR$log_monthly_logsdir variable in
includes/basic.inc.php.<masteradmins><admins>, this section
should contain only those logins you want to have all
admin rights, and 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.<log_all_chat>False</log_all_chat>True to log all players' chat lines,
not just their use of chat commands.<show_min_recs>8</show_min_recs>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>2</show_recs_before>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 before,
and if 0 no record is shown. On TMF 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>2</show_recs_after>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 v0.7 is
shown, and if 0 no records are shown. On TMF 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>True</show_recs_range>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>1</show_tmxrec>2 on TMF to have the server display
the TMX 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>1</show_playtime>2 on TMF 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>0</show_curtrack>2 on TMF 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>tracklist.txt</default_tracklist><writetracklist_random>True</writetracklist_random>True to add a <random_map_order>
filter section to track lists written via /admin
writetracklist, so that /admin readtracklist of such
files randomizes the track list again. If False,
no randomization will occur.<help_explanation>False</help_explanation>True to add an extra explanation to the
/help output to help new players. If False,
no explanation is shown.<lists_colornicks>True</lists_colornicks>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>True</lists_colortracks>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>2</topclans_minplayers><auto_enable_cps>True</auto_enable_cps>True to automatically enable /cps
for new players. Returning players will retain their previous
setting (until the next XASECO restart). If False,
/cps is initially disabled.<auto_enable_dedicps>True</auto_enable_dedicps>True to automatically enable /dedicps
for new players. Returning players will retain their previous
setting (until the next XASECO restart). If False,
/dedicps is initially disabled.<adminops_file>adminops.xml</adminops_file><bannedips_file>bannedips.xml</bannedips_file><blacklist_file>blacklist.txt</blacklist_file><guestlist_file>guestlist.txt</guestlist_file><trackhist_file>trackhist.txt</trackhist_file><clickable_lists>True</clickable_lists>True to add clickable buttons to various
lists on TMF (e.g. /list, /best and /worst
for jukeboxing a track). If False, no buttons
are added.<recs_in_window>True</recs_in_window>True on TMF 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>True</rounds_in_window>True on TMF 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>6</window_timeout><window_style>DarkBlur</window_style><admin_panel>AdminBelowChat</admin_panel><donate_panel>DonateBelowCPList</donate_panel><records_panel>RecordsRightBottom</records_panel><vote_panel>VoteBelowChat</vote_panel><tmlogin> field should be an
<ipaddress> field, optionally specifying
the IP address from which that login will be granted Admin or
Operator abilities. You can update the login lists manually
before starting v0.88+ for the first time, but any further
changes are best done via the relevant /admin commands,
which will automatically write them back into the file in
case of XASECO restarts. The same goes for changes to the
ability lists. If you manually edit the file while XASECO is
running, and then make a change via an /admin command,
the manual changes will be overwritten unless you reload the
file right away.<limit>50</limit>$nextrank_show_rp = true;true if you want /nextrank to show
the difference in record positions (RP), i.e. the combined
number of positions that your records need to be improved
in order to catch up with the next better ranked player.
If false the RP value isn't included.$always_show_pb = true;true, the Personal Best message is always shown
at the start of a track; if false and the player
has a ranked record and <show_recs_before>
(from config.xml) is True (so that record is
included in the listing at the start of a track), or on TMF if
the player has a records panel enabled, then the PB message is
not shown.$allow_public_karma = true;true if you allow public ++ &
-- votes as well as silent /++ & /--,
if false only the latter are allowed. Public
votes may be undesirable because they could influence other
players – after all in most democratic processes votes
are confidential. J$karma_show_start = true;true if you want to show the karma message
at the start of each track, if false it's not
shown.$karma_show_details = true;true if you want to show counts and
percentages of karma votes, if false these details
aren't shown.$karma_show_votes = true;true if you want to show their actual
votes to players, if false those votes aren't
shown.$karma_require_finish = 0;$remind_karma = 0;2 if you want to send a reminder upon
every finish to any player that has not yet karma voted
for the current track; set to 1 if you want to send
a reminder at the end of a track to all players that have not
yet karma voted for that track; if 0, no reminders
are sent. After voting, players are no longer sent a reminder,
and spectators are never sent one.$feature_jukebox = true;true if you want jukebox functionality,
if false then /jukebox is disabled, but
/list still works (as long as plugin.rasp_jukebox.php
is included) so that players can still see which tracks are
available.$jukebox_skipleft = true;true if you want jukebox to skip tracks
requested by players that left, if false no skip
takes place. This speeds up playing the tracks that the online
players actually want, as they no longer have to play tracks
from other players that (prematurely) went offline.$jukebox_permadd = false;true if you want /add to permanently
add jukeboxed tracks to the server. If false,
/add-ed tracks are removed after they're finished.$jukebox_adminadd = true;true if you want /admin add to
immediately jukebox tracks that are successfully downloaded from
TMX, just like a passed /add vote. If false
no jukeboxing takes place.$jukebox_in_window = false;true on TMF if you want to divert all global
jukebox messages to the message window. If false
they remain in the chat as before.$admin_contact = 'YOUR@EMAIL.COM';$autosave_matchsettings = '';$prune_records_times = false;true if you want XASECO's start-up to
prune records/rs_times table entries for all deleted tracks.
It's recommended to enable this only if you want to do a
clean-up, and then disable it again, so you don't get surprised
when e.g. restarting the TMN server with a different set of
tracks.$features_votes = false;true if you want to disable the normal
CallVotes and enable chat-based voting commands (see
/helpvote). The actual voting configuration options
are defined in includes/votes.config.php.$uptodate_check = true;true if you want the start-up process to
check for the current XASECO version. If false, you
can still check the version with /admin uptodate.$tmxtmpdir = 'Challenges/TMXtmp';$feature_tmxadd is true to enable
TMX /add votes, this new directory is where the tracks
are saved, and you must create it along with 'Challenges/TMX'.
If $feature_tmxadd is false, this
directory is optional since tracks added via /admin add
are saved to $tmxdir as before.$features_votes option is enabled, all
chat-based voting features can be configured in this file. See
the detailed comments and the v0.84
release notes for more info.$conf_file$vips_file$bans_file$unspecvote = 1;1 to allow users to start /unspec
votes, or 0 to disallow this.$infomessages = 1;2 on TMF to divert Info messages to the
system message window, 1 for chat messages (as
before), or 0 to disable them.$badwordstime$badwordslist