Revision as of 18:07, 4 September 2020

Multiplayer Surveyor ("MPS") is an "Early Access" feature of Trainz in Trainz Plus Update 1 2020, introducing Stage 1 of a multi-stage implementation that will ultimately change the way that many Trainz routes and sessions are created and operated.

After several years in development, this early access feature will be a available to all Trainz Plus and Gold Class members.

What is Multiplayer Surveyor (MPS)?

+ Click to show/hide What is Multiplayer Surveyor?

What is MPS Early Access?

+ Click to show/hide What is MPS Early Access?

How do I access MPS Early Access?

+ Click to show/hide WHow do I access MPS early access?

How do I find and access MPS Routes?

MPS routes shared by other users will appear in your routes menu by default. These routes are list to the right of locally installed routes and show with a purple title. These can be searched upon, filtered and selected like a standard route. You can explore as many or as few of these routes as you wish.

The colour coding is as follows:

green-route.JPG Green Tick = Joined. You have previously entered the route

grey-route.JPG Grey Trainz Logo = Publicly listed and you haven't joined or abandoned it.

blue-route.JPG Blue Plus = Invited. You have been invited to the route, and you haven't abandoned or joined it.

yellow-route.JPG Yellow Key = Owned. You are the owner of this route.

Note that edit permissions are shown in-game and not in the menu UI, and that there are limits to the number of routes displayed at one time in the menu. You can still search for routes not listed by default.

How do I import my own routes?

To share your existing Trainz routes to the MPS server, follow this guide (requires an active Trainz Plus account):

• Select your route in the routes menu and click Edit Route
• If you’ve made any modifications, ensure you save your route before continuing
• Click Sharing Menu > Share route
• A prompt will inform you session data will not be included in the upload
• If your route includes assets not available in the current MPS content set, an error will show, and the upload will abort. If this occurs:
• On the Launcher click Developer > Show logs and you will see a list showing all of the KUIDs that are not currently usable in MPS.
• Replace/remove each of these items using the Bulk Update tool or by manually deleting/replacing them.
• Retry until you’ve replaced all the necessary items
• Your route will now begin uploading, with progress shown in a modal dialog (a large route may take several hours to upload)
• Once uploaded, a copy of your original route will exist on the MPS server (but no-one else will see it yet). Your online route will be given a new “MPS-Sever KUID” and will not (currently) be able to be saved offline.
• Your original offline route will remain as it was when it was last saved, and is now effectively a different route, independent from the MPS online version.
• For clarity, any future edits to the offline route will have no effect on the MPS version, and vice versa.

share-menu.JPG

Can I import a Download Station Route that isn't mine?

While it is possible to download and edit DLS routes for your own use, the laws regarding copyright infringement come into play when you start redistributing work you do not have copyright to.

Therefore to upload someone else's route from the DLS you need their permission first, or you need to have made a "new work" by significantly altering their original work (and even this step becomes grey under law).

For this reason, we highly recommend only uploading original creations or getting permission from the original author to upload their work.

How do I make my MPS route visible to others?

Once you have uploaded your route to the MPS Server, you’re ready to determine who else has access. Note that making a route visible does not allow the users to make any edits. this is done through the permissions dialog.

To make your route visible to everyone:

Click on Sharing Menu > Open Player List Enable guest access by clicking the lock icon

Alternatively, to make your route visible to only specific users.

Option 1, invite them by username:

Click on Sharing Menu > Open Player List Click on Add New Player Enter the MyTrainz username of the person you wish to invite Once the player is invited the route will show in their Routes menu. Note that there's a limit on the number of invited routes that will show, but the player can search for all routes by name.

share-menu.JPG Share menu

Multiplayer-permissions.JPG MPS Permissions menu

Player-list.JPG MPS Player list

How do I give permissions to other users?

To allow other players access to the various tools to edit the route, you will need to change the permissions for that player or player group, using the following tips. Note that you must be the Owner or an Administrator to edit permissions.

To issue full edit permissions to anyone:

Click Sharing menu > Open Permissions List Select “Guest Access” Click on "Enable all editing tools”, or the specific set of tools you wish to enable You can also then do the same to enable Area Locking, Layer Tools and Environment Tools Important Note: Allowing full edit permissions also means that a user can, for example, delete all the baseboards in a route. Be careful when issuing permissions. To issue limited permissions to individual users or a group of users:

