6RIWZDUH 'RFXPHQWDWLRQ

9HUVLRQ
Read the included End User License Agreement (EULA)
NO WARRANTIES. Open Rails.org disclaims any warranty, at all, for its Software. The Open Rails software and any related tools, or documentation is provided as is without warranty of any kind, either express or implied, including suitability for use. You, as the user of this software, acknowledge the entire risk from its use.
Trademark Acknowledgment Open Rails, Open Rails Transport Simulator, ORTS, Open Rails trademark, Open Rails.org, Open Rails symbol and associated graphical representations of Open Rails are the property of Open Rails.org. All other third party brands, products, service names, trademarks, or registered service marks are the property of and used to identify the products or services of their respective owners.
Copyright Acknowledgment 2010-2011 Open Rails.org All rights reserved.

Table of Contents

Introduction..... 5 About Open Rails.... 5 Community.... 6 Version..... 7 Whats New..... 7 Installing Open Rails program.... 8 Overview.... 8 System Requirements.... 8 Supported Operating Systems... 9 Technical Requirements Software.... 9 Installation Procedure.... 10 Working installation of Microsoft Train Simulator... 10 Video card supporting DirectX v9.0c or greater with Pixel Shader 2.0+.. 10 Microsoft XNA Framework Requirements... 11 Installing Microsoft XNA Framework Redistributable 3.1... 11 Upgrade of.NET Framework Requirements for Open Rails software.. 13 Installing Microsoft.NET Framework 3.5 Service Pack 1 (SP1) Redistributable. 13 Installing OPEN RAILS software.... 15 Upgrading from a previous Public Download... 16 How to Use RailDriver with Open Rails... 16 Setting up the RailDriver calibration file... 16 Driving with your RailDriver in Open Rails.. 17 Getting Started.... 18 Overview.... 18 Traditional Windows Main Menu... 19 Train Sim Style Menu... 19 Game Loading runactivity.exe.... 22 Open Rails Loading Error Messages... 23 Main Viewer Window... 25 Windows Main Menu Options.... 26 Routes Details.... 26 Activities Details.... 26 3
Add Folder.... 27 Remove..... 27 Options Windows Style & Train Sim Style... 27 Join..... 29 Full Screen.... 29 Resume..... 29 Game Controls..... 29 Mouse Controls..... 29 Keyboard Controls.... 29 Known Issues..... 31 General Display.... 32 Cameras.... 32 Track Display.... 32 Cab view.... 32 Trainset Physics.... 32 Consists..... 32 Routes..... 32 Environment.... 32 Activities.... 33 AI trains..... 33 Acknowledgements.... 33 License Agreement.... 34

Introduction

Open Rails software (OPEN RAILS) is a community developed and maintained project from Open Rails.org. Its objective is to create a new transport simulator platform that is first, compatible with routes, activities, consists, locomotives, and rolling stock created for MSTS; and second, a platform for future content creation freed of the constraints of MSTS. Our goal is to enhance the railroad simulation hobby through a community designed and supported platform built to serve as a lasting foundation for an accurate and immersive simulation experience. By making the source code of the platform accessible to community members, we ensure that OPEN RAILS software will continually evolve to meet the technical, operational, graphical, and content building needs of the community. Open architecture ensures that our considerable investment in building accurate representations of routes and rolling stock will not become obsolete. Access to the source code eliminates the frustration of undocumented behavior and simplifies understanding the internal operation of the simulator without the time consuming trial and error experimentation typically needed today. Open Rails software is just what the name implies a railroad simulation platform thats open for inspection, open for continuous improvement, open to third parties and commercial enterprises open to the community, and best of all, an open door to the future.

About Open Rails

To take advantage of almost a decade of content developed by the train simulation community; Open Rails software is a complete new game platform that has backward compatibility with MSTS content. By leveraging the communitys knowledge base on how to develop content for MSTS, Open Rails software provides a rich environment for community and pay ware contribution. The primary objective of the Open Rails project is to create a railroad simulator that will provide true to life operational experience. The Open Rails software is aimed at the serious train simulation hobbyist; someone who cares about loco physics, train handling, signals, AI behavior, dispatching, and most of all running trains in a realistic, prototypical manner. While the project team will strive to deliver an unparalleled graphical experience, eye candy is not the primary objective of Open Rails software. By developing a completely new railroad simulator, Open Rails software offers the potential to better utilize current and next generation computer resources, like graphics processing units (GPUs), multi-core CPUs, advanced APIs such as PhysicX, and wide screen monitors, among many others. The software is distributed in restricted source code form so the user community can understand how the software functions to facilitate feedback and to improve the capabilities of Open Rails software.

