XASECO (TMN/TMF) v1.00

[Xymph]

Enough teasing, here is the real deal. This is by far the biggest release I've done, but I wanted it to be worthy of the v1.00 label, and most of the new features just made sense to put in together anyway, rather than spread them over multiple releases. The big theme is of course TMF-style windows and panels, built such that they are customizable by each player with no performance impact, as any style and panel change is simply done by switching to different templates. The large collection of standard templates should hopefully offer everyone something to their tastes. To see how this works and looks, check the sneak preview thread (if you haven't already), or just download, install and try it yourself.

Further new features include the promised /autojuke command, the new /admin forcespec command (which slipped through the cracks with the v0.9x releases), a handful of minor improvements, and thoroughly updated documentation. The release notes are huge, so grab some popcorn and start reading:

New features and other changes in the v1.00 release of XASECO:

• * new TMF window styles support with the following features:
  • - the distribution includes a new styles/ subdirectory that can contain up to 50 style templates for the ManiaLink windows
    - there are no fewer than 20 standard templates in light and dark, and in transparent, blurred and opaque variants
    - templates define the window, header and body background containers, as well as the header and body text fonts, and the clickable button style
    - the default window style is configurable via new config.xml setting <window_style> (default: DarkBlur)
    - new /admin style <xxx> command to select another default window style for newly connecting players (requires style name, 'off' disables the default)
    - the new /style command allows players to select an individual window style with the following options:
    • + help: Displays help information
      + list: Displays available styles
      + default: Resets style to server default
      + off: Disables TMF window style
      + <xxx>: Selects window style <xxx>, which can be a style name or the sequence number from /style list
      + in the /style list overview a player can also click a style name to dynamically select a new style (or refresh the current one if its .xml file was updated)
    - multi-page windows get ArrowFirst and ArrowLast buttons to jump directly to the first and last pages -- as with the plain TMN-like style, windows of more than 5 pages also get ArrowFastPrev (Prev5) and ArrowFastNext (Next5) buttons to jump back and forth by 5 pages
    - note that on TMNF the Black, Blue, Cyan and Orange styles revert to Green, so you might as well remove those files to prevent player confusion
  * new TMF admin panel support with the following features:
  • - the admin panel contains 7 icons to perform common admin tasks, from left to right (or top to bottom):
    the ClipRewind icon for /admin restartmap, ClipPause for /admin endround, ClipPlay for /admin nextmap, Refresh for /admin replaymap, ArrowGreen for /admin pass, ArrowRed for /admin cancel and Buddies for /admin players live
    - the distribution includes a new panels/ subdirectory that can contain up to 40 admin panel templates; their filenames must start with 'Admin'
    - there are 14 standard templates in various positions and sizes all around the HUD
    - templates define the complete ManiaLink panel with position, size and fonts, so you have full control to develop custom panels
    - the default admin panel is configurable via new config.xml setting <admin_panel> (default: BelowChat)
    - new /admin admpanel <xxx> command to select another default admin panel for newly connecting admins (requires panel name, 'off' disables the default)
    - the new /admin panel command allows admins to select an individual admin panel with the following options:
    • + help: Displays help information
      + list: Displays available panels
      + default: Resets panel to server default
      + off: Disables admin panel
      + <xxx>: Selects admin panel <xxx>, which can be a panel name or the sequence number from /admin panel list
      + in the /admin panel list overview an admin can also click a panel name to dynamically select a new panel (or refresh the current one if its .xml file was updated)
    - as with chat commands, use of the buttons in the admin panel remains governed by the tiered admin system and the ability lists
  * new TMF records panel support with the following features:
  • - the records panel lists the Personal Best, Local #1 record, Dedimania #1 record and TMX world record
    - the times (or scores in TMUF Stunts mode) for these four fields act as buttons to invoke the /topsums, /recs, /dedirecs and /tmxrecs commands, respectively
    - the distribution's panels/ subdirectory can contain up to 50 records panel templates; their filenames must start with 'Records'
    - there are 15 standard templates in left- and right-edge variants
    - templates define the complete ManiaLink panel with position, size and fonts, so you have full control to develop custom panels
    - the default records panel is configurable via new config.xml setting <records_panel> (default: RightBottom)
    - new /admin recpanel <xxx> command to select another default records panel for newly connecting players (requires panel name, 'off' disables the default)
    - the new /recpanel command allows players to select an individual records panel with the following options:
    • + help: Displays help information
      + list: Displays available panels
      + default: Resets panel to server default
      + off: Disables records panel
      + <xxx>: Selects records panel <xxx>, which can be a panel name or the sequence number from /recpanel list
      + in the /recpanel list overview a player can also click a panel name to dynamically select a new panel (or refresh the current one if its .xml file was updated)
    - all players' records panels are updated when a new #1 Local or Dedimania record is driven, a player's own panel when a new Personal Best is driven
    - when the scoreboard comes up at the end of a track, records panels are temporarily disabled
    - note that on TMNF some of the Blue fonts revert to Green, so you could rename those files to prevent player confusion
  * new TMF vote panel support with the following features:
  • - the vote panel provides Yes and No buttons for TMX /add and all chat-based votes
    - players can also operate the buttons with the F5 and F6 keys respectively (the keys don't work for spectators)
    - the Yes button and F5 key invoke the /y command, the No button and F6 key are dummy operations to close the vote panel, which is necessary for a consistent user interface experience
    - the vote panel is displayed for all players upon entering an /add or chat-based voting command, except for spectators when $allow_spec_voting in votes.config.php is off (but admins always get the vote panel) and for the vote initiator when $auto_vote_starter is on (because that already invokes /y automatically)
    - a player's vote panel disappears once clicked (or when entering /y), and any remaining panels disappear automatically when a vote passes, expires, or is cancelled
    - the color of the Yes button matches the type of vote: pink ({#vote} in config.xml) for chat-based votes and orange ({#emotic}) for /add votes; the No button is always dark gray
    - the distribution's panels/ subdirectory can contain up to 10 vote panel templates; their filenames must start with 'Vote'
    - there are 4 standard templates in various positions and sizes around the HUD
    - templates define the complete ManiaLink panel with position, size and fonts, so you have full control to develop custom panels
    - the default vote panel is configurable via new config.xml setting <vote_panel> (default: BelowChat)
    - new /admin votepanel <xxx> command to select another default vote panel for newly connecting players (requires panel name, 'off' disables the default)
    - the new /votepanel command allows players to select an individual vote panel with the following options:
    • + help: Displays help information
      + list: Displays available panels
      + default: Resets panel to server default
      + off: Disables vote panel
      + <xxx>: Selects vote panel <xxx>, which can be a panel name or the sequence number from /votepanel list
      + in the /votepanel list overview a player can also click a panel name to dynamically select a new panel (or refresh the current one if its .xml file was updated) -- while doing this the panel is briefly displayed to show its new location
    - when the scoreboard comes up at the end of a track, vote panels are disabled (because the ongoing vote expires at that point)
  * the /admin players command now accepts a special option live to display a list of just the online players, rather than any players in the database that match the search string
  * on TMF the /admin players command now provides a comprehensive player management window:
  • - the nick/login buttons will invoke /stats on the selected player
    - the operation buttons invoke, from left to right, on the selected player: /admin warn, /admin ignore or /admin unignore, /admin kick, /admin ban or /admin unban, /admin ban or /admin unblack, /admin addguest or /admin removeguest, and /admin forcespec
    - the toggle operations show the operation that is meaningful with respect to the player's status, e.g. UnIgnore for an ignored player, Add Guest for a non-guest one, and no Force Spec button for a spectator
    - operations can be performed on both online and offline players, but buttons are only provided when that operation is feasible, e.g. offline players cannot be warned, ignored, kicked or banned but they can still be unbanned and unblacked
    - the window is refreshed (albeit to the first page) to show the new status when any toggle operation is performed, i.e. (Un)Ignore, Kick, (Un)Ban, (Un)Black, Add/Remove Guest and Force Spec
    - buttons are only provided for the first 200 players, which should be sufficient for the live list -- if the desired player in an offline list is beyond the 200 mark, refine your search string
  * new /jfreu players command to display the list of all known players since the last XASECO restart, and search for offline players via a (part of a) login or nickname with /jfreu players <string>
  * the special option live displays a list of just the online players, rather than any players tracked since the last XASECO restart that match the search string
  * on TMN this command also includes the current Badword count for each player if $badwords in jfreu.config.php is 1 (true)
  * on TMF this command provides the second player management window:
  • - as before, the nick/login buttons will invoke /stats on the selected player
    - the operation buttons invoke, from left to right, on the selected player: /jfreu badword (if $badwords is 1), /jfreu banfor 1H, /jfreu banfor 24H, /jfreu unban, /jfreu addvip or /jfreu removevip, and /jfreu unspec
    - also shown are the player's current badword count (if $badwords is 1) and the time left in a temporary ban, if any
    - the single toggle operation in this window shows the operation that is meaningful with respect to the player's status, i.e. Add or Remove a player as VIP
    - the Spec column provides an UnSpec button for SpecOnly players, and otherwise shows the player's current status (Player, Spec or Offln)
    - operations can be performed on both online and offline players, but buttons are only provided when that operation is feasible, e.g. offline players cannot have their badword count incremented or be unspec-ed but they can still be temporarily banned
    - the window is refreshed (albeit to the first page) to show the new status after all of the operations
    - buttons are only provided for the first 200 players, which should be sufficient for the live list -- if the desired player in an offline list is beyond the 200 mark, refine your search string
  * on TMF in the output of the various /list lists, /best and /worst, an author column has been added
  * on TMF it's now possible to add clickable buttons to relevant lists, configurable via new config.xml setting <clickable_lists> (default: True):
  • - in the various /list lists, /best and /worst the track buttons will jukebox the selected track; no button is displayed for tracks in the track history -- supports up to 1900 tracks
    - in the various /list lists, /best and /worst the author buttons will invoke /list <author>
    - on TMUF, in the various /list lists, /best and /worst the environment buttons will invoke /list env: for the selected environment
    - in /music list the song buttons will jukebox the selected song -- supports up to 1900 songs
    - in /jukebox display a player will get a button only for the name of his/her own jukebox track, which can be used to drop it; admins of any tier with the 'dropjukebox' ability get buttons for all track names to drop any of them -- supports up to 100 tracks
    - in /players the nick/login buttons will invoke /stats on the selected player -- supports up to 200 players
    - in /stats the Time Played field is a button to invoke /active, Server Rank invokes /top100, Records invokes /toprecs and Races Won invokes /topwins
    - in /admin listignores, /admin listbans, /admin listblacks and /admin listguests the nick/login buttons will invoke /admin unignore, /admin unban, /admin unblacks and /admin removeguest (respectively) on the selected player -- supports up to 200 players
    - in /jfreu listbans, /jfreu listvips and /jfreu listvipteams the nick/login/team buttons will invoke /jfreu unban, /jfreu removevip and /jfreu removevipteam (respectively) on the selected player/team -- supports up to 200 players/teams
    - this works with any window style, including the plain TMN-like style
  * all clicked commands in the aforementioned windows and panels are logged analogous to chat commands
  * when you've added more style or panel templates than the maximum, a warning is logged and the excess templates are ignored
  * new /autojuke command to automatically jukebox the first available track from the chosen /list selection (e.g. /autojuke nofinish, /autojuke norank... see /autojuke help) -- optional alias /aj becomes available by uncommenting the appropriate two lines at the start of plugin.rasp_jukebox.php
  * new /admin forcespec command to force a player into spectator mode (free camera)
  * the /stats command now accepts an optional login or player ID by all players, not just admins with the 'chat_stats' ability -- that ability was renamed to 'chat_statsip' and defines which admin tiers can see the player's IP address (for privacy reasons this isn't shown to all players)
  * on TMF, players' team names are no longer updated (cleared) in the local database upon reconnection, so that a plugin/command (e.g. /teamname in plugin.matchsave.php) can store meaningful team names in the database
  * on TMF if a track contains no custom song, /song will advise to try /music current if the music server plugin is enabled
  * when the scoreboard comes up at the end of a track, any pop-up windows are now automatically closed
  * optimized the checkpoints panel display code
  * HTTP GET requests to TMX and for the up-to-date check now include a User-Agent header to allow minimal statistics tracking
  * updated the GBXDataFetcher module to rename the GBXDataFetcher class to GBXChallengeFetcher, and add a new GBXReplayFetcher class (not used in XASECO though)

Bug fixes in the v1.00 release of XASECO:

• * the search order is missing from the /list karma header -- fixed
  * on TMF, the /admin listignores (aka. ignorelist) listing could get mixed up with previous window output -- fixed
  * reminder, expiration and cancellation messages for /add votes show the unstripped track name -- fixed

Those installation notes are as important as ever:

• Important:
  
  * To register your server with the central Dedimania database, you must copy the login and password values in the <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.
  * Open ports 8003, 8006 and 8007 on your firewall/router for communication with the central Dedimania server (if that's not possible, the system falls back on port 80).
  * In the zip file, all *.XML and config files are now located inside the newinstall/ directory. This means that you should be able to unzip the download and replace all the code files (unless you made changes to any) without worrying about overwriting your customized config files. However, for every XML/config file that was updated (see above), you must replace your version with the one from the newinstall/ directory, or compare them and add any new/changed configuration settings to your version to insure the system remains working correctly.
  * For a new installation, go into the newinstall/ directory and move all *.XML files into the main directory, next to aseco.php, and *.PHP files into the includes/ directory.

The download and all further information can be found on my XASECO/TMN page:

http://www.gamers.org/tmn/

Phew!
Xymph

PS. Some useless stats to show how much XAseco has grown since the original v0.7:
v0.7 had 8628 lines of PHP code (261 KB)
v0.8 .....11033 lines ... (352 KB)
v0.90 ...16823 lines ... (562 KB)
v0.99 ...29212 lines ... (0.99 MB)
v1.00 ...33236 lines ... (1.13 MB)

[lille79]

Thought I'd go to bed early tonight, but that suddenly changed

GO XYMPH!!

ps. Still fits on a floppy Xymph, so no worries

[Xymph]

ps. Still fits on a floppy Xymph, so no worries

Yeah, but who knows 2-3 releases from now?

[Ptitzizi]

I'm gonna to test that right now !!
Thanx man !

[LaBBe-]

nice! i was secretly hoping an option to set /cps and /dedicps to be automatically on for every player, since one of my servers is a league training server and everyone are not aware of these commands and im not always there to educate them

[Ouwe]

I am going to see it tommorrow Xymph.
Many Thanks for your Xaseco.
I am off to bed....

[kevtoofoo]

At Least

just see that in config xml

Code: Select all

<lists_colornickstrue</lists_colornicks>

need to add a ">"i think

Code: Select all

<lists_colornicks>true</lists_colornicks>

i return set it

[lille79]

Works like a charm here playing with menus and having a great time

[Xymph]

At Least

Or "last"?

just see that in config xml

Code: Select all

<lists_colornickstrue</lists_colornicks>

need to add a ">"i think

Code: Select all

<lists_colornicks>true</lists_colornicks>

i return set it

Oops, good point. Fixed in the download now.

[kevtoofoo]

sorry for my poor english

just a big thx for all ure work

[Xymph]

sorry for my poor english

No problem, just checking.

just a big thx for all ure work

Ok, glad your jukebox problem (just edited out) is fixed too, as I can't reproduce that here.

[kevtoofoo]

yes there's no problem just Xaseco open twice on my serv
me-->> <<--you

[lille79]

Pushing f5 or f6 doesn't work when I have fufi's plugin activated.

Everything else so far is working great.

[untraceablesmurf]

Pushing f5 or f6 doesn't work when I have fufi's plugin activated.

Everything else so far is working great.

i got the same problem, but deactiving the f7 in fufi's plugin fixed that.
great update

[liquide]

Amazing and very great job Xymph !
Thank you for all.

PS 1 : Your signature isn't up to date "Developer/maintainer of XASECO v0.8-v0.9+"

PS 2: When you have time can you make a little tutorial in order to explain "How create little plugin for Xaseco " ?: : that's can explain the base for an integration of a php script in xaseco (if you want of course ).

bye