Click Sharing menu > Open Permissions List Next to Guest Access click the + button to add a new permissions group Name the group (e.g. Friends) Select the group and enable the desired permissions as explained above Click the + button beside the Group Members (on the far right) to add users to the group, and grant them those permissions Note that using this method to a player who is not already registered with the route will do so automatically (and so have them also show in the player list dialog). You can also allow limited permissions by only issing access to one or more of the various tools. For example, you could issue scenery editing permission only, or scenery + track.

Also, only one person is allowed to edit certain dialogs at one time such as Environment Settings or Edit Route.

How do I drive a train on an MPS route?

There are a few options available to drive trains in MPS. To start from the beginning:

• Select an MPS route (title is shown in purple in the routes menu) and then click Edit Route
• Click Tools menu > Driver Mode to switch into Driver (or press Ctrl-F2)
• Find any existing locos by looking around, using Ctrl-F (and filter on vehicles), or clicking on the Driver image bottom left to open the Drivers List.
• In the Drivers list click on the “eye” icon to view each train and location.
• Once you have found a train that is not assigned to another player already, click on Multiplayer - Assign Driver to gain control of the train.
• To add your own train, switch to Surveyor Mode, click the Trains tab.
• Scroll or search to select your rolling stock and place each train car on the tracks.
• Note that placing your own train requires Train edit permissions
• If you do not have any train controls at this point, click on your loco or click the eye icon in the Drivers list.
• If required, change driving mode by clicking on the 3 dots on the bottom right

Important note: You can switch back and forward between editing and driving and your train will continue on without pausing. You can only change the controls in Driver Mode*.

Driver-mode-surveyor-mode.JPG

What protections are in place for MPS routes?

First off, everything created in MPS is saved to our servers and is backed up regularly.

As creator of a route, you are also the owner, and you have full control over who has access to the route. You can set permissions on a per feature, per group, or per person basis.

Many hands make light work, but on the other hand, too many cooks can spoil the broth. So while MPS will enable lots of people to work together to create routes far quicker than solo efforts, if everyone is working in different directions, things may get messy quickly.

For this reason we recommend that you allocate edit permissions wisely!

Note that during Early Access there is no user-facing “revert” option in case of needing to restore an earlier version of a route. In case of a full failure, routes can be restored.

Does MPS support Sessions and Rules?

MPS is based around new streaming technology that loads in only the parts of the route near to your current location.

Since everything is happening in real time without pausing, these systems mean that many session rules and concepts aren’t supported.

This also means that Driver commands (other than “Drive”) are not supported.

What is Area Locking

Area locking is a way to define custom permissions for a specific area of the route. These permissions may be restrictive (ie, prevent other users editing an area) or permissive (ie, grant edit access to specific users).

To create an area lock:

Click Sharing Menu > Take Temporary Area Lock (Note this option will be disabled if you don't have appropriate edit permissions) Use the mouse to drag-select the area on the map you wish to lock The locked area is marked in green for you (and other group members you add) and will show in red for other players Newly created area locks are temporary, and will prevent other players (except the route owner) from editing within the locked area until you log out. However, area locking is just another way to create custom permissions groups, and these groups can be edited like any other (using the permissions dialog). This includes modifying the edits that are prevented/permitted, modifying which players can edit, etc. anyone with permissions editing access (e.g. "Admin" users, and the route owner) can also edit them. Once an area lock is edited in the permissions dialog it becomes permanent, and must be manually deleted to remove it again (ie, it will remain in the route after you log out).

What’s the best way to coordinate route building in MPS?

To obtain the best results, coordination is the key in route building. If everyone does their own thing, the result will be disjointed. Therefore we recommend a variety of ways to coordinate your activities:

Give your route a meaningful name Ensure your route is visible to others (see "How do I make my route visible to others?") Use Edit Menu > Edit Route and add a detailed description of your plans for the route, what you expect from contributors to the route and how they can contact you Make a forum post giving more details about the route and the goals (link: https://forums.auran.com/trainz/forumdisplay.php?71-Trainz-Multiplayer-talk) Make a Discord channel post (join our Discord channel here, it's free) Utilize your other favourite channels to communicate (e.g. Skype, Teamspeak etc) Create your own website and post updates about route progress etc