Trainzoptions.txt modifications/additions?

WileeCoyote

Eatibus Almost Anythingus
I have lately noticed that there exist more trainzoptions.txt modifications that I ever thought possible, Dinorius_Redundicus's thread has somewhat proved this to the point that I cannot help but wonder. What other modifications are there? So far the only one I know of are -resourcememory and -keepallresources, but there seem to be many more. Can anyone show me what others exist and what they do?

WileeCoyote:D

EDIT: As requested I'll make a list of them, much easier to compile under one post than having to hunt through dozens to find the one you want.

EDIT EDIT: If anyone wants to use this list on another website or forum, feel free to do so (this means you PerRock!).

-freeintcam
Allows user to move around locomotive to place cameras

-keepallresources
Does not empty cache, keeps all objects in memory (see this thread for more information)

-surveyorfov=55
Changes the field of view in surveyor. Large numbers are wider view and smaller numbers allow you to zoom in more. 55 is default.

-driverfov=
Same as above but in Driver.

-ResourceMemory=XXX
Specifies the amount of memory reserved (in megabytes) for resource disk
caching. This will prevent Trainz from accessing the disk as often, reducing caching time and 'stutter' caused by slow disk access. This option defaults to 0.

-vsync
Activates 'vertical sync'. This option may be overridden by the video card
driver settings. When active, vertical sync results in smoother updates (no
visual tearing) but lower frame rates. This is usually a good thing. This is
equivalent to "-vsync = 1".

-vsync=XXX
See "-vsync" for more info. Allows finer control over vsync, attempting to synch to every second frame ("-vsync=2") or every third frame ("-vsync=3") etc. Larger numbers lower the maximum possible frame rate further but may improve the chance of achieving a steady frame rate. Probably not useful for most people.

-width=XXX
Manually specify the window/screen width (in pixels). When in fullscreen
mode, this must match one of the available display resolutions, and an
appropriate height must be selected. When in dualhead or surround modes
this is the horizontal resolution across all displays, not across a single display.

-height=XXX
Manually specify the window/screen height (in pixels). When in fullscreen
mode, this must match the Width setting used. Width-to-Height ratios other than 4:3 are untested. When in dualhead or surround modes, this is still the vertical height of a single display.

-640
Equivalent to specifying "-width=640" and "-height=480".

-800
Equivalent to specifying "-width=800" and "-height=600".

-1024
Equivalent to specifying "-width=1024" and "-height=768".

-znear=XXX
Override the default z-buffer near distance. Specified in meters. The default is 0.1 meters. Smaller numbers allow the viewing of objects closer than 10cm but rapidly decrease the z-buffer accuracy and will cause visual artifacts on most graphics cards. Larger numbers will improve the z-buffer accuracy and may provide less artefacts, especially in 16-bit depth buffer modes, however there may be problems viewing nearby objects such as inside cabin view.

-zfar=XXX
Override the default z-buffer far distance. Specified in meters. The default is 1500m. Decreasing the far distance will result in slightly improved z-buffer accuracy but will result in far-away objects not being visible (Note: this may not result in a speed gain if a high draw distance is specified in the Trainz tuning screens as Trainz will still consider the far-away objects as visible even if the video card is unable to render them.) Increasing the z-buffer distance probably isn't useful as Trainz doesn't allow the selection of draw distances greater than about 1300m, and the z-buffer accuracy will be decreased causing visual artefacts.

-disablefog
Causes fog to be completely disabled.

-fullscreen
Causes Trainz to take over the chosen display. This is the preferred mode.

-windowed
Causes Trainz to run in a window. This is useful for debugging, however may result in reduced frame rate and cause visual 'stutters', especially in DirectX mode.

-dualhead
Enables support for dual-display mode. This will only work if you have two
displays attached to a single video card acting as a single, large display (i.e. single frame-buffer). This wont work if there are two displays on different video cards or configured to act as independent displays. Currently dualhead support is only utilized in the Driver module. This option requires that a dualhead resolution is selected (ie. 8:3 ratio) and that Trainz is run in fullscreen mode. On some video cards this option may require you to switch to the appropriate resolution prior to launching Trainz.

-surround
Enables support for triple-display (triple-head / surround gaming) mode. This will only work if you have three displays attached to a single video card acting as a single, large display (ie. single frame-buffer.) This wont work if there are three displays on different video cards or configured to act as independent displays. Currently surround gaming support is only utilised in the Driver module. This option requires that a surround gaming resolution is selected (ie. 12:3 ratio) and that Trainz is run in fullscreen mode. On some video cards this option may require you to switch to the appropriate resolution prior to launching Trainz.

-disablecarz=X
Default 0 (carz enabled). If set to 1 (carz disabled), then carz will not appear on roads. This may (untested) result in smoother framerates. Experimental only.

