The information in this Wiki Page applies to TRS19, Trainz Plus and TRS22. This page is intended to provide information for understanding the different asset Status labels used by Content Manager. |
Installing Assets into Content Manager
|
|
|
![Top](/mediaWiki/images/3/3b/BackToTop.png) |
|
![Next Down](/mediaWiki/images/4/41/NextDown.png) |
![Bottom](/mediaWiki/images/4/47/BackToBottom.png) |
There are three common ways that assets can be installed into Trainz using Content Manager:-
![Ablue.png](/mediaWiki/images/0/06/Ablue.png) |
selecting an asset shown in the Content Manager display that is listed as Available for download (see the section Installing the Latest or an Older Version of an Asset). This is the preferred method as it will also download and install any dependencies required by that asset |
|
|
|
Start Content Manager by clicking Manage Content from the Trainz Launcher.
The Status column in the Content Manager display gives information about each listed asset - its location, availability, and "currency" (installed, obsolete, modified, Payware, unknown, etc). |
![Content Manager Display - Status](/mediaWiki/images/thumb/f/f9/StatusCMWindow.png/580px-StatusCMWindow.png) |
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
If the Status column is not present in the Content Manager display, then:-
Steps: To add the Status column:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Right Click on the column heading where you want it to be inserted |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
select Insert Column and then Status |
![insert Status Column](/mediaWiki/images/8/8b/StatusAddStatusColumn.png) |
|
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
Columns in Content Manager Can Be:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Removed
- Right Click on a column heading and select Remove Column
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Moved
- Left Click and Drag a column heading left or right
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Resized
- Move the tip of the mouse pointer onto the dividing line between two column headings then Left Click and Drag it left or right
|
|
|
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
It is important to remember that:-
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
many assets on the Download Station (DLS) are available in more than one version, the original and at least one update. When an asset is updated by the release of a new version, the original, and any previously existing updates, will remain on the DLS for those who prefer to use them instead of the latest release. The status labels Newer version available and Obsolete are the result of updates. |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
an update will not always have the same name as the original or previous updates. It may also have a completely different Asset ID (or <kuid> code number) as shown in the examples below. |
Example 1: the list below shows the same asset, the original and 3 updates, using 4 different names for the same <kuid> - the trailing :digit> is the update number.
|
|
|
|
Example 2: the list below shows the same asset, the original and 2 updates, all with the same name but each has a different <kuid>. The fact that they are updates of the same asset can be shown with the List Asset Versions option.
![StatusUpdatesNewKUIDs.png](/mediaWiki/images/d/d6/StatusUpdatesNewKUIDs.png)
Assets with a negative <kuid> can only be updated by issuing them with a new <kuid> code but this can also happen with updates to assets that have a positive <kuid> code.
|
|
|
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
it is not uncommon for two completely different assets to have identical names. If one is not an updated version of the other then both will appear in the Surveyor asset selection lists and if they are of the same type, e.g. scenery, road spline or track object, then they will appear under each other in the same selection list. |
![IdenticalAssetNames.png](/mediaWiki/images/d/df/IdenticalAssetNames.png) |
|
|
The Status labels are described in the following sections. |
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Status labels can have qualifiers added that provides additional information about each asset |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Two of the most common qualifiers are Newer version available and Obsolete |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
|
Other status qualifiers that can also appear include:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Open for Edit |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Faulty |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Missing dependencies |
Each of these labels are listed in the Table of Contents for this Wiki page (found at the top of this page) and are explained in the various sections below |
|
Newer Version Available
|
This means that the selected asset has another version available on the DLS that is a more recent version. This qualifier label can appear on any assets such as Installed from DLS, Packaged, Built-in |
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
You can download and install the newest (latest) version by a Right Click on the asset and select the option Download from the popup menu. Any versions of the asset, including the one selected, that are are not the newest version will be ignored and Content Manager will locate and download only the newest version. If the latest version was installed it will be relabelled as Installed from DLS with no further qualifier. If an earlier version was installed it will be relabelled as Installed from DLS, Newer version available |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
You can ignore the newest version to download and install the selected version by a Right Click on the asset and select the option Download this version from the popup menu. Any newer version of the asset that exists on the DLS will be ignored and Content Manager will only download and installed the selected version. The installed asset will be relabelled as Installed from DLS, Newer version available |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Packaged assets with the qualifier label Newer version available can usually be updated by firstly listing all their asset versions.
![StatusPackagedNewVersion.png](/mediaWiki/images/thumb/c/ca/StatusPackagedNewVersion.png/400px-StatusPackagedNewVersion.png) |
Open the options menu of a selected asset (spring-field 03 in this example) by a Right Click and select the option List Asset Versions . This will reveal all the available versions of that asset |
![StatusPackagedNewVersionList.png](/mediaWiki/images/thumb/c/c4/StatusPackagedNewVersionList.png/600px-StatusPackagedNewVersionList.png) |
In this case a version that is Available for download from the DLS has been identified. Right Click on this asset and select the option Download |
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Payware assets with the qualifier label Newer version available can sometimes be updated through Content Manager by listing all their asset versions as shown above IF the asset update has been released as Freeware through the DLS. However, if no update is available through Content Manager then open the Content Store from the Trainz Launcher and check for updates.
![StatusPaywareNewVersion.png](/mediaWiki/images/3/3c/StatusPaywareNewVersion.png) |
|
|
Obsolete
|
This means that the selected asset has been updated by a newer version that is installed on your system. This qualifier label can appear on any assets such as Installed from DLS, Packaged, Built-in |
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
If the selected obsolete asset is also showing the label Available for download then this specific obsolete version is not installed on your system but it is possible for you to download and install it if you need it - use the Download this version option described in the Newer Version Available section above - after it has been installed it will be relabelled as Installed from DLS, Obsolete. The latest updated version that is already installed on your system will not be affected by this change |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Obsolete Installed from DLS assets can be deleted |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Obsolete Packaged, Payware, Built-in and Base assets cannot be deleted |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Available for Download simply means that the asset is on the DLS and is not already installed on your system |
The Status labels that you may see would include:-
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Newer version available means that a later version of that asset is also available and can be downloaded and installed |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Obsolete means that a later version of that asset is already installed in Content Manager |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
You can select and download any asset that is labelled Available for download even if it is also labelled as Obsolete or Newer version available |
|
Available for download |
This version is available on the DLS and it is not already installed. This version IS the latest version available. If you are looking to install a new asset or update an existing one to the latest version, then this is the one you would normally select |
Available for download, Newer version available |
This version is available on the DLS and it is not already installed. It is NOT the latest version available. There is an updated version available on the DLS but you can still download and install this older version if it is required |
Available for download, Obsolete |
This version is available on the DLS and it is not already installed but it is Obsolete because you already have a more recent version installed but you can still download and install this older obsolete version if it is required |
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
You can check to see what is the latest version of an asset that is listed as Newer version available or Obsolete. This will produce a list of all the previous versions (installed or not), currently installed (if any) and later versions of the selected asset. |
|
|
|
In the example shown above the latest version of the selected asset is already installed (Installed from DLS) and it does not have exactly the same name as the original. If it is the latest available version and is not already installed then it will be shown as Available for download without any additional labels. |
|
Create an "Available for Download" Filter
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
This modified search filter will show all the freeware assets including their different versions that are available on the Download Station (DLS).
Steps: To create and save this filter:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Select the Content Manager search filter Download Station |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Open the filter (click the small triangle pointer on the left of the word Filter:) |
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
Remove (click the buttons on the extreme right) of the filter lines:-
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
Out of date, and |
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
Obsolete |
|
You can save this as a new filter |
![DotPoint4.JPG](/mediaWiki/images/8/87/DotPoint4.JPG) |
Click the Save button (which will appear as soon as you delete one of the filter lines) |
![DotPoint5.JPG](/mediaWiki/images/2/23/DotPoint5.JPG) |
Give the new filter a name (e.g. Available for Download) |
Once saved you can reuse the filter whenever needed. |
|
![Create and save a new filter](/mediaWiki/images/9/9e/StatusCreateSaveFilter.png) |
Any new filters that you create will appear in the drop down list of available filters. |
|
Create an "Updates Available" Filter
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
Installing the Latest or an Older Version of an Asset
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
To Install the Latest Version: You can select the version that is labelled Available for download with no other qualifier (Obsolete or Newer version available) or you can select ANY Available for download version (including those marked as Newer version available and Obsolete) and Content Manager will download and install only the latest version. |
![Download latest version](/mediaWiki/images/9/96/StatusDownload.png)
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version. |
Steps: To install the latest version of an asset:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Select (Left Click on) any version of the asset, it does not matter if it is labelled Obsolete |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Right Click on the asset and select the option Download |
Content Manager will ignore all the listed versions to download and install only the latest available version, even if that version is not shown in your filtered list. The asset download will include all the available dependencies of the latest version. |
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
To Install a Specific Older Version: You can download and install an earlier version of an asset (one that also has the label Newer version available or Obsolete) if you don't want the latest version. |
![Download this version](/mediaWiki/images/4/4b/StatusDownloadThis.png)
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version. |
Steps: To |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Select (Left Click on) the specific version of the asset you want, it can be one labelled Obsolete which means that you already have a later version of the asset installed |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Right Click on the asset and select the option Download this Version |
Content Manager will ignore any and all newer versions of the asset and will download and install only the selected version. The asset download will include all the available dependencies of the selected version. |
|
|
This built-in search filter will show all the assets that are installed in Content Manager. Set the Content Manager search filter to Installed. The Status labels that you may see would be:- |
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Newer version available added to a label means that a later version of that asset is also available and can be downloaded and installed |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Obsolete added to a label means that a later version of that asset is already installed in Content Manager |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
An asset that was originally Base, Built-in, Packaged, Payware or Third Party can be updated to Installed from DLS if a newer version becomes available on the DLS |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Packaged and Payware assets can ONLY be deleted (Uninstalled) using the Content Store and are usually updated through the Content Store |
|
For simplicity only the major labels are shown |
Base
Built-in |
The asset was installed when Trainz was installed |
Installed from DLS |
The asset was installed from the DLS |
Modified |
The asset is one you have created yourself, modified or cloned from another asset or have installed from somewhere other than the DLS (e.g. a 3rd party web site) |
Packaged |
The asset is included in a DLC package that you have installed but it may also be found on the DLS. See the Packaged and Payware section below for more information |
Payware |
The asset is exclusive to a DLC package that you have installed. See the Packaged and Payware section below for more information |
Third Party |
The installed asset may have been previously available on the DLS but is now unavailable |
|
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
You can ONLY delete assets that are labelled as Packaged or Payware using Uninstall in the Content Store, not from Content Manager.
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Assets labelled as Modified, Payware are an exception as these are DLC assets you have modified and they can be deleted using Content Manager. |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
But before you uninstall any assets see the
Warning Uninstalling DLC below. |
|
|
|
Base, Built-in
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
You will often see the following labels on installed assets:-
|
Base and Built-in
The asset was installed when Trainz was installed on your system. When you installed your current version of Trainz, or do a reinstall, the Base and Built-in assets will be the only ones installed. All the other assets have to be manually added later from the DLS, DLC or other sources. Base and Built-in assets can also have the label Newer version available which means that an update is available |
![Stop.PNG](/mediaWiki/images/4/43/Stop.PNG) |
WARNING:
Base and Built-in assets are optimised for specific versions of Trainz. If you have updated your copy of Trainz to a newer version you cannot copy (via .cdp files for example) any Base and Built-in assets from the old version to the new without creating errors and major problems. |
|
Installed from DLS
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
You will often see the following label on installed assets:-
|
Installed from DLS
You have downloaded and installed the asset from the DLS. You may have performed this manually by selecting and downloading the asset or it was downloaded and installed automatically as a dependency of another asset that you have manually selected and downloaded from the DLS, for example a route. Installed from DLS assets can also have the label Newer version available which means that an update is available |
Modified
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
You may often see the following label on installed assets:-
|
Modified
You have created, altered or cloned the asset, or not installed it directly from the DLS. |
This label will appear on all assets that you have:-
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
created yourself (it will have your kuid code) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
modified from an installed asset |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
cloned from an installed asset (it will have your kuid code) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
imported directly into Content Manager without using the Download option - as a result Content Manager will not know the source of the asset |
Open for Edit
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
|
Open for edit
The asset is currently in use by another process such as Surveyor, Driver or Content Manager. |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes: the Open for Edit label will appear on any asset that you have:-
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
currently open as a Route or Session in Surveyor or Driver. In this case, exiting Surveyor or Driver will close the open Route and Session assets |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
opened in Content Manager for editing - for example changing its config.txt file or image files |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
imported into Content Manager from a Content File (.cdp file) or a Content Folder when the same asset is already installed. In this case you will need to manually close the open assets |
|
|
Steps: To manually close open assets:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
select (Left Click on) the open assets (individually or as a group) |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Right Click on an open asset
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
select the option Submit Edits to close them with the edits saved, OR |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
select the option Revert to Original to cancel the edits and return the assets to their previous unedited states, OR |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
select the option Revert if Unchanged if you have opened the assets (in Explorer or have just viewed their config,txt files) but have made no changes. Any opened assets that you have changed will remain Open for Edit |
|
|
![Submit edits](/mediaWiki/images/f/fa/SubmitEditOptions.png) |
|
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Assets that are Open for edit cannot be exported to a .cdp file or uploaded to the DLS. They must be closed first |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
If you import assets into Trainz from a Content File (.cdp) or a Content Folder then Content Manager will not search for and install any missing dependencies from the DLS. You will have to do this manually. See the Missing Dependencies section below |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
If Trainz unexpectedly closes while using Surveyor or Driver, such as a Crash To Desktop or it is terminated by Windows Task Manager, then the loaded Route and Session will be Open for edit when you restart Trainz.
- See the Trainz Wiki Page
Route and Session Basics for more information on dealing with this situation
|
|
|
Packaged, Payware
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
If you have installed routes or other assets from the DLC then you see the following label or labels on installed assets:-
|
Packaged and Packaged, Payware
The asset has been installed as part of a DLC package. Packaged and Payware assets can also have the label Newer version available which means that an update is available |
Both labels mean that the asset was included in a DLC package that you have downloaded and installed.
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Packaged by itself means that the asset can be cloned and modified for your personal use. Many, but not all, Packaged assets will also be found on the DLS |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Payware means that the asset is exclusive to a DLC package and will not be found on the DLS. Some Payware assets are encrypted and cannot be cloned or modified |
It is up to the creator of a DLC package to decide if an asset they have created will also be available on the DLS, or if it will be encrypted.
See the Packaged and Payware section below for more information. |
Third Party
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
You may occasionally see the following label on installed assets:-
|
Third Party
The assets availability is "questionable". It may be best to avoid using until its status is resolved. |
This will appear on assets that:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
you have uploaded to the DLS but they have not yet been approved for distribution. Usually it takes 24 hours (sometimes more) before approval is given. After approval the Third Party label will be changed to Installed from DLS |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
have been removed from the DLS listing, or are not shown in the listing, for a variety of reasons including:-
![DotPoint1Blue.png](/mediaWiki/images/2/21/DotPoint1Blue.png) |
repair work - then they can still be downloaded and installed, as Third Party assets, and the repaired assets will (eventually) become available as updates that will be identified using the "Updates Available" filter as shown in the example below. |
![DotPoint2Blue.png](/mediaWiki/images/8/8c/DotPoint2Blue.png) |
legacy content - the assets are older than the minimum supported build number (currently 3.5) for uploading to the DLS but are required as dependencies of other installed assets. Legacy assets usually will not meet the latest content standards and as a result can be labelled as "faulty". Content Manager will not normally display legacy assets to prevent users from downloading faulty content but you can force it to display and download legacy assets by searching for them using their <kuid> codes. If downloaded and installed they will be given the status label Third Party. |
![DotPoint3Blue.png](/mediaWiki/images/6/61/DotPoint3Blue.png) |
copyright - the assets were removed because of a "terms of use" violation by their creator and will not be available on the DLS to anyone who had not already downloaded and installed them before they were removed. If you had downloaded them before their removal then they will appear as Third Party in your Content Manager. |
|
WARNING: |
![Stop.PNG](/mediaWiki/images/4/43/Stop.PNG) |
If you include a Third Party asset in a route (or other asset) that you upload then anyone who installs your route will see it labelled as having Missing dependencies and the asset itself will be labelled as an <unknown asset>. |
![Stop.PNG](/mediaWiki/images/4/43/Stop.PNG) |
Third Party assets cannot be used in Multiplayer Driver or Multiplayer Surveyor. |
|
Sometimes a Third Party asset will be updated by a new version that is available on the DLS. Installing the update will add Obsolete to the status of the original Third Party asset and the new version will have the status Installed from DLS. |
Disabled
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
You may occasionally see the following label on installed assets:-
|
Disabled
The asset has been manually Disabled (from the Content menu select Disable or Hide depending on your version of Trainz). The label will be added to an existing label on the asset (e.g. Packaged, Disabled) and the words will be "grey" not black. |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Disabling assets will "hide" them from other assets, including Routes and Sessions, so they cannot be used. It is a useful technique for deleting troublesome assets from a Route or Session without actually deleting the assets themselves. For an example of this see the Trainz Wiki Page at Deleting Stubborn Scenery Assets. |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Normally you would restore (Enable) the Disabled assets after removing them from the Route or Session. |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Payware assets that are Disabled will have Payware (not active) as their status label. |
Unknown, Incompatible, Not Installed/Not Active
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
![Top](/mediaWiki/images/3/3b/BackToTop.png) |
![Next Up](/mediaWiki/images/a/a7/NextUp.png) |
![Next Down](/mediaWiki/images/4/41/NextDown.png) |
![Bottom](/mediaWiki/images/4/47/BackToBottom.png) |
Set the Content Manager search filter to All Content and click the Status column heading (once or twice) to sort the very long list according to their Status labels. Scroll down the list and you may see the following Status labels:- |
Unknown Location
|
Unknown location
The asset is listed but it is unavailable on the DLS. It may be part of a DLC package |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
If the Status label Obsolete appears with Unknown location then a later version of that missing asset is already installed in Content Manager |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
The Unknown location label can appear if:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
a later version of an asset has been uploaded to the DLS but the original version was not uploaded or had been removed for some reason |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the later version of the asset is part of a DLC package but is not on the DLS |
|
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
Sometimes the Unknown Location status label can appear on assets that were not unknown before a Trainz update. In this case the issue can sometimes be resolved by perfoming one ot more of the following actions:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
a DBR (Database Repair) - See the Wiki Page How to Perform Database Repairs for the details |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
an EDBR (Extended Database Repair) - See the Wiki Page How to Perform Database Repairs for the details. Note: An EDBR should be used with caution |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
reverting the Unknown Location assets - select all the assets, Right Click on one of them and select the option Revert to Original |
|
|
Incompatible
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
|
Incompatible
The asset is designed for a more recent version of Trainz than you are currently using. |
For example: The SP4 versions of TRS19 and Trainz Plus will load Routes and Sessions with asset build numbers up to and including 4.9. Routes and Session with build numbers 5.0 and above will be labelled Incompatible and will need a later Trainz version (for example TRS19 SP5 for build 5.0 or TRS22/Trainz Plus for build 5.1) to be loaded.
![Build incompatible example](/mediaWiki/images/c/cb/StatusIncompatibleExample.png)
The Build Version column will identify the minimum Trainz build that the asset needs. A list of all the Trainz Build Version Numbers with their corresponding Trainz Version Names and service pack (SP) numbers can be found on the Trainz Wiki Page at "Trainz-build"_number |
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
The build Trainz version of an asset can be shown in Content Manager
Steps: To display the Build Version column in Content Manager:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Right Click on any column heading where the new column will be inserted |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
select the option Insert Column and then |
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
select the option Build Version |
|
|
|
Not Installed/Not Active
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
|
Not installed, Payware (not active)
The asset is in a DLC package and must be installed using the Content Store option from the Trainz Launcher |
Unknown Asset
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
An <unknown asset> can appear when using the List Asset Versions or the List Dependencies options on a selected asset. |
The label "<unknown asset>" will be shown in the Name column and the Status column will be blank.
|
unknown asset
The asset cannot be found on your system or on the DLS. |
Apart from the example above, unknown assets are almost always dependencies of other assets that you have downloaded and installed. The installed assets would be labelled has having Missing dependencies. See the Missing Dependencies section below. |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Note:
Having an <unknown asset> is not necessarily a problem. If an installed asset with an unknown asset as a dependency is not classified as Faulty then it can often be ignored. A Route, for example, can be labelled as having unknown assets but still function perfectly well.
|
|
The unknown asset may:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
be from an independent (3rd party) web site |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
have been made by the same creator as the dependant asset but was not uploaded to the DLS |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
have been removed from the DLS for some reason (a rare event but it does happen) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
simply not exist, anywhere |
Fixing this may not be easy. Possible solutions are:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
There is a very long thread in the Trainz Forum where you can find posts looking for missing/unknown assets. See Missing kuids? Post them here |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
You can try contacting the creator via email (their address may be in the config.txt file) or a PM (Personal Message) through the Forum |
Neither is a guaranteed solution. |
If the unknown asset is in a Route or a Session then a third option is to select Delete Missing Assets from the Tools menu in Surveyor, but make a backup copy of the Route or Session first. |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Packaged assets are installed from DLC packages and may also be available on the DLS or elsewhere |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Payware assets are exclusive to DLC packages or other payware sites (see Notes: below) |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
DLC packages can only be installed, updated and uninstalled using the Content Store from the Trainz Launcher |
All new DLC packages downloaded and installed from the Content Store now contain ALL the required dependencies in the download package. This includes any assets that are on the DLS or on independent web sites that in the past would have to be downloaded separately from the DLS or elsewhere. This means that all the assets are now in a single package that will be downloaded at the maximum possible speed your internet connection will allow even if you do not have an FCT (First Class Ticket). Older DLC packages are currently being converted to this system.
|
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes: Packaged and Payware for Trainz Versions Before TRS19 SP5
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
In DLC created before TRS19 SP5 the automated process that created the package (TCCP) would classify any assets included in the package it was building as Payware if it could not locate them on the DLS. These assets may have been freeware on third party sites or the specific version included in the package was not on the DLS. |
|
|
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes: Packaged and Payware for Trainz Version TRS19 SP5 and Later (including Trainz Plus and TRS22)
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
DLC created for TRS19 SP5 and later is packaged by a different automated process (TCCP2.0) that only labels included assets as Payware if the package creator has identified them as payware. It is up to the content creator to decide what is payware and what is not payware. |
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
If a creator has included an asset in the DLC that is not payware and is not on the DLS then it will be labelled as Packaged, along with all those assets that are on the DLS. If you include that asset in a route that you upload to the DLS (or elsewhere) then users who download the route will have the asset labelled as Unknown. They will have to locate it themselves, as is the case with Unknown assets in DLS downloads. |
![RedDot10x10.png](/mediaWiki/images/1/11/RedDot10x10.png) |
If you include Packaged assets in an upload to the DLS it is important to check that they are actually on the DLS in the correct version used in your upload.
See How to Check the DLS Status of Packaged Assets below for instructions on how to check if a Packaged asset is also on the DLS. |
|
|
Installing Packaged and Payware Assets
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Packaged and Payware assets can only be installed by installing a DLC package using the Content Store from the Trainz Launcher |
Steps: To Install a purchased DLC package:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
From the Trainz Launcher select the Content Store option |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Left Click the Purchased icon on the top right of the Content Store window. This will show all the DLC packages that you have installed or are available for you to install
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the packages that have already been installed will be shown with an Uninstall button |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the packages that you have purchased, or your membership level allows you to install, but have not yet been installed will be shown with an Install button |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
The Store button will list ALL the DLC packages including those that you have not yet purchased. Packages that can be purchased will have a Price button, in $US currency |
|
|
![StoreButtons.png](/mediaWiki/images/4/4d/StoreButtons.png) |
|
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
Scroll down tle list, and/or enter a search filter, to locate the package to be installed (it MUST have an Install button) |
![DotPoint4.JPG](/mediaWiki/images/8/87/DotPoint4.JPG) |
Left Click on the Install button |
The DLC package and all its assets will be installed into your copy of Trainz. You can remove an installed package and re-install it again at any time |
|
Deleting Packaged and Payware Assets
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Packaged and Payware assets can only be deleted by Uninstalling the DLC package that installed them |
Steps: To Uninstall a DLC package:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
From the Trainz Launcher select the Content Store option |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Left Click the Purchased icon on the top right of the Content Store window. This will show all the DLC packages that you have purchased and those that your membership allows you to install
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the packages that have already been installed will be shown with an Uninstall button |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the packages that you have purchased, or are entitled to use, but have not yet been installed will be shown with an Install button |
|
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
Scroll down tle list, and/or enter a search filter, to locate the package to be removed |
![DotPoint4.JPG](/mediaWiki/images/8/87/DotPoint4.JPG) |
Left Click on the Uninstall button |
The DLC package and all its assets will be removed from your copy of Trainz. You can re-install a removed package at a later time without any additional cost |
|
Packaged and Payware Status Labels
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
Some of the Status labels that can appear on Packaged and Payware assets are:-
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Newer version available means that a later version of that asset is also available and can be downloaded and installed |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
The Status label Obsolete means that a later version of that asset is already installed in Content Manager |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
An asset that was originally Packaged or Payware can be changed to Installed from DLS if an update is installed from the DLS. It is possible for a Payware asset to be replaced by an updated "Freeware" version, |
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
If a Payware asset has the label Newer version available and no update can be found on the DLS, then open the Content Store (from the Trainz Launcher) and select the Updates option to check for any updates to the installed DLC packages |
|
Steps: To check the DLS Status of Packaged Assets:- |
|
|
Updating Packaged and Payware Assets
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Packaged and Payware assets can be made obsolete by a newer version of the same asset appearing on the DLS |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
these updates can be downloaded and installed from the DLS |
If the asset Transformer 1 is selected and its different versions are shown ( Right Click on the asset and select the List Asset Versions option) then the following is displayed in Content Manager:-
![Packaged06.png](/mediaWiki/images/7/74/Packaged06.png) |
The asset shown at the top of the list <kuid2:60238:27118:2> Transformer 1 is the latest version available and if this is selected and downloaded then the result, as displayed in Content Manager, is shown below:-
![Packaged07.png](/mediaWiki/images/5/58/Packaged07.png) |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
the original installed Packaged version is now labelled Packaged, Obsolete and has been replaced by the newer version labelled Installed from DLS |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
note the difference in the file sizes of the two installed versions. This could be due to changes made to the asset but it is also due to the lower compression used on DLS assets compared to Packaged assets |
|
|
|
The following situation can also occur with Packaged and Payware assets.
![Packaged05a.png](/mediaWiki/images/3/3f/Packaged05a.png) |
![NotePad.PNG](/mediaWiki/images/0/04/NotePad.PNG) |
Notes:
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Assets that are labelled as Payware, Newer version available are normally updated by opening the Content Store from the Trainz Launcher and then running the Updates option. Sometimes an update to a Payware asset is released as Freeware on the DLS. In this case Right Click on the asset and select the option Download to download and install the update. If nothing is downloaded then the update is not on the DLS so try the Content Store
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Some assets that are labelled as Packaged, Newer version available such as Villa blue shown left, but if they are highlighted and the option Download is selected then nothing will be downloaded and installed. The update is most likely in a DLC package
|
|
|
|
If the asset Villa blue is selected and its different versions are shown ( Right Click on the asset and select the List Asset Versions option) then the following is displayed in Content Manager:-
![Packaged06a.png](/mediaWiki/images/0/00/Packaged06a.png) |
The list shows an updated version, <kuid2:75607:25008:1>, of the asset with its status listed as Unknown location. It is possible that the update to this asset is found only in a DLC package or it was referenced in a DLC package by its creator but the update was never uploaded |
|
Modifying and Sharing Payware
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Some DLC assets cannot be modified |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Most DLC routes (and sessions) can be modified but the original must always be present and active on your system |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Modified DLC routes can be uploaded and used by those who also have the original present and active on their system |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
DLC routes, including modified ones, cannot be merged |
It is possible to modify a DLC (payware) route or session and upload it to the DLS provided the creator of the route allows this to happen. There are some conditions that apply:- |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Some DLC assets are encrypted and cannot be cloned or modified |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Your modified route or session will be saved as an alias of the original and, provided the original remains on your system (i.e. it is not deleted or disabled), then your modified copy will work |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
You can upload a modified DLC route or session to the DLS (again, if the creator allows this) for others to download and use but they must also have the original unmodified route (and session) installed on their system |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
It is NOT possible to merge a DLC route, or a cloned DLC route, with another route (payware or freeware) as this will remove the payware protection from the route |
These restrictions are to protect the rights and intellectual property of the payware creators.
![Stop.PNG](/mediaWiki/images/4/43/Stop.PNG) |
WARNING:
If you uninstall or disable the original payware asset then your cloned or modified copy will no longer work. The original DLC payware asset must be present and active in Content Manager for your copy to work.
|
|
![Question.PNG](/mediaWiki/images/thumb/a/ae/Question.PNG/30px-Question.PNG) |
What happens to my modifications if the creator of the original payware route issues a new update?
If the update is issued by the normal method, as an increase in the build number (the trailing :digit> at the end of a kuid2 number) then your modifications should not be affected.
If, however, the content creator has released the update with a completely new <kuid> number then your modifications will most likely not work.
|
|
Using Packaged Assets in Routes Uploaded to the DLS
|
![Skip Down](/mediaWiki/images/b/b9/SkipDown.png) |
![Skip Up](/mediaWiki/images/2/2e/SkipUp.png) |
|
|
|
|
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
Packaged assets can be used in routes and sessions that you upload to the DLS provided the asset is also on the DLS or is already installed as Packaged by users who have downloaded your route or session |
An asset will be labelled as Packaged if it part of a DLC package that you have installed. It may also be on the DLS or a 3rd party web site. The same asset can be in both a DLC package and on the DLS and its status will be labelled according to how it was installed. |
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
The most important first step is to confirm that the Packaged asset you have added to your route is also available on the DLS.
See How to Check the DLS Status of Packaged Assets above.
A Packaged asset that is NOT on the DLS will appear as an <unknown asset> or as Not installed, Payware (not active) if your route is downloaded and installed by other users. |
|
For example:-
![Packaged asset](/mediaWiki/images/d/da/StatusNZHouse.png) |
You have installed a DLC package that contains an asset NZ House 1-4 as shown. Even if you had this exact same asset from the DLS before you installed the DLC package, it will now be labelled as Packaged in your Content Manager. |
If, after confirming that this asset is on the DLS (see How to Check the DLS Status of Packaged Assets above), you then use this asset in a route that you have uploaded to the DLS. Anyone who downloads and installs your DLS route, and who does not already have the asset or the same DLC package installed, will have NZ House 1-4 downloaded and installed from the DLS by their Content Manager as normally happens with all DLS dependencies during the asset installation process.
When they look at the asset in Content Manager they will see:-
![DLS asset](/mediaWiki/images/5/5d/StatusNZHouseDLS.png)
If they later install the same DLC package, or another that contains the same asset, its status will change to Packaged. |
|
|
Using Different Versions of the Same Asset
Complications can occur if a Packaged asset has been updated to a newer version but the DLS version has not been updated to the same version. That is usually a decision made by the content creator. |
![Stop.PNG](/mediaWiki/images/4/43/Stop.PNG) |
WARNING:
If an updated Packaged asset is a dependency of a route you have uploaded to the DLS then anyone who downloads and installs the route and does not already have the updated asset, either Packaged or Installed from the DLS, will see the route labelled as having "missing dependencies" and the asset itself labelled as an <unknown asset>.
This makes it very important that you check that every Packaged asset in your upload is also available in the same version on the DLS. |
|
This label can appear on any asset that:- |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
you have incorrectly modified so that it now has an error |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
has been installed from the DLS or elsewhere but contains errors |
|
Faulty
The asset has an error or errors that will prevemt it from either loading into Trainz or working correctly if it does load |
The causes of this can be many. A few common examples:-
![Ablue.png](/mediaWiki/images/0/06/Ablue.png) |
Compliance Failure: |
When an asset is installed into Content Manager from the DLS, or imported from a .cdp file or a folder, it will be put through a series of "compliance tests" which will check that it meets the minimum standards set for the version of Trainz for which it was created. These test will vary between versions of Trainz but, in general, will be tougher for the later version than they are for the earlier versions.
The standards that asset creators are required to meet have increased significantly over the years with the result that many assets that were allowed in the earliest versions of Trainz can be labelled as Faulty in the more recent versions. This is the main reason why assets built for Trainz versions before TS12 will no longer be accepted for uploading to the DLS - the majority of those earlier assets do not meet the quality and performance standards expected today. |
![Bblue.png](/mediaWiki/images/5/5f/Bblue.png) |
Missing Components: |
A common issue here is missing images or other required files (for example: a thumbnail image is now compulsory in all assets). The image below illustrates this. The config.txt file refers to an image (driver1.jpg) that is missing from the asset.
![StatusMissingImage.png](/mediaWiki/images/6/66/StatusMissingImage.png) |
![Cblue.png](/mediaWiki/images/7/79/Cblue.png) |
Faulty Tags: |
Tags are found in the assets config.txt file and control how an asset appears and what it does. Some common examples of faulty tags are:-
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
a tag or its data has not been correctly formatted (spelling and syntax errors were common problems in the early days) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
data, files or tags are missing when they are required to be present (as shown in the error message above) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
tags are in the wrong "container" (another type of tag) |
It may be possible to fix some of these errors if you understand the structure and rules of the config.txt file and, more importantly, you know what you are doing |
|
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Faulty assets that are Built-in, Packaged or Payware can often be repaired by Reverting them to their original versions.
Steps: To "repair" faulty Built-in, Packaged or Payware assets:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
In Content Manager select (hightlight) the faulty assets |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
Right Click on any one of the highlighted assets |
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
select the option Revert to Original from the pop-up menu |
This method usually works because the original assets are stored separately from the Content Manager Database. The Revert command fetches those original files and installs them in the database replacing the faulty copies. |
|
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Performing a DBR (DataBase Repair) can sometimes fix other faulty assets. See the Wiki Page How to Perform Database Repairs for the details |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
Unfortunately there are many faults that can only be repaired by the person who created the asset |
|
The first step in repairing a faulty asset, if it is possible, is to identify the cause of the fault
Missing Dependencies can occur when an asset:- |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
has been installed from a .cdp file (e.g. from a 3rd party site) without also installing other assets it requires |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
has had assets that are dependencies deleted or disabled |
![BlueDot10x10.png](/mediaWiki/images/8/8a/BlueDot10x10.png) |
has been downloaded from the DLS but contains dependency assets that are not on the DLS or built-in |
This is a label to be avoided if possible.
|
Missing dependencies
The asset relies on the presence of other assets (dependencies) that must be installed on your system and at least one of those assets has not been installed or has been disabled. |
This situation shown in the example above can occur if you have:-
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
deleted the asset without realising that it is needed in other assets, such as a Route or a Session, OR |
![DotPoint.JPG](/mediaWiki/images/thumb/8/81/DotPoint.JPG/10px-DotPoint.JPG) |
used the Import option to install the asset from a .cdp file or a content folder - Content Manager will not search for and install missing dependencies when you import an asset. |
If you have imported an asset from a .cdp or content folder and see the Missing dependencies label then:-
Steps: To find and install assets missing after an import:- |
![DotPoint1.JPG](/mediaWiki/images/c/c5/DotPoint1.JPG) |
Right Click on the asset or assets with the missing dependencies and select List Dependencies |
![DotPoint2.JPG](/mediaWiki/images/6/6d/DotPoint2.JPG) |
select all assets marked as Available for Download |
![DotPoint3.JPG](/mediaWiki/images/5/55/DotPoint3.JPG) |
Right Click on any one of them and select Download |
|
![PencilTips.PNG](/mediaWiki/images/0/0e/PencilTips.PNG) |
To avoid accidentally deleting an asset that other assets are depending on:-
|
|
Trainz Wiki
![TrainzWiki.png](/mediaWiki/images/7/71/TrainzWiki.png) |
More Tutorials and Guides to Using Trainz
|
|
![LinkWiki.PNG](/mediaWiki/images/5/5f/LinkWiki.PNG) |
Related Links
|
|
This page was created by Trainz user pware in January 2022 and was last updated as shown below.