Understand Content Manager Status Labels

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (Packaged and Payware)
m (Packaged and Payware)
(40 intermediate revisions by one user not shown)
Line 142: Line 142:
  
 
='''Available for Download'''=
 
='''Available for Download'''=
<table bgcolor=#ffffe0 width=1000>
+
<table cellpadding=4 bgcolor=#c1e7e7>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:PencilTips.PNG|link=]]</td>
+
<td>[[image:DotPoint.JPG|link=]]</td>
<td>This modified search filter will show all the freeware assets including their different versions that are available on the '''Download Station (DLS)'''.<br>
+
<td>'''Available for Download''' simply means that the asset is on the '''DLS''' and is not already installed on your system</td>
<br>
+
<table bgcolor=#000000>
+
<tr valign="top">
+
<td>
+
<table bgcolor=#ffffff>
+
<tr valign="top">
+
<td>
+
#Select the '''Content Manager''' search filter '''Download Station'''
+
#Open the filter (click the small triangle pointer on the left of the word '''Filter:''')
+
#Remove (click the '''(-)''' buttons on the extreme right) of the filter lines:-
+
:*'''Out of date''' and
+
:*'''Obsolete'''
+
You can save this as a new filter
+
#Click the '''Save''' button (which will appear as soon as you delete one of the filter lines)
+
#Give the new filter a name (e.g. '''Available for Download''')
+
Once saved you can reuse the filter whenever needed.
+
</td>
+
<td>[[image:StatusCreateSaveFilter.png|link=|alt=Create and save a new filter]]</td>
+
 
</tr>
 
</tr>
 
</table>
 
</table>
</td>
+
<br>
</tr>
+
The '''Status''' labels that you may see would include:-<br>
</table>
+
</td>
+
</tr>
+
</table>
+
 
+
The filtered list created above will show all the assets except '''Payware''' that are available on the '''DLS'''. The '''Status''' labels that you may see would be:-<br>
+
  
 
<table>
 
<table>
Line 194: Line 170:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>The '''Status label "Newer version available"''' means that a later version of that asset can be downloaded and installed</td>
+
<td>The '''Status label "Newer version available"''' means that a later version of that asset is also available and can be downloaded and installed</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>The '''Status label "Obsolete"''' means that a later version of that asset is already installed in '''Content Manager'''</td>
 
<td>The '''Status label "Obsolete"''' means that a later version of that asset is already installed in '''Content Manager'''</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>You can select and download any asset that is '''Available for download''' even if it is also labelled as '''Obsolete''' or '''Newer version available'''</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 205: Line 185:
 
</table>
 
</table>
  
<table bgcolor=#e8e8e8>
+
<table bgcolor=#e8e8e8 width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Available&nbsp;for&nbsp;download'''</td>
 
<td>'''Available&nbsp;for&nbsp;download'''</td>
Line 223: Line 203:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:PencilTips.PNG|link=]]</td>
 
<td>[[image:PencilTips.PNG|link=]]</td>
<td>You can also 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.</td>
+
<td>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.</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 260: Line 240:
 
<td>&nbsp;</td>
 
<td>&nbsp;</td>
 
<td>
 
<td>
In this case 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 the latest version is not installed in '''Content Manager''' then it will be shown as '''Available for download'''.
+
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.
 +
</td>
 +
</tr>
 +
</table>
 +
=='''Create an "Available for Download" Filter'''==
 +
<table bgcolor=#ffffe0 width=1000>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>This modified search filter will show all the freeware assets including their different versions that are available on the '''Download Station (DLS)'''.<br>
 +
<table bgcolor=#000000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff>
 +
<tr valign="top">
 +
<td>
 +
#Select the '''Content Manager''' search filter '''Download Station'''
 +
#Open the filter (click the small triangle pointer on the left of the word '''Filter:''')
 +
#Remove (click the '''(-)''' buttons on the extreme right) of the filter lines:-
 +
:*'''Out of date''' and
 +
:*'''Obsolete'''
 +
You can save this as a new filter
 +
#Click the '''Save''' button (which will appear as soon as you delete one of the filter lines)
 +
#Give the new filter a name (e.g. '''Available for Download''')
 +
Once saved you can reuse the filter whenever needed.
 +
</td>
 +
<td>[[image:StatusCreateSaveFilter.png|link=|alt=Create and save a new filter]]</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
=='''Create an "Updates Filter"'''==
+
=='''Create an "Updates Available" Filter'''==
 
+
 
<table bgcolor=#ffffe0 width=1000>
 
<table bgcolor=#ffffe0 width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:PencilTips.PNG|link=]]</td>
 
<td>[[image:PencilTips.PNG|link=]]</td>
<td>A very useful '''Content Manager''' filter to create and save is one that will identify and display any installed assets that have updates available on the '''DLS'''. Detailed step-by-step instructions for making the filter (it is a simple process) can be found on the Wiki Page
+
<td>A very useful '''Content Manager''' filter to create and save is one that will identify and display any installed assets that have updates available on the '''DLS'''. Detailed step-by-step instructions for making the filter (it is a simple process) can be found on the Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;'''[[Using_Content_Manager_to_Update_Assets#Set_Up_An_Update_Filter|Using Content Manager to Update Assets]]''' but a summary is provided below.<br>
:[[image:WikiLink.PNG|link=]] '''[[Using_Content_Manager_to_Update_Assets#Set_Up_An_Update_Filter|Using Content Manager to Update Assets]]''' but a summary is provided below.<br>
+
 
<br>
+
 
<table width=904 bgcolor=#000000>
 
<table width=904 bgcolor=#000000>
 
<tr valign="top">
 
<tr valign="top">
Line 281: Line 289:
 
Create a '''Custom''' filter as shown in the figure below:-<br>
 
Create a '''Custom''' filter as shown in the figure below:-<br>
 
[[image:Update_Filter05.png|link=]]<br>
 
[[image:Update_Filter05.png|link=]]<br>
*Set the '''Installed''' filter line to '''True''' (it normally is)
+
#Set the '''Installed''' filter line to '''True''' (it normally is)
*Change one of the remaining filter lines to '''Out of date''' and set it to '''True'''
+
#Change one of the remaining filter lines to '''Out of date''' and set it to '''True'''
*Delete all remaining filter lines
+
#Delete all remaining filter lines
*Save the filter - "Updates Available" would be a good filter name
+
#Save the filter - "Updates Available" would be a good filter name
 
