Dundun92: /* Document Structure */

2025-12-15T00:12:34Z

Document Structure

← Older revision		Revision as of 00:12, 15 December 2025
Line 3:		Line 3:
	= Document Structure =		= Document Structure =
	<table width=1200>		<table width=1200>
	The WagonX Tutorial set is written over several TrainzWiKi pages. This page is an introduction to WagonX and its ~~capabilties~~. Other pages in the series are:		The WagonX Tutorial set is written over several TrainzWiKi pages. This page is an introduction to WagonX and its capabilities, designed and developed by Joseph Bennett (dundun92). Other pages in the series are:
	</table>		</table>
	# [[HowTo/WagonX - Technical Reference]]<br>		# [[HowTo/WagonX - Technical Reference]]<br>

Dundun92: /* Config.txt - first steps */

2024-07-07T19:52:50Z

Config.txt - first steps

← Older revision		Revision as of 19:52, 7 July 2024
Line 189:		Line 189:
	{		{
	animated 1		animated 1
	use-jbv-animation 1		use-jbv-animation 0
	duration 1.5		duration 1.5
	}		}
	misc		misc
	{		{
	begin-load-time 15		begin-load-time 5
	begin-unload-time 5		begin-unload-time 5
	end-load-time 1		end-load-time 1

Dundun92 at 04:29, 7 January 2024

2024-01-07T04:29:46Z

← Older revision		Revision as of 04:29, 7 January 2024
Line 1:		Line 1:
	<!--the next line is the page title-->		<!--the next line is the page title-->
	<!--HowTo/Use the WagonX Library-->		<!--HowTo/Use the WagonX Library-->
	~~<span style="color: red; font-weight: 700; font-size: 30px;">Draft Only</span>~~
	= Document Structure =		= Document Structure =
	<table width=1200>		<table width=1200>

Dundun92: /* Config.txt - first steps */

2024-01-07T04:29:08Z

Config.txt - first steps

← Older revision		Revision as of 04:29, 7 January 2024
Line 143:		Line 143:
	=== Config.txt - first steps ===		=== Config.txt - first steps ===
	<table width=1200>		<table width=1200>
	<td>Let's start with the basic tags needed to make WagonX work. You will need to include script and class tags, a script-include-table, and a kuid-table reference if you are using ACSLib to control couplers and coupled hoses. <b>The spelling and capitisation of the class name is important.</b> The config entries should look like this:		<td>Let's start with the basic tags needed to make WagonX work. You will need to include script and class tags, a script-include-table, and a kuid-table reference if you are using ACSLib to control couplers and coupled hoses. <b>The spelling and capitisation of the class name is important.</b> <span style="color: red; font-weight: 700;">Do not reference an iteration of the kiud, only exactly as the one shown below, as this will prevent your asset from receiving updates and bug fixes for compatibility in future trainz versions.</span>

			The config entries should look like this:
	</td>		</td>
	</table>		</table>

Pcas1986 at 05:13, 27 September 2023

2023-09-27T05:13:04Z

← Older revision		Revision as of 05:13, 27 September 2023
Line 6:		Line 6:
	The WagonX Tutorial set is written over several TrainzWiKi pages. This page is an introduction to WagonX and its capabilties. Other pages in the series are:		The WagonX Tutorial set is written over several TrainzWiKi pages. This page is an introduction to WagonX and its capabilties. Other pages in the series are:
	</table>		</table>
	# [[HowTo/WagonX - Reference]]<br>		# [[HowTo/WagonX - Technical Reference]]<br>
	# [[HowTo/WagonX - Browser Properties Examples and Basic Tutorials]]<br>		# [[HowTo/WagonX - Browser Properties Examples and Basic Tutorials]]<br>
	# [[HowTo/WagonX - Traincar Tutorial]]<br>		# [[HowTo/WagonX - Traincar Tutorial]]<br>

Pcas1986: Draft version - checking for links,etc.

2023-09-27T04:52:45Z

Draft version - checking for links,etc.

New page

<span style="color: red; font-weight: 700; font-size: 30px;">Draft Only</span>
= Document Structure =
<table width=1200>
The WagonX Tutorial set is written over several TrainzWiKi pages. This page is an introduction to WagonX and its capabilties. Other pages in the series are:
</table>
# [[HowTo/WagonX - Reference]]<br>
# [[HowTo/WagonX - Browser Properties Examples and Basic Tutorials]]<br>
# [[HowTo/WagonX - Traincar Tutorial]]<br>
# [[HowTo/WagonX - Locomotive Tutorial]]<br>
<br>

__TOC__

= Introduction =
== A discussion about "properties" ==
<table width=1200>
<tr valign="top">
<td>So what is a "property" and what is its purpose in Trainz?
A Google search will reveal that a property in this context is a value or attribute of an object. In Trainz we generally call such objects <b>assets</b>. An example might be a traincar (wagon/car/carriage) and that traincar has some standard properties such as weight, cargo or passengers.

But the standard properties are rather limited and, if a content creator wanted to add extra properties such as texture replacement, then a Trainz script is required. Creating such scripts is not easy even for experienced programmers. Maintaining scripts can create a huge amount of work if common scripts are replicated across many assets.

This is where WagonX can help.
</td>
</tr>
</table>
<br>
== WagonX and Properties ==
<table width=1200>
<tr valign="top">
<td>WagonX is a universal script library that simplifies adding properties and scripted features to your traincar assets.
You can create an asset with all the perks of scripted assets without touching any TrainzScript (GS) files, or having much knowledge of trainzscript. You can set up a number of asset options, as identified in the following list, in the config.txt file. All the details are then automatically presented to the user in the View Details (property browser) dialog, making it easy to edit as needed.
</td>
</tr>
</table>
<br>
== The WagonX Asset ==
<table width=1200>
<tr valign="top">
<td>
*The '''JBV WagonX Script Library - <kuid:661805:500008>''' is available on the Download Station.
*It is suitable for asset with Trainz Builds 5.0 or higher. The library uses script functions only available from that version.
</td>
</tr>
</table>
<br>

<table>
<tr valign="top">
<td>
<table width=1200 bgcolor=#000000 cellpadding=1>
<tr valign="top">
<td>
<table width=1196 bgcolor=#ffffff cellpadding=2>
<tr valign="top">
<td>The '''The WagonX Library''' can be used to set:-
<table>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''animations''' - stop or start</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''texture replacements''' - loaded from a textures library asset</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''head codes''' - for UK vehicles</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''lamps''' - for UK vehicles</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''ACS controlled couplers and hoses''' - loaded from a suitable couplers/hoses mesh library</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''sounds'''</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''PFX effects''' - such as smoke or dust</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''triggered effects'''</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''consist synchronisation''' - such as texture swapping for vehicles also using WagonX in a consist</td>
</tr>
<tr valign="top">
<td>[[image:DotPoint.JPG|10px|link=]]</td>
<td>'''...and much more.'''</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
</table>
<br>
<table width=1200>
<td>
This picture demonstrates entries in the config and the result in the Properties Browser in game. The asset is the library author's Prestwin 1/277 EXP (<kuid2:661805:1:1>).
</td>
</table>
<table width=1500>
<tr valign="center">
<td>
[[File:WagonX Documentation2.jpg|left]]
</td>
</tr>
</table>

= Implementation =
== Basic configuration for the config.txt and asset script ==
=== Background ===
<table width=1200>
<td>
The library implementation for WagonX is a bit different from other library assets (such as Bloodnoks ACS lib or superscript) and utilizes a new script referencing technique from David Pistelak’s scripted assets. The traincar’s config.txt does not directly reference the wagon.gs file. It instead must reference a (mostly) blank gs file that will hold the information for the WagonX gs file. In this case, this special file is named ref.gs and the class to used is eRef.
</td>
</table>

=== The asset script ===
<table width=1200>
<td>You will need to create a Trainzscript file called "ref.gs" and include it with your asset files. <b>Do not add any other code to ref.gs as future updates to the WagonX library may break your asset.</b> The content of ref.gs should be:
</td>
</table>

include "WagonX.gs"
class eRef isclass WagonX{};

=== Config.txt - first steps ===
<table width=1200>
<td>Let's start with the basic tags needed to make WagonX work. You will need to include script and class tags, a script-include-table, and a kuid-table reference if you are using ACSLib to control couplers and coupled hoses. <b>The spelling and capitisation of the class name is important.</b> The config entries should look like this:
</td>
</table>


script-include-table
{
0 <kuid:661805:500008>
}
script "ref.gs"
class "eRef"
kuid-table
{
acslib <kuid2:60850:89100>
}

<table width=1200>
<td>That's it for the initial referencing of the script into your asset. The rest of the information for the script library goes inside the extensions container, under a sub-container that must be named “wagon-x”, all of which will be explained in the next sections. The following is a general example of how an extensions container using ACS and WagonX might appear. It may not be suitable for your application.
</td>
</table>

extensions
{
max_permitted_speed-60850 "50mph"
active-coupling-standard-60850
{
version-major "2"
version-minor "0"
brakes "vac"
front
{
coupler "instanter|hook"
vacbrake "twin"
}
back
{
coupler "instanter|hook"
vacbrake "twin"
}
}
wagon-x
{
acs
{
animated 1
use-jbv-animation 1
duration 1.5
}
misc
{
begin-load-time 15
begin-unload-time 5
end-load-time 1
end-unload-time 1
}
marker-lights
{
enabled 1
car-minimum-count 1
require-locomotive 1
front
{
head
{
mesh "null"
}
tail
{
mesh "lamp-front-red"
}
}
back
{
head
{
mesh "lamp-back-white"
}
tail
{
mesh "lamp-back-red"
}
}
}
browser-properties
{
0
{
enabled 1
property-visibility 1
name "Skin: "
property-id "p_skin"
description "Sets the weathering type"
kind "fx-replacement"
fx-replacement-type "texture-replacement"
meshes "null"
effects "texture-albedo,texture-parameter"
asset "texturelib"
files-path "null"
values "0;3,1;4,2;5"
default-index -1
trigger "user"
display-type "link"
display-values "Clean,Weathered,Dirty"
}
1
{
enabled 1
property-visibility 0
name "Handbrake State: "
property-id "p_handbrake"
description "Toggle the handbrake"
kind "mesh-attachment"
mesh-attachment-type "mesh-animation-frame"
meshes "handbrake-lever,braking-system"
values "0;0,30;30"
events "handbrake-release,handbrake-apply"
duration 3.2
default-index 0
trigger "both"
display-type "link"
display-values "release,apply"
}
}
}
}
<br>

= Next Steps =
<table width=1200>
<td>This page has been a basic introduction to WagonX. Some basic tutorials to setup some WagonX properties can be found at the [[HowTo/WagonX - Browser Properties Examples and Basic Tutorials|<span style="color: #0080ff">Basic Tutorials</span>]] page.<br>
You can find a locomotive tutorial at the [[HowTo/WagonX - Locomotive Tutorial|<span style="color: #0080ff">Locomotive Tutorial</span>]] page and a traincar tutorial at the [[HowTo/WagonX - Traincar Tutorial|<span style="color: #0080ff">Traincar Tutorial</span>]] page.<br>
These tutorials are supported by a detailed WagonX reference at the [[HowTo/WagonX - Reference|<span style="color: #0080ff">WagonX Reference</span>]] page.
</td>
</table>

<table width=1200>
=Copyright Notice=
Much of the content on this page and child pages was derived from Dundun92's original Google Docs document. Permission was granted to use that information here.
</table>

HowTo/Use the WagonX Library - Revision history

Dundun92: /* Document Structure */

Dundun92: /* Config.txt - first steps */

Dundun92 at 04:29, 7 January 2024

Dundun92: /* Config.txt - first steps */

Pcas1986 at 05:13, 27 September 2023

Pcas1986: Draft version - checking for links,etc.