GTA3 / GTA Vice City MP3 Station Randomiser v2.0 - 12th May 2002

By Gareth "GazChap" Griffiths - mail@gazchap.com - http://www.gazchap.com

----------------------------------------------------------------------------

IMPORTANT!!!

If you want to host this file on your website, DON'T! I've noticed a lot of
GTA3/VC sites popping up hosting the actual file on the site. This is bad. It
stops site visitors from getting the latest version automatically. It also
means I can't track the number of downloads effectively.

If you want to put the file on your site, link to:

	http://www.gazchap.com/download.php?id=18

That way, your visitors get the latest version automatically. No more work
on your part, see?

Similarly, if posting a message about this program on forums, DON'T link
directly to the file, link to the address above.

Thanks.

----------------------------------------------------------------------------

DESCRIPTION

After installing Grand Theft Auto 3 or GTA Vice City on your PC, you may
notice during play that the MP3 Player radio station is always played in
alphabetical order, or if not alphabetical, in the same order every time.

This program circumvents this by adding a random number to the filename of
any shortcuts or MP3s in your GTA3/Vice City folder. This fools the game
into playing the MP3s in random order.

----------------------------------------------------------------------------

INSTALLATION

To install the program, simply copy the executable to your GTA3/Vice City
folder (the same place that the GTA3.exe or GTA-VC.exe main executable is).

The program automatically launches GTA3/Vice City (unless you tell it not to
(see below) so you don't have to muck about with batch files.

----------------------------------------------------------------------------

COMMAND LINE ARGUMENTS

Add the following to the command line in the shortcut if you wish:

	/debug		- 	This turns on Debug Mode, which writes a log of every
	                rename operation the program performs to Randomiser.log
	                in the same folder as the Randomiser.exe

	/denum		-	This removes the leading numbers from all the filenames,
					if there are any there. Basically this just undos the
					rename operations that the program does without /denum
					active.

	/launch		-	Supply an executable to this argument and it will be run
	                instead of the game executable - useful for starting
	                trainers.

	                Example:

	          	    	/launch Trainer.exe

	                Note: The executable must be in the main game folder, but
	                you can have executables in folders inside the game folder
	                folder, for example:

	          	    	/launch mods\GXT Editor\GXTEditor.exe

	/nolaunch	-	This argument stops the Randomiser from executing any
	                executables.

----------------------------------------------------------------------------

VERSION HISTORY

v2.0

    - The Randomiser now has 100% support for Grand Theft Auto Vice City.
      Thanks to DJ^AndyC for letting me know that the MP3 system is the same
      (I don't yet have the game!) and for providing bug reports.

v1.9

	- Added a /denum option that removes the numbers from the filenames.

	- Added leading zero's to numbers so that in Windows Explorer (or similar)
	  the order they are shown in the file list is the order they'll be played
	  in game.

v1.8

	- Fixed a silly bug where an error box would pop up if there were no
	  MP3 files to randomise.

v1,7

	- Improved handling of bits before hyphens in filenames. As of v1.4, the
	  program stripped everything before the first hyphen that was numeric.
	  There were some bugs in this though and things like "2Pac" were being
	  classed as numeric so were stripped.

	  This is now fixed.

v1.6

	- Fixed a silly bug discovered by myself (well, sort of, I figured out
	  that it wouldn't work in some situations from looking at the code :)
	  where the /launch argument wouldn't work properly if you had something
	  else before it on the command line.

	- Added a new error handling routine so hopefully some peoples problems
	  will become more apparent. On the other hand, it could screw things up
	  more.

v1.5

	- Some silly bugs have been getting in, regrettably. They should all be
	  gone by now, and the error handling routines have had a bit of a
	  makeover.

v1.4

	- Because of the way I name my MP3 files, I'd forgotten that most MP3s
	  have at least one hyphen in their name and the Randomiser was removing
	  everything before the first hyphen.

	  This is fixed, but only to a certain degree - it will remove any numbers
	  that come before the FIRST hyphen in the filename, as long as there is
	  no text with it. For example:

	  	"Blink 182 - ATSM" will become "<num>-Blink 182 - ATSM"

	  but "182 - ATSM" will become "<num>- ATSM".

v1.3

	- Seems that the bug wasn't fixed in v1.2, so now the files are moved
	  to a "temp" directory in the GTAIII\mp3 directory and then moved back.
	  I've been assured that this will fix it, so fingers crossed :)

	  Cheers to wamingo for reporting the bug. Hope its fixed now mate :)

v1.2

	- Files are renamed randomly - hopefully this will counter the "bug"
	  where some Windows installations don't give directory listings
	  alphabetically.

    - Debug mode added. Put "/debug" in the command line and all rename
      operations are logged to Randomiser.log in the same folder as the exe.

v1.1

    - Launch different executables (rather than GTA3.exe) using the new
      "/launch <executable>" command line argument. Useful for running
      trainers instead of GTA3. Use like so:

         Randomiser.exe /launch trainer.exe

    - Or alternatively, launch no executables at all (not even the GTA3 one)
      Just put "/nolaunch" in the command line and no programs will be run
      after the randomiser has finished.

v1.0

	- First release.

----------------------------------------------------------------------------

A LITTLE NOTE

It's written in Visual Basic so if you haven't got the Visual Basic run-time
installed it might not work. You can download these from:

http://download.microsoft.com/download/vb60pro/Redist/sp5/WIN98Me/EN-US/vbrun60sp5.exe

Run that program (its about a 1 MB download) and then Randomiser should work.

----------------------------------------------------------------------------

Have fun!

(C)2002-2003 GazChap Productions - http://www.gazchap.com

Footnote: A HUGE thanks to wamingo from http://www.gta3forums.com for providing
reports on bugs in the program. He doesn't have to sit and test it, but he has
been. Excellent stuff. Cheers mate, 'tis appreciated :)