Understand Content Manager Status Labels
m (→Unknown Location) |
m (→Third Party) |
||
(13 intermediate revisions by one user not shown) | |||
Line 63: | Line 63: | ||
<td> | <td> | ||
There are three common ways that assets can be installed into '''Trainz''' using '''Content Manager''':- | There are three common ways that assets can be installed into '''Trainz''' using '''Content Manager''':- | ||
− | <table> | + | <table width=1000 bgcolor=#000000 cellpadding=2> |
+ | <tr valign="top"> | ||
+ | <td> | ||
+ | <table width=996 bgcolor=#ffffff cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=25>[[image:Ablue.png|link=]]</td> | <td width=25>[[image:Ablue.png|link=]]</td> | ||
− | <td>selecting an asset shown in the '''Content Manager''' display that is listed as '''Available for download''' (see the section [[image:PageLink.PNG|link=]] '''[[#skipVersionAsset|Installing the Latest or an Older Version of an Asset]]'''). This is the | + | <td>selecting an asset shown in the '''Content Manager''' display that is listed as '''Available for download''' (see the section [[image:PageLink.PNG|link=]] '''[[#skipVersionAsset|Installing the Latest or an Older Version of an Asset]]'''). This is the <span style="font-weight: 700; background-color: yellow;"> preferred method </span> as it will also download and install any dependencies required by that asset</td> |
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 73: | Line 82: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td>[[image:CMContentInstall.png|link=]]</td> | <td>[[image:CMContentInstall.png|link=]]</td> | ||
+ | <td><span style="font-weight: 700; font-size: 15px;">OR</span> | ||
+ | <table bgcolor=#000000 cellpadding=2> | ||
+ | <tr valign="top"> | ||
<td> | <td> | ||
− | <table> | + | <table bgcolor=#ffffff cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
− | <td | + | <td>[[image:Bblue.png|link=]]</td> |
− | <td> | + | <td>selecting previously saved '''.cdp''' files and the '''Content Manager''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Import Content Files... </span> option from the '''File Menu''' (shown left). This method is commonly used to restore backup copies of assets that you have created or modified yourself such as routes and sessions</td> |
</tr> | </tr> | ||
+ | </table> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <span style="font-weight: 700; font-size: 15px;">OR</span> | ||
+ | <table bgcolor=#000000 cellpadding=2> | ||
+ | <tr valign="top"> | ||
+ | <td> | ||
+ | <table bgcolor=#ffffff cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
<td>[[image:Cblue.png|link=]]</td> | <td>[[image:Cblue.png|link=]]</td> | ||
− | <td> | + | <td>selecting a folder (only one folder at a time) that contains all the asset files and the '''Content Manager''' <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Import Content Folder... </span> option from the '''File Menu''' (shown left). This method is frequently used to install assets that you have created yourself</td> |
</tr> | </tr> | ||
− | < | + | </table> |
− | + | </td> | |
</tr> | </tr> | ||
− | < | + | </table> |
− | < | + | <br> |
<table bgcolor=#000000 cellpadding=2> | <table bgcolor=#000000 cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 94: | Line 115: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=25>[[image:NotePad.PNG|link=]]</td> | <td width=25>[[image:NotePad.PNG|link=]]</td> | ||
− | <td>In addition, assets can be installed by purchasing '''DLC''' packages from the '''Content Store''' which is found on the '''Trainz Launcher'''. Each package contains all the required assets</td> | + | <td>In addition, assets can be installed by purchasing '''DLC''' packages from the '''Content Store''' which is found on the '''Trainz Launcher'''. Each package contains all the required dependencies including those that are already on the '''DLS'''. These assets will appear in '''Content Manager''' with the status labels of '''Packaged''' and/or '''Payware'''</td> |
</tr> | </tr> | ||
</table> | </table> | ||
Line 102: | Line 123: | ||
</td> | </td> | ||
</tr> | </tr> | ||
− | < | + | <tr valign="top"> |
− | < | + | <td colspan=2> |
− | < | + | <br> |
− | + | The '''Import''' methods ([[image:Bblue.png|link=]] and [[image:Cblue.png|link=]]) listed above will install the selected asset(s) but '''Content Manager''' will '''NOT''' search for any of their dependencies on the '''DLS'''. Selecting these options can result in assets having the message '''Missing dependencies''' added to their status labels (see the [[image:PageLink.PNG|link=]] '''[[#Missing Dependencies|Missing Dependencies]]''' section below). You must manually find these missing dependencies yourself. | |
</td> | </td> | ||
</tr> | </tr> | ||
Line 204: | Line 225: | ||
</table> | </table> | ||
<br> | <br> | ||
− | <table bgcolor=#ffffb0 width=1000> | + | <table bgcolor=#ffffb0 width=1000 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td>[[image:NotePad.PNG|link=]]</td> | <td>[[image:NotePad.PNG|link=]]</td> | ||
Line 210: | Line 231: | ||
---- | ---- | ||
It is important to remember that:- | It is important to remember that:- | ||
− | <table> | + | <table width=996 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | <td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | ||
Line 216: | Line 237: | ||
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td | + | <td>[[image:DotPoint.JPG|10px|link=]]</td> |
<td>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.</td> | <td>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.</td> | ||
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td | + | <td colspan=2> |
− | + | <table> | |
− | <table | + | |
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | <table bgcolor=#000000 width= | + | <table bgcolor=#000000 width=485 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | <table bgcolor=#ffffff width= | + | <table bgcolor=#ffffff width=481 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td>'''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.<br> | <td>'''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.<br> | ||
Line 239: | Line 259: | ||
</table> | </table> | ||
</td> | </td> | ||
− | <td width= | + | <td width=10> </td> |
<td> | <td> | ||
− | <table bgcolor=#000000 width= | + | <table bgcolor=#000000 width=485 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | <table bgcolor=#ffffff width= | + | <table bgcolor=#ffffff width=481 cellpadding=2> |
<tr valign="top"> | <tr valign="top"> | ||
<td>'''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 <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> List Asset Versions </span> option.<br> | <td>'''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 <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> List Asset Versions </span> option.<br> | ||
[[image:StatusUpdatesNewKUIDs.png|link=]]<br> | [[image:StatusUpdatesNewKUIDs.png|link=]]<br> | ||
− | Assets with negative '''<kuid>''' can only be updated by issuing them with new '''<kuid>''' | + | 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. |
</td> | </td> | ||
</tr> | </tr> | ||
Line 261: | Line 281: | ||
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td | + | <td>[[image:DotPoint.JPG|10px|link=]]</td><td> |
<table> | <table> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 275: | Line 295: | ||
</table> | </table> | ||
<br> | <br> | ||
− | <table width=1000> | + | <table width=1000 bgcolor=#000000 cellpadding=2> |
+ | <tr valign="top"> | ||
+ | <td> | ||
+ | <table width=996 bgcolor=#ffffff cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
<td align="center"><span style="font-size: 17px;">The '''Status labels''' are described in the following sections.</span></td> | <td align="center"><span style="font-size: 17px;">The '''Status labels''' are described in the following sections.</span></td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Line 396: | Line 422: | ||
</table> | </table> | ||
<br> | <br> | ||
− | + | <table> | |
− | The latest version, shown at the bottom of the list in the image | + | <tr valign="top"> |
+ | <td colspan=2>The latest version, shown at the bottom of the list in the image below, has '''Unknown Location''' as its status (see the [[image:PageLink.PNG|link=]] '''[[#Unknown Location|Unknown Location]]''' section below for more information on this situation) while the previous version is already installed. </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:StatusNewerVersion3.png|link=]]</td> | ||
+ | <td>This can happen if the updated version has been released as part of a '''DLC''' package and is not on the '''DLS'''. The previous installed version is still fully operational | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Line 403: | Line 438: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | <td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | ||
− | <td>'''Packaged | + | <td>'''Packaged''' assets with the qualifier label '''Newer version available''' can usually be updated by firstly listing all their asset versions. |
<table width=1000> | <table width=1000> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 410: | Line 445: | ||
</tr> | </tr> | ||
</table> | </table> | ||
− | + | ||
<table> | <table> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 418: | Line 453: | ||
</table> | </table> | ||
</td> | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <table> | ||
+ | <tr valign="top"> | ||
+ | <td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | ||
+ | <td>'''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 <span style="font-weight: 700; font-size: 15px;">IF</span> 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.<br> | ||
+ | [[image:StatusPaywareNewVersion.png|link=]]</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Line 472: | Line 514: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=629><span id="stepDownload"></span> | <td width=629><span id="stepDownload"></span> | ||
− | |||
='''Available for Download'''= | ='''Available for Download'''= | ||
</td> | </td> | ||
Line 1,015: | Line 1,056: | ||
<table width=996 bgcolor=#fcbcbc > | <table width=996 bgcolor=#fcbcbc > | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[ | + | <td width=30>[[image:Stop.PNG|link=]]</td> |
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br> | <td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br> | ||
'''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.</td> | '''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.</td> | ||
Line 1,354: | Line 1,395: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td>[[image:DotPoint.JPG|10px|link=]]</td> | <td>[[image:DotPoint.JPG|10px|link=]]</td> | ||
− | <td>have been removed from the '''DLS''' listing, for a variety of reasons:- | + | <td>have been removed from the '''DLS''' listing, or are not shown in the listing, for a variety of reasons including:- |
<table> | <table> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td width= | + | <td width=25>[[image:DotPoint1Blue.png|link=]]</td> |
− | <td> | + | <td><span style="font-weight: 700; font-size: 15px;">repair work</span> - 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.</td> |
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[image: | + | <td>[[image:DotPoint2Blue.png|link=]]</td> |
− | <td> | + | <td><span style="font-weight: 700; font-size: 15px;">legacy content</span> - 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'''.</td> |
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[image: | + | <td>[[image:DotPoint3Blue.png|link=]]</td> |
− | <td> | + | <td><span style="font-weight: 700; font-size: 15px;">copyright</span> - 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'''.</td> |
</tr> | </tr> | ||
</table> | </table> | ||
Line 1,378: | Line 1,419: | ||
<table width=996 bgcolor=#fcbcbc cellpadding=2> | <table width=996 bgcolor=#fcbcbc cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td | + | <td colspan=2><span style="font-size: 15px; font-weight: 700;">WARNING:</span></td> |
− | + | </tr> | |
− | If | + | <tr valign="top"> |
− | </td> | + | <td>[[image:Stop.PNG|link=]]</td> |
+ | <td>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 <span style="font-weight: 700; font-size: 15px">Missing dependencies</span> and the asset itself will be labelled as an <span style="font-weight: 700; font-size: 15px"><unknown asset></span>.</td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:Stop.PNG|link=]]</td> | ||
+ | <td>'''Third Party''' assets cannot be used in '''Multiplayer Driver''' or '''Multiplayer Surveyor'''.</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
</td> | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | <br> | ||
+ | <table width=1000> | ||
+ | <tr valign="top"> | ||
+ | <td>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'''.</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Line 1,415: | Line 1,467: | ||
</tr> | </tr> | ||
</table> | </table> | ||
− | After the update | + | After the update the replacement assets '''should''' be shown as '''Installed from DLS'''. |
− | [[image:UpdatedFromThirdParty.png|link=|alt=Updated from Third Party]] | + | <table> |
+ | <tr valign="top"> | ||
+ | <td width=480>[[image:UpdatedFromThirdParty.png|link=|alt=Updated from Third Party]]</td> | ||
+ | <td>The original '''Third Party''' assets will still be present but they will now be labelled '''Obsolete'''. They can can be deleted.</td> | ||
+ | </tr> | ||
+ | </table> | ||
</td> | </td> | ||
</tr> | </tr> | ||
Line 1,423: | Line 1,480: | ||
</tr> | </tr> | ||
</table> | </table> | ||
+ | <br> | ||
<table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS --> | <table width=1000> <!-- BEGIN Nav Buttons Table SKIPS NO SECTIONS --> | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=629><span id="skipDisabled"></span> | <td width=629><span id="skipDisabled"></span> | ||
+ | |||
==='''Disabled'''=== | ==='''Disabled'''=== | ||
</td> | </td> | ||
Line 1,544: | Line 1,603: | ||
</tr> | </tr> | ||
</table> | </table> | ||
− | <br> | + | <br> |
+ | <table width=1000> | ||
+ | <tr valign="top"> | ||
+ | <td> | ||
<table width=600 bgcolor=#000000 cellpadding=2> | <table width=600 bgcolor=#000000 cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 1,575: | Line 1,637: | ||
[[image:StatusUnknownLocationInstalled.png|link=]]<br> | [[image:StatusUnknownLocationInstalled.png|link=]]<br> | ||
This indicates that an older version is installed but the newer version is not available for downloading from the '''DLS''' (it may be part of a '''DLC''' package). | This indicates that an older version is installed but the newer version is not available for downloading from the '''DLS''' (it may be part of a '''DLC''' package). | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
+ | <td> | ||
+ | <table bgcolor=#000000 cellpadding=2> | ||
+ | <tr valign="top"> | ||
+ | <td> | ||
+ | <table bgcolor=#ffffe0 cellpadding=2> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:PencilTips.PNG|link=]]</td> | ||
+ | <td colspan=2>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:-</td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:DotPoint.JPG|10px|link=]]</td> | ||
+ | <td>a '''DBR''' (Database Repair) - See the '''Wiki Page [[image:WikiLink.PNG|link=]] [[How_to_Perform_Database_Repairs|How to Perform Database Repairs]]''' for the details</td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:DotPoint.JPG|10px|link=]]</td> | ||
+ | <td>an '''EDBR''' (Extended Database Repair) - See the '''Wiki Page [[image:WikiLink.PNG|link=]] [[How_to_Perform_Database_Repairs|How to Perform Database Repairs]]''' for the details. <span style="font-weight: 700; background-color: yellow;"> Note: An EDBR should be used with caution </span></td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:DotPoint.JPG|10px|link=]]</td> | ||
+ | <td>reverting the '''Unknown Location''' assets - select all the assets, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;"> Right Click </span> on one of them and select the option <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Revert to Original </span></td> | ||
+ | </tr> | ||
+ | </table> | ||
</td> | </td> | ||
</tr> | </tr> | ||
Line 1,585: | Line 1,676: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=629><span id="skipIncompatible"></span> | <td width=629><span id="skipIncompatible"></span> | ||
− | |||
==='''Incompatible'''=== | ==='''Incompatible'''=== | ||
</td> | </td> | ||
Line 2,158: | Line 2,248: | ||
<table bgcolor=#fcbcbc width=996 cellpadding=2> | <table bgcolor=#fcbcbc width=996 cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[ | + | <td width=30>[[image:Stop.PNG|link=]]</td> |
<td><span style="font-size: 15px; font-weight: 700;">WARNING: Uninstalling DLC</span> | <td><span style="font-size: 15px; font-weight: 700;">WARNING: Uninstalling DLC</span> | ||
<table> | <table> | ||
Line 2,173: | Line 2,263: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=25>[[image:DotPoint1.JPG|link=]]</td> | <td width=25>[[image:DotPoint1.JPG|link=]]</td> | ||
− | <td>run a '''DBR''' (Database Repair - see the Wiki Page [[image:WikiLink.PNG|link=]] '''[[How_to_Perform_Database_Repairs | + | <td>run a '''DBR''' (Database Repair - see the Wiki Page [[image:WikiLink.PNG|link=]] '''[[How_to_Perform_Database_Repairs|How to Perform a DBR]]''' for details) after the '''Uninstall'''</td> |
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 2,551: | Line 2,641: | ||
<table width=1000> | <table width=1000> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[image:Packaged05a.png|link=]]</td> | + | <td width=395>[[image:Packaged05a.png|link=]]</td> |
<td> | <td> | ||
− | + | <table width=605 bgcolor=#000000 cellpadding=2> | |
− | <table bgcolor=#000000 cellpadding=2> | + | |
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | <table bgcolor=# | + | <table width=600 bgcolor=#ffffb0 cellpadding=2> |
+ | <tr valign="top"> | ||
+ | <td width=25>[[image:NotePad.PNG|link=]]</td> | ||
+ | <td width=975><span style="font-size: 17px; font-weight: 700;">Notes:'''</span><br> | ||
+ | ----</td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td colspan=2> | ||
+ | <table> | ||
<tr valign="top"> | <tr valign="top"> | ||
<td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | <td width=10>[[image:DotPoint.JPG|10px|link=]]</td> | ||
− | <td>Some assets that are labelled as '''Packaged, Newer version available''' such as '''Villa blue''', but if they are highlighted and the option <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Download </span> is selected then nothing will be downloaded and installed</td> | + | <td>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 <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;"> Right Click </span> on the asset and select the option <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Download </span> to download and install the update. If nothing is downloaded then the update is not on the '''DLS''' so try the '''Content Store''' |
+ | </td> | ||
+ | </tr> | ||
+ | <tr valign="top"> | ||
+ | <td>[[image:DotPoint.JPG|10px|link=]]</td> | ||
+ | <td>Some assets that are labelled as '''Packaged, Newer version available''' such as '''Villa blue''' shown left, but if they are highlighted and the option <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;"> Download </span> is selected then nothing will be downloaded and installed. The update is most likely in a '''DLC''' package | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | </td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
Line 2,648: | Line 2,754: | ||
<table bgcolor=#fcbcbc cellpadding=2> | <table bgcolor=#fcbcbc cellpadding=2> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[ | + | <td width=30>[[image:Stop.PNG|link=]]</td> |
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</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. | 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. | ||
Line 2,764: | Line 2,870: | ||
<table bgcolor=#fcbcbc width=996> | <table bgcolor=#fcbcbc width=996> | ||
<tr valign="top"> | <tr valign="top"> | ||
− | <td>[[ | + | <td width=30>[[image:Stop.PNG|link=]]</td> |
<td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br> | <td><span style="font-size: 15px; font-weight: 700;">WARNING:</span><br> | ||
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>'''.<br> | 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>'''.<br> | ||
Line 3,198: | Line 3,304: | ||
<td> | <td> | ||
<span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br> | <span style="font-size: 17px;">'''More Tutorials and Guides to Using Trainz'''</span><br> | ||
− | *'''<span class=" | + | *'''<span class="plain;s">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>''' |
*'''[[Driver Commands List]]''' | *'''[[Driver Commands List]]''' | ||
*'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]''' | *'''[[Session Rule List with Parameters|Session Rules List (Alphabetical) with Parameters]]''' | ||
Line 3,221: | Line 3,327: | ||
</table> | </table> | ||
---- | ---- | ||
− | This page was created by Trainz user '''<span class=" | + | This page was created by Trainz user '''<span class="plain;s">[http://online.ts2009.com/mediaWiki/index.php/User:Pware pware]</span>''' in January 2022 and was last updated as shown below. |
---- | ---- | ||
[[Category:How-to guides]] | [[Category:How-to guides]] |
Latest revision as of 22:36, 9 September 2024
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. |
|
|
[edit] Installing Assets into Content Manager |
There are three common ways that assets can be installed into Trainz using Content Manager:-
|
||||||||||||||
|
[edit] 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 asset - its location, availability, and "currency" (installed, obsolete, modified, Payware, unknown, etc). |
|
|
Notes: It is important to remember that:-
|
|
[edit] Status Label Qualifiers |
Status labels can have qualifiers added that provides additional information about each asset | |
Two of the most common qualifiers are Newer version available and Obsolete |
|
[edit] Newer Version Available
|
|
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 | |
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 |
|
[edit] Obsolete
|
|
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 | |
Obsolete Installed from DLS assets can be deleted | |
Obsolete Packaged, Payware, Built-in and Base assets cannot be deleted |
[edit] Available for Download |
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 | 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 |
|
[edit] Create an "Available for Download" Filter |
|
[edit] Create an "Updates Available" Filter |
|
[edit] Installing the Latest or an Older Version of an Asset |
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. |
|
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. |
|
|
[edit] 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:- |
|
|
|
|
[edit] Base, Built-in |
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 |
|
[edit] Installed from DLS |
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 |
[edit] Modified |
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:-
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 option - as a result Content Manager will not know the source of the asset |
[edit] Open for Edit |
|
Open for edit The asset is currently in use by another process such as Surveyor, Driver or Content Manager. |
|
|
|
[edit] Packaged, Payware |
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.
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 | |
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. |
[edit] Third Party |
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:- | |||||||
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, or are not shown in the listing, for a variety of reasons including:-
|
|
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. |
|
[edit] Disabled |
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. |
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. | |
Normally you would restore (Enable) the Disabled assets after removing them from the Route or Session. | |
Payware assets that are Disabled will have Payware (not active) as their status label. |
[edit] Unknown, Incompatible, Not Installed/Not Active |
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:- |
[edit] Unknown Location
|
Unknown location The asset is listed but it is unavailable on the DLS. It may be part of a DLC package |
If the Status label Obsolete appears with Unknown location then a later version of that missing asset is already installed in Content Manager |
|
|
|
[edit] 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 for build 5.0 or TRS22/Trainz Plus for build 5.1) to be loaded.
|
|
[edit] Not Installed/Not Active |
|
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 an original DLC package (e.g. a Route) that you have cloned to create a new modified version for your own use. The (not active) label will appear on your cloned copy. Most Payware assets can be cloned but conditions apply. See Modifying and Sharing Payware below.
|
[edit] Unknown Asset |
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. |
|
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 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 select Delete Missing Assets from the Tools menu in Surveyor, but make a backup copy of the Route or Session first. |
[edit] Packaged and Payware |
Packaged assets are installed from DLC packages and may also be available on the DLS or elsewhere | |
Payware assets are exclusive to DLC packages or other payware sites (see Notes: below) | |
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.
|
|
|
[edit] Installing Packaged and Payware Assets |
Packaged and Payware assets can only be installed by installing a DLC package using the Content Store from the Trainz Launcher |
|
|
[edit] Deleting Packaged and Payware Assets |
Packaged and Payware assets can only be deleted by Uninstalling the DLC package that installed them |
|
|
[edit] Packaged and Payware Status Labels |
Some of the Status labels that can appear on Packaged and Payware assets are:-
|
|
|
|
|
|
|
[edit] Updating Packaged and Payware Assets |
Packaged and Payware assets can be made obsolete by a newer version of the same asset appearing on the DLS | |
these updates can be downloaded and installed from the DLS |
Consider the following examples:- | |||||||
After running the Updates Available filter (see Create an Updates Available Filter above) the following list of assets is displayed:- | |||||||
|
|
The following situation can also occur with Packaged and Payware assets.
|
|
[edit] Modifying and Sharing Payware |
Some DLC assets cannot be modified | |
Most DLC routes (and sessions) can be modified but the original must always be present and active on your system | |
Modified DLC routes can be uploaded and used by those who also have the original present and active on their system | |
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:- | |
Some DLC assets are encrypted and cannot be cloned or modified | |
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 | |
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 | |
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.
|
|
[edit] Using Packaged Assets in Routes Uploaded to the DLS |
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. |
|
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. |
|
|
[edit] Faulty |
This label can appear on any asset that:- | |
you have incorrectly modified so that it now has an error | |
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:-
|
|
The first step in repairing a faulty asset, if it is possible, is to identify the cause of the fault
|
[edit] Missing Dependencies |
Missing Dependencies can occur when an asset:- | |
has been installed from a .cdp file (e.g. from a 3rd party site) without also installing other assets it requires | |
has had assets that are dependencies deleted or disabled | |
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:-
deleted the asset without realising that it is needed in other assets, such as a Route or a Session, OR | |
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:-
|
|
[edit] Trainz Wiki
|
|
This page was created by Trainz user pware in January 2022 and was last updated as shown below.