-framestoaverage=XXX
This option controls the 'smoothing' of frame rate timing. Increasing this option may result in less visual 'stutter', however can cause period 'surges' if rapid changes in frame rate occur. Increasing this option may be useful for high-end machines with fast graphics cards where the frame rate remains fairly constant. Default is 4, maximum is currently 16, minimum is 1 (no averaging.)

-heartbeat=XXX
Specify the time interval at which the physics heartbeat occurs (in seconds). Defaults to 0.03sec. Larger intervals decrease processor usage for physics at the expense of accuracy. Intervals larger than 0.05sec are not recommended. Changing this option is probably unnecessary and may have a negative impact on physics accuracy.

-filter=XXX
Specify the texture filtering mode. Default is trilinear which provides the best visual results. Other options are bilinear and none. This option is unlikely to provide performance gains, except perhaps on minimum-spec (or lower) graphics cards.

-DisableEnvMap
Causes Trainz to not render Environmental maps. This may improve
performance on certain minimum-spec (or lower) graphics cards.

-framerate=XXX
Requests that Trainz limit the frame rate to the specified number of fps. Not tested. Doesn't appear to work with vsync enabled. May help with maintaining a stable frame rate on faster machines.

-render=renderdirectx
Cause Trainz to use the Direct3D API for graphics rendering as opposed to
OpenGL(default). This may improve performance or compatibility where the
video card drivers do not correctly support OpenGL.

-autopilotsignaldistance = XXX
Modifies the autopilot signal-visibility distance, specified in meters. Default
value is 200m. Smaller values are not permitted. This will affect how the
autopilot reacts to the signals - how soon it will begin to slow down and how close to the signal it will attempt to stop.

-disableztest
Turns off z-buffer testing for coronas (signal flares, headlights, sun.) This will make the flares shine *through* other objects, however will reduce artefacts with the ground and train clipping the flare.

-debug
Including this option enables debug mode. The main feature of debug mode is that it allows you to accelerate the game speed by holding down the Shift key. This can be useful for content creators that might want to test their sessions more quickly. However debug mode is not a supported feature and the behavior of Trainz in not guaranteed when using the Shift speed-up.

-loc
Displays the xy location of the cursor. x is distance in meters north/south of the ground plane origin and y is distance east/west of it. x is negative for locations north of the origin and postive for locations south of it. y is negative for locations west of the origin and positive for locations east of it. The origin is the northwest corner of the 1st base board. Does not function with -ShowKuids.

-allownoctrlrightclick
Removes the requirement to have to hold down the CTRL key when right clicking an object in driver to see info about the object.

-disablerailjointsound
Probably TRS2006 and later. Disables the rail joint "clickity-click" sound.

-intro=disable
Disables the playing of the Auran intro video when Trainz is started. The word "disable" must be entirely in lower case and not enclosed in quotes. Sometimes helpful if Trainz crashes on startup.

-showcachebar
Probably TRS2006 and later. Displays the cache bar which is displayed in TRS2004 but by default not displayed in TRS2006.

-ShowKuids
Displays the kuid of the currently selected asset in Surveyor. No effect in Driver, Scenarios, etc.
 
Last edited:
Change your post to make a list, then add them so we have a reference

-freeintcam ...... allows user to move around loco to place cameras
 
-surveyorfov=55 <--Changes the field of view in surveyor. Large numbers are wider view and smaller numbers allow you to zoom in more. 55 is default.

-driverfov= <Same as above but in Driver.

William
 
Here are two that I have seen but don't know what they do.

-PrototypicalTractionLevel
-HighPrecision
 
Last edited:
-allownoctrlrightclick
Probably TRS2006 and later. Sorry, I don't know what it does.

-DefaultAutoMip=none
Probably TRS2006 and later. Sorry, I don't know what it does.

-disablerailjointsound
Probably TRS2006 and later. Disables the rail joint "clickity-click" sound.

-intro=disable
Disables the playing of the Auran intro video when Trainz is started. The word "disable" must be entirely in lower case and not enclosed in quotes. Sometimes helpful if Trainz crashes on startup.

-showcachebar
Probably TRS2006 and later. Displays the cache bar which is displayed in TRS2004 but by default not displayed in TRS2006.

-ShowKuids
Displays the kuid of the currently selected asset in Surveyor. No effect in Driver, Scenarios, etc.

-windowcentered
I'm not sure what this does. Centres a Trainz window on the screen when running in windowed mode, maybe?

HTH,
John
 
>-allownoctrlrightclick
>Probably TRS2006 and later. Sorry, I don't know what it does.


It removes the requirement to have to hold down the CTRL key when right clicking an object in driver to see info about the object.

William
 
-ResourceMemory=XXX
Specifies the amount of memory reserved (in megabytes) for resource disk
caching. This will prevent Trainz from accessing the disk as often, reducing caching time and 'stutter' caused by slow disk access. This option defaults to 0.

