KUID - Revision history

Pw3r: /* Important Notes */

2024-07-30T06:53:43Z

Important Notes

← Older revision		Revision as of 06:53, 30 July 2024
Line 99:		Line 99:
	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.		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~~.		4. 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.

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

	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.
	{{FUN-bot}}		{{FUN-bot}}
	[[Category:Trainz Wiki]]		[[Category:Trainz Wiki]]
	[[category:Trainz reference pages]]		[[category:Trainz reference pages]]

Pw3r: /* User ID Number */

2024-07-30T06:52:28Z

User ID Number

← Older revision		Revision as of 06:52, 30 July 2024
Line 59:		Line 59:
	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.		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.

	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~~. Even Auran/N3V Games has a user ID, though the exact content creator may be an internal secret. These in many versions, especially in older content will show up with a negative User ID in the Kuid~~.		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==		==Content ID Number==

Pw3r: /* KUID identifiers */

2024-07-30T04:04:50Z

KUID identifiers

← Older revision		Revision as of 04:04, 30 July 2024
Line 1:		Line 1:
	{{FUN-beg}}{{TOCright}}		{{FUN-beg}}{{TOCright}}
	==KUID identifiers==		==KUID identifiers==
	A '''KUID'' is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. Typically, these identifiers are created and used internally by Trainz, so understanding the exact format is not necessary for most users - copy and paste is about all that is required. Full details are provided here for interested parties.		A '''KUID''' is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. Typically, these identifiers are created and used internally by Trainz, so understanding the exact format is not necessary for most users - copy and paste is about all that is required. Full details are provided here for interested parties.


	==KUID Format==		==KUID Format==

Fabartus: /* User ID Number */ Auran/N3V's

2013-07-26T00:11:05Z

User ID Number: Auran/N3V's

← Older revision		Revision as of 00:11, 26 July 2013
Line 60:		Line 60:
	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.		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.

	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.		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. Even Auran/N3V Games has a user ID, though the exact content creator may be an internal secret. These in many versions, especially in older content will show up with a negative User ID in the Kuid.


	==Content ID Number==		==Content ID Number==

Fabartus: fmt, cats

2013-07-16T09:04:16Z

fmt, cats

← Older revision		Revision as of 09:04, 16 July 2013
Line 1:		Line 1:
	A [[KUID]] is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. Typically, these identifiers are created and used internally by Trainz, so understanding the exact format is not necessary for most users - copy and paste is about all that is required. Full details are provided here for interested parties.		{{FUN-beg}}{{TOCright}}
			==KUID identifiers==
			A '''KUID'' is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. Typically, these identifiers are created and used internally by Trainz, so understanding the exact format is not necessary for most users - copy and paste is about all that is required. Full details are provided here for interested parties.


	=KUID Format=		==KUID Format==
	~~[[KUID]]s~~ are strings comprised of several value fields, separated by colons (':') and surrounded by angle braces. The first field denotes the encoding format used. There are two encoding formats in common use at the current time, however this may be extended in the future. In a given encoding, each value field has a specific meaning and cannot accept arbitrary text. Fields cannot be arbitrarily added or removed.		'''KUIDs''' are strings comprised of several value fields, separated by colons (':') and surrounded by angle braces. The first field denotes the encoding format used. There are two encoding formats in common use at the current time, however this may be extended in the future. In a given encoding, each value field has a specific meaning and cannot accept arbitrary text. Fields cannot be arbitrarily added or removed.


Line 104:		Line 106:

	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.		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.
			{{FUN-bot}}
			[[Category:Trainz Wiki]]
			[[category:Trainz reference pages]]

Windwalkr at 02:02, 18 October 2010

2010-10-18T02:02:38Z

