HowTo/Build Passenger Enabled Assets - Revision history

Frogpipe: Removed link to vinnybarb's site due to it being abandoned and subsequently taken over by a porn site. vinnybarb.com was not copied by the Internet Archive.

2023-01-03T17:39:23Z

Removed link to vinnybarb's site due to it being abandoned and subsequently taken over by a porn site. vinnybarb.com was not copied by the Internet Archive.

← Older revision		Revision as of 17:39, 3 January 2023
Line 270:		Line 270:

	The original TRS2004 package is no longer available for download from [[N3V Games]]. A number of us still have this package and you can get it by requesting on the forum.		The original TRS2004 package is no longer available for download from [[N3V Games]]. A number of us still have this package and you can get it by requesting on the forum.

	~~At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]~~


Line 290:		Line 288:
	;gmax_files/		;gmax_files/
	:The gmax source files for the assets in this tutorial.		:The gmax source files for the assets in this tutorial.


	==Return to Index==		==Return to Index==

Tonyhilliam at 23:05, 16 January 2018

2018-01-16T23:05:27Z

← Older revision		Revision as of 23:05, 16 January 2018
Line 10:		Line 10:
	;Note:		;Note:
	This tutorials does not cover how to create people assets for use as passengers. It uses the existing people provided with the simulator.		This tutorials does not cover how to create people assets for use as passengers. It uses the existing people provided with the simulator.


	===Passenger Station Asset===		===Passenger Station Asset===
Line 30:		Line 29:

	[[Image:Station_Asset_Mesh19812.jpg]]		[[Image:Station_Asset_Mesh19812.jpg]]


	====Config.txt file====		====Config.txt file====
