YOU MUST BACK UP THE ROUTE
FOLDER BEFORE TRYING THIS PROGRAM AT ALL !!!!
You must have the 6 Default Routes installed in MSTS on your PC.
Introduction
Route-Riter v7 is a suite of over 110 utilities for performing
various actions on sections of the Microsoft Train Simulator program.
The major options are as follows:-
- Check a Route for missing shape and texture files.
- Compact a Route by removing files from the route which are not required and
just serve to slow the program down.
- Check all Activities installed in the Simulator
- Package a route ready for uploading (including production of spanned zip files).
- Count objects in selected and adjacent World tiles
- List all the track and road sections used by a route.
- Produce 'Mini-Routes', i.e. compact versions of MSTS which contain only one route
and associated rolling stock.
- Options to check and fix many of the file types used by MSTS.
- A host of utilities to compress and uncompress files, replace shapes in .W files,
build AI locomotives etc.
- Graphics utilities which allow the user to view shape files and consists in full
colour, run 3rd party programs such as TGATools2a and TView etc.
The full version of Carl-Heinz Rive's TSUtils program is also included. The language.txt
file included with Route-Riter is in English, but lang_Dutch.txt, lang_Norwegian.txt,
lang_Danish, lang_French and lang_Spanish.txt files are also included, just select the
appropriate language from the Files/Language menu.
Version History For Latest FULL Install and later
- v7.1.32 - A new FULL install of Route Riter. Again an updated RRit_Extra_Files released with this upgrade, correcting some errors in the previous brake files. Also a new version of TsUtils.
Note: brake file figures and calculations are for North American trains only as Australia and other parts of the world operate trains with air brake-pipe pressures of 70psi rather than the US' 80 and 90 psi and do not have Emergency Brake Reservoirs.
{Released 17-February-2009}
- v7.1.35 - Minor bug fixes.
{Released 29-March-2009}
- v7.1.36 - Minor bug fix. Also new version of Route Riter ExtraFiles (7.1.36) installer containing the latest version of TsUtils (v3.4.02)
{Released 27-June-2009}
- v7.1.38 - Minor bug fix.
{Released 04-Sep-2009}
- v7.1.42
- Correct COG (Centre of Gravity) - This is on the Edit .eng/.wag files screen and adds a CentreOfGravity line to any selected rolling stock, calculated from the Shape file viewer settings for the model. This can in some cases be useful for centering couplings on a model. Based on calculations by L W Shaw and Jeff Kraus-Yao - see discussion on Centre Of Gravity fix here.
- Updated the Search Screen which is used in many options including the Correct .SD Files. The list box on this screen has been replaced with a Grid control allowing over 32768 items to be listed. Furthermore these options no longer check for files in folders with the words Backup or Stored in their names.
- There is also a new version of TsUtil v3.4.04: this has resulted in the creation of a new update file Route_Riter_ExtraFiles_7_1_42.exe, link below. Besides error-corrections there are two new functions :
- -fcpy : works as 'fmgr' but can modify data while copying. This function was needed to handle routes where overheadwire was suppressed using the 'SectionIDX'-Method.
In opposite to the 'Hidewire'-Method, 'SectionIDX'-Method replaces the 'SectionIDX'-value of a track-definiton with a value which points to a road-piece. Because roads do not contain a overheadwire, it is suppressed.
The 'SectionIDX'-value is located within the world-file and therefore a modification has no impact on the track-database.
- -world This functions can 'split' and 'merge' world-files. I may be used to export objects of a word-file into another one, so that the file may be small enough to be saved correctly. Only 'static objects' may be moved. Later, all world-files can be merged together using ths function again. The result may be saved compressed, so that no further processing is needed.
The above new functions and some others which are listed in Carl-Heinz's text files in the archive are not yet implemented from within Route_Riter, but full details of how to use them from a CLI window are included.
{Released 20-Sep-2009}
- v7.1.44 includes a new button on the Activities/Stock tab named "Fix .SMS broken by patch v7.1.42" (see screen shot at top of this page) - this button is a fix for a bad bug introduced with v7.1.42 whereby when you used the 'Fix .sms files' button, .sms
files would contain long lines looking like "../../../../../../../../" etc.
This button is only for fixing these corrupt files, otherwise it can be ignored (actually it does nothing if it does not find these errors.)
Sorry about that, the Fix .sms files now works like it always did in the past.
{Released 27-Sep-2009}
- v7.1.47Due to a change from using a ListBox in the Search screen to a Grid control, it is no longer possible to add multiple file types to the filter box, e.g. "*.eng;*.wag" this box now only accepts a single file type. This has also meant that instead of the 'Fix .eng/.wag files' button under the 5 'Fix' buttons on the Activities/Stock tab, there are now 6 buttons. Many thanks to Derek Morton for his help in debugging these options.
{Released 03-Oct-2009}
The language.txt file included with Route-Riter is in English, but lang_Dutch.txt, lang_Norwegian.txt, lang_Danish, lang_French and lang_Spanish.txt files are also included, just select the
appropriate language from the Files/Language menu.
Notes:
1. If you are using this program to compress routes you have downloaded, then after running the route from end to end, providing everything is OK, then you can delete your backup.
2. Do not run this utility against the Default MSTS routes or you will delete files which might be required by other routes.
YOU MUST BACK UP THE ROUTE
FOLDER BEFORE TRYING THIS PROGRAM AT ALL !!!!
Technical Support
Please advise me of any difficulties - Any comments / Suggestions will be appreciated. :-
Mike Simpson - 03-Oct-2009.
Email: virtualtrains@optusnet.com.au
Unlocking Route_Riter's Extra Features
If you wish to make a small donation towards Route_Riter development,
click the PayPal button at right.
All contributors will receive a Licence file which activates some extra features within Route_Riter.
Note: The payee is agene AT optushome.com.au - this is correct, it is Mike Simpson's main email address.
|
|
Downloads:
Summary of Files Required
Note: Versions of Route_Riter less than 7.0.85 are no longer supported. It is strongly recommended that you install a full version of 7.1.32 or higher as listed below. If you delete your old folder (not necessary), be sure to save your licence file if you have donated to Route_Riter.
- New Installation:
- Download and run the full 7.1.32 Route Riter Package installer (~15 MB);
- Download and run the ExtraFiles_7.1.47 installer (~5.65 MB);
- Download and install 7.1.47 upgrade (~1.1 MB)
- Download and install the latest version of Java: visit http://www.java.com/en.
If you see "Navigation To Web Page was Canceled" when opening the help file within Route_Riter, click here to fix this problem;
- Upgrading your installation:
Download Links
|
Clickable Links
|
Description
|
RRit7_1_32full.zip
Full Install
14.8 MB (15,584,579 bytes)
|
Full Route Riter Package: all Route_Riter exe and help files, AceIt! (and its matching TGATools2a), and TsUtils v3.4 (dated 09-Feb-2009).
You must have an up to date Java installation on your computer: visit http://www.java.com/en for the recommended installation.
Released 17-Feb-2009 |
RR_ExtraFiles_v7.1.47
5.65 MB (5,930,892 bytes)
|
Route_Riter Extra Files for Route_Riter - Coupling, Brake, etc. files for Route_Riter as well the latest version of TsUtils (files dated 16-Sep-2009) if updating: now packaged as separate download as updates no longer contain these files (brake files etc are installed with FULL versions of RR, but not the latest TsUtils). Includes NEW Couplings from TurboBill and Otto.
Now presented as a simple to run installer.
This IS the latest version containing files most recently dated 16-Sep-2009
Released 03-Oct-2009
|
Update to v7.1.47
1.17 MB (1,237,834 bytes)
|
Update Package - updates a full install of
RouteRiter 7.1.12 or higher to 7.1.47.
Check version numbers of Extras and Help files below for complete upgrade (as these are now packaged separately): extrafiles may need to be upgraded with this version, install ExtraFiles BEFORE running this update. Download and install the Extra_Files using the installer below.
You must have an up to date Java installation on your computer: visit http://www.java.com/en for the recommended installation. Microsoft .NET Framework 1.1 is no longer required.
Released 03-Oct-2009
|
|
French Help File
|
French Help File: translation by U.Telemaque with many thanks (6.30 MB (6,611,795 bytes))
Released 12-Nov-2007
|
|
Spanish Help File
|
Spanish Help File: translation by Javier Torres with many thanks. New version for 6.2.01 or higher.
Released 5-Dec-2004
|
|
Portugese Help File
|
Portugese Help file: translation by Carlos Alberto Ricardi with many thanks.
Released 1-May-2005
|
|
Italian Help File
|
Italian Help file: translation by Daniele Formica with many thanks.
Released 14-June-2007
|
|
Java Downloads
|
Download the "Offline" install version - the automatic/online download sometimes doesn't install completely/properly on some XP systems. If you have installed Java and RR doesn't work, read #11 in error messages below.
|
Error Messages after Installation / Upgrading
- I receive error message when installing/upgrading Java "The wizard was interrupted before Java(TM)6 Update nn could be completely installed. To complete installation at another time, please run set up again.":
Follow these steps to correct this problem:
- Uninstall ALL versions of Java via Start | Control Panel | Add/Remove Programs. You may find one or more cannot be completely uninstalled. Don't worry about that at the moment.
- Go to C:\Program Files\Java and delete all files and folders.
- Go to C:\Documents and Settings\myusername\Application Data and delete the Sun folder.
- Download and install the Windows Installer CleanUp Utility from microsoft.com;
- Run the Windows Installer Cleanup Utility and look for Java (see image below):
- Highlight and select "Java update" (there may be more than one), click on "remove", then click on "ok" (see image below):
- You should now be able to install Java without any further difficulty.
- I receive Error 76 when I first try to run Route-Riter after clicking OK on the Startup screen:
The possibility is that the Route Riter 6 registry entry has become messed up, in which case it will be necessary to
use Regedit, and look for the entry:
HKEY_CURRENT_USER\Software\VB and VBA Program Settings\Route_Riter6
Right click on Route_Riter6 (and Route_Riter as well if it exists from a previous version)
and select Delete from the menu. The program should then run OK.
(The registry entries are then re-written when you next exit RR.)
- The Route_Riter main window opens too high on my screen and I cannot drag it back into place
There must be a problem with the registry entry for Route_Riter as this tells RR to open on the screen in the position it was closed in.
I suggest
- you run Regedit from the Start menu run box, and navigate to HKEY_CURRENT_USER\Software\VB and VBA Program Settings\Route_Riter6
- Click on Route_Riter6 and under it you will see an entry Startupk;
- Left-click on Startup and you should see entries for Height/Left/Top/Width
- Right-click on Top and select MODIFY from the menu and change the figure in the box to somthing like 2000 this should move the Route_Riter screen down to around the screen centre.
- I receive Error 429 whenever I try 'Set up new .ENV files' or some other options:
If you still get this Error 429 after you have carried out the option in 2. above, and
you find that you can run the 'Check Route' option successfully, then it is likely that you have
a problem running scripts on your PC. This can be overcome by going to the Desktop Start/Run box and entering:-
regsvr32.exe scrrun.dll
Then clicking the OK button. After this everything should work OK.
- I receive Error 429 whenever I try Route_Riter's ZIP options:
This can be caused by the ZIP dll not being registered correctly. This can be overcome by going to the Desktop Start/Run box and entering:-
regsvr32.exe SawZipNG.dll
Then clicking the OK button. After this everything should work OK.
- I am using Windows 98 and am unable to see the Route-Riter help files:
This is similar to 3. above: Windows 98 does not natively read .chm files, so
needs hhctrl.ocx installed to do this, this file must also be registered as above:-
regsvr32.exe hhctrl.ocx
A useful utility is MJ Diag available
by clicking here, it checks your Help file .dlls etc and fixes some errors automatically a
s well as showing you a report.
- I receive Error 75 while running Check Route (or some other items):
Error 75 - Means 'Unable to access the selected file' - This is usually because the file
in question is READ ONLY - There is a button on the MSTS File Utils screen which will force all
files in your MSTS installation to be Read/Write, or you may change individual files to Read/Write
using Windows Explorer.
- I receive Error 380 when Route-Riter starts or when running TsUtils:
This has been connected to problems with the Java installation. Users have
found that downloading the latest version from Java Manual Downloads for All Operating Sytems. Make sure you download the 'Manual Download' version as Windows XP SP2 has been found to block
installation of the automatic version.
- I can not get TsUtils to run:
Open a DOS window and go to the TsUtil folder, then type at the prompt java TSUtil - You should get the response 'Error --- too less arguments!' Instructions for use can be obtained with argument '?'! ("java TSUtil ?")
This response indicates Java/TsUtil is correctly installed. However I found that on my PC, I had to place the TsUtil class and properties files into the folder c:\program files\java\jre1.6.0_nn\Classes as mentioned in the readme.txt file in the TsUtil folder of Route-Riter. This fixed everything up (Note: The folder jre1.6.0_xx number may vary depending upon your Java version) .
- AVG anti-virus reports UHARC.exe as a virus in Route_Riter
This is a 'false positive' report by recent versions of AVG, UHARC.exe is a compression program like WinZip widely used, however I am modifying Route_Riter (v7.0.74 onwards) so that if UHARC is missing, then the button for using it will be greyed out. In the meantime, anyone who is worried or annoyed by this AVG report can safely remove UHARC from the Route_Riter folder.
- I receive Error 75 when Packaging an Activity.
This has been reported when a user checks a selected activity and finds it is OK, yet when he tries to package that activity he gets an Error 75. Error 75 usually means that a file is inaccessible because it is Read Only, but in this case it is caused by the .zip utility not being registered correctly. Correct this in a similar manner to registration errors in item 4. above, i.e. with the entry in the RUN box of
regsvr32.exe SAWZipNG.dll
- Problems with the Java/TsUtils installation
As TsUtils is now used for all compress/uncompress operations within Route_Riter, it is imperative that a working Java setup is running on your PC. The latest version can always be downloaded from
Java Manual Downloads for All Operating Sytems. Make
sure you download the 'Manual Download' version as Windows XP SP2 has been found to block
installation of the automatic version.
From v7.0.23, Route_Riter automatically runs a java script on startup, and will advise you if Java/TsUtils are not working. At which time Route_Riter will close.
TsUtils is normally installed in the Route_Riter\TsUtils folder, but if you have installed Java and it still does not work, you should go to the Java folder, normally at c:\Program Files\Java, under which there may be several sub-folders like jre1.4.0 and jre1.6.0 - The one with the highest number is the latest version. Open this folder and you should see sub-folders bin and lib make a new folder 'classes' which will then appear between these two and copy the contents of the TsUtil folder into this new Classes folder. After which TsUtils should run OK. You may then remove all older versions of Java (they occupy about 114MB per version) using the Start | Settings | Control Panel | Add/Remove Programs option.
- Using Route_Riter with Windows Vista
Route_Riter and MSTS both run fine under Vista (although due to limitations of early video and sound card drivers, MSTS does leave something to be desired).
Install Route_Riter V7 as usual under Vista using the Full-Install versions of RR.
You must also download and install Java to be able to use the TsUtils options.
After that, RR should run fine under Vista, however it has been found that you may need to run Route_Riter as an administrator.
To do this:-
- Open the folder which contains the program file (by default C:\program files\Route_Riter}
- Right-click the Route_Riter.exe file
- On the Compatability tab, click the 'Run this program as an Administrator' check-box.
- Click OK, then the program will always run in Administrator mode.
- Help file won't open - "Navigation to the web page was canceled"
You have been blessed with yet another Microsoft security fix! After a bit of online research, I discovered that Microsoft security update 896358 included changes to the InfoTech protocol that blocks the ability to view remote content. These changes were introduced to reduce security vulnerabilities in HTML Help.
The net effect of this "security update" is that you may find you are unable to open the Route Riter Help file: you may see a message such as this:
Clicking on any option in Contents doesn't improve things at all
Fortunately, the cure is simple: browse to "route_riter.chm" in Explorer, Right-click, select "Properties", and click on "Unblock".
You will now be able to view the help file.