Community

At the present time, Open Rails software is offered without technical support. Therefore, users are encouraged to use their favorite train simulation forums to get support from the community. Train-Sim.Com UK Train Sim Elvas Tower http://forums.flightsim.com/vbts/ http://forums.uktrainsim.com/index.php http://www.elvastower.com/forums/index.php?/index
The Open Rails team has launched a wiki http://wiki.uktrainsim.com/display/OPEN RAILS/Home that will offer the community a central resource for technical assistance on installation, creating content, known issues, tutorials, and a place for the community to provide feedback to the Open Rails team. The Open Rails team is NOT planning on hosting a forum on the Open Rails website. We believe that the best solution is for the current train simulation forum sites to remain the destination for users who want to discuss topics relating to Open Rails software. The Open Rails team monitors and actively participates at these forums.

Version

This document is based on version 0.645.

Whats New

Since the last public download (v360) Open Rails software has been extensively upgraded and improved. A dedicated team of worldwide volunteers has been hard at work delivering on our mission of the most "realistic" train simulator. The Open Rails team would like to gratefully acknowledge the generous support of real world experts and historical societies from across the globe in signaling, interlocking, dispatching, train engine manufacturing, and railway design and construction. Their input and patience as we've gone about turning their intimate knowledge into simulation code has been utterly invaluable and has contributed immensely to the authenticity of the experience provided by Open Rails Train Simulator.
Among the areas that have been upgraded since the last release are train physics across steam, diesel and electric locomotives towards prototype realism; an all new interlocking and signaling module that will set the standard for train simulations for the future; new self-aware AI capabilities that allow for dynamic changes to Activities; replacement of the irrKlang sound engine with an Open AL implementation; a 20% -30% improvement in Frame per Second performance; Phase 1 special effects; integration with RailDriver; and much more.
Major Enhancements in v6xx Listed here in no particular order. 1. Upgraded dynamic shadows and lighting effects. Specular lighting has been added back via new, more efficient implementation. Shadows now respect ambient lighting/overcast effect. Hidden setting (ShadowAllShapes) added to make everything cast shadows. Shadows are fixed in position and don't flutter.
2. Working Crossing Gates and Car Spawners. Sounds associated with Crossing Gates and flashing light animation have NOT been implemented. Cars can interact (slow down and stop when gate is closed, acceleration and move when no obstacle).
3. Full integration with RailDriver and its API's.
4. Phase 1 special effects have been added. Steam and smoke effects are displayed using a brand new particle physics module developed by the Open Rails team. At the present time, Open Rails software reads the effects data from the engine file. However, this new foundation means that the community need not be forced to accept artificial limits in the number and types of emitters per engine, nor restricting the types of emitters per engine. The foundation means special effects, in the future, will be configurable for any object in the Open Rails 3D world.
5. F1 keyboard assignments and printable copy. Since the last version, Open Rails software has changed some of the keyboard assignments. To make these changes and all key assignments easily accessible, Open Rails software shows that information in this F1 display.
6. Significant improvements in FPS performance especially when dynamic shadows and other realism effects are enabled. The Open Rails team has also done some adjustments in the shaders to better simulate lighting in the 3D world.