← Older revision		Revision as of 02:02, 18 October 2010
Line 77:		Line 77:
	:<KUID2:171456:38001:'''1'''>		:<KUID2:171456:38001:'''1'''>

	The third number, ''1'' in the example above, is the [[KUID Version Number]].		The third number, ''1'' in the example above, is the ''KUID Version Number''.

	Should this asset require revisions after release to the [[Download Station]], the [[KUID Version Number]] for each subsequent revision may be updated as follows:		Should this asset require revisions after release to the [[Download Station]], the ''KUID Version Number'' for each subsequent revision may be updated as follows:

	First revision <KUID2:xxx:yyyyy:1>		First revision <KUID2:xxx:yyyyy:1>
Line 87:		Line 87:
	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.		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 [[KUID Version Number]] will be updated in the new copy.		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 ''KUID Version Number'' will be updated in the new copy.

Windwalkr at 02:01, 18 October 2010

2010-10-18T02:01:31Z

← Older revision		Revision as of 02:01, 18 October 2010
Line 13:		Line 13:
	This example KUID can be parsed as into following values:		This example KUID can be parsed as into following values:
	:''KUID'' - The encoding format of this KUID.		:''KUID'' - The encoding format of this KUID.
	:''171456'' - The [[User ID]] of this KUID.		:''171456'' - The [[KUID#User ID Number\|User ID]] of this KUID.
	:''38001'' - The [[Content ID]] of this KUID.		:''38001'' - The [[KUID#Content ID Number\|Content ID]] of this KUID.


Line 24:		Line 24:
	This example KUID can be parsed as into following values:		This example KUID can be parsed as into following values:
	:''KUID2'' - The encoding format of this KUID.		:''KUID2'' - The encoding format of this KUID.
	:''171456'' - The [[User ID]] of this KUID.		:''171456'' - The [[KUID#User ID Number\|User ID]] of this KUID.
	:''38001'' - The [[Content ID]] of this KUID.		:''38001'' - The [[KUID#Content ID Number\|Content ID]] of this KUID.
	:''1'' - The [[KUID Version Number]] of this KUID.		:''1'' - The [[KUID#KUID Version Number\|KUID Version Number]] of this KUID.


Line 42:		Line 42:
	\|<KUID:123:456:1>\|\|KUID encoding does not support a version field.		\|<KUID:123:456:1>\|\|KUID encoding does not support a version field.
	\|-		\|-
	\|<KUID:123:-4>\|\|[[Content ID]] field does not support negative numbers.		\|<KUID:123:-4>\|\|[[KUID#Content ID Number\|Content ID]] field does not support negative numbers.
	\|-		\|-
	\|123:456\|\|Missing surrounding braces and encoding format field.		\|123:456\|\|Missing surrounding braces and encoding format field.
Line 54:		Line 54:
	:<KUID2:'''171456''':38001:1>		:<KUID2:'''171456''':38001:1>

	The first number, ''171456'' in the above example, is the [[User ID]] of the content creator.		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.		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.

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


Line 65:		Line 65:
	:<KUID2:171456:'''38001''':1>		:<KUID2:171456:'''38001''':1>

	The middle number, ''38001'' in the above example, is the [[Content ID]].		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. The number must be a positive integer in the range (1 <= id <= 2147483648).		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. The number must be a positive integer in the range (1 <= id <= 2147483648).

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

	==KUID Version Number==		==KUID Version Number==
Line 85:		Line 85:
	Third revision <KUID2:xxx:yyyyy:3> Etc.		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.		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 [[KUID Version Number]] will be updated in the new copy.		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 [[KUID Version Number]] will be updated in the new copy.

Windwalkr at 14:44, 17 October 2010

2010-10-17T14:44:45Z

← Older revision		Revision as of 14:44, 17 October 2010
Line 50:		Line 50:


	=User ID Number=		==User ID Number==

	:<KUID2:'''171456''':38001:1>		:<KUID2:'''171456''':38001:1>

Windwalkr: /* Content ID Number */

2010-03-03T11:57:02Z

Content ID Number

← Older revision		Revision as of 11:57, 3 March 2010
Line 67:		Line 67:
	The middle number, ''38001'' in the above example, is the [[Content ID]].		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.		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. The number must be a positive integer in the range (1 <= id <= 2147483648).

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


	==KUID Version Number==		==KUID Version Number==

Windwalkr at 11:55, 3 March 2010

2010-03-03T11:55:34Z

← Older revision		Revision as of 11:55, 3 March 2010
Line 1:		Line 1:
	A [[KUID]] is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code.		A [[KUID]] is an identifier uniquely allocated to each item of content created for Trainz, similar to a bar code. Typically, these identifiers are created and used internally by Trainz, so understanding the exact format is not necessary for most users - copy and paste is about all that is required. Full details are provided here for interested parties.


	=KUID Format=		=KUID Format=
			[[KUID]]s are strings comprised of several value fields, separated by colons (':') and surrounded by angle braces. The first field denotes the encoding format used. There are two encoding formats in common use at the current time, however this may be extended in the future. In a given encoding, each value field has a specific meaning and cannot accept arbitrary text. Fields cannot be arbitrarily added or removed.

	~~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~~:		==KUID Encoding==
			The first encoding format is simply "KUID". The overall format string follows this field breakdown: '''<KUID:'''User ID''':'''Content ID'''>'''

	<~~KUID2~~:171456:38001:1>		An example of a KUID using this encoding is as follows: <KUID:171456:38001>

			This example KUID can be parsed as into following values:
			:''KUID'' - The encoding format of this KUID.
			:''171456'' - The [[User ID]] of this KUID.
			:''38001'' - The [[Content ID]] of this KUID.

	==User ID Number==
			==KUID2 Encoding==
			The second encoding format is "KUID2". The overall format string follows this field breakdown: '''<KUID2:'''User ID''':'''Content ID''':'''Version Number'''>'''

			An example of a KUID using this encoding is as follows: <KUID2:171456:38001:1>

			This example KUID can be parsed as into following values:
			:''KUID2'' - The encoding format of this KUID.
			:''171456'' - The [[User ID]] of this KUID.
			:''38001'' - The [[Content ID]] of this KUID.
			:''1'' - The [[KUID Version Number]] of this KUID.


			==Invalid Encodings==
			Any KUID encoding which does not match this specification is considered invalid. In the strictest sense, any invalid encoding is not a KUID. For legacy compatibility reasons, some components of the Trainz environment will attempt to parse a incorrectly encoded KUID however this is considered unreliable any may be removed in the future.

			Examples of invalid encodings are as follows:
			{\| border="1" cellspacing="0" cellpadding="2"
			\|'''Example Invalid Encoding'''\|\|'''Explanation'''
			\|-
			\|KUID:123:456\|\|Missing surrounding braces.
			\|-
			\|<KUID2:123:456>\|\|KUID2 encoding requires a version field.
			\|-
			\|<KUID:123:456:1>\|\|KUID encoding does not support a version field.
			\|-
			\|<KUID:123:-4>\|\|[[Content ID]] field does not support negative numbers.
			\|-
			\|123:456\|\|Missing surrounding braces and encoding format field.
			\|-
			\|<123:456>\|\|Missing encoding format field.
			\|}


			=User ID Number=

			:<KUID2:'''171456''':38001:1>

	The first number, ''171456'' in the above example, is the [[User ID]] of the content creator.		The first number, ''171456'' in the above example, is the [[User ID]] of the content creator.
Line 21:		Line 62:

	==Content ID Number==		==Content ID Number==

			:<KUID2:171456:'''38001''':1>

	The middle number, ''38001'' in the above example, is the [[Content ID]].		The middle number, ''38001'' in the above example, is the [[Content ID]].
Line 31:		Line 74:


	==~~Asset~~ Version Number==		==KUID Version Number==

			:<KUID2:171456:38001:'''1'''>

	The third number, ''1'' in the example above, is the [[~~Asset~~ Version Number]].		The third number, ''1'' in the example above, is the [[KUID 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 [[Download Station]], the [[KUID Version Number]] for each subsequent revision may be updated as follows:

	First revision <KUID2:xxx:yyyyy:1>		First revision <KUID2:xxx:yyyyy:1>
Line 43:		Line 88:
	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.		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.		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 [[KUID Version Number]] will be updated in the new copy.