Unified Driver Surveyor

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Saving Games, Sessions and Routes)
Line 24: Line 24:
 
* A number of Session Rules have been updated to correct flaws exposed by UDS, but many have not. See [[Session_Rule_Implementation|Session Rule Implementation]] for a programmers guide to correct Rule behaviour.
 
* A number of Session Rules have been updated to correct flaws exposed by UDS, but many have not. See [[Session_Rule_Implementation|Session Rule Implementation]] for a programmers guide to correct Rule behaviour.
  
==Saving Games, Sessions and Routes==
+
==Saving Games==
 +
The concept of Save Game relies on having no changes to the underlying session. With the extra ability to update a session and/or route on the fly, and to avoid different outcomes if you save while in Surveyor versus Driver, we've retired the old Save Game option.
 +
 
 +
By having the Saved Session option in both Surveyor and Driver mode, there is now consistency across both modes, meaning less confusion for end users as to exactly what you're saving.
 +
 
 +
There is also more flexibility with the resulting saved session asset which can be edited (whereas a Save Game cannot).
 +
 
 +
The Saved Session asset not only includes the train progress, but also all the Session Layer edits made during your session.
 +
 
 +
If you made changes to the route layer as well, then the save will prompt you to save both Route and Session layers.
 +
 
 +
==Saving Sessions==
 
The various save options provided will be determined by which edits have been made.  
 
The various save options provided will be determined by which edits have been made.  
  
* We've now removed the Save Game option
+
* If running a Session made by someone else, Save will prompt you to Create New Session.
* If no edits have been made, then "Save" will prompt to "Save Driver Session" and create a "Saved Game" (asset kind "savegame").
+
* Their original session remains intact, and you now have a version with your current progress saved.
* A Save Game can be restored from the View Sessions menu but cannot be loaded directly into Surveyor.
+
* If running your own Session, Save will now offer to "Overwrite" your session by default.
* After you load your saved game into Driver, you can still switch to Surveyor and edit as before.
+
* If no edits have been made, then "Save > Overwrite" will replace your original session with the current status at that time.
* If edits have been made, then wherever possible, saving will prompt to generate a savegame asset by default.
+
* If you don't want to save your current progress, then simply Exit Driver
* If edits have been made which are not compatible with the savegame asset type, you will be prompted save the Route and/or Session as appropriate.
+
* If you want to save progress but not overwrite the original session, then select Save > Create New Session".
* Exit Driver will return you to the menu. If you want to return to Surveyor, simply change mode instead.
+
* Exit Driver will return you to the menu. If you want to return to Surveyor, simply switch mode instead.
  
 
==Using Save Session to save your progress==
 
==Using Save Session to save your progress==

Revision as of 17:22, 12 September 2019

Unified Driver Surveyor (UDS) replaces the concept of "Quickdrive" and greatly expands upon the capabilities previously provided. In short, the system allows you to switch back and forward between Driver Mode and Editor (Surveyor) Mode instantly. When you switch mode, the User Interface changes and functionality changes accordingly.

Contents

Switching Modes

When in Driver, click the Tools button on the menu bar, then select "Surveyor Mode" to change to editing mode. The User Interface will change to the traditional Surveyor tool tabs and the new Surveyor Menubar options along the top. (A warning may appear the first time, and this can be hidden for future mode switches).

You will notice everything looks just as it would if you had selected Edit Session from the menu. Items that show only in Surveyor will now be visible (e.g. trackmarks, spline points, direction arrows on trains etc), and you'll have the full set of editing tools to use.

To switch to Driver Mode from Surveyor, click the Tools button on the menu bar, then click on "Surveyor Mode" to deselect that option and switch back to Driver instantly.

The User Interface will change to the traditional Driver Mode UI.

Changes to existing behaviour

