Understand Content Manager Status Labels

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m
m (Using Packaged Assets in Routes Uploaded to the DLS)
Line 1,978: Line 1,978:
 
</tr>
 
</tr>
 
</table>
 
</table>
<br><br>
+
 
 
<table bgcolor=#ff0000 width=1000 cellpadding=2>
 
<table bgcolor=#ff0000 width=1000 cellpadding=2>
 
<tr valign="top">
 
<tr valign="top">
Line 2,047: Line 2,047:
 
<tr valign="top">
 
<tr valign="top">
 
<td width=629><span id="stepMissing"></span>
 
<td width=629><span id="stepMissing"></span>
 +
 
=<span style="font-weignt: 700; color: red;">Missing Dependencies</span>=
 
=<span style="font-weignt: 700; color: red;">Missing Dependencies</span>=
 
</td>
 
</td>

Revision as of 23:01, 28 August 2023

      Next Down Bottom
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

        Next Down Bottom
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:-
Steps: To add a column:-
DotPoint1.JPG Right Click on the column heading where you want it to be inserted
DotPoint2.JPG select  Insert Column  and then  Status 
insert Status Column
NotePad.PNG Columns in Content Manager Can Be:-

DotPoint.JPG  Removed 
Right Click on a column heading and select  Remove Column 
DotPoint.JPG  Moved 
Left Click and Drag a column heading left or right
DotPoint.JPG  Resized 
Move the tip of the mouse pointer onto the dividing line between two column headings then Left Click and Drag it left or right


NotePad.PNG 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 <kuid> 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. scenery, road spline or track object, then they will appear under each other in the same selection list. IdenticalAssetNames.png


The Status labels are described in the following sections.


Available for Download

Skip Down   Top Next Up Next Down Bottom
BlueDot10x10.png Available for Download simply means that the asset is on the DLS and is not already installed on your system


The Status labels that you may see would include:-

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 labelled  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.
 
Steps: To list the different versions of an asset:-
DotPoint1.JPG Right Click on the asset
DotPoint2.JPG 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.

DotPoint.JPG first click - sort ascending A to Z, 1 to 9, Jan to Dec
DotPoint.JPG second click - sort descending Z to A, 9 to 1, Dec to Jan
DotPoint.JPG 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

Skip Down Skip Up        
PencilTips.PNG This modified search filter will show all the freeware assets including their different versions that are available on the Download Station (DLS).
Steps: To create and save a filter:-
DotPoint1.JPG Select the Content Manager search filter Download Station
DotPoint2.JPG Open the filter (click the small triangle pointer on the left of the word Filter:)
DotPoint3.JPG Remove (click the (-) buttons on the extreme right) of the filter lines:-
RedDot10x10.png Out of date, and
RedDot10x10.png Obsolete
You can save this as a new filter
DotPoint4.JPG Click the Save button (which will appear as soon as you delete one of the filter lines)
DotPoint5.JPG Give the new filter a name (e.g. Available for Download)
Once saved you can reuse the filter whenever needed.
Create and save a new filter

Any new filters that you create will appear in the drop down list of available filters.


Create an "Updates Available" Filter

Skip Down Skip Up        
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.
Steps: Create a Custom filter as shown in the figure below:-
Update Filter05.png
DotPoint1.JPG Set the Installed filter line to True (it normally is)
DotPoint2.JPG Change the filter line Out of date to True
DotPoint3.JPG Delete all remaining filter lines
DotPoint4.JPG Save the filter - "Updates Available" would be a good filter name

You can then highlight, Right Click and select the option  Download  to get the updates for the selected assets.

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

Skip Down Skip Up        
BlueDot10x10.png To Install the Latest Version: You can select the version that is labelled Available for download with no other qualifier (Obsolete or Newer version available) or you can select ANY Available for download version (including those marked as Newer version available and Obsolete) and Content Manager will download and install only the latest version.
Download latest version
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version.
Steps: To install the latest version of an asset:-
DotPoint1.JPG Select (Left Click on) any version of the asset, it does not matter if it is labelled Obsolete
DotPoint2.JPG Right Click on the asset and select the option  Download 
Content Manager will ignore all the listed versions to download and install only the latest available version, even if that version is not shown in your filtered list. The asset download will include all the available dependencies of the latest version.