You can then highlight, '''right mouse click''' and select '''Download''' to get the updates for the selected assets.<br>
 
You can then highlight, '''right mouse click''' and select '''Download''' to get the updates for the selected assets.<br>
  
 
'''Note:''' This will show but not update assets that are '''Built-in''' or '''Base'''.  
 
'''Note:''' This will show but not update assets that are '''Built-in''' or '''Base'''.  
:See the Wiki Page [[image:WikiLink.PNG|link=]] '''[[Using_Content_Manager_to_Update_Assets|Using Content Manager to Update Assets]]''' for instructions on updating those assets.</td>
+
:See the '''Tip Box''' in the section '''Installing the Latest or an Older Version of an Asset''' below for a guide on updating these assets or the Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;'''[[Using_Content_Manager_to_Update_Assets|Using Content Manager to Update Assets]]''' for more detailed instructions.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 319: Line 327:
 
#Select any version of the asset, it does not matter if it is labelled '''Obsolete'''
 
#Select any version of the asset, it does not matter if it is labelled '''Obsolete'''
 
#'''Right mouse click''' on the asset and select '''Download'''
 
#'''Right mouse click''' on the asset and select '''Download'''
'''Content Manager''' will skip over any older but not yet installed versions and will download and install only the latest available version even if that version is not shown in your filtered list.</td>
+
'''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.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 346: Line 354:
 
#'''Right mouse click''' on the asset and select '''Download this Version'''
 
#'''Right mouse click''' on the asset and select '''Download this Version'''
 
'''Content Manager''' will ignore any and all newer versions of the asset and will download and install only the selected version.</td>
 
'''Content Manager''' will ignore any and all newer versions of the asset and will download and install only the selected version.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0 width=996 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>
 +
<table>
 +
<tr valign="top">
 +
<td width=720>Some assets will show a status of '''Newer version available''' or '''Obsolete''' but the '''Download''' and '''Download this Version''' options will be greyed out and cannot be selected. This will always occur for all '''Built-in''' and '''Base''' assets and will usually occur for '''Packaged''' and '''Payware''' assets.</td>
 +
<td width=240>[[image:Download_Greyed_Out.png|link=]]</td>
 +
</tr>
 +
</table>
 +
<table>
 +
<tr valign="top">
 +
<td width=240>[[image:List_Asset_Versions.png|link=]]</td>
 +
<td width=720>In these cases select the '''List Asset Versions''' option. This will list all the available versions of the selected asset or assets and allow you to select one that can be downloaded ('''Available for download''').</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan=2>'''Packaged''' and '''Payware''' assets are normally updated through the '''Update''' option in the '''Content Store''' but can sometimes be updated through '''Content Manager''' to become freeware ('''Installed from DLS'''). If the asset is '''Packaged''' or '''Payware''' and still does not show an available download, then check the '''Content Store''' for updates.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 385: Line 423:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>The '''Status "Newer version available"''' added to a label means that a later version of that asset can be downloaded and installed</td>
+
<td>The '''Status "Newer version available"''' added to a label means that a later version of that asset is also available and can be downloaded and installed</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 413: Line 451:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Packaged'''</td>
 
<td>'''Packaged'''</td>
<td>The asset is included in a '''DLC''' package that you have installed. See the [[image:PageLink.PNG|link=]] '''[[#Packaged and Payware|Packaged and Payware]]''' section below</td>
+
<td>The asset is included in a '''DLC''' package that you have installed. If the label '''Payware''' is NOT present then it is also available on the '''DLS'''. See the [[image:PageLink.PNG|link=]]&nbsp;'''[[#Packaged and Payware|Packaged and Payware]]''' section below</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 442: Line 480:
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>You '''cannot delete''' assets that are labelled as '''Built-in, Obsolete''' or '''Base, Obsolete'''
 
<td>You '''cannot delete''' assets that are labelled as '''Built-in, Obsolete''' or '''Base, Obsolete'''
 +
</td>
 +
</tr>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>You '''can ONLY delete''' assets that are labelled as '''Packaged''' using '''Uninstall''' in the '''Content Store''', not from '''Content Manager'''. But before you uninstall any assets see the <span style="font-weight: 700;"><span style="color: white; background-color: red;">&nbsp;Warning&nbsp;</span> [[image:PageLink.PNG|link=]]&nbsp;[[#DLCWarning|Uninstalling DLC]]</span> below.
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 522: Line 565:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:PencilTips.PNG|link=]]</td>
 