-vsync
Activates 'vertical sync'. This option may be overridden by the video card
driver settings. When active, vertical sync results in smoother updates (no
visual tearing) but lower frame rates. This is usually a good thing. This is
equivalent to "-vsync = 1".

-vsync=XXX
See "-vsync" for more info. Allows finer control over vsync, attempting to synch to every second frame ("-vsync=2") or every third frame ("-vsync=3") etc. Larger numbers lower the maximum possible frame rate further but may improve the chance of achieving a steady frame rate. Probably not useful for most people.

-width=XXX
Manually specify the window/screen width (in pixels). When in fullscreen
mode, this must match one of the available display resolutions, and an
appropriate height must be selected. When in dualhead or surround modes
this is the horizontal resolution across all displays, not across a single display.

-height=XXX
Manually specify the window/screen height (in pixels). When in fullscreen
mode, this must match the Width setting used. Width-to-Height ratios other than 4:3 are untested. When in dualhead or surround modes, this is still the vertical height of a single display.

-640
Equivalent to specifying "-width=640" and "-height=480".

-800
Equivalent to specifying "-width=800" and "-height=600".

-1024
Equivalent to specifying "-width=1024" and "-height=768".

-znear=XXX
Override the default z-buffer near distance. Specified in meters. The default is 0.1 meters. Smaller numbers allow the viewing of objects closer than 10cm but rapidly decrease the z-buffer accuracy and will cause visual artifacts on most graphics cards. Larger numbers will improve the z-buffer accuracy and may provide less artefacts, especially in 16-bit depth buffer modes, however there may be problems viewing nearby objects such as inside cabin view.

-zfar=XXX
Override the default z-buffer far distance. Specified in meters. The default is 1500m. Decreasing the far distance will result in slightly improved z-buffer accuracy but will result in far-away objects not being visible (Note: this may not result in a speed gain if a high draw distance is specified in the Trainz tuning screens as Trainz will still consider the far-away objects as visible even if the video card is unable to render them.) Increasing the z-buffer distance probably isn't useful as Trainz doesn't allow the selection of draw distances greater than about 1300m, and the z-buffer accuracy will be decreased causing visual artefacts.

-disablefog
Causes fog to be completely disabled.

-fullscreen
Causes Trainz to take over the chosen display. This is the preferred mode.

-windowed
Causes Trainz to run in a window. This is useful for debugging, however may result in reduced frame rate and cause visual 'stutters', especially in DirectX mode.

-dualhead
Enables support for dual-display mode. This will only work if you have two
displays attached to a single video card acting as a single, large display (i.e. single frame-buffer). This wont work if there are two displays on different video cards or configured to act as independent displays. Currently dualhead support is only utilized in the Driver module. This option requires that a dualhead resolution is selected (ie. 8:3 ratio) and that Trainz is run in fullscreen mode. On some video cards this option may require you to switch to the appropriate resolution prior to launching Trainz.

-surround
Enables support for triple-display (triple-head / surround gaming) mode. This will only work if you have three displays attached to a single video card acting as a single, large display (ie. single frame-buffer.) This wont work if there are three displays on different video cards or configured to act as independent displays. Currently surround gaming support is only utilised in the Driver module. This option requires that a surround gaming resolution is selected (ie. 12:3 ratio) and that Trainz is run in fullscreen mode. On some video cards this option may require you to switch to the appropriate resolution prior to launching Trainz.

-disablecarz=X
Default 0 (carz enabled). If set to 1 (carz disabled), then carz will not appear on roads. This may (untested) result in smoother framerates. Experimental only.

-framestoaverage=XXX
This option controls the 'smoothing' of frame rate timing. Increasing this option may result in less visual 'stutter', however can cause period 'surges' if rapid changes in frame rate occur. Increasing this option may be useful for high-end machines with fast graphics cards where the frame rate remains fairly constant. Default is 4, maximum is currently 16, minimum is 1 (no averaging.)

-heartbeat=XXX
Specify the time interval at which the physics heartbeat occurs (in seconds). Defaults to 0.03sec. Larger intervals decrease processor usage for physics at the expense of accuracy. Intervals larger than 0.05sec are not recommended. Changing this option is probably unnecessary and may have a negative impact on physics accuracy.

-filter=XXX
Specify the texture filtering mode. Default is trilinear which provides the best visual results. Other options are bilinear and none. This option is unlikely to provide performance gains, except perhaps on minimum-spec (or lower) graphics cards.

-DisableEnvMap
Causes Trainz to not render Environmental maps. This may improve
performance on certain minimum-spec (or lower) graphics cards.

-framerate=XXX
Requests that Trainz limit the frame rate to the specified number of fps. Not tested. Doesn't appear to work with vsync enabled. May help with maintaining a stable frame rate on faster machines.