Video card supporting DirectX v9.0c or greater with Pixel Shader 2.0+. Pixel Shader 3.0 is required for a full implementation of new dynamic shadows features. To determine if your system has DirectX v9.0c or greater installed, follow these instructions: Go to START menu Select RUN command; a dialog box as shown below appears
Type dxdiag into the dialog box. Click OK button
- After the window appears, the last line (indicated by the arrow) will show which version of DirectX is currently installed on your computer.
Although the current version of DirectX is ver11, you only need ver9.0c in order to run Open Rails. If this test shows that you already have v9.0c, then upgrading to a higher version is not needed, and it may not be supported by your video card. In addition, if your version of DirectX is less than v9.0c, your video card may not support a higher version. If indeed you have a version less than v9.0c, you are *strongly* urged to update your system with a new video card rather than risk updating your old card with a new version of DirectX. To upgrade your system, please go here to download the correct version of DirectX. Many major video card manufacturers will install the optimal version of DirectX as part of the installation of the video card drivers.
Before changing or upgrading your system, you must make sure your system hardware supports DirectX v9.0c or higher and Pixel Shader 2.0. Do not upgrade or change your system software unless you are knowledgeable on how to do it.
Your video card must also support Pixel Shader Model 2.0 or better. Video cards built in 2005 or later should be compatible, but please check with the manufacturer to be certain. We do not have a suggestion on how you can determine this yourself. The best way to find this out is to run the software and see if it works. Most reasonably modern video cards support Pixel Shader 2.0. Microsoft XNA Framework Requirements There are certain Microsoft runtime libraries that must be installed for the Open Rails software to function properly. These runtime libraries are included in the Microsoft XNA Framework Redistributable 3.1. XNA Framework Redistributable 4.0 is NOT compatible with Open Rails software.
Installing Microsoft XNA Framework Redistributable 3.1 Please download and install this software from the Microsoft website here. Select the Download button to download the software from the website.

When the Microsoft installation Wizard appears, select Next to begin the installation process. Please note the.NET package is 2.8 MB, so plan the download depending on your Internet connection speed.
Once you have successfully completed the installation of the.NET Framework, you will see the final installation screen. Select Finish to complete the installation process.
Congratulations, you have successfully installed the Microsoft.NET Framework 3.5.
Installing OPEN RAILS software You can download the zipped install file here. The Open Rails software may periodically, but rarely, be unavailable for download because the team disables the link while preparing an updated version or while fixing a software problem. Open Rails team recommends that you install the software in a separate folder from where your MSTS is installed. Since there is not an automated uninstall process, 15
segregating your Open Rails software from your MSTS or any other software ensures that you can accurately remove the Open Rails software by just deleting the folder. In addition, updating the Open Rails software will be much easier if it is located in an easyto-find, separate folder on your system.
Upgrading from a previous Public Download. If you have previously installed an earlier public download, upgrading Open Rails software is easy. Download the latest public version from the Open Rails website. Unzip the contents into any folder. Users have two options: (1) copy and paste the new Open Rails files and folders into their existing Open Rails installation, overwriting the files and folders; or, (2) unzip the Open Rails software into a new folder. Multiple instances of Open Rails software can exist on your computer without any conflicts. Please check the path of any desktop shortcuts you may have created to ensure they reference the desired version of Open Rails software.
How to Use RailDriver with Open Rails You can now use RailDriver to run Open Rails, even on Windows Vista and Windows 7. Just follow the steps in this section.
Setting up the RailDriver calibration file. If you already have a RailDriver installation where you have calibrated your RailDriver, youre in luck, as there is very little to do. Simply find your RailDriver software folder (C:\Program Files\PI Engineering\RailDriver, or something similar). With luck, Open Rails will find it there. (A Registry
entry LOCAL MACHINE/SOFTWARE/PI Engineering/PIBUS/RailDriver should identify the location. If youre not familiar with Registry navigation, dont try.)
If you can find it, but Open Rails software cannot, look in a folder named controller and copy the ModernCalibration.rdm file to your main Microsoft Train Simulator folder. Youre done! Hook up your RailDriver and launch Open Rails software If you dont have a ModernCalibration.rdm file or you want to re-calibrate your RailDriver, here is the suggested procedure: 1. If you have an existing RailDriver software installation, find the installation folder (C:\Program Files\PI Engineering\RailDriver, or something similar). If you dont, youll have to install the RailDriver software from your RailDriver CD or from the RailDriver website, at http://www.raildriver.com/support/downloads.php. Use the MSTS version, halfway down the page. (If you like, you can uninstall it at the end of this calibration procedure.) Using the RailDriver Calibration application, this procedure will have you create an independent copy of just the calibration file. 16

Getting Started

Start the Open Rails software by navigating to the Folder where you unzipped the software. To start of Open Rails software, double click on the Open Rails.exe file. This will start Open Rails software with the traditional Windows style menu. You can switch to the Windows Presentation Format menu via the switch menu button, or double click on the MenuWPF.exe file to start Open Rails with a new train simulator style menu. The software will remember which menu style was opened last.
Since the Open Rails software is not registered with either of the major video card developers (ATI or NVidea), the video card default of application controlled for the video card settings is 18
recommended at the present time. In future versions, Open Rails will automatically set the default Anti-Aliasing and Ansiotropic filtering levels that provide the best graphic display.
Traditional Windows Main Menu
Once the Open Rails software loads, a Main Menu screen appears listing the Folder location of your MSTS installation, active Route(s) and Activity(s) within your MSTS installation.
To start game, simply highlight the route and activity, then click the Start button. The Switch Menu Style changes the main menu from traditional Windows style to Train Sim style menu. The choices, selection and operation of both the Windows style and the Train Sim style menus are identical.