<td>[[image:PencilTips.PNG|link=]]</td>
<td>Running the '''Updates Available''' filter (see the [[image:PageLink.PNG|link=]] '''[[#Create an "Updates Filter"|Create an "Updates Filter"]]''' section above) will identify any '''Third Party''' assets that have updates available as shown in the figure below:-
+
<td>Running the '''Updates Available''' filter (see the [[image:PageLink.PNG|link=]]&nbsp;'''[[#Create an "Updates Available" Filter|Create an "Updates Available" Filter]]''' section above) will identify any '''Third Party''' assets that have updates available as shown in the figure below:-
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
Line 564: Line 607:
  
 
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.<br>
 
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.<br>
:For an example of this see the Trainz Wiki Page at [[image:WikiLink.PNG|link=]] '''[[How_to_Use_Bulk_Asset_Update/Replace_Tool#Option_3:_Delete_Scenery_Objects|Deleting Stubborn Scenery Assets]]'''.<br>
+
:For an example of this see the Trainz Wiki Page at [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Use_Bulk_Asset_Update/Replace_Tool#Option_3:_Delete_Scenery_Objects|Deleting Stubborn Scenery Assets]]'''.<br>
 
Normally you would restore the '''Disabled''' assets after fixing the Route or Session (from the '''Content''' menu select '''Enable''').<br>
 
Normally you would restore the '''Disabled''' assets after fixing the Route or Session (from the '''Content''' menu select '''Enable''').<br>
  
Line 609: Line 652:
 
#'''right mouse click''' on an open asset
 
#'''right mouse click''' on an open asset
 
:*select the '''Submit Edits''' command to close them with the edits saved, or
 
:*select the '''Submit Edits''' command to close them with the edits saved, or
:*select '''Revert to Original''' to cancel the edits and return the assets to their previous unedited states
+
:*select '''Revert to Original''' to cancel the edits and return the assets to their previous unedited states, or
 +
:*select '''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'''
 
</td>
 
</td>
 
<td>[[image:SubmitEditOptions.png|link=|alt=Submit edits]]</td>
 
<td>[[image:SubmitEditOptions.png|link=|alt=Submit edits]]</td>
Line 633: Line 677:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>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 [[image:PageLink.PNG|link=]] '''[[#Missing Dependencies|Missing Dependencies]]''' section below</td>
+
<td>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 [[image:PageLink.PNG|link=]]&nbsp;'''[[#Missing Dependencies|Missing Dependencies]]''' section below</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 639: Line 683:
 
<td>If '''Trainz''' unexpectedly closes while using '''Surveyor''' or '''Driver''', such as a '''C'''rash '''T'''o '''D'''esktop or it is terminated by '''Windows Task Manager''', then the loaded Route and Session will be '''Open for edit''' when you restart '''Trainz'''.<br>
 
<td>If '''Trainz''' unexpectedly closes while using '''Surveyor''' or '''Driver''', such as a '''C'''rash '''T'''o '''D'''esktop or it is terminated by '''Windows Task Manager''', then the loaded Route and Session will be '''Open for edit''' when you restart '''Trainz'''.<br>
  
:See the Trainz Wiki Page [[image:WikiLink.PNG|link=]] '''[[Route_and_Session_Basics#Loading_After_an_Unexpected_Shutdown|Route and Session Basics]]''' for more information on dealing with this situation
+
:See the Trainz Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;'''[[Route_and_Session_Basics#Loading_After_an_Unexpected_Shutdown|Route and Session Basics]]''' for more information on dealing with this situation
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 747: Line 791:
 
[[image:StatusAddBuildColumn.png|link=|alt=insert Build column]]<br>
 
[[image:StatusAddBuildColumn.png|link=|alt=insert Build column]]<br>
  
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<br>
+
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 [[file:WikiLink.PNG|link=]]&nbsp;'''[["Trainz-build"_number]]'''
:[[file:WikiLink.PNG|link=]]&nbsp;'''[["Trainz-build"_number]]'''
+
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 775: Line 818:
 
</tr>
 
</tr>
 
</table>
 
</table>
 
+
This status label can appear if you uninstall a '''DLC''' package (e.g. a Route) that you have modified or cloned as a new asset. Most '''Payware''' assets can be modified but conditions apply. See the section [[image:PageLink.PNG|link=]]&nbsp;'''[[#Modifying and Sharing Payware|Modifying and Sharing Payware]]''' below.
 +
<br>
 
==='''Unknown Asset'''===
 
==='''Unknown Asset'''===
 
An '''<unknown asset>''' can appear when using the '''List Asset Versions''' or the '''List Dependencies''' commands on a selected asset.<br>
 
An '''<unknown asset>''' can appear when using the '''List Asset Versions''' or the '''List Dependencies''' commands on a selected asset.<br>
Line 831: Line 875:
 
</table>
 
</table>
  
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 <span style="color: red; font-weight: 700;">Missing dependencies</span>. See the [[image:PageLink.PNG|link=]] '''[[#Missing Dependencies|Missing Dependencies]]''' section below.<br>
+
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 <span style="color: red; font-weight: 700;">Missing dependencies</span>. See the [[image:PageLink.PNG|link=]]&nbsp;'''[[#Missing Dependencies|Missing Dependencies]]''' section below.<br>
  
 
<table bgcolor=#000000 width=1000>
 
<table bgcolor=#000000 width=1000>
Line 856: Line 900:
 
* simply not exist, anywhere
 
* simply not exist, anywhere
 
Fixing this may not be easy. Possible solutions are:-
 
Fixing this may not be easy. Possible solutions are:-
*There is a very long thread in the '''Trainz Forum''' where you can find posts looking for missing/unknown assets. See [[file:WikiLink.PNG|link=]] '''[https://forums.auran.com/trainz/showthread.php?111942 Missing kuids? Post them here]'''
+
*There is a very long thread in the '''Trainz Forum''' where you can find posts looking for missing/unknown assets. See [[file:WikiLink.PNG|link=]]&nbsp;'''[https://forums.auran.com/trainz/showthread.php?111942 Missing kuids? Post them here]'''
 
*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'''
 
*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.<br>
 
Neither is a guaranteed solution.<br>
Line 873: Line 917:
  
 
='''Packaged and Payware'''=
 
='''Packaged and Payware'''=
<table bgcolor=#c1e7e7>
+
<table bgcolor=#c1e7e7 cellpadding=5>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
Line 900: Line 944:
 
*If you already have the exact same version of an asset that is included in a package you are installing then you will '''NOT''' end up with two identical copies of that asset. Your installed copy of the asset will be re-labelled as '''Packaged'''.
 
*If you already have the exact same version of an asset that is included in a package you are installing then you will '''NOT''' end up with two identical copies of that asset. Your installed copy of the asset will be re-labelled as '''Packaged'''.
 
*If the version included in the package is more recent than your current version then the newer version will be installed and the previous version will become '''Obsolete''' - this is the normal process for asset updates.
 
*If the version included in the package is more recent than your current version then the newer version will be installed and the previous version will become '''Obsolete''' - this is the normal process for asset updates.
Problems can arise if the asset included in a '''DLC''' package has a higher version number (the ''':digit>''' at the end of a '''kuid2 number''') than the "identical" copy on the '''DLS'''. This usually occurs when the '''DLS''' copy has not been updated to match the '''DLC''' copy. See '''How to Check the DLS Status of Packaged Assets''' below. If you encounter this problem in a '''Packaged''' asset, report it by the '''[https://n3vgames.typeform.com/to/xRdryu Bug Reporting Web Page]''' or the '''[https://support.trainzportal.com/ Trainz Help Desk]'''</td>
+
Problems can arise if the asset included in a '''DLC''' package has a higher version number (the ''':digit>''' at the end of a '''kuid2 number''') than the copy on the '''DLS'''. This usually occurs when the '''DLS''' copy has not been updated to match the '''DLC''' copy. See '''How to Check the DLS Status of Packaged Assets''' below. If you encounter this problem in a '''Packaged''' asset, report it by the '''[https://n3vgames.typeform.com/to/xRdryu Bug Reporting Web Page]''' or the '''[https://support.trainzportal.com/ Trainz Help Desk]'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<span id="DLCWarning"></span>
 +
<table bgcolor=#ff0000 width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#fcbcbc width=996 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[file:Stop.PNG|link=]]</td>
 +
<td><span style="font-size: 15px; font-weight: 700;">WARNING: Uninstalling DLC</span><br>
 +
If you '''Uninstall''' a '''DLC''' package then all its '''Packaged''' assets will be deleted, even if those same assets were previously labelled as '''Installed from DLS'''. The '''Uninstall''' process has no way of "knowing" if an asset was previously '''Installed from DLS''' or came from the package itself. This could result in other installed assets becoming faulty due to '''Missing dependencies'''.<br>
 +
 
 +
The solution is to run a '''DBR''' (Database Repair - see the Wiki Page [[image:WikiLink.PNG|link=]]&nbsp;'''[[How_to_Perform_Database_Repairs#How_to_Perform_a_Database_Repair_.28a_DBR.29#Set_Up_An_Update_Filter|How to Perform a DBR]]''' for details) after the '''Uninstall''' then install the missing assets from the '''DLS'''.
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 907: Line 970:
 
</table>
 
</table>
 
<br>
 
<br>
 +
<span id="CheckDLS"></span>
 
<table bgcolor=#000000 width=1000>
 
<table bgcolor=#000000 width=1000>
 
<tr valign="top">
 
<tr valign="top">
Line 919: Line 983:
 
<td>[[image:Packaged01.png|link=|alt=Packaged asset candidates]]</td>
 
<td>[[image:Packaged01.png|link=|alt=Packaged asset candidates]]</td>
 
<td>
 
<td>
*In the example shown left the assets are in a saved '''Picklist''' named '''Fences &amp; Walls''' but it could be the '''Installed''' filter sorted on the '''Status''' column to group all the '''Packaged''' assets together.
+
*In the example shown left the assets are in a saved '''Picklist''' named '''Fences &amp; Walls''' but it could be the '''Installed''' filter sorted on the '''Status''' column to group all the '''Packaged''' assets together or use a '''Custom''' filter with '''Packaged = True'''.
 +
[[image:PackagedFilter.png|link=|alt=Packaged Filter]]
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 932: Line 997:
 
</tr>
 
</tr>
 
</table>
 
</table>
[[image:DotPoint3Blue.png|link=]] Add the filter line '''On Download Station''' set to '''True'''<br>
+
[[image:DotPoint3Blue.png|link=]] In the new search window, add the filter line '''On Download Station''' and set it to '''True'''<br>
 
<table>
 
<table>
 
<tr valign="top">
 
<tr valign="top">
Line 960: Line 1,025:
 
Some of the '''Status labels''' that can appear on '''Packaged''' and '''Payware''' assets are:-<br>
 
Some of the '''Status labels''' that can appear on '''Packaged''' and '''Payware''' assets are:-<br>
  
<table>
+
<table width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
Line 976: Line 1,041:
 
</td>
 
</td>
 
<td>
 
<td>
<table bgcolor=#c1e7e7>
+
<table bgcolor=#c1e7e7 cellpadding=5>
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>The '''Status label "Newer version available"''' means that a later version of that asset can be downloaded and installed</td>
+
<td>The '''Status label "Newer version available"''' means that a later version of that asset is also available and can be downloaded and installed</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 987: Line 1,052:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>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, </td>
+
<td>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" ('''Available for download''') version, </td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 994: Line 1,059:
 
</table>
 
</table>
  
<table bgcolor=#e8e8e8>
+
<table width=1000>
 +
<tr valign="top">
 +
<td width=600>
 +
<table bgcolor=#e8e8e8 width=600>
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Packaged'''</td>
 
<td>'''Packaged'''</td>
Line 1,001: Line 1,069:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Payware'''</td>
 
<td>'''Payware'''</td>
<td>The asset is part of a payware package (usually from the '''DLC'''). Most '''DLC Payware''' can be modified and it is even possible to upload '''Modified, Payware''' assets to the '''DLS''' but special restrictions will apply. Exactly which assets in a package are '''Payware''' and which are '''Packaged''' is decided by the creator of the package. See '''Notes: Modifying and Sharing Payware''' below</td>
+
<td>The asset is part of a payware package, usually from the '''DLC'''. Most '''DLC Payware''' can be modified but restrictions will apply. Exactly which assets in a package are '''Payware''' and which are '''Packaged''' is decided by the creator of the package. See the section [[image:PageLink.PNG|link=]]&nbsp;'''[[#Modifying and Sharing Payware|Modifying and Sharing Payware]]''' below</td>
 
</tr>
 
</tr>
 
<tr valign="top">
 
<tr valign="top">
Line 1,013: Line 1,081:
 
<tr valign="top">
 
<tr valign="top">
 
<td>'''Modified, Payware'''</td>
 
<td>'''Modified, Payware'''</td>
<td>The asset is '''Payware''' that you have modified or cloned with certain restrictions. See '''Notes: Modifying and Sharing Payware''' below</td>
+
<td>The asset is '''Payware''' that you have modified or cloned. See the section [[image:PageLink.PNG|link=]]&nbsp;'''[[#Modifying and Sharing Payware|Modifying and Sharing Payware]]''' below</td>
 +
</tr>
 +
</table>
 +
<td width=400>
 +
<table bgcolor=#000000 width=400>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffb0 width=396>
 +
<tr valign="top">
 +
<td>[[image:NotePad.PNG|link=]]</td>
 +
<td><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br>
 +
----
 +
<table>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>You '''can ONLY delete''' assets that are labelled as '''Packaged''' or '''Payware''' using '''Uninstall''' in the '''Content Store''', not from '''Content Manager'''. But before you uninstall any assets see the <span style="font-weight: 700;"><span style="color: white; background-color: red;">&nbsp;Warning&nbsp;</span> [[image:PageLink.PNG|link=]]&nbsp;[[#DLCWarning|Uninstalling DLC]]</span> above.
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 1,051: Line 1,144:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:DotPoint.JPG|link=]]</td>
 
<td>[[image:DotPoint.JPG|link=]]</td>
<td>'''Payware''' - without the label '''Packaged''' means that the asset can be modified and cloned with restrictions
+
<td>'''Payware''' - without the label '''Packaged''' means that the asset can be modified and cloned with restrictions as shown below
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,062: Line 1,155:
 
</table>
 
</table>
 
<br>
 
<br>
<table bgcolor=#000000 width=1000>
+
=='''Modifying and Sharing Payware'''==
 +
 
 +
It is possible to modify a payware route and upload it to the '''DLS''' provided the '''creator of the route allows this to happen'''. There are some conditions that apply:-
 +
# If the status of a route is listed as '''"Packaged, Payware"''' then the route has been encrypted and cannot be modified or cloned
 +
# You can modify and save an unencrypted payware route that is installed on your system. It will be saved as an '''alias''' of the original and, provided the original payware route remains on your system (i.e. it is not deleted or disabled), then your modified copy will work
 +
# You can upload a modified payware route to the '''DLS''' (again, if the route creator allows this) for others to download and use but they must also have the original payware route installed on their system
 +
# It is '''NOT possible''' to merge a payware route with another route (payware or freeware) as this will remove the payware protection from the route
 +
<br>
 +
<table bgcolor=#ff0000 cellpadding=2 width=1000>
 
<tr valign="top">
 
<tr valign="top">
 
<td>
 
<td>
<table bgcolor=#ffffb0>
+
<table bgcolor=#fcbcbc cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
<td>[[image:NotePad.PNG|link=]]</td>
+
<td>[[file:Stop.PNG|link=]]</td>
<td><span style="font-size: 17px; font-weight: 700;">Notes: Modifying and Sharing Payware'''</span><br>
+
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br>
----
+
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.
It is possible to modify a payware route and upload it to the '''DLS''' provided the '''creator of the route allows this to happen'''. There are some conditions that apply:-
+
# If the status of a route is listed as '''"Packaged, Payware"''' then the route has been encrypted and cannot be modified or cloned
+
# You can edit and save an unencrypted payware route that is installed on your system. It will be saved as an '''alias''' of the original and, provided the original payware route remains on your system (i.e. it is not deleted or disabled), then your modified copy will work
+
# You can upload an modified payware route to the '''DLS''' (again, if the route creator allows this) for others to download and use but they must also have the original payware route installed on their system
+
# It is '''NOT possible''' to merge a payware route with another route (payware or freeware) as this will remove the payware protection from the route
+
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,088: Line 1,184:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[image:Question.PNG|link=|30px]]</td>
 
<td>[[image:Question.PNG|link=|30px]]</td>
<td><span style="font-size: 16px; font-weight: 700;">Can you use Packaged assets in a Route or Session that you will upload to the DLS?</span><br>
+
<td><span style="font-size: 16px; font-weight: 700;">What happens to my modifications if the creator of the original payware route issues a new update?</span><br>
An asset will be labelled as '''Packaged''' if it is on the '''DLS''' and is also part of a '''DLC''' package that you have installed. The same asset can be in both locations and its status will be labelled according to how it was installed.<br>
+
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.<br>
  
'''Note:''' An important first step is to confirm that the '''Packaged''' asset you have added to your route is available in the '''identical''' version on the '''DLS'''. See the section '''Tips: How to Check the DLS Status of Packaged Assets''' above.<br>
+
If, however, the content creator has released the update with a completely new '''<kuid>''' number then your modifications will most likely not work.<br>
  
 +
In either case, if your modified payware route no longer works after an update to the original payware then report the problem by the '''[https://n3vgames.typeform.com/to/xRdryu Bug Reporting Web Page]''' or the '''[https://support.trainzportal.com/ Trainz Help Desk]'''
 +
</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
 +
=='''Using Packaged Assets in Routes or Sessions Uploaded to the DLS'''==
 +
<table cellpadding=4 bgcolor=#c1e7e7>
 +
<tr valign="top">
 +
<td>[[image:DotPoint.JPG|link=]]</td>
 +
<td>'''Packaged''' assets can be used in routes and sessions that you upload to the '''DLS'''</td>
 +
</tr>
 +
</table>
 +
 +
An asset will be labelled as '''Packaged''' if it is on the '''DLS''' and is also part of a '''DLC''' package that you have installed. The same asset can be in both locations and its status will be labelled according to how it was installed. This means that you can use '''Packaged''' assets in routes and sessions that you upload to the '''DLS'''.<br>
 +
<table>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#000000 cellpadding=2 width=1000>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffe0 cellpadding=2>
 +
<tr valign="top">
 +
<td>[[image:PencilTips.PNG|link=]]</td>
 +
<td>An important first step is to confirm that the '''Packaged''' asset you have added to your route is available in the '''identical''' version on the '''DLS'''. See the [[image:PageLink.PNG|link=]]&nbsp;'''[[#CheckDLS|Tips: How to Check the DLS Status of Packaged Assets]]''' above.</td>
 +
</tr>
 +
</table>
 +
</td>
 +
</tr>
 +
</table>
 +
<br>
 +
<table bgcolor=#000000 width=1000 cellpadding=2>
 +
<tr valign="top">
 +
<td>
 +
<table bgcolor=#ffffff cellpadding=2>
 +
<tr valign="top">
 +
<td>
 
For example:-<br>
 
For example:-<br>
  
Line 1,101: Line 1,237:
 
</tr>
 
</tr>
 
</table>
 
</table>
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 Route installation process.<br>
+
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.<br>
  
 
When they look at the asset in '''Content Manager''' they will see:-<br>
 
When they look at the asset in '''Content Manager''' they will see:-<br>
Line 1,107: Line 1,243:
 
[[image:StatusNZHouseDLS.png|link=|alt=DLS asset]]<br>
 
[[image:StatusNZHouseDLS.png|link=|alt=DLS asset]]<br>
  
If they later install the same '''DLC''' package, or another that contains the same asset, its status will change to '''Packaged'''.<br>
+
If they later install the same '''DLC''' package, or another that contains the same asset, its status will change to '''Packaged'''.
 
+
</td>
So the answer to the question is '''Yes'''.
+
</tr>
 +
</table>
 
</td>
 
</td>
 
</tr>
 
</tr>
Line 1,169: Line 1,306:
 
<td colspan=2>In this case, the '''Missing dependency''' is shown as '''Available for download''' so it is on the '''DLS''' and can be installed to fix the problem. If there are several assets that are listed as '''Available for download''', select and download them all.<br>
 
<td colspan=2>In this case, the '''Missing dependency''' is shown as '''Available for download''' so it is on the '''DLS''' and can be installed to fix the problem. If there are several assets that are listed as '''Available for download''', select and download them all.<br>
  
If the '''Missing dependency''' is an '''<unknown asset>''' then it can be a much harder problem to solve. See the section [[image:PageLink.PNG|link=]] '''[[#Unknown Asset|Unknown Asset]]''' above for possible remedies.
+
If the '''Missing dependency''' is an '''<unknown asset>''' then it can be a much harder problem to solve. See the section [[image:PageLink.PNG|link=]]&nbsp;'''[[#Unknown Asset|Unknown Asset]]''' above for possible remedies.
 
</td>
 
</td>
 
</tr>
 
</tr>

Revision as of 11:26, 24 June 2022

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.

Contents

  Top   Next Down Bottom

Content Manager Status

Start Content Manager by clicking Manage Content from the Trainz Launcher.

The Status column in the Content Manager display gives information about each listed assets location, availability, and its "currency" (installed, obsolete, modified, Payware, unknown, etc).

Content Manager Display - Status
PencilTips.PNG If the Status column is not present in the Content Manager display, then:-
  • right mouse click on the column heading where you want it to be inserted
  • select Insert Column and then Status
insert Status Column
NotePad.PNG Columns in Content Manager Can Be

 Removed 

Right mouse click on a column heading and select Remove Column

 Moved 

Hold down the left mouse button on a column heading and drag it left or right

 Resized 

Move the tip of the mouse pointer onto the dividing line between two column headings, hold down the left mouse button and drag it left or right


NotePad.PNG Notes:

It is important to remember that:-

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 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.

StatusUpdatesNewNames.png

 
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 command.

StatusUpdatesNewKUIDs.png
Assets with negative <kuids> can only be updated by issuing them with new <kuid> codes but this can also happen with any asset update.

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. track, then they will appear under each other in the same selection list.


The Status labels are described in the following sections.


  Top Next Up Next Down Bottom

Available for Download

DotPoint.JPG 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:-

Available for download
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 The Status label "Obsolete" means that a later version of that asset is already installed in Content Manager
DotPoint.JPG You can select and download any asset that is Available for download even if it is also labelled as Obsolete or Newer version available
Available for download This IS the latest version available on the DLS and it (this version) is not already installed. 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 is NOT the latest version available on the DLS and this particular version is not already installed. There is an update to this version available on the DLS
Available for download, Obsolete This is NOT the latest version available on the DLS and this particular version is not already installed. You have an updated version already installed but it may not be the latest version


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.
 
  1. right mouse click on the asset
  2. select the command List Asset Versions

The list can be sorted into alphabetical/numerical order using a particular column by clicking on the column heading.

  • first click - sort ascending A to Z, 1 to 9, Jan to Dec
  • second click - sort descending Z to A, 9 to 1, Dec to Jan
  • third click - repeats first click, etc
List Asset Versions
 

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

PencilTips.PNG This modified search filter will show all the freeware assets including their different versions that are available on the Download Station (DLS).
  1. Select the Content Manager search filter Download Station
  2. Open the filter (click the small triangle pointer on the left of the word Filter:)
  3. Remove (click the (-) buttons on the extreme right) of the filter lines:-
  • Out of date and
  • Obsolete

You can save this as a new filter

  1. Click the Save button (which will appear as soon as you delete one of the filter lines)
  2. 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

Create an "Updates Available" Filter

PencilTips.PNG A very useful Content Manager filter to create and save is one that will identify and display any installed assets that have updates available on the DLS. Detailed step-by-step instructions for making the filter (it is a simple process) can be found on the Wiki Page WikiLink.PNG Using Content Manager to Update Assets but a summary is provided below.

Create a Custom filter as shown in the figure below:-
Update Filter05.png

  1. Set the Installed filter line to True (it normally is)
  2. Change one of the remaining filter lines to Out of date and set it to True
  3. Delete all remaining filter lines
  4. Save the filter - "Updates Available" would be a good filter name

You can then highlight, right mouse click and select Download to get the updates for the selected assets.

Note: This will show but not update assets that are Built-in or Base.

See the Tip Box in the section Installing the Latest or an Older Version of an Asset below for a guide on updating these assets or the Trainz Wiki Page WikiLink.PNG Using Content Manager to Update Assets for more detailed instructions.

Installing the Latest or an Older Version of an Asset

DotPoint.JPG 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
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version.
  1. Select any version of the asset, it does not matter if it is labelled Obsolete
  2. Right mouse click on the asset and select 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.


DotPoint.JPG To Install a Specific Older Version: You can download and install an earlier (older or Obsolete) version of an asset if you don't want the latest version.
Download this version
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version.
  1. Select 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
  2. Right mouse click on the asset and select Download this Version
Content Manager will ignore any and all newer versions of the asset and will download and install only the selected version.


PencilTips.PNG
Some assets will show a status of Newer version available or Obsolete but the Download and Download this Version options will be greyed out and cannot be selected. This will always occur for all Built-in and Base assets and will usually occur for Packaged and Payware assets. Download Greyed Out.png
List Asset Versions.png In these cases select the List Asset Versions option. This will list all the available versions of the selected asset or assets and allow you to select one that can be downloaded (Available for download).
Packaged and Payware assets are normally updated through the Update option in the Content Store but can sometimes be updated through Content Manager to become freeware (Installed from DLS). If the asset is Packaged or Payware and still does not show an available download, then check the Content Store for updates.


  Top Next Up Next Down Bottom

Installed

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:-
[For simplicity only the major labels are shown in the figure below]

Installed assets
DotPoint.JPG The Status "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 The Status "Obsolete" added to a label means that a later version of that asset is already installed in Content Manager
DotPoint.JPG An asset that was originally Base, Built-in or Packaged can be changed to Installed from DLS by installing a newer version 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)
Built-in The asset was installed when Trainz was installed on your system
Packaged The asset is included in a DLC package that you have installed. If the label Payware is NOT present then it is also available on the DLS. See the PageLink.PNG Packaged and Payware section below
Installed from DLS The asset was installed from the DLS
Base The asset was installed when Trainz was installed on your system
NotePad.PNG Notes:

DotPoint.JPG You can delete assets that are labelled as Installed from DLS, Obsolete
DotPoint.JPG You cannot delete assets that are labelled as Built-in, Obsolete or Base, Obsolete
DotPoint.JPG You can ONLY delete assets that are labelled as Packaged using Uninstall in the Content Store, not from Content Manager. But before you uninstall any assets see the  Warning  PageLink.PNG Uninstalling DLC below.

Modified

You may often see the following label on installed assets:-

Modified 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:-

  • created yourself (it will have your kuid code)
  • modified from an installed asset
  • cloned from an installed asset (it will have your kuid code)
  • imported directly into Content Manager without using the Download command - as a result Content Manager will not know the source of the asset

Third Party

You may occasionally see the following label on installed assets:-

Third Party 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:-

  • 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
  • have been removed from the DLS listing, for a variety of reasons:-
  • if the reason was copyright violation then the assets will no longer be available 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. If you include them in an uploaded Route then they will appear as <unknown assets> in the Content Manager of users who have downloaded your Route but do not already have the assets.
  • if the reason is 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.
  • in some circumstances a removed asset might still be downloaded as a dependency of another asset but not as an individual asset in its own right. It will receive the label Third Party once downloaded.
PencilTips.PNG Running the Updates Available filter (see the PageLink.PNG Create an "Updates Available" Filter section above) will identify any Third Party assets that have updates available as shown in the figure below:-
Third Party available updates
Highlight the listed assets, right mouse click and select Download from the pop up menu.

The updates for the selected assets will be downloaded and installed.

Disabled

You may occasionally see the following label on installed assets:-

disabled
Disabled
The asset has been manually Disabled (from the Content menu select Disable).

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 WikiLink.PNG Deleting Stubborn Scenery Assets.

Normally you would restore the Disabled assets after fixing the Route or Session (from the Content menu select Enable).

Payware assets that are Disabled will have Payware (not active) as their status label.

Open for Edit

Open for edit
Open for edit
The asset is currently in use by another process such as Surveyor, Driver or Content Manager.

This label will appear on any asset that you have:-

  • currently open in Surveyor (a Route that is being edited) or Driver (a Session that is running)
  • opened in Content Manager for editing - for example changing its config.txt file or image files
  • imported into Content Manager from a Content File (.cdp file) or a Content Folder when the same asset is already installed

In the first case, exiting Surveyor or Driver will close the open Route and Session assets.

In the second and third cases you will need to manually close the open assets.

To manually close open assets:-

  1. select the open assets (individually or as a group)
  2. right mouse click on an open asset
  • select the Submit Edits command to close them with the edits saved, or
  • select Revert to Original to cancel the edits and return the assets to their previous unedited states, or
  • select 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


NotePad.PNG Notes:

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 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 PageLink.PNG Missing Dependencies section below
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 WikiLink.PNG Route and Session Basics for more information on dealing with this situation


  Top Next Up Next Down Bottom

Unknown, Incompatible, Not Installed

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:-

Unknown Location

DotPoint.JPG The Status label "Unknown location, Obsolete" means that a later version of that asset is already installed in Content Manager
unknown
Unknown location
The asset is listed as being on the DLS but it is unavailable

The Unknown location label can sometimes appear if a later version of an asset has been uploaded to the DLS but the original version was not or had been removed for some reason, as shown in the example below.

PencilTips.PNG If the asset is simply labelled as Unknown location then try the following:-
  1. right mouse click on the asset
  2. select List Asset Versions

You may find a later version is Available for download
Versions of an Unknown Location asset


Incompatible

incompatible
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 or TRS22 for build 5.0) to be loaded.
Build incompatible example

The Build Version column will identify the minimum Trainz build that the asset needs.

PencilTips.PNG To display the Build Version column in Content Manager:-
  1. right mouse click on any column heading where the new column will be inserted
  2. select Insert Column and then
  3. select Build Version

insert Build column

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 WikiLink.PNG "Trainz-build"_number


Not Installed

not installed
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

This status label can appear if you uninstall a DLC package (e.g. a Route) that you have modified or cloned as a new asset. Most Payware assets can be modified but conditions apply. See the section PageLink.PNG Modifying and Sharing Payware below.

Unknown Asset

An <unknown asset> can appear when using the List Asset Versions or the List Dependencies commands on a selected asset.

The label "<unknown asset>" will be shown in the Name column and the Status column will be blank.

unknown
unknown asset
The asset cannot be found on your system or on the DLS.
Using the List Asset Versions command on a selected asset will often reveal one or more unknown assets.
Unknown assets in version history In this example:-
  • the first version of the asset (<kuid:122285:1161>) is also the original version and is available on the DLS but it is now Obsolete as a later version is already installed
  • the fourth and latest version (<kuid2:122285:1161:3>) is labelled as Packaged and is installed in Content Manager. It is also available on the DLS
The two intermediate versions (:1 and :2) are unknown assets and are not available on the DLS. They may have been created but never uploaded. It is not unusual for asset creators to leave "gaps" in the Asset ID update numbers (the trailing ":digit" in the <kuid>) during the development process.

If the two unknown assets shown above had been uploaded to the DLS then they would have been made Obsolete by the latest version.

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 PageLink.PNG Missing Dependencies section below.

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:-

  • be from an independent (3rd party) web site
  • have been made by the same creator as the dependant asset but was not uploaded to the DLS
  • have been removed from the DLS for some reason (a rare event but it does happen)
  • simply not exist, anywhere

Fixing this may not be easy. Possible solutions are:-

  • There is a very long thread in the Trainz Forum where you can find posts looking for missing/unknown assets. See WikiLink.PNG Missing kuids? Post them here
  • 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 use the Delete Missing Assets command from the Tools menu in Surveyor, but make a backup copy of the Route or Session first.

  Top Next Up Next Down Bottom

Packaged and Payware

DotPoint.JPG Packaged assets are found on the DLS as well as in DLC packages
DotPoint.JPG Payware assets are exclusive to DLC packages
DotPoint.JPG DLC packages can only be installed, updated and uninstalled using Content Store from the Trainz Launcher


NotePad.PNG Notes:

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.

  • If you already have the exact same version of an asset that is included in a package you are installing then you will NOT end up with two identical copies of that asset. Your installed copy of the asset will be re-labelled as Packaged.
  • If the version included in the package is more recent than your current version then the newer version will be installed and the previous version will become Obsolete - this is the normal process for asset updates.

Problems can arise if the asset included in a DLC package has a higher version number (the :digit> at the end of a kuid2 number) than the copy on the DLS. This usually occurs when the DLS copy has not been updated to match the DLC copy. See How to Check the DLS Status of Packaged Assets below. If you encounter this problem in a Packaged asset, report it by the Bug Reporting Web Page or the Trainz Help Desk


Stop.PNG WARNING: Uninstalling DLC

If you Uninstall a DLC package then all its Packaged assets will be deleted, even if those same assets were previously labelled as Installed from DLS. The Uninstall process has no way of "knowing" if an asset was previously Installed from DLS or came from the package itself. This could result in other installed assets becoming faulty due to Missing dependencies.

The solution is to run a DBR (Database Repair - see the Wiki Page WikiLink.PNG How to Perform a DBR for details) after the Uninstall then install the missing assets from the DLS.


PencilTips.PNG How to Check the DLS Status of Packaged Assets

DotPoint1Blue.png Set the Content Manager search filter to show the Packaged assets you plan to use in a route that will be uploaded to the DLS.

Packaged asset candidates
  • In the example shown left the assets are in a saved Picklist named Fences & Walls but it could be the Installed filter sorted on the Status column to group all the Packaged assets together or use a Custom filter with Packaged = True.

Packaged Filter

DotPoint2Blue.png Select the Packaged asset or assets to be confirmed as being on the DLS. Right mouse click and select List Assets in New Window

Create new window
  • This will open a new search window with the selected assets.

DotPoint3Blue.png In the new search window, add the filter line On Download Station and set it to True

Packaged asset on DLS
  • Any assets that remain in the display will be found on the DLS.
  • Any that vanish are not on the DLS.

DotPoint4Blue.png As a variation to the above, set the On Download Station filter to False. This will reveal any of the selected Packaged assets that are NOT on the DLS.

Packaged asset NOT on DLS
  • In this example none of the selected assets are missing from the DLS.


Some of the Status labels that can appear on Packaged and Payware assets are:-

Packaged and Payware
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 The Status label "Obsolete" means that a later version of that asset is already installed in Content Manager
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" (Available for download) version,
Packaged The asset is included in a DLC package that you have installed. See Notes: below
Payware The asset is part of a payware package, usually from the DLC. Most DLC Payware can be modified but restrictions will apply. Exactly which assets in a package are Payware and which are Packaged is decided by the creator of the package. See the section PageLink.PNG Modifying and Sharing Payware below
Payware (not active) The asset is part of a payware package that is no longer active on your system. You may have uninstalled the package, disabled it, or it may have been installed for a free trial period which has now expired
Packaged, Payware The asset is encrypted so it cannot be modified or cloned
Modified, Payware The asset is Payware that you have modified or cloned. See the section PageLink.PNG Modifying and Sharing Payware below
NotePad.PNG Notes:

DotPoint.JPG You can ONLY delete assets that are labelled as Packaged or Payware using Uninstall in the Content Store, not from Content Manager. But before you uninstall any assets see the  Warning  PageLink.PNG Uninstalling DLC above.


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


NotePad.PNG Notes:

For current DLC packs, there are two important clarifications for the term Packaged:-

DotPoint.JPG Packaged - means that the asset is from an installed DLC package. DLC packages are normally installed using the Content Store selected from the Trainz Launcher. If there is no Payware label after the Packaged then the asset will be Freeware and should also be available on the DLS or on an independent 3rd party web site
DotPoint.JPG Packaged, Payware - means that the asset is Payware and has been encrypted so it cannot be modified or cloned
DotPoint.JPG Payware - without the label Packaged means that the asset can be modified and cloned with restrictions as shown below


Modifying and Sharing Payware

It is possible to modify a payware route and upload it to the DLS provided the creator of the route allows this to happen. There are some conditions that apply:-

  1. If the status of a route is listed as "Packaged, Payware" then the route has been encrypted and cannot be modified or cloned
  2. You can modify and save an unencrypted payware route that is installed on your system. It will be saved as an alias of the original and, provided the original payware route remains on your system (i.e. it is not deleted or disabled), then your modified copy will work
  3. You can upload a modified payware route to the DLS (again, if the route creator allows this) for others to download and use but they must also have the original payware route installed on their system
  4. It is NOT possible to merge a payware route with another route (payware or freeware) as this will remove the payware protection from the route


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 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.

In either case, if your modified payware route no longer works after an update to the original payware then report the problem by the Bug Reporting Web Page or the Trainz Help Desk


Using Packaged Assets in Routes or Sessions Uploaded to the DLS

DotPoint.JPG Packaged assets can be used in routes and sessions that you upload to the DLS

An asset will be labelled as Packaged if it is on the DLS and is also part of a DLC package that you have installed. The same asset can be in both locations and its status will be labelled according to how it was installed. This means that you can use Packaged assets in routes and sessions that you upload to the DLS.

PencilTips.PNG An important first step is to confirm that the Packaged asset you have added to your route is available in the identical version on the DLS. See the PageLink.PNG Tips: How to Check the DLS Status of Packaged Assets above.


For example:-

Packaged asset 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.

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

If they later install the same DLC package, or another that contains the same asset, its status will change to Packaged.


  Top Next Up   Bottom

Missing Dependencies

This is a label to be avoided.

missing
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.
The first thing to check is to see if the missing asset or assets can be identified.
  • Right mouse click on the asset
  • select the command List Dependencies

All the assets that are required by this asset will be identified.

missing
In this case, the Missing dependency is shown as Available for download so it is on the DLS and can be installed to fix the problem. If there are several assets that are listed as Available for download, select and download them all.

If the Missing dependency is an <unknown asset> then it can be a much harder problem to solve. See the section PageLink.PNG Unknown Asset above for possible remedies.

This situation shown in the example above can occur if you have:-

  • deleted the asset without realising that it is needed in other assets, such as a Route or a Session, or
  • used the Import command 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:-
  1. right mouse click on the asset or assets with the missing dependencies and select List Dependencies
  2. select all assets marked as Available for Download, right mouse click and select Download


PencilTips.PNG

To avoid the possibility of accidentally deleting an asset that is a dependency of other assets:-

  1. right mouse click on the asset to be deleted
  2. select the command List Dependants


This will give a list of all other assets that use the selected asset.

Deleting the selected asset ("Abuttment 2" in the example shown) will produce Missing dependencies errors for all the assets shown in the Dependants list.

List Dependants


  Top Next Up    


Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz


This page was created by Trainz user pware in January 2022 and was last updated as shown below.


Personal tools