Line 39:		Line 37:
	username "Station Basic Example"		username "Station Basic Example"
	:This provides the human-readable name of the station. You may also provide translated usernames in the usual fashion.		:This provides the human-readable name of the station. You may also provide translated usernames in the usual fashion.


	kind "industry"		kind "industry"
	:We are describing an Industry asset.		:We are describing an Industry asset.


	kuid <kuid:-18:10236>		kuid <kuid:-18:10236>
	:The KUID of this particular station asset; provide one in your own KUID range.		:The KUID of this particular station asset; provide one in your own KUID range.


	icon-texture "icon_brickstation.tga"		icon-texture "icon_brickstation.tga"
	:An icon for this station asset, used for the 'Drive To' command and similar. This is a 64x64 texture with no alpha channel.		:An icon for this station asset, used for the 'Drive To' command and similar. This is a 64x64 texture with no alpha channel.


	script "Station"		script "Station"
	class "Station"		class "Station"
	:The script file for this asset is "Station.gs", and contains a class named "Station".		:The script file for this asset is "Station.gs", and contains a class named "Station".


	kuid-table {		kuid-table {
Line 62:		Line 55:
	}		}
	:You must reference the passenger asset from your kuid-table, it is required for the passenger station script. As mentioned earlier, this tutorial doesn’t cover the creation of passenger characters.		:You must reference the passenger asset from your kuid-table, it is required for the passenger station script. As mentioned earlier, this tutorial doesn’t cover the creation of passenger characters.


	mesh-table {		mesh-table {
Line 71:		Line 63:
	}		}
	:There is a single mesh file for this asset, which contains both the geometry for the station and also the attachment points which are described throughout this document.		:There is a single mesh file for this asset, which contains both the geometry for the station and also the attachment points which are described throughout this document.


	attached-track {		attached-track {
Line 84:		Line 75:
	}		}
	:A single section of track (which can be comprised of multiple vertices) must be specified for each platform. The passenger station script will reference this track.		:A single section of track (which can be comprised of multiple vertices) must be specified for each platform. The passenger station script will reference this track.


	attached-trigger {		attached-trigger {
Line 94:		Line 84:
	}		}
	:Triggers should be specified as appropriate to fill the above requirements. The passenger station script will reference these triggers.		:Triggers should be specified as appropriate to fill the above requirements. The passenger station script will reference these triggers.


	queues {		queues {
Line 121:		Line 110:

	:It is normal that attachment points in the “on” queue are oriented to face the passengers towards the platform track, whereas attachment points in the “off” queue are oriented to face the passengers away from the platform track. See the Industry section of the CCG for more information regarding Queues.		:It is normal that attachment points in the “on” queue are oriented to face the passengers towards the platform track, whereas attachment points in the “off” queue are oriented to face the passengers away from the platform track. See the Industry section of the CCG for more information regarding Queues.


	processes {		processes {
Line 156:		Line 144:

	:The full config.txt updated to TS12 for this station asset is [[HowTo/Example_Station_Config.txt\|HERE]]		:The full config.txt updated to TS12 for this station asset is [[HowTo/Example_Station_Config.txt\|HERE]]



Line 162:		Line 149:

	The station’s script derives from the GenericPassengerStation class. The complete functionality of a passenger station is already implemented for you in this class, the functions that you provide simply describe your station’s specific configuration. The following functions must be provided by you:		The station’s script derives from the GenericPassengerStation class. The complete functionality of a passenger station is already implemented for you in this class, the functions that you provide simply describe your station’s specific configuration. The following functions must be provided by you:


	bool TriggerSupportsMassStoppedLoad(Vehicle vehicle, string triggerName)		bool TriggerSupportsMassStoppedLoad(Vehicle vehicle, string triggerName)
Line 178:		Line 164:
	public void AppendDriverDestinations(string[] destNames, string[] destTracks)		public void AppendDriverDestinations(string[] destNames, string[] destTracks)
	:This is the normal industry function for providing ‘Drive To’ destination tracks. This should look up the string table and return the mappings between platform tracks and human-readable names.		:This is the normal industry function for providing ‘Drive To’ destination tracks. This should look up the string table and return the mappings between platform tracks and human-readable names.


	:The full TS12 "Station.gs" script for this station asset is [[HowTo/Example_Station_Script\|HERE]]		:The full TS12 "Station.gs" script for this station asset is [[HowTo/Example_Station_Script\|HERE]]
Line 186:		Line 171:
	Passenger vehicles are not much different from normal Trainz vehicles that support loads. The only difference is that the guidelines for a passenger vehicle can be a bit more strict than usual.		Passenger vehicles are not much different from normal Trainz vehicles that support loads. The only difference is that the guidelines for a passenger vehicle can be a bit more strict than usual.
	The only totally essential requirement to make a vehicle work with passengers is a passenger product queue. Things like transparent windows so you can see the passengers and door animations are optional, but certainly nice extras that make for a more interesting passenger experience.		The only totally essential requirement to make a vehicle work with passengers is a passenger product queue. Things like transparent windows so you can see the passengers and door animations are optional, but certainly nice extras that make for a more interesting passenger experience.


	====Config.txt file====		====Config.txt file====

	The most important tags required for a passenger vehicle’s config.txt are listed and discussed here. Note that although this section does cover some non-passenger specific tags as well as everything essential for passenger support, many common tags that are not specific to passengers will not be described.		The most important tags required for a passenger vehicle’s config.txt are listed and discussed here. Note that although this section does cover some non-passenger specific tags as well as everything essential for passenger support, many common tags that are not specific to passengers will not be described.


	kind "traincar"		kind "traincar"
	:This is a vehicle asset and not much different from other vehicles, so use “traincar” as you would for any vehicle.		:This is a vehicle asset and not much different from other vehicles, so use “traincar” as you would for any vehicle.


	kuid <kuid:-3:10069>		kuid <kuid:-3:10069>
	:The KUID of this particular station asset; provide one in your own KUID range.		:The KUID of this particular station asset; provide one in your own KUID range.


	username "BR MK1 RMB"		username "BR MK1 RMB"
Line 311:		Line 292:


			==Return to Index==

	~~;Return to~~ [[HowToGuides]]		[[HowToGuides\|<< How To Guides]]


	[[Category:How-to guides]]		[[Category:How-to guides]]

Windwalkr at 09:26, 26 February 2013

2013-02-26T09:26:05Z

← Older revision		Revision as of 09:26, 26 February 2013
Line 288:		Line 288:
	===Example File Listings===		===Example File Listings===

	The original TRS2004 package is no longer available for download from N3V Games ~~(Auran)~~. A number of us still have this package and you can get it by requesting on the forum.		The original TRS2004 package is no longer available for download from [[N3V Games]]. A number of us still have this package and you can get it by requesting on the forum.

	At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]		At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]

Pev: quotes fixed. repeat-delay value amended

2012-09-20T02:14:51Z

quotes fixed. repeat-delay value amended

Show changes

Pev at 02:12, 19 August 2012

2012-08-19T02:12:18Z

← Older revision		Revision as of 02:12, 19 August 2012
Line 314:		Line 314:

	;Return to [[HowToGuides]]		;Return to [[HowToGuides]]


			[[Category:How-to guides]]

Pev at 00:23, 19 August 2012

2012-08-19T00:23:31Z

← Older revision		Revision as of 00:23, 19 August 2012
Line 288:		Line 288:
	===Example File Listings===		===Example File Listings===

	The original TRS2004 package is no longer ~~availabe~~ for download from N3V Games (Auran). A number of us still have this package and you can get it by requesting on the forum.		The original TRS2004 package is no longer available for download from N3V Games (Auran). A number of us still have this package and you can get it by requesting on the forum.

	At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]		At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]


	;The TRS2004 package contained the following example passenger assets:		;The TRS2004 package contained the following example passenger assets:
Line 312:		Line 313:


	Return to [[HowToGuides]]		;Return to [[HowToGuides]]

Pev: /* Passenger Station Asset */ image of mesh added

2012-08-19T00:17:13Z

Passenger Station Asset: image of mesh added

← Older revision		Revision as of 00:17, 19 August 2012
Line 26:		Line 26:

	The radius of each trigger is defined in the config file in metres.		The radius of each trigger is defined in the config file in metres.

			The mesh for this asset looks like:

			[[Image:Station_Asset_Mesh19812.jpg]]


Line 177:		Line 181:

	:The full TS12 "Station.gs" script for this station asset is [[HowTo/Example_Station_Script\|HERE]]		:The full TS12 "Station.gs" script for this station asset is [[HowTo/Example_Station_Script\|HERE]]




	===Passenger Vehicle Asset===		===Passenger Vehicle Asset===

Pev at 01:53, 16 August 2012

2012-08-16T01:53:54Z

← Older revision		Revision as of 01:53, 16 August 2012
Line 1:		Line 1:
	This is a transcription of a document by Auran created in 2004 to illustrate how to make stations and traincar vehicles support passengers. I have attempted to bring the information up-to-date. PEV.		This is a transcription of a document by Auran created in 2004 to illustrate how to make stations and traincar vehicles support passengers.

			I have attempted to bring the information up-to-date. PEV.


	==Passenger Station and Vehicle Assets Tutorial==		==Passenger Station and Vehicle Assets Tutorial==

	This tutorial provides a brief overview to an example passenger station and passenger vehicle that are compatible with the passenger features supported by Trainz. For content creators wanting to make their own vehicles and stations passenger compatible, all the basic information to get started as well as a link to ~~owdnload~~ functional example assets are provided.		This tutorial provides a brief overview to an example passenger station and passenger vehicle that are compatible with the passenger features supported by Trainz. For content creators wanting to make their own vehicles and stations passenger compatible, all the basic information to get started as well as a link to download functional example assets are provided.
	Note:
			;Note:
	This tutorials does not cover how to create people assets for use as passengers. It uses the existing people provided with the simulator.		This tutorials does not cover how to create people assets for use as passengers. It uses the existing people provided with the simulator.

