View source for HowTo/Your first Trainz Script

Scripting is one of most powerful tools when creating trainz assets.
More and more content creators are using scripts to extend the funciontallity of their contents,
so scripters, like me, get a lot of request for script work.
Finally, I thought, even for small functionallity, it'll be a good idea, if more people know how to script.

I'm from germany and this is my first article here, so feel free to send corrections or if you have the permission,
feel free to correct this article on your own!

First, let us take a theoretical approach:

Trainz Script is a small programming language and has many similar aspects to Java or C++. I'll say it's a kind of a Framework,
that allows us to implement new features based on built-in classes and their members.
That means we have to assign our assets to a script class. Without a custom script, we do it by selecting the kind of our asset
in config.txt. A kind of "scenery" (not "screnery-trackside"!) will assign the class "MapObject" to our asset.
So, if we want to extend our asset of [[Class MapObject]], we'll have to extend the class itself.
Extending a class means to create a custom script file with a custom class declaration inside of it that inherits from the [[Class MapObject]].
"MapObject" then becomes our parent class and we have all functionallity of this class within our custom implemented class.

A basic script may look like this:


; myscript.gs
 '''<font color="#0000C0">include</font>''' <font color="#808080">"MapObject.gs"</font>
 
 '''<font color="#0000C0">class</font>''' <font color="#008000">CMyClass</font> '''<font color="#0000C0">isclass</font>''' '''<font color="#800000">MapObject</font>'''
 {
     <font color="#0000C0">'''public void''' Init</font>(<font color="#800000">'''Asset'''</font> <font color="#008000">pAsset</font>)
     {
         <font color="#0000C0">'''inherited'''</font>(<font color="#008000">pAsset</font>);
     }
 };

As you see in the little script above, our class already got a member function. This member function (Init) is the most important member we have to implement.
This little function initializies our class and inherits all initializations of our parent class (see: <font color="#0000C0">'''inherited'''</font>(<font color="#008000">pAsset</font>);).
Without that function with it's call to <font color="#0000C0">'''inherited'''</font>, functionallity of our asset is not granted, because in this case our parent class won't be initialized.


'''Notice:'''

1. Never forget the "Init"-Method (method = function within class)!

2. Never forget to call "inherited"!



In the config.txt of our asset, we need to set two new tags!
The first tag is the "script"-tag and the second one is the "class"-tag. We have to fill these tags with our script information.

'''script''': The filename of our script

'''class''': The class we created for our 


In our case the config.txt may look like:

<pre>
trainz-build                            3.7
kuid                                    [...]
category-class                          "[...]"
category-region                         "[...]"
category-era                            "[...]"
kind                                    "scenery"
description                             "[...]"
username                                "[...]"
script                                  "myscript.gs"
class                                   "CMyClass"

thumbnails
{
    [...]
}

mesh-table
{
    [...]
}

kuid-table
{
    [...]
}
</pre>