BlueDot10x10.png To Install a Specific Older Version: You can download and install an earlier version of an asset (one that also has the label Newer version available or Obsolete) if you don't want the latest version.
Download this version
In the figure above all the assets shown are different versions of the same original asset with the last entry the latest available version.
Steps: To
DotPoint1.JPG Select (Left Click on) the specific version of the asset you want, it can be one labelled Obsolete which means that you already have a later version of the asset installed
DotPoint2.JPG Right Click on the asset and select the option  Download this Version 
Content Manager will ignore any and all newer versions of the asset and will download and install only the selected version. The asset download will include all the available dependencies of the selected version.


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) as shown in the example below. If the asset is Packaged or Payware and still does not show an available download, then check the Content Store for updates.

PackagedToFreeware.png


Installed

  Skip Up Top Next Up Next Down Bottom
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:-
Installed assets
DotPoint.JPG The Status label  Newer version available  added to a label means that a later version of that asset is also available and can be downloaded and installed
DotPoint.JPG The Status label  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, Packaged, Payware or Third Party can be updated to Installed from DLS if a newer version becomes available on the DLS
DotPoint.JPG Packaged and Payware assets can ONLY be deleted (Uninstalled) using the Content Store and are usually updated through the Content Store
For simplicity only the major labels are shown
Base
Built-in
The asset was installed when Trainz was installed
Installed from DLS The asset was installed from the DLS
Modified The asset is one you have created yourself, modified or cloned from another asset or have installed from somewhere other than the DLS (e.g. a 3rd party web site)
Packaged The asset is included in a DLC package that you have installed but it may also be found on the DLS. See the PageLink.PNG Packaged and Payware section below for more information
Payware The asset is exclusive to a DLC package that you have installed. See the PageLink.PNG Packaged and Payware section below for more information
Third Party The installed asset may have been previously available on the DLS but is now unavailable
NotePad.PNG You can ONLY delete assets that are labelled as Packaged or Payware using Uninstall in the Content Store, not from Content Manager.
DotPoint.JPG Assets labelled as Modified, Payware are an exception as these are DLC assets you have modified and they can be deleted using Content Manager.
DotPoint.JPG But before you uninstall any assets see the
 Warning  PageLink.PNG Uninstalling DLC below.

Base, Built-in

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

Base Built-in 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.
Stop.PNG WARNING:

Base and Built-in assets are optimised for specific versions of Trainz. If you have updated your copy of Trainz to a newer version you cannot copy (via .cdp files for example) any Base and Built-in assets from the old version to the new without creating errors and major problems.

Installed from DLS

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

Assets from DLS
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 assets
Modified
You have created, altered or cloned the asset, or not installed it directly from the DLS.

This label will appear on all assets that you have:-

DotPoint.JPG created yourself (it will have your kuid code)
DotPoint.JPG modified from an installed asset
DotPoint.JPG cloned from an installed asset (it will have your kuid code)
DotPoint.JPG 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
Open for edit
The asset is currently in use by another process such as Surveyor, Driver or Content Manager.
NotePad.PNG Notes: the Open for Edit label will appear on any asset that you have:-

DotPoint.JPG currently open as a Route or Session in Surveyor or Driver. In this case, exiting Surveyor or Driver will close the open Route and Session assets
DotPoint.JPG opened in Content Manager for editing - for example changing its config.txt file or image files
DotPoint.JPG imported into Content Manager from a Content File (.cdp file) or a Content Folder when the same asset is already installed. In this case you will need to manually close the open assets


Steps: To manually close open assets:-
DotPoint1.JPG select (Left Click on) the open assets (individually or as a group)
DotPoint2.JPG Right Click on an open asset
DotPoint.JPG select the option  Submit Edits  to close them with the edits saved, OR
DotPoint.JPG select the option  Revert to Original  to cancel the edits and return the assets to their previous unedited states, OR
DotPoint.JPG select the option  Revert if Unchanged  if you have opened the assets (in Explorer or have just viewed their config,txt files) but have made no changes. Any opened assets that you have changed will remain Open for Edit
Submit edits


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

Packaged, Payware

If you have installed routes or other assets from the DLC then you see the following label or labels on installed assets:-

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

DotPoint.JPG Packaged by itself means that the asset can be cloned and modified for your personal use. Many, but not all, Packaged assets will also be found on the DLS
DotPoint.JPG 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 PageLink.PNG Packaged and Payware section below for more information.

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:-
DotPoint.JPG you have uploaded to the DLS but they have not yet been approved for distribution. Usually it takes 24 hours (sometimes more) before approval is given. After approval the Third Party label will be changed to Installed from DLS
DotPoint.JPG have been removed from the DLS listing, for a variety of reasons:-
RedDot10x10.png 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.
RedDot10x10.png 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.
RedDot10x10.png 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.


