Understand Content Manager Status Labels
m (→Packaged and Payware) |
m |
||
Line 26: | Line 26: | ||
<td>[[image:PencilTips.PNG|link=]]</td> | <td>[[image:PencilTips.PNG|link=]]</td> | ||
<td>If the '''Status''' column is not present in the '''Content Manager''' display, then:- | <td>If the '''Status''' column is not present in the '''Content Manager''' display, then:- | ||
− | * | + | *<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the column heading where you want it to be inserted |
*select '''Insert Column''' and then '''Status''' | *select '''Insert Column''' and then '''Status''' | ||
[[image:StatusAddStatusColumn.png|link=|alt=insert Status Column]]</td> | [[image:StatusAddStatusColumn.png|link=|alt=insert Status Column]]</td> | ||
Line 41: | Line 41: | ||
---- | ---- | ||
<span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Removed </span><br> | <span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Removed </span><br> | ||
− | : | + | :<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on a column heading and select '''Remove Column'''<br> |
<span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Moved </span><br> | <span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Moved </span><br> | ||
− | : | + | :<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> a column heading left or right |
<span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Resized </span><br> | <span style="font-weight: 700; font-size: 16px; color: white; background-color: black;"> Resized </span><br> | ||
− | :Move the tip of the mouse pointer onto the dividing line between two column headings | + | :Move the tip of the mouse pointer onto the dividing line between two column headings then <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click and Drag</span> it left or right |
</td> | </td> | ||
</tr> | </tr> | ||
Line 224: | Line 224: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset |
#select the command '''List Asset Versions''' | #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. | The list can be sorted into alphabetical/numerical order using a particular column by clicking on the column heading. | ||
Line 299: | Line 299: | ||
#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, | + | You can then highlight, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> 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'''. | ||
Line 331: | Line 331: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | #Select ( | + | #Select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) any version of the asset, it does not matter if it is labelled '''Obsolete''' |
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> 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. The asset download will include all the available dependencies of the latest version.</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. The asset download will include all the available dependencies of the latest version.</td> | ||
</tr> | </tr> | ||
Line 630: | Line 630: | ||
<td> | <td> | ||
To manually close open assets:- | To manually close open assets:- | ||
− | #select ( | + | #select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the open assets (individually or as a group) |
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> 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, or | :*select '''Revert to Original''' to cancel the edits and return the assets to their previous unedited states, or | ||
Line 762: | Line 762: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td>[[image:UpdatesAvailableThirdParty.png|link=|alt=Third Party available updates]]</td> | <td>[[image:UpdatesAvailableThirdParty.png|link=|alt=Third Party available updates]]</td> | ||
− | <td><br>Highlight all the listed assets, | + | <td><br>Highlight all the listed assets, <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on any one of them and select '''Download''' from the pop up menu.<br><br> |
The updates for the selected assets will be downloaded and installed. | The updates for the selected assets will be downloaded and installed. | ||
Line 861: | Line 861: | ||
<td>[[image:PencilTips.PNG|link=]]</td> | <td>[[image:PencilTips.PNG|link=]]</td> | ||
<td>If the asset is simply labelled as '''Unknown location''' then try the following:- | <td>If the asset is simply labelled as '''Unknown location''' then try the following:- | ||
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset |
#select '''List Asset Versions''' | #select '''List Asset Versions''' | ||
You may find a later version is '''Available for download'''<br> | You may find a later version is '''Available for download'''<br> | ||
Line 880: | Line 880: | ||
</table> | </table> | ||
<br> | <br> | ||
− | |||
==='''Incompatible'''=== | ==='''Incompatible'''=== | ||
<table> | <table> | ||
Line 913: | Line 912: | ||
<td>[[image:PencilTips.PNG|link=]]</td> | <td>[[image:PencilTips.PNG|link=]]</td> | ||
<td>To display the '''Build Version''' column in '''Content Manager''':- | <td>To display the '''Build Version''' column in '''Content Manager''':- | ||
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on any column heading where the new column will be inserted |
#select '''Insert Column''' and then | #select '''Insert Column''' and then | ||
#select '''Build Version''' | #select '''Build Version''' | ||
Line 1,076: | Line 1,075: | ||
<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>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 version on the '''DLS'''. This usually occurs when the '''DLS''' version has not been updated to match the version included in the '''DLC'''. See the [[image:PageLink.PNG|link=]] '''[[#CheckDLS|Tips: How to Check the DLS Status of Packaged Assets]]''' below for instructions on how to check if a '''Packaged''' asset is also on the '''DLS'''.</td> | + | <td>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 version on the '''DLS'''. This usually occurs when the '''DLS''' version has not been updated to match the version included in the '''DLC'''. See the [[image:PageLink.PNG|link=]] '''[[#CheckDLS|Tips: How to Check the DLS Status of Packaged Assets]]''' below for instructions on how to check if a '''Packaged''' asset is also on the '''DLS'''.</td> | ||
</tr> | </tr> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 1,256: | Line 1,256: | ||
<td>[[image:PencilTips.PNG|link=]]</td> | <td>[[image:PencilTips.PNG|link=]]</td> | ||
<td>You can identify the '''DLC''' package that a '''Packaged''' or '''Payware''' asset was installed from. | <td>You can identify the '''DLC''' package that a '''Packaged''' or '''Payware''' asset was installed from. | ||
− | #Select ( | + | #Select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span>) the '''Packaged''' or '''Payware''' asset |
#Open the '''Content''' menu on the '''Content Manager''' menu bar | #Open the '''Content''' menu on the '''Content Manager''' menu bar | ||
#Select the '''Report Containing Packages''' option at the bottom of the drop down list | #Select the '''Report Containing Packages''' option at the bottom of the drop down list | ||
Line 1,285: | Line 1,285: | ||
</tr> | </tr> | ||
</table> | </table> | ||
− | [[image:DotPoint2Blue.png|link=]] Select ( | + | [[image:DotPoint2Blue.png|link=]] Select (<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Left Click</span> on) the '''Packaged''' asset or assets to be confirmed as being on the '''DLS'''. <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on any of the selected assets and select '''List Assets in New Window''' from the drop down menu<br> |
<table> | <table> | ||
<tr valign="top"> | <tr valign="top"> | ||
Line 1,560: | Line 1,560: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | * | + | *<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset |
*select the command '''List Dependencies''' | *select the command '''List Dependencies''' | ||
All the assets that are required by this asset will be identified. | All the assets that are required by this asset will be identified. | ||
Line 1,581: | Line 1,581: | ||
*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. | *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:- | ::If you have imported an asset from a '''.cdp''' or '''content folder''' and see the '''Missing dependencies''' label then:- | ||
− | ::# | + | ::#<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset or assets with the missing dependencies and select '''List Dependencies''' |
− | ::#select all assets marked as '''Available for Download''', | + | ::#select all assets marked as '''Available for Download''', <span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on any one of them and select '''Download'''<br> |
<br> | <br> | ||
Line 1,596: | Line 1,596: | ||
<tr valign="top"> | <tr valign="top"> | ||
<td> | <td> | ||
− | # | + | #<span style="font-weight: 700; font-size: 15px; background-color: lightcyan;">Right Click</span> on the asset to be deleted |
#select the command '''List Dependants''' | #select the command '''List Dependants''' | ||
<br> | <br> |
Revision as of 23:01, 2 August 2023
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 |
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).
|
Notes: It is important to remember that:-
|
The Status labels are described in the following sections. |
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 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 |
You can check to see what is the latest version of an asset that is listed as Newer version available or Obsolete. This will produce a list of all the previous versions (installed or not), currently installed (if any) and later versions of the selected asset. | |||||
|
|||||
In the example shown above the latest version of the selected asset is already installed (Installed from DLS) and it does not have exactly the same name as the original. If it is the latest available version and is not already installed then it will be shown as Available for download without any additional labels. |
Create an "Available for Download" Filter
This modified search filter will show all the freeware assets including their different versions that are available on the Download Station (DLS).
|
Create an "Updates Available" Filter
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 Using Content Manager to Update Assets but a summary is provided below.
|
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. |
|
|
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:-
|
|
|
|
Base, Built-in
You will often see the following label 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. |
|
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. |
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 command - as a result Content Manager will not know the source of the asset
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.
|
|
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. |
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
- Packaged, Payware means that the asset is exclusive to a DLC package and will not be found on the DLS. Some Payware assets are encrypted and cannot be cloned or modified
It is up to the creator of a DLC package to decide if an asset they have created will also be available on the DLS, or if it will be encrypted.
See the Packaged and Payware section below for more information.
Third Party
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, for a variety of reasons:-
- 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.
- if the reason was copyright violation then the assets will no longer 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.
|
|
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 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.
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:-
Unknown Location
|
Unknown location The asset is listed as being on the DLS but it is unavailable |
If the Status label Obsolete appears with Unknown location then a later version of that missing asset is already installed in Content Manager |
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 uploaded or had been removed for some reason, as shown in the example below. |
|
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.
The Build Version column will identify the minimum Trainz build that the asset needs.
|
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 the section Modifying and Sharing Payware below.
The label can also appear on an asset that:-
- is part of a DLC item that you have not purchased or it requires a membership option (e.g. Plus, Gold or Silver)
- has been updated to a newer version but the source DLC package has not yet been updated - there may be a delay before the package is updated. This is certainly the case if a working payware (or packaged) asset is suddenly relabelled as (not active) - check the Update option in the Content Store
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 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 use the Delete Missing Assets command from the Tools menu in Surveyor, but make a backup copy of the Route or Session first.
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 |
|
|
Some of the Status labels that can appear on Packaged and Payware assets are:-
|
|
|
|
|
|
|
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.
|
|
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.
|
|
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 dependent assets deleted or disabled | |
has been downloaded from the DLS but contains dependent assets that are not on the DLS or built-in |
This is a label to be avoided.
|
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. |
|
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:-
- Right Click on the asset or assets with the missing dependencies and select List Dependencies
- select all assets marked as Available for Download, Right Click on any one of them and select Download
- If you have imported an asset from a .cdp or content folder and see the Missing dependencies label then:-
|
Trainz Wiki
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.