KUID
(New page: ''Taken from CCGTC.'' A KUID is a unique number allocated to all content created for Trainz and can be thought of as a bar code. '''KUID2 Format''' The KUID format in TS2009 follows t...) |
m |
||
| Line 1: | Line 1: | ||
| − | + | A [[KUID]] is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. | |
| − | |||
| − | + | =KUID Format= | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
The breakdown of the KUID system is as follows: <KUID2:User_ID:Content_ID:Version_ID> | The breakdown of the KUID system is as follows: <KUID2:User_ID:Content_ID:Version_ID> | ||
| Line 15: | Line 10: | ||
<KUID2:171456:38001:1> | <KUID2:171456:38001:1> | ||
| − | |||
| − | + | ==User ID Number== | |
| − | + | The first number, ''171456'' in the above example, is the [[User ID]] of the content creator. | |
| − | + | When you register Trainz with the [https://www.auran.com/planetauran/login_f.php Planet Auran website], you are issued with your own [[User ID]]. After you enter your Planet Auran account details in the [[Content Manager]] settings, you will see this same [[User ID]] displayed. At no time should a content creator use a [[User ID]] other than the appropriate number assigned to them by Planet Auran. | |
| − | https://www.auran.com/planetauran/login_f.php | + | |
| − | Every member of the Trainz community who is a member of Planet Auran has a | + | Every member of the Trainz community who is a member of Planet Auran has a [[User ID]]. Now, you may be wondering why you need a [[User ID]] if you don't intend to make any content for Trainz. If you intend to make a layout (route or map) at some point in time and you'd like to share that layout with your friends or other community members, then you are in fact a content creator. |
| − | + | ==Content ID Number== | |
| − | The middle number is the | + | The middle number, ''38001'' in the above example, is the [[Content ID]]. |
| − | This is a number that the content creator assigns to each creation to uniquely identify it | + | This is a number that the content creator assigns to each creation to uniquely identify it. The combination of a creator's [[User ID]] and the [[Content ID]] form a unique asset identifier, to prevent conflict with assets created by others. |
| − | A | + | When creating a new asset using [[Content Manager]], an appropriate [[Content ID]] is generated automatically. [[Content Manager]] keeps track of all locally installed content and all content on the [[Download Station]] to ensure that no duplicate numbers are generated. A [[Content ID]] is also assigned automatically when you save a layout (map). |
| − | + | This number has no special meaning beyond helping to form a unique identifier for the asset. Historically, some users have attempted to organize content into different types by sorting on the [[Content ID]]. This is not recommended and Auran does not provide support for this workflow. | |
| − | + | ==Asset Version Number== | |
| − | + | ||
| + | The third number, ''1'' in the example above, is the [[Asset Version Number]]. | ||
| − | + | Should this asset require revisions after release to the [[Download Station]], the [[Asset Version Number]] for each subsequent revision may be updated as follows: | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | Should this asset require revisions after release to the | + | |
First revision <KUID2:xxx:yyyyy:1> | First revision <KUID2:xxx:yyyyy:1> | ||
| Line 52: | Line 41: | ||
Third revision <KUID2:xxx:yyyyy:3> Etc. | Third revision <KUID2:xxx:yyyyy:3> Etc. | ||
| − | The maximum version number is 127. | + | The maximum version number is 127. If the maximum version number should be reached, a new [[Content ID]] must be allocated for the asset, and the previous one needs to be added to the obsolete-table. |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | To make a new version asset, right click on the asset in [[Content Manager]] and select "Create New Version". The asset will be duplicated and the [[Asset Version Number]] will be updated in the new copy. | |
| − | + | ||
| − | |||
| − | + | =Important Notes= | |
| − | + | 1. <KUID2:xxx:yyyyy:0> is exactly equal to <KUID:xxx:yyyyy> in the old KUID format. These will be read as duplicates should they be used simultaneously. | |
| − | + | 2. Similarly, <KUID2:xxx:yyyyy:1> acts as a KUID2 format obsoletion of <KUID:xxx:yyyyy>. | |
| − | + | 3. Using the zero, "0" as the first version is acceptable, however the display on the Download Station, and the installed file will be in the KUID format, without the KUID2 format display. It is recommended that you start the numbering at one, "1" if this is a problem to you. | |
| − | + | 4. The Download Station displays a History of obsoleted models. If an obsoleted model has never been placed on the Download Station, do not include it in your obsolete table, it will result in a History error notification when you try to upload the asset. | |
| − | + | 5. While you may use leading zeros in the KUID system, a version "02" will be the same as "002" or "2", and the zeros will be truncated. It is recommended not to use any leading zeros. | |
| − | + | An asset placed in your map will display (show as) the latest installed version. When retrieving an asset from the [[Download Station]], the newest version will be automatically provided, and the Download Station will display a History tag for the model versions. | |
Revision as of 21:22, 3 March 2010
A KUID is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code.
Contents |
KUID Format
The breakdown of the KUID system is as follows: <KUID2:User_ID:Content_ID:Version_ID>
An example of a Kuid number with actual figures:
<KUID2:171456:38001:1>
User ID Number
The first number, 171456 in the above example, is the User ID of the content creator.
When you register Trainz with the Planet Auran website, you are issued with your own User ID. After you enter your Planet Auran account details in the Content Manager settings, you will see this same User ID displayed. At no time should a content creator use a User ID other than the appropriate number assigned to them by Planet Auran.
Every member of the Trainz community who is a member of Planet Auran has a User ID. Now, you may be wondering why you need a User ID if you don't intend to make any content for Trainz. If you intend to make a layout (route or map) at some point in time and you'd like to share that layout with your friends or other community members, then you are in fact a content creator.
Content ID Number
The middle number, 38001 in the above example, is the Content ID.
This is a number that the content creator assigns to each creation to uniquely identify it. The combination of a creator's User ID and the Content ID form a unique asset identifier, to prevent conflict with assets created by others.
When creating a new asset using Content Manager, an appropriate Content ID is generated automatically. Content Manager keeps track of all locally installed content and all content on the Download Station to ensure that no duplicate numbers are generated. A Content ID is also assigned automatically when you save a layout (map).
This number has no special meaning beyond helping to form a unique identifier for the asset. Historically, some users have attempted to organize content into different types by sorting on the Content ID. This is not recommended and Auran does not provide support for this workflow.
Asset Version Number
The third number, 1 in the example above, is the Asset Version Number.
Should this asset require revisions after release to the Download Station, the Asset Version Number for each subsequent revision may be updated as follows:
First revision <KUID2:xxx:yyyyy:1> Second revision <KUID2:xxx:yyyyy:2> Third revision <KUID2:xxx:yyyyy:3> Etc.
The maximum version number is 127. If the maximum version number should be reached, a new Content ID must be allocated for the asset, and the previous one needs to be added to the obsolete-table.
To make a new version asset, right click on the asset in Content Manager and select "Create New Version". The asset will be duplicated and the Asset Version Number will be updated in the new copy.
Important Notes
1. <KUID2:xxx:yyyyy:0> is exactly equal to <KUID:xxx:yyyyy> in the old KUID format. These will be read as duplicates should they be used simultaneously.
2. Similarly, <KUID2:xxx:yyyyy:1> acts as a KUID2 format obsoletion of <KUID:xxx:yyyyy>.
3. Using the zero, "0" as the first version is acceptable, however the display on the Download Station, and the installed file will be in the KUID format, without the KUID2 format display. It is recommended that you start the numbering at one, "1" if this is a problem to you.
4. The Download Station displays a History of obsoleted models. If an obsoleted model has never been placed on the Download Station, do not include it in your obsolete table, it will result in a History error notification when you try to upload the asset.
5. While you may use leading zeros in the KUID system, a version "02" will be the same as "002" or "2", and the zeros will be truncated. It is recommended not to use any leading zeros.
An asset placed in your map will display (show as) the latest installed version. When retrieving an asset from the Download Station, the newest version will be automatically provided, and the Download Station will display a History tag for the model versions.