Stop.PNG WARNING:

If a DLS asset was removed for copyright reasons and you have included it in an uploaded route as a Third Party asset, then anyone who installs your route will see it labelled as having Missing dependencies and the asset itself will be labelled as an <unknown asset>.


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
Steps: To install any available updates of any Third Party assets:-
DotPoint1.JPG highlight all the listed assets
DotPoint2.JPG Right Click on any one of them and select the option  Download  from the pop up menu
Any available updates of the selected assets will be downloaded and installed.

After the update, Third Party assets should be shown as Installed from DLS
Updated from Third Party

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 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.
DotPoint.JPG For an example of this see the Trainz Wiki Page at WikiLink.PNG 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.


Unknown, Incompatible, Not Installed/Not Active

Skip Down   Top Next Up Next Down Bottom
Set the Content Manager search filter to All Content and click the Status column heading (once or twice) to sort the very long list according to their Status labels. Scroll down the list and you may see the following Status labels:-

Unknown Location

unknown
Unknown location
The asset is listed as being on the DLS but it is unavailable
BlueDot10x10.png If the Status label  Obsolete  appears with  Unknown location  then a later version of that missing asset is already installed in Content Manager
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.


PencilTips.PNG If the asset is simply labelled as Unknown location then try the following:-
Steps: To locate possible versions of an Unknown' asset:-
DotPoint1.JPG Right Click on the asset
DotPoint2.JPG select the option  List Asset Versions 

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

  In this case simply select and download the asset labelled "Available for download".

But sometimes you can get a different result
StatusUnknownLocationInstalled.png
This indicates that an older version is already installed but the newer version is not (yet) available for downloading.


Incompatible

Skip Down Skip Up        
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.


Build incompatible example

The Build Version column will identify the minimum Trainz build that the asset needs. A list of all the Trainz Build Version Numbers with their corresponding Trainz Version Names and service pack (SP) numbers can be found on the Trainz Wiki Page at WikiLink.PNG "Trainz-build"_number


PencilTips.PNG The build Trainz version of an asset can be shown in Content Manager
Steps: To display the Build Version column in Content Manager:-
DotPoint1.JPG Right Click on any column heading where the new column will be inserted
DotPoint2.JPG select the option  Insert Column  and then
DotPoint3.JPG select the option  Build Version 

insert Build column


Not Installed/Not Active

Skip Down Skip Up        
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 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 PageLink.PNG Modifying and Sharing Payware below.

The label can also appear on an asset that:-

DotPoint.JPG is part of a DLC item that you have not purchased or it requires a membership option (e.g. Plus or Gold)
DotPoint.JPG 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 almost 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

Skip Down Skip Up        
BlueDot10x10.png 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:-
DotPoint.JPG 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
DotPoint.JPG the fourth and latest version (<kuid2:122285:1161:3>) is labelled as Packaged and is installed in Content Manager. It was installed from a DLC package and it may 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:-
DotPoint.JPG be from an independent (3rd party) web site
DotPoint.JPG have been made by the same creator as the dependant asset but was not uploaded to the DLS
DotPoint.JPG have been removed from the DLS for some reason (a rare event but it does happen)
DotPoint.JPG simply not exist, anywhere
Fixing this may not be easy. Possible solutions are:-
DotPoint.JPG 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
DotPoint.JPG You can try contacting the creator via email (their address may be in the config.txt file) or a PM (Personal Message) through the Forum
Neither is a guaranteed solution.
If the unknown asset is in a Route or a Session then a third option is to 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

Skip Down Skip Up Top Next Up Next Down Bottom
BlueDot10x10.png Packaged assets are installed from DLC packages and may also be available on the DLS or elsewhere
BlueDot10x10.png Payware assets are exclusive to DLC packages or other payware sites (see Notes: below)
BlueDot10x10.png DLC packages can only be installed, updated and uninstalled using the Content Store from the Trainz Launcher


NotePad.PNG Notes: Packaged and Payware Assets

