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
• Top Visitors
• Top Active Players
• Top Betwins
• Top Roundscore
• Top Winning Payouts
• 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 Mania Karma 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.

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

Commands for Players

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 *
• topvisitors
• topactive
• toppayouts
• topbetwins *

* 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
• authorname
• map
• norecent
• onlyrecent
• norank
• onlyrank
• nomulti
• onlymulti
• noauthor
• nogold
• nosilver
• nobronze
• nofinish
• best
• worst
• shortest
• longest
• newest
• oldest
• bestkarma
• worstkarma

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

Commands for Operators/Admins/MasterAdmins

Show the outstanding winning payouts

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
• For in-game Images and Backgrounds see the Overview

ClockWidget

It is very important that you set <clock_widget><default_timezone> to the timezone your Server is setup to, otherwise the ClockWidget can not display the right time.

MusicWidget (Custom music on your Server)

If you use MUX-Files or untagged OGG-Files, then you can use this Format for the filenames to be able to see the Songname and the Artist:

• Michael_Jackson_-_Bad.mux or
• Michael_Jackson_-_Bad.ogg

The underscores are replaced by spaces.

If you are running XAseco2 on a Windows system and using the P2P option, then make sure you setup <music_server> in the musicserver.xml to Music instead of Music/ (as documented), otherwise the CurrentSongWidget can not match the current song (click here for details).

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)

Detailed information for <include> in a <placement>

The best place for XML files to include with a <placement> is a own directory named placements:

xaseco2
xaseco2/includes
xaseco2/panels
xaseco2/placements
xaseco2/plugins
xaseco2/styles
		

In the directory placements you have to place your example.xml. Then you can use this <placement> to include your example.xml at race:

<placement>
	<enabled>true</enabled>
	<display>race</display>
	<include>placements/example.xml</include>
</placement>
		

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 3 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.

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.02+
• Trackmania2 (Maniaplanet)
• PHP/5.2.13 or above (or "Olson" Timezone Database Version 2010.2 or above, 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