Train Sim Style Menu

Open Rails software introduces a new menu style that is similar to familiar train sim main menus as shown below.
Upon first loading of the train sim style menu, all fields will be blank. In the Select Folder pane, navigate to the location of your MSTS location or choose Default. The menu will read the train information from your MSTS folders to populate the menu selections.
Once the train database has been loaded, active routes, consists, activities will be shown.
The train sim style menu can be customized by selecting Options in the navigation bar and choosing Graphics from the menu options. A custom background graphic can be used. You must select Save for the graphic change to take effect.
Open Rails software is fully compatible with Train Store. Only unstored Routes, Consists, Activities, and Trainsets will be displayed in the Open Rails Main Menu Window.
You may receive a Windows security warning when you start the Open Rails program, such as illustrated below. Select the Run button to start the Open Rails program. Clear the checkbox Always ask before opening this file to avoid this pop up security warning appearing each time the Open Rails game is started.
Game Loading runactivity.exe
Clicking on the START button initializes the runactivity.exe and opens a dialog box. The path of the Activity selected in the Main Menu is displayed. The runactivity.exe program starts to load the key data sets needed to build the simulation environment.

The runactivity.exe module verifies that the specified folder contains a.trk file for either MSTS or ORTS. It creates either Tr_RouteFile (MSTS) or ORTRKData (ORTS), which parses the respective file. The software then verifies the tdb file in the selected routes folder. The TSectionDat process verifies the track sections and shapes. Similar actions are done against the Activity and Consist files. The process can be monitored in the Loading line (TRK TDB DAT ACT CON) of the runactivity.exe window. Open Rails software proceeds to: Initialize the start time of the activity. Aligns all switches to their default positions, as specified by the activity. The internal Track Data Base (TDB) data structure is traversed in order to do this. Places the player train. Places static consists. Signals will be initialized (when implemented) Creates a queue of AI trains.
After this process is complete, the Open Rails software launches its Viewer. The Viewer proceeds to: Set up user game settings Creates and initializes the sound engine (IrrKlang 3D Sound Engine version 1.1.3) Initializes the environment according to the activity (time and weather) Reads TTYPE.DAT and builds an internal data structure. 22
Instantiates a Tile class object whose constructor initializes an 8x8 (x, z) buffer of tile objects.
During the loading of the Viewer, the user may see error messages like those shown below.
In the runactivity.exe window, the loading of the game elements can be monitored. Different initials indicated the type of game file being loaded by the Open Rails software. Error messages will be generated for each file that presents a problem. All output from runactivity.exe is available in the Open RailsLog.txt file.
Initials Table: T = route tile; W = world file; S = shape file; C = Wagon or Engine file $ = World Sound file
Finally, the software creates two or three subsidiary threads, one for rendering, one for loading, and (if the PC has multiple processors) one for updating. Open Rails Loading Error Messages The Open Rails software offers extensive error trapping and messages to assist the user to identify problems with Trains, Consists, Shapes and Texture file loading. If the following message is displayed, the Open Rails software encountered an error that prevented the game from loading correctly.