DotPoint.JPG 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.
RedDot10x10.png 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.
RedDot10x10.png Assets that are Packaged are compressed more than DLS assets. Image files will be in the .texture graphic format used by Built-in assets. This speeds up both the download process and the loading of the asset into a route or session.
RedDot10x10.png 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 PageLink.PNG 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.
DotPoint.JPG Packaged and Payware Assets for Trainz Versions Before TRS19 SP5
RedDot10x10.png In DLC created before TRS19 SP5 the automated process that created the package (TCCP) would classify any assets included in the package it was building as Payware if it could not locate them on the DLS. These assets may have been freeware on third party sites or the specific version included in the package was not on the DLS.
DotPoint.JPG Packaged and Payware Assets for Trainz Version TRS19 SP5 and Later (including Trainz Plus and TRS22)
RedDot10x10.png DLC created for TRS19 SP5 and later is packaged by a different automated process (TCCP2.0) that only labels included assets as Payware if the package creator has identified them as payware. It is up to the content creator to decide what is payware and what is not payware.
RedDot10x10.png If a creator has included an asset in the DLC that is not payware and is not on the DLS then it will be labelled as Packaged, along with all those assets that are on the DLS. If you include that asset in a route that you upload to the DLS (or elsewhere) then users who download the route will have the asset labelled as Unknown. They will have to locate it themselves, as is the case with Unknown assets in DLS downloads.
RedDot10x10.png If you include Packaged assets in an upload to the DLS it is important to check that they are actually on the DLS in the correct version used in your upload. See the PageLink.PNG 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.


Stop.PNG WARNING: Uninstalling DLC
DotPoint.JPG 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.

Steps: To restore deleted DLS assets that were packaged:-
DotPoint1.JPG run a DBR (Database Repair - see the Wiki Page WikiLink.PNG How to Perform a DBR for details) after the Uninstall
DotPoint2.JPG then reinstall the missing assets from the DLS
DotPoint.JPG Be aware that it is possible that some of the Packaged assets that were uninstalled may NOT be on the DLS - that is a decision made by the creator of the DLC package


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" 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. See the section PageLink.PNG Modifying and Sharing Payware below. Exactly which assets in a package are Payware and which are Packaged is decided by the creator of the package
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 Payware and was installed as part of a DLC package. Some Payware assets are encrypted and cannot be cloned or modified
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 Assets that are labelled as Packaged or Payware can only be deleted using Uninstall in the Content Store, not from Content Manager
DotPoint.JPG Modified, Payware is an exception as these are assets you have modified and can be deleted using 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


PencilTips.PNG You can identify the DLC package that a Packaged or Payware asset was installed from.
Steps: To identify the source DLC for a package asset:-
DotPoint1.JPG Select (Left Click) the Packaged or Payware asset
DotPoint2.JPG Open the Content menu on the Content Manager menu bar
DotPoint3.JPG Select the Report Containing Packages option at the bottom of the drop down list

The DLC package or packages will be identified by their code names (e.g. "sc491d").


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

DotPoint1Blue.png Set the Content Manager search filter to show the Packaged assets that you want to confirm are available on the DLS - for example you may want to use them in a route you will be uploading to the DLS.

Packaged asset candidates
DotPoint.JPG 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 (Left Click on) the Packaged asset or assets to be confirmed as being on the DLS. Right Click on any of the selected assets and select List Assets in New Window from the drop down menu

Create new window
DotPoint.JPG 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
DotPoint.JPG Any assets that remain in the display will be found on the DLS.
DotPoint.JPG Any assets that vanish are not on the DLS.



In the example shown on the left, all of the selected Packaged assets can also be found 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 the example shown on the left, none of the selected Packaged assets are missing from the DLS.


Modifying and Sharing Payware

Skip Down Skip Up        
DotPoint.JPG Some DLC assets cannot be modified
DotPoint.JPG Most DLC routes (and sessions) can be modified but the original must always be present and active on your system
DotPoint.JPG Modified DLC routes can be uploaded and used by those who also have the original present and active on their system
DotPoint.JPG DLC routes, including modified ones, cannot be merged


It is possible to modify a DLC (payware) route or session and upload it to the DLS provided the creator of the route allows this to happen. There are some conditions that apply:-
DotPoint.JPG Some DLC assets are encrypted and cannot be cloned or modified
DotPoint.JPG Your modified route or session will be saved as an alias of the original and, provided the original remains on your system (i.e. it is not deleted or disabled), then your modified copy will work
DotPoint.JPG You can upload a modified DLC route or session to the DLS (again, if the creator allows this) for others to download and use but they must also have the original unmodified route (and session) installed on their system
DotPoint.JPG It is NOT possible to merge a DLC route, or a cloned DLC route, with another route (payware or freeware) as this will remove the payware protection from the route