There are a number of differences to the way things used to operate.

  • The Quickdrive option in the menu is removed. Use "Create Session" to gain access to all of the Surveyor Tools to create a new driving/operating session.
  • The Quickdrive button in Surveyor is removed, and it's default keyboard shortcut (Ctrl-F2) is now mapped to the Surveyor Mode toggle .
  • The Surveyor Mode toggle allows you to swap instantly from Driver to Surveyor and back again without any delay or loading screen.
  • A game pause control has been added to Surveyor (in the Tools Menu).
  • Switching modes does not pause the game automatically, so after switching from Driver to Surveyor your trains will keep moving.
  • The "Edit Trains" option is removed from Tools menu in Driver (this is replaced by Surveyor Mode where you can access all the editing tools, not just Trains).
  • Achievement progress is disabled if you activate Surveyor mode.
  • Session Rules can now be manually reset after returning from Driver (see below for more details).
  • A number of Session Rules have been updated to correct flaws exposed by UDS, but many have not. See Session Rule Implementation for a programmers guide to correct Rule behaviour.

Saving Games

The concept of Save Game relies on having no changes to the underlying session. With the extra ability to update a session and/or route on the fly, and to avoid different outcomes if you save while in Surveyor versus Driver, we've retired the old Save Game option.

By having the Saved Session option in both Surveyor and Driver mode, there is now consistency across both modes, meaning less confusion for end users as to exactly what you're saving.

There is also more flexibility with the resulting saved session asset which can be edited (whereas a Save Game cannot).

The Saved Session asset not only includes the train progress, but also all the Session Layer edits made during your session.

If you made changes to the route layer as well, then the save will prompt you to save both Route and Session layers.

Saving Sessions

The various save options provided will be determined by which edits have been made.

  • If running a Session made by someone else, Save will prompt you to Create New Session.
  • Their original session remains intact, and you now have a version with your current progress saved.
  • If running your own Session, Save will now offer to "Overwrite" your session by default.
  • If no edits have been made, then "Save > Overwrite" will replace your original session with the current status at that time.
  • If you don't want to save your current progress, then simply Exit Driver
  • If you want to save progress but not overwrite the original session, then select Save > Create New Session".
  • Exit Driver will return you to the menu. If you want to return to Surveyor, simply switch mode instead.

Using Save Session to save your progress