-render=renderdirectx
Cause Trainz to use the Direct3D API for graphics rendering as opposed to
OpenGL(default). This may improve performance or compatibility where the
video card drivers do not correctly support OpenGL.

-autopilotsignaldistance = XXX
Modifies the autopilot signal-visibility distance, specified in meters. Default
value is 200m. Smaller values are not permitted. This will affect how the
autopilot reacts to the signals - how soon it will begin to slow down and how close to the signal it will attempt to stop.

-disableztest
Turns off z-buffer testing for coronas (signal flares, headlights, sun.) This will make the flares shine *through* other objects, however will reduce artefacts with the ground and train clipping the flare.

-debug
Including this option enables debug mode. The main feature of debug mode is that it allows you to accelerate the game speed by holding down the Shift key. This can be useful for content creators that might want to test their sessions more quickly. However debug mode is not a supported feature and the behavior of Trainz in not guaranteed when using the Shift speed-up.
 
-loc
Displays the xy location of the cursor. x is distance in meters north/south of the ground plane origin and y is distance east/west of it. x is negative for locations north of the origin and postive for locations south of it. y is negative for locations west of the origin and positive for locations east of it. The origin is the northwest corner of the 1st base board.

Bob Pearson
 
-loc
Displays the xy location of the cursor. x is distance in meters north/south of the ground plane origin and y is distance east/west of it. x is negative for locations north of the origin and postive for locations south of it. y is negative for locations west of the origin and positive for locations east of it. The origin is the northwest corner of the 1st base board.

Bob Pearson

Just a heads up, an interesting thing I learned a few months ago, if you have -showkuids, -loc does not function.
 
It would be useful at some stage to compile a neat list with all the options, plus an indication of which version(s) of Trainz they apply to.

Trainzobjectz had options for TRS2004, along with explanations, under its 'Trainzoptions' tab. I think wreeder was quoting from that.
 
if one of you wishes (I'll do it if no one wants) then can take the list that is here and add it to the threat at the Trainz Resource (see link in earlier post) it would be very nice to get a complete listing somewhere.

peter
 
I remember there was a thread......

I remember a thread where various tweaks in trainzoptions file were put to the test and guess what?! Other than increasing -ResourceMemory most tweeks resulted in poorer performance.:eek:

Anyway I have TRS2004 and here is my trainzoption.txt file:
-DepthBits=24
-StencilBits=8
-LoadingTime=1
-KeepParticles=0
-KeepAllResources=0
-Intro=disable
-ResourceMemory=512
-fullscreen
-Jet=bin
-cabinfov=65
-driverfov=55
-zfar=1500
I seem to be pleased with the performance on my old system.
Athlon 64 +3200, nVidea 6800LE, 1.5 Ghz ram.

The funny thing is the defaults choosen by Auran usually resulted in best performance in Trainz on most systems. Imagine that.:hehe:
 
Searching the TC CCG for trainzclassicoptions finds 3-4, a bunch can be found in the TRS2004 Technical Manual located in
/Auran/TRS2004/Docs/manuals_cd/manuals/
 
It is my belief that there is no one perfect combination for everyone. Given the different computer hardware running different programs in the background under different operating systems finding the best settings for your installation would become a hobby in itself. But many commands are not performance related and useful in surveyor. For instance, I increase my -surveyorfov when doing wide area terrain shaping and decrease to do detail work.

Through trial and error, I have arrived at a group of settings that work for my style of Trainz experience. I like slow moving steam trains of short lengths moving through the mountains. Therefore my settings are adjusted to give me that tiny train lost in the rugged mountains feeling. Someone wanting to have a screaming fast passenger train rushing through an urban setting would be horrified by my settings.

Perhaps route creators should include their trainzoptions.txt with their route so the user can see the route the way the creator does. Just a thought.

William

PS..I quoted the TRS2006 manual since many newbies don't seem to get around to reading it. Lots of good stuff in there. Hint, Hint.;)
 
Several RBR members did some informal benchmarking recently and we reached this conclusion:

If changing the performance options in trainzoptions.txt has anything other than a marginal effect on your Trainz frame rates, then your video board is underpowered for Trainz.

What do you guyz think, would you agree or disagree with that theory?

John
 
I would tend to agree on frame rate. If you want max frame rate then run the default trainzoptions.txt setting. I think what can be done is to alter the look of the world at the expense of frame rate. I get between 15 and 20 fps but the grande scenic vista look is more important to my enjoyment. Of course, all my performance settings are cranked to the right.

William
 
Great thread. I dont know how to track it other than making a post:confused: . I am also very curious about the ones that I never can find documented, or if I do, there does not seem to be an in-depth discussion about the pros and cons of it. All of you keep up your fabulous contributions.:wave:
 
Back
Top