These restrictions are to protect the rights and intellectual property of the payware creators.

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


Using Packaged Assets in Routes Uploaded to the DLS

Skip Down Skip Up        
DotPoint.JPG Packaged assets can be used in routes and sessions that you upload to the DLS provided the asset is also on the DLS or is already installed as Packaged by users who have downloaded your route or session
An asset will be labelled as Packaged if it part of a DLC package that you have installed. It may also be on the DLS or a 3rd party web site. The same asset can be in both a DLC package and on the DLS and its status will be labelled according to how it was installed.


PencilTips.PNG The most important first step is to confirm that the Packaged asset you have added to your route is also available on the DLS. See the PageLink.PNG Tips: How to Check the DLS Status of Packaged Assets above.
A Packaged asset that is NOT on the DLS will appear as an <unknown asset> or as Not installed, Payware (not active) if your route is downloaded and installed by other users.


For example:-

Packaged asset You have installed a DLC package that contains an asset NZ House 1-4 as shown. Even if you had this exact same asset from the DLS before you installed the DLC package, it will now be labelled as Packaged in your Content Manager.

If, after confirming that this asset is on the DLS (see PageLink.PNG Tips: How to Check the DLS Status of Packaged Assets above), you then use this asset in a route that you have uploaded to the DLS. Anyone who downloads and installs your DLS route, and who does not already have the asset or the same DLC package installed, will have NZ House 1-4 downloaded and installed from the DLS by their Content Manager as normally happens with all DLS dependencies during the asset installation process.

When they look at the asset in Content Manager they will see:-

DLS asset

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


Using Different Versions of the Same Asset

Complications can occur if a Packaged asset has been updated to a newer version but the DLS version has not been updated to the same version. That is usually a decision made by the content creator.
Stop.PNG WARNING:

If an updated Packaged asset is a dependency of a route you have uploaded to the DLS then anyone who downloads and installs the route and does not already have the updated asset, either Packaged or Installed from the DLS, will see the route labelled as having "missing dependencies" and the asset itself labelled as an <unknown asset>.

This makes it very important that you check that every Packaged asset in your upload is also available in the same version on the DLS.


 Update:  The good news is that this problem seems to has been solved in the latest Trainz release

In the examples shown below, an updated asset, <kuid2:33404:501440:4>, is installed from a DLC package in one copy of Trainz (shown on the left). An earlier version of the same asset also exists, <kuid2:33404:501440:3>, as Installed from DLS in a different copy of Trainz (shown on the right). The updated version has not been uploaded to the DLS so there is no Newer version available status label.

Tomato Spline 117669.png Tomato Spline 118660.png

The updated asset is then used in a route and uploaded to the DLS. If that route is then installed in a copy of Trainz that does not have the packaged update, then:-

DotPoint.JPG if an earlier version (:3 in this case) has been installed then it will be used instead of the update (:4) and no missing dependency or <unknown asset> messages will appear on the new route
DotPoint.JPG if an earlier version of the asset is NOT installed, then the latest Available for download version (:3) can be downloaded and installed from the DLS. This will occur automatically if the route was installed directly from the DLS, or manually if it was imported from another source. In both cases the missing dependency and <unknown asset> messages will not appear after the :3 asset version has been installed
DotPoint.JPG if there is NO Earlier version available from the DLS then the installed route will be labelled as having a missing dependency and the asset will be labelled as an <unknown asset>


Missing Dependencies

  Skip Up Top Next Up   Bottom
Missing Dependencies can occur when an asset
DotPoint.JPG has been installed from a .cdp file (e.g. from a 3rd party site) without also installing other assets it requires
DotPoint.JPG has had dependent assets deleted or disabled
DotPoint.JPG 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
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.
Steps: To identify Missing Dependencies:-
DotPoint1.JPG Right Click on the asset
DotPoint2.JPG 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:-

DotPoint.JPG deleted the asset without realising that it is needed in other assets, such as a Route or a Session, OR
DotPoint.JPG 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:-
Steps: To find and install assets missing after an import:-
DotPoint1.JPG Right Click on the asset or assets with the missing dependencies and select List Dependencies
DotPoint2.JPG select all assets marked as Available for Download
DotPoint3.JPG Right Click on any one of them and select Download


PencilTips.PNG

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

Steps: To check an assets dependents:-
DotPoint1.JPG Right Click on the asset to be deleted
DotPoint2.JPG 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