This Plugin based upon the well known and good old FuFi.Widgets who accompanied us for years, it was written from scratch to change the look and feel of the Widgets and to make it easier to configure. Also to use the new XAseco features and events for more speed (since XAseco/1.12).

Some new features are included to have more information available and easily accessible. The famous feature (i think) is the adjustable clock, no more need to calculate the local time from a Server far away!

Also included the BEAT (the Swatch Internet Time), that displays the time which is worldwide the same. Another nice feature are the clickable Record-Widgets to display all the driven records and not just a few in the small Widgets.

The extended MX-Mapinfo-Window display more information of a Map as the default currently does and also in a very nice way.

The next very nice thing is the Maplist where you can easily add a Map to the Jukebox. The integrated filter options makes it easy for e.g. list only Maps with the mood night or only Canyon Maps or only Maps from a selected Mapauthor.

Featured Widgets at Race

• Dedimania Records (except Gamemode 'Stunts')
• Gerymania Records (only for Gamemode 'Stunts')
• Local Records
• Live Rankings
• Current Song
• Current Map (with additional Last-/Current-/Next-Map Window)
• Round Score (which replaces the original one)
• Ladder Limits
• Gamemode
• Player & Spectator amount
• Current Ranking
• Toplist (More Ranking)
• Mapcount
• Visited Players
• Clock
• Add Favorite
• Checkpoint Count

Featured Widgets at Score

• Top Ranks
• Top Winners
• Most Records
• Most Finished
• Hours Played
• Top Donators
• Top Nations
• Top Maps
• Top Voters
• Average Last Round
• Dedimania Records (except Gamemode 'Stunts')
• Gerymania Records (only for Gamemode 'Stunts')
• Local Records
• Finish Winners (pay Coppers to winning Players)
• Add Favorite
• Upcomming Environment
• Upcomming Gamemode
• Donation

Supported Gamemodes

• Rounds
• TimeAttack
• Team
• Laps
• Cup
• Stunts

Note

• This Plugin comes WITHOUT integrated Karma-Feature, just use the TM-Karma.com Plugin additionally.
• The Dedicated Server did not event onCheckpoint and onFinish in WarmUp-Mode, and therefor the Round Score Widget did not display any times or something else.

Demo

If you want to see this Plugin in action, just visit my test server.

Special thanks to

• tyjo from the COS//Clan for providing dumps of a large database to analyze & test with
• .anDy for the help and testing for the Round Score Widget
• hoppse for testing
• all other betatester

Info

• For feedback, help, bugs or suggestions please use the related thread at TM-Forum

Displays a Help-Window

Hide all Records-Widgets, same as pressing F7, but save this as preference into Database

Show all Records-Widgets, same as pressing F7, but save this as preference into Database

Toggle the display of the Records-Widgets

Display the TopListWindow or one of a optional parameter, which can be:

• dedirecs
• geryrecs *
• localrecs
• topnations
• topranks
• topwinners
• mostrecords
• mostfinished
• topplaytime
• topdonators
• topmaps
• topvoters *

* Only if the related Plugin is enabled

Lists musics currently on the server

Lists maps currently on the server, optional parameter can be:

• jukebox
• author
• map
• norecent
• onlyrecent
• norank
• onlyrank
• nomulti
• onlymulti
• noauthor
• nogold
• nosilver
• nobronze
• best
• worst
• shortest
• longest
• newest
• oldest
• bestkarma
• worstkarma

or a keyword to search for (e.g. /elist undef)

Commands for MasterAdmins only

Reloads the records_eyepiece.xml

Set the normal <refresh_interval> sec.

Set the nice <refresh_interval> sec.

Set the nice <lower_limit> Players.

Set the nice <upper_limit> Players.

Set the <nicemode><force>

Set the <features><mark_online_player_records>

Tips

• If you want to setup <pos_x> or <pos_y> to 0, then type 0.01 instead. This is required, because the XML-Parser from XAseco assume 0 as false and skip this option
• For Text-Formatting like colors or styles, see the TM-Wiki

Placements

Displays multiple fully customizable widgets all over the HUD containing images. This content needs its loading time so please be patient if it does not show up immediately and you need to press DEL to get the loaded content to be displayed.

You can combine the tags in nearly every possible way, having a manialink on a video that becomes an image on mouseover or something like that. You can add as many <placement>-Blocks as you want but be sure to not overload your HUD for your players.

Note

