===================================================
=                                                 =
=                                                 =
=          Tribes MuiliMedia System README        =
=                 for Build #245                  =
=                                                 =
===================================================

About TMMS:
--------------
TMMS (Tribes Muilimedia System) is an more than an advance mp3 player script. It they ONLY way to play mp3 music via Tribes2 IMO. The script was first coded by my self (^BuGs^) and then myself and Labrat worked together during da Beta Period to create almos to a point to where we had a DemoHUD Style Interface. The script minimizes your CPU usage, unlike Winamp and other mp3 players that might be running behing Tribes2. This script is still the number one downloaded script so far... *cough*SuperIP*cough*. I hope you enjoy! I hope you find this usefull as much as I do. :P

Special Thanks:
---------------
LabRat - Working with me
Beta & Meta #t2scripters - Helpt us with ideas.
VeKToR - Name of the script.
Writer - support.vl2
Zear - Createing the super l33t group of scripters
Digital Outcast & Pagemap - My personal beta testers. :o)
Tribes2 Dev Team - Making it possiable for mp3's to be played.


Requierments:
--------------
 - Able to read this readme.txt fully.

OPTIONIAL and RECOMENDED:
---------------------------
Writers Support Pack - www.planettribes.com/lorne/support.vl2


Instalation:
--------------

Read this if you are upgrading:

1) Delete any files that are related to TMMS at the moment that are located in your:
 - x:\dynamix\tribes2\gamedata\base\tmms
 - x:\dynamix\tribes2\gamedata\base\scripts\autoexec\
2) If you want, you can delete everything located in the mp3 dir or what ever the directory is that holds your mp3's.
3) After words, place tmms.vl2 that located in this zip, in your:
 - x:\dynamix\tribes2\gamedata\base\
4) All Done (please read Running TMMS in Tribes2)

If this is a fresh install:

1) Create a directory called mp3 in your:
 - x:\dynamix\tribes2\gamedata\base\
2) Place tmms.vl2 in the same directory:
 - x:\dynamix\tribes2\gamedata\base\
3) All done. (please read Running TMMS in Tribes2)

Running TMMS in Tribes2:
--------------------------
There are 2 flavors of TMMS included in this one zip.

1) support.vl2 use (Would be a good idea if you had Writer's Support Pack. If not, your an idiot. :D)
2) support.vl2 no use

If you have support.vl2 in the next build there will be a GUI options page to where you can change the keys for quick an easy changing without loading up the "DemoHUD" interface. We hope to have this out soon. Please stay tuned. But for now, F3 is the default keys for opening up the "DemoHUD" interface.

NEW FEATURES:
---------------

mpu and pls import.

To play mp3 music outside of your mp3 directory follow these steps:
1) Make sure T2 is closed and open Winamp.
2) Create a playlist of the songs you want that are located within the drive of your Tribes2 dir.
3) Save the playlist int he default folder of:
 - x:\dynamix\tribes2\gamedata\base\mp3\
 - Make as many playlists as you like.
4) Open up Tribes2. Goto the Playlist Editor via the Console (F3). 
 **If you are having trouble with opening TMMS with your F3 key read troubleshooting.**
5) Press the import .m3u or .pls file and select the playlist. This should load the playlist. Once you are done you can same it as a tribes playlist so you do not have to keep reloading it.

- TrackHUD
- "X" to close the dialog
- Skin Changing works
- Add a clearlist button (Credit to MaXGTS)
- Code has been improved


NEW FEATUERES NOT WORKING YET:
--------------------------------

If you have Writers's support.vl2 file, you will be soon be able to change the different keys for different options. I am still working on the code. You can download it here: http://www.planettribes.com/lorne/support.vl2

TMMS HISTORY BUILD:
--------------------
Build #124
- HUD To show the song name
- Improve speed code
- Volume code is now fix (didn't see this bug in the last build)
- Added an "x" to the main control to close.
- Fix a UE crash when you tried to change skins.

Troblesshooting:
-----------------
To change you key for TMMS Console at the momet, open up tmmsprefs.cs in the tmms dir to the key you want. Save it and delete the tmmsprefs.cs.dso file. Then restart tribes. Until the GUI editor is done (read above) this is the only way to do it. Sorry. :(



That's it. Check at http://www.tribalwar.com/bugs/tribes for updates!