Line 76:		Line 80:
	}		}
	:A single section of track (which can be comprised of multiple vertices) must be specified for each platform. The passenger station script will reference this track.		:A single section of track (which can be comprised of multiple vertices) must be specified for each platform. The passenger station script will reference this track.


	attached-trigger {		attached-trigger {
Line 138:		Line 143:

	:See the [[CCG/Kind:_Industry]] section of the CCG for more information regarding Processes.		:See the [[CCG/Kind:_Industry]] section of the CCG for more information regarding Processes.


	string-table {		string-table {
Line 170:		Line 176:


	:The full Station.gs script for ~~TS12 of~~ this station asset is [[HowTo/Example_Station_Script\|HERE]]		:The full TS12 "Station.gs" script for this station asset is [[HowTo/Example_Station_Script\|HERE]]


Line 200:		Line 206:
	mesh-table {		mesh-table {
	default {		default {
	mesh "mk1_rmb_br_bld_custd_body/mk1_rmb_br_bld_custd_body.lm"		mesh "mk1_rmb_br_bld_custd_body/mk1_rmb_br_bld_custd_body.lm"
	auto-create 1		auto-create 1
	}		}
	left-passenger-door {		left-passenger-door {
	mesh "mk1_rmb_br_bld_custd_body/left_door/left_door.im"		mesh "mk1_rmb_br_bld_custd_body/left_door/left_door.im"
	anim "mk1_rmb_br_bld_custd_body/left_door/left_door.kin"		anim "mk1_rmb_br_bld_custd_body/left_door/left_door.kin"
	auto-create 1		auto-create 1
	att "a.doors"		att "a.doors"
	att-parent "default"		att-parent "default"
	}		}
	right-passenger-door {		right-passenger-door {
Line 223:		Line 229:
	queues {		queues {
	passengers {		passengers {
	size 44		size 44
	initial-count 0		initial-count 0
	passenger-queue 1		passenger-queue 1
	product-kuid <kuid:-3:10060>		product-kuid <kuid:-3:10060>
	attachment-points {		attachment-points {
	0 "a.sitpoint5a"		0 "a.sitpoint5a"
	...		...
	62 "a.standpoint14"		62 "a.standpoint14"
	}		}
	}		}
Line 250:		Line 256:
	soundscript {		soundscript {
	door_open {		door_open {
	trigger "door_open"		trigger "door_open"
	nostartdelay 1		nostartdelay 1
	repeat-delay 1		repeat-delay 1
	distance 5,170		distance 5,170
	sound {		sound {
	start.wav		start.wav
Line 259:		Line 265:
	}		}
	door_close {		door_close {
	trigger "door_close"		trigger "door_close"
	...		...
	}		}

Pev at 01:38, 16 August 2012

2012-08-16T01:38:21Z

← Older revision		Revision as of 01:38, 16 August 2012
Line 282:		Line 282:

	The original TRS2004 package is no longer availabe for download from N3V Games (Auran). A number of us still have this package and you can get it by requesting on the forum.		The original TRS2004 package is no longer availabe for download from N3V Games (Auran). A number of us still have this package and you can get it by requesting on the forum.

	At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]		At the time of placing this page on this Wiki, Vinnybarb had this available [http://www.vinnybarb.com/zips/SP2-Passenger_Asset_Tutorial.zip HERE]

Pev: links to station script and vehicle config.txt pages added

2012-08-16T01:22:03Z

links to station script and vehicle config.txt pages added

← Older revision		Revision as of 01:22, 16 August 2012
Line 144:		Line 144:
	:A name must be provided for each platform track on the station; these will be used by your station script.		:A name must be provided for each platform track on the station; these will be used by your station script.

	:The full config.txt updated to TS12 for this asset is [[HowTo/Example_Station_Config.txt\|HERE]]
			:The full config.txt updated to TS12 for this station asset is [[HowTo/Example_Station_Config.txt\|HERE]]


Line 167:		Line 168:
	public void AppendDriverDestinations(string[] destNames, string[] destTracks)		public void AppendDriverDestinations(string[] destNames, string[] destTracks)
	:This is the normal industry function for providing ‘Drive To’ destination tracks. This should look up the string table and return the mappings between platform tracks and human-readable names.		:This is the normal industry function for providing ‘Drive To’ destination tracks. This should look up the string table and return the mappings between platform tracks and human-readable names.


			:The full Station.gs script for TS12 of this station asset is [[HowTo/Example_Station_Script\|HERE]]


Line 262:		Line 266:
	door animations. This doesn’t relate directly to passenger station functionality and is simply a case of the		door animations. This doesn’t relate directly to passenger station functionality and is simply a case of the
	animation triggering a sound for the “door_close” and “door_open” events.		animation triggering a sound for the “door_close” and “door_open” events.


			:The full config.txt updated to TS12 for this vehicle asset is [[HowTo/Example_Vehicle_Config.txt\|HERE]]