• If you set <url>, <manialink>, <action_id> and <chat_command> together, only <url> will be used
• Min. required are (without <include>): <enabled>, <display>, <pos_x>, <pos_y>, <width> and <height>
• Min. required are (with <include>): <enabled>, <display> and <include> (all other are ignored)

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

These are only the changes for the current release, please refer for older changes the included CHANGELOG.txt file in the current release.

Changes

• This release require min. 0.9.6 of the plugin.gerymania.php, if Gerymania is enabled
• Include the support of the event onGerymaniaRecordsLoaded
• Speed-Up the MostRecords Database access
• With the new option at the WelcomeWindow it is possible to hide this WelcomeWindow from Players who has received a ServerRank, all others see the WelcomeWindow
• Removed support for the ManiaRecords.org (see why)

Changes in the XML file

• Added <welcome_window><hide>*
• Changed <welcome_window><image><link> to a new URL
• Changed <dedimania_records><gamemode><rounds><pos_y> from 13.3 to 32.9
• Changed <dedimania_records><gamemode><rounds><entries> from 9 to 15
• Changed <dedimania_records><gamemode><time_attack><pos_y> from 4.3 to 32.9
• Changed <dedimania_records><gamemode><time_attack><entries> from 14 to 30
• Changed <dedimania_records><gamemode><team><pos_y> from 13.3 to 32.9
• Changed <dedimania_records><gamemode><team><entries> from 9 to 15
• Changed <dedimania_records><gamemode><laps><pos_y> from 4.3 to 32.9
• Changed <dedimania_records><gamemode><laps><entries> from 14 to 30
• Changed <dedimania_records><gamemode><cup><pos_y> from 13.3 to 32.9
• Changed <dedimania_records><gamemode><cup><entries> from 9 to 15
• Removed <mania_records>*
• Changed <local_records><gamemode><rounds><pos_y> from -6.3 to 2.5
• Changed <local_records><gamemode><rounds><entries> from 9 to 14
• Changed <local_records><gamemode><team><pos_y> from -6.3 to 2.5
• Changed <local_records><gamemode><team><entries> from 9 to 14
• Changed <local_records><gamemode><cup><pos_y> from -6.3 to 2.5
• Changed <local_records><gamemode><cup><entries> from 9 to 14
• Changed <scoretable_lists><top_average_times><entries> from 8 to 10
• Changed <scoretable_lists><dedimania_records><pos_y> from -9.25 to 5.1
• Changed <scoretable_lists><dedimania_records><entries> from 8 to 15
• Removed <scoretable_lists><mania_records>*
• Removed <nicemode><allow><mania_records>
• Changed <messages><winning_mail_body>

Bugfix

• BillUpdated for unknown BillId [ID] Error: The transmitted message does not match the message of this transaction. (thanks sbone)
• MostRecords in the MoreRankingWindow are only refreshed at a new or changed local record, if the MostRecords at <scoretable_lists> is enabled
• TopWinners in the MoreRankingWindow are only refreshed when a Player wins, if the TopWinners at <scoretable_lists> is enabled
• No check for required Plugin plugin.rasp.php when <scoretable_lists><top_rankings> is enabled

Please make sure the requirements and dependencies are met for your Installation, otherwise XAseco2 can not start, raise an error and quits. It is always recommended that the latest release from XAseco2 is installed!

Requirements

• XAseco2/1.00+
• ManiaPlanet Trackmania2 (TM2)
• PHP/5.2.13 or above (or "Olson" Timezone Database Version 2010.2 or above, see here for more).
• It is recommended to have mbstring (Multibyte String) in PHP included (see here for more).
• Since the included Maplist need to access every Map installed at the Dedicated-Server over the local filesystem, you need to install XAseco2 at the same Machine (Computer), otherwise the Maps are unable to load.

Dependencies with other Plugins

Do not combine with these Plugins

Path layout

This documentation assume that you want to install this Plugin on a Linux System and your pathes looks like:

GameServer
Logs
xaseco2
xaseco2/includes
xaseco2/panels
xaseco2/plugins
xaseco2/styles
		

Installation and configuration

Enable the Gerymania-Plugin

If you want to use this Plugin together with the Gerymania-Plugin, then please make sure that the following settings are set to true:

• <gerymania_records><gamemode><stunts><enabled>
• <scoretable_lists><gerymania_records><enabled>
• <nicemode><allow><gerymania_records> (only if you want to allow it)

Info

• For feedback, help, bugs or suggestions please use the related thread at TM-Forum