Other types of messages related to Open Rails software loading serve as warnings about errors, which users can safely ignore.
In addition, this release includes enhanced Warnings and Error messaging to allow the Open Rails team the ability to better diagnose and potentially fix problems. Common Warnings are as follows: Water Layer Warning: MSTS environment files have a water layer count of 3 and then four water layers. The code is ignoring the last one in each case. The Open Rails development team speculates that it is possible MSTS counted this list from 0 (unlikely) or the extra was an unfinished feature (likely); the "error" is reported as informational only; it's not actually an error.
runactivity.exe : Warning : 0 : Ignoring extra world_water_layer in C:\Program Files\Microsoft Games\Train Simulator\ROUTES\Allegheny\ENVFILES\Sun.env:line 303 at ORTS.ORTraceListener.TraceEvent(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.TraceInternal.TraceEvent(TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.Trace.TraceWarning(String format, Object[] args) at MSTS.ENVFile.ctor(String filePath) at ORTS.Viewer3D.ReadENVFile() at ORTS.Viewer3D.Initialize() at ORTS.Program.Start(IEnumerable`1 settings, String[] args) at ORTS.Program.Main(String[] args)
Sound Warnings:.Unexpected stream.sms sound Errors identifies the syntax error that MSTS silently ignores. Open Rails will identify the line where the error occurred to assist in correcting the.sms file. Its actually informational; Open Rails will play the sound file normally.
runactivity.exe : Error : 0 : Unexpected Stream in C:\Program Files\Microsoft Games\Train Simulator\trains\trainset\Bessemer719\sound\F7eng.sms:line 347 at ORTS.ORTraceListener.TraceEvent(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.TraceInternal.TraceEvent(TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.Trace.TraceError(String format, Object[] args) at MSTS.STFException.ReportError(STFReader reader, String message)
at MSTS.STFReader.SkipUnknownBlock(String token) at MSTS.ScalabiltyGroup.ctor(STFReader f)
Stream mismatch.sms Error identifies the syntax error that MSTS silently ignores. Open Rails will identify the line where the error occurred to assist in correcting the.sms file. Its actually informational; Open Rails will play the sound file normally.
runactivity.exe : Error : 0 : Stream count mismatch in C:\Program Files\Microsoft Games\Train Simulator\trains\trainset\Bessemer719\sound\F7eng.sms:line 346 at ORTS.ORTraceListener.TraceEvent(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.TraceInternal.TraceEvent(TraceEventType eventType, Int32 id, String format, Object[] args) at System.Diagnostics.Trace.TraceError(String format, Object[] args) at MSTS.STFException.ReportError(STFReader reader, String message) at MSTS.SMSStreams.ctor(STFReader f) at MSTS.ScalabiltyGroup.ctor(STFReader f) at MSTS.Tr_SMS.ctor(STFReader f)

Open Rails software may not properly load a Route, Consist, or Trainset that MSTS toolsets show as having no errors. The Open Rails development team is aware of the issue and is working to identify those errors to fix them.
As a first step in diagnosing the root cause of the problem, the Open Rails team suggests using the standard MSTS tools, such as RouteRiter among many others to ensure proper installation of routes, trainsets, sounds and other game elements.

Main Viewer Window

Once the main viewer screen appears, the game is ready to play.
. The user must either minimize the runactivity.exe window or click on the main viewer window for the game controls to be activated. Do NOT close the runactivity.exe window, or the game will exit. The main viewer window is set to a default size of 1024 x768. If the default aspect ratio of your display is smaller, the Open Rails viewer window will automatically be reduced in size to fit your display. You may change the default size of the main Viewer window in the Options Tab of the Main Menu. To maximize the viewer windows to full screen, click on Alt + Enter keys. To exit the Open Rails viewer window, click Escape key or click on the close button of the window. The software returns to the Main Menu window on closing the viewer window.
Windows Main Menu Options
Routes Details The Routes Details button opens a separate window displaying the Routes text description contained within the route.trk file of the route highlighted in the Main Menu window. Click OK to return to the Main Menu window.
Activities Details The Activities Details button opens a separate window displaying the text within the Activity Description and Activity Briefing of the activity highlighted in the Main Menu window. The Activity Details window also displays the Start Time, Duration, Season, Weather and Difficulty of the selected activity. Click OK to return to the Main Menu window.
Add Folder The Add Folder button opens a separate window, allowing you to select the drive, directory and folder where your MSTS installation is located. The Open Rails software reads the Window registry to determine where the MSTS directory is located. However, if you have a non-standard installation, mini routes, or an installation location in addition to the main MSTS location, use the Add Folder button to navigate to the location of your MSTS directory. The highlighted folder must be the one named Train Simulator and must have the complete train sim folder set within it. Click OK to return to the Main Menu window.

Alt + P Shift F1 (+ Shift) F4 F8 F9 F8 Num 7 Num 1 Shift + 1 Shift Control Num 4 (+ Shift) (+ Control) Num 6 (+ Shift) (+ Control) Num 8 (+ Shift) (+ Control) Num 2 (+ Shift) (+ Control) Num 9 (+ Shift) (+ Control) Num 3 (+ Shift) (+ Control) Alt + Num 4 (+ Shift) (+ Control) Alt + Num 6 (+ Shift) (+ Control) Alt + Num 8 (+ Shift) (+ Control) Alt + Num 2 (+ Shift) (+ Control) Alt + Num 9 Alt + Num 3 Alt + Num 7 Alt + Num 1 G Shift + G Alt U Control + E Shift + Control + F Tab W S W S D A ' ; ] [
Control Dynamic Brake Increase Control Dynamic Brake Decrease Control Bail Off Control Initialize Brakes Control Handbrake Full Control Handbrake None Control Retainers On Control Retainers Off Control Brake Hose Connect Control Brake Hose Disconnect Control Emergency Control Sander Control Wiper Control Horn Control Bell Control Light Control Pantograph Control Headlight Increase Control Headlight Decrease Control Dispatcher Extend Control Dispatcher Release Control Injector 1Increase Control Injector 1Decrease Control Injector 1 Control Injector 2Increase Control Injector 2Decrease Control Injector 2 Control Blower Increase Control Blower Decrease Control Damper Increase Control Damper Decrease Control Firing Rate Increase Control Firing Rate Decrease Control Fire Shovel Full Control Cylinder Cocks Control Firing
,. / Shift + / Shift + ' Shift + ; Shift + ] Shift + [ \ Shift + \ Back X V Space B L P H Shift + H Shift + Tab Shift + Control + Tab K Shift + K I L Shift + L O N Shift + N M Shift + M R Shift + R Control + R C Control + F

Known Issues

At the present time, the Open Rails software is in the process of being developed. Therefore, users may find things that do not work or function like MSTS. If a specific capability or function is not working doesnt mean the Open Rails software is incapable of having it in the future. The development teams object is serve the serious train simulation hobbyist; someone who cares about loco physics, train handling, signals, AI behavior, dispatching, and most of all running trains in a realistic, prototypical manner. Please consult the Open Rails website for more information.

General Display

At the present time, there are known alpha sorting and z-bias issues that may cause lights and other see thru effects do not properly display such as terrain cutouts for tunnels. The display of the sky dome may not extend all the way to the ground. Users may experience moir patterns on the track bed. Increasing AntiAliasing may or may not reduce the moir.

Cameras

Open Rails Cameras do not behave exactly like MSTS. Please consult the Camera Controls for more information.

Track Display

There may be some display issues with some specialized Track types, such as Narrow Gauge XTracks. These may exhibit discontinuities that dont affect train operations except to make them more exciting.

License Agreement Open Rails transport simulator (Open Rails)
End User License Agreement
IMPORTANT-READ CAREFULLY: THIS END-USER LICENSE AGREEMENT (EULA) IS A LEGAL AGREEMENT BETWEEN YOU (EITHER AN INDIVIDUAL OR A SINGLE ENTITY HEREBY REFERRED TO AS YOU) AND OPEN RAILS.ORG FOR THE ABOVE REFERENCED SOFTWARE PRODUCT(S), WHICH INCLUDES COMPUTER SOFTWARE AND MAY INCLUDE DOWNLOADED BINARY OR SOURCE CODE FILES, AND ONLINE OR ELECTRONIC DOCUMENTATION. THE SOFTWARE PRODUCT INCLUDES ANY UPDATES, SUPPLEMENTS, PATCHES, OR MAINTENANCE PACKS PROVIDED BY OPEN RAILS.ORG. BY INSTALLING, COPYING OR OTHERWISE USING THE SOFTWARE, YOU AGREE TO BE BOUND BY THE TERMS OF THIS EULA. IF YOU DO NOT AGREE TO THE TERMS OF THIS EULA, DO NOT INSTALL OR USE THE SOFTWARE. YOU SHALL INFORM ALL USERS OF THE SOFTWARE OF THE TERMS AND CONDITIONS OF THIS EULA.
This EULA, grants You, the user, a non-exclusive license to use the Software under the terms and conditions stated herein. You agree that all updates, enhancements, maintenance releases, patches, bug-fixes or other modifications to the Software provided to You, on a when and if available basis, shall be governed by the terms and conditions, including the limited warranty, exclusive remedies and limitations of liability provisions, contained in this EULA, or the then-current version of this EULA. You may: (I) use the Software on any number of computers You own; (II) make modifications to the original source code of the software for your own personal use; (III) distribute the compiled version of the software; (IV) distribute software plug-ins, add-on files, and any other secondary content created for the software; (V) make copies of the Software, documentation or other user information, tools, or content accompanying the Software for back-up purposes; (VI) make a copy of or print documentation provided in electronic form for Your internal use only; and, (VII) use Open Rails trademarks solely for these purposes, but You must incorporate all patent, copyright, trademark and other notices included on the materials on any copies that You make. You may not: (I) sell, sublicense, rent, or lease the Software to another party; (II) disseminate any modification, revision, correction, or change, in any manner, to the Software source code except and only to the extent that such activity is expressly permitted by this EULA or by written permission of Open Rails.org; (II) transfer or assign Your rights to use the Software; (IV) use the Software in violation of applicable local, federal or International laws or regulations; (V) use the Software for any purpose other than as permitted in this EULA; or, (VI) remove, destroy, erase, alter or otherwise modify Open Rails trademarks. 34
NO WARRANTIES. Open Rails.org disclaims any warranty, at all, for its Software. The OPEN RAILS software and any related tools, or documentation is provided as is without warranty of any kind, either express or implied, including suitability for use. You, as the user of this software, acknowledge the entire risk from its use. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. In no event shall Open Rails.org or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use this product, even if Open Rails.org has been advised of the possibility of such damages. COPYRIGHT. Any intellectual property or content which may be accessed through the use of Open Rails software program is the property of the respective property or content owner and may be protected or prohibited by its applicable copyright. You, as the user of the software, must determine the applicability of any third party intellectual property or content. This EULA grants you no rights to use such content. The Open Rails software program(s) itself, title and copyrights, any accompanying documentation, and copies of the software program are the property of Open Rails.org.

Trademark Acknowledgment Open Rails, OPEN RAILS Transport Simulator, OPEN RAILS, OPEN RAILS trademark, Open Rails.org, OPEN RAILS symbol and associated graphical representations of OPEN RAILS are the property of OPEN RAILS.org. All other third party brands, products, service names, trademarks, or registered service marks are the property of and used to identify the products or services of their respective owners.
Copyright Acknowledgment 2010 - 2011 Open Rails.org All rights reserved.

Getting Route_Riter to run correctly.
Some users have had problems getting Route_Riter to run correctly, especially if using Windows 7, however the following is applicable to any version of Windows. Installing Java 1. The user must download the latest Java version from www.java.com and install it. (If using Windows 7 or Vista, the Java installer must be run as Administrator. 2. They should then go to the folder c:\program files\Java\jre6 (or c:\Program Files (x86) \Java\jre6) 3. In that folder should be two sub-folders, 'bin' and 'lib' 4. Make a 3rd sub-folder named classes 5. Copy all of the files from the Route_Riter\TsUtil folder into Java\Jre6\classes 6. Run RR and on the TsUtil tab click the 'Show TsUtil Version' button If all is well you should then see a report showing all of the TsUtil files and their version numbers. This indicates that both Java and TsUtil are working correctly.
Setting up the MSTS Path 1. Run Route_Riter and navigate to the TrainSimulator folder in the left hand folder list
2. Double click on Train Simulator and the file list should display the files in the TrainSimulator folder as above. 3. Go to the Files/MSTS Path menu and you should see a box as under:-
4. Click the Select button and you will be taken to the Routes folder. 5. Double click on any route name to select it, e.g. Europe 1 and click the Confirm Route button. 6. The MSTS Path and selected Route should now appear in the top window border, e.g.
Running Route_Riter At this point Route_Riter should work correctly, just remembering that if you are using Windows 7 or Vista then, especially if your MSTS is located in the Program Files (x86) folder then Route_Riter must be run as Administrator. (You can do this by right clicking the desktop icon and selecting Run as Administrator).
Registry Settings Users familiar with Regedit may which to check their Registry settings for both MSTS and Route_Riter these can be found at:1. MSTS - HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft Games\Train Simulator\1.0 This may not appear on Windows bit machines, for some reason it does not appear on my PC as above.
2. Route_Riter - HKEY_CURRENT_USER\Software\VB and VBA Program Settings\Route_Riter6 If you cant get Route_Riter running at all, this item may be garbled, so Right-Click on the Route_Riter6 entry in the left hand column and select Delete from the drop-down menu. This will remove all Route_Riter entries from the Registry and it will be rewritten next time you run the program.
The above is complete as far as I am aware, please advise me of any errors. Mike Simpson http://www.rstools.info