To mimic the behaviour of the old Save Game option (i.e. you're not making any edits in Surveyor), follow these steps:

  • Select a session from the menu
  • Click Drive Session
  • This loads your session with the trains, industries etc in the "original start position".
  • Drive and operate your trains as normal
  • Click Save
  • If the session IS NOT your own asset, the prompt will offer by default to "Create a New Session"
  • Saving will create a new Session asset with your train progress saved at the time of the save.
  • If the session IS your own asset, the prompt will offer by default to "Overwrite Session."
  • Choose "Overwrite".to save your current progress and overwrite the "original start position" session
  • NOTE: This is different to the old Save Game option which would not affect the original session
  • Or, if you want to keep your "original start position" for the session, but save your progress as well, then choose "Create a New Session"
  • By clicking Create New you now have the "original start position" session asset, and a new "progress saved" asset.
  • You can continue to "save and overwrite", or "save and create new" as often as you like.
  • Obviously the more times you choose to create new, the more copies of the session you will have to choose from.

Using Create Session to replace Quickdrive

To mimic the behaviour of the Quickdrive option follow these steps:

  • As there is no longer a "Quickdrive" session in View Sessions, simply click Create Session instead
  • This opens the Surveyor (Editor) mode
  • Click on the Train tab to open the tool you would normally see in Quickdrive
  • Place trains as per normal
  • To drive your newly created session, click Tools Menu > Surveyor Mode (to uncheck the editor mode)
  • You will immediately switch into Driver mode, and the Interface will show your currently selected loco, and the track profile etc
  • Drive as you normally would
  • If you want to add more rolling stock, or move something already in the session, click Tools Menu > Surveyor Mode again
  • You will instantly switch back to editing mode.

Edit Session Rules

While not new to this update, many Trainz users will be unfamiliar with the very power Edit Session window (found under the Edit menu in Surveyor mode).

Session Rules control gameplay behaviour and logic within a Session. For example, the Cinematic Camera Rule will change the camera target and animate the camera position for a period when executed.

By creating sets of rules you can effectively "program" how you want your world to operate, setting up triggers that will change what happens and when.

Find out more about Rules here.

Resetting Rules

Historically, Rules would execute when a Driver Session starts. Since users can now quickly switch between modes, there might be a time when a user needs to "restart" their rules.

So, we've added the option to reset any rule (so it will trigger on the next load into Driver) or Restart All Rules (and they will all trigger on the next load into Driver).

This option allows you to reset gameplay within a Session, which is extremely useful for Session testing and development.

For example if a Trigger Check rule has already been executed, but you edit the Session and now need to hit that trigger again, then you can manually reset the Trigger Check rule (in Edit Session) in order to retest that rule.

Another example is adding new Driver Commands to the Driver Setup rule. If the status shows as "Complete was-complete" then the new instructions will not be executed when you next enter Driver mode.

To ensure the rule will execute, right click on the rule (in Edit Session in Surveyor), select Reset, and this will change the rule to Paused.

Click the Tick to save your changes, then switch modes to Driver and the Driver Setup rule will execute again.

Using Undo

Undo continues to operate as before, and is found in the Edit menu in Surveyor, or operated using the ctrl+z hotkey (or ctrl+y for redo). Undo is not available in Driver.

Given that trains can be in motion in Surveyor, undoing certain actions (such as modifying track) may result in derailments. However, using Redo should restore all changes made by undo, including any accidental derailments. Other dependent states which can be modified (such as junction directions) may also be affected by undo/redo, so use caution and common sense when using this features.

Practical examples:

Adding or Replacing Rolling Stock

Switch to Surveyor mode, open the Trains Tab, select a loco or rolling stock and place on the track (or open the Consist tab to create or place a whole train).

Note that the Driver Setup rule will be marked complete, so you will need to reset it in order to get it running again.

Remember, being in Surveyor no longer guarantees the world is static, so beware of moving trains when making your edits! We also do not recommend editing moving trains, as this may upset the physics state.

Adding or Replacing Track

The normal restrictions of not being able to move track that has a train on it still apply. TIP: Lay a short section of track nearby, move your train to the new track, make your edits, them move the train back again and delete your temporary track.

Adding or Replacing Trackside Objects

Ever find yourself testing a Session you've created, and realise you need an extra signal? Or that a trackmark or trigger is misnamed? With UDS you can switch to Surveyor, correct your mistake, and continue testing the Session without any interruption.

Adding or Replacing Scenery Objects or Splines

Driving along and notice something missing or out of place? That tree a little too close to the track? A house that slightly floating? Switch to Surveyor, add, move or delete the item(s) then switch back to Driver mode. Make sure you save your Route/Session changes when you're done, but remember you can do that directly from Driver.

Changing/Editing Environment Settings

The addition of UDS grants full control over the weather, water/sky, environment lighting/colour, and more. No longer are you restricted to simple changes using the Quickdrive rule or the Session Options dialog. Note that certain rules (such as the weather rule) may still override your Surveyor settings during a Driver session.

Changing/Editing Session Rules

Session Rules, which dictate the gameplay behaviour of a Session, are also able to be edited at any time. This includes adding new rules, removing unwanted rules, or fixing existing rules.

For example, you may be testing a created Session and notice a spelling mistake in a message popup. Simply switch to Surveyor, edit the rule to correct the mistake, then switch back. In this example the rule will already have executed and there's probably no need to test the change, so you can continue driving without interruption.

Another example would be when setting up an introduction to your Session. For this you may use a fade-in, some camera animation, and some subtitles or message popups, and the sequence might be quite long if you want to really give some story/background to your session. UDS allows you to switch to Driver to run the startup sequence in full, where you can see whether it's working and what might need fixing or improving (e.g. you might spot another spelling mistake or typo, or you may want a camera angle slightly higher). When it's done you can switch back to Surveyor, make the fixes, click "Reset all Rules" to reset the rule state, and then switch to Driver to run the whole sequence again. And you can do this dozens of times over without ever needing to save your asset(s) or look at a loading screen.

Go back.png Go back to:

Personal tools