Trainz/Kinds/kind scenery-trackside

From Wikibooks, open books for an open world
< Trainz‎ | Kinds
Jump to navigation Jump to search
logo
Trainz Annotated Reference Pages

Trainz Asset Maintenance and Creation
TOC | BeginningsFun | AM&C | Creation | InBook Refs ORP Refs:  • Index • Containers • Kinds • Tags | Appendixes  • Vers
Loupe light.svg
 Glossary
 HKeys-CM
 HKeys-DVR
 HKeys-SUR
 HKeys-WIN
 Mouse use
 Notations

KIND Scenery-trackside provides the basis for all track-attached scenery assets, such as trackside signs and devices.

This asset type inherits all map object characteristics except positioning, and adds trackside positioning and TrackSearch semantics.

The config.txt file for a KIND Scenery-trackside asset has the same kind scenery entry as kind scenery for historical reasons, however the two kinds are quite distinct and should not be confused. A KIND Scenery-trackside will contain a trackside tag, whereas KIND Scenery does not.

KIND Hierarchy[edit]

Parent Classes[edit]

Child Classes[edit]

Supported Tags[edit]

Each trackside asset supports the following tags. Each tag is shown here with its default value.

 trackside         0
 speedlimit        0
 buffer-speed      0
 follow-gradient   0
 trackmark         0
 search-limit      0
 placeable-on-splines-of-group
 {
 }

buffer-speed[edit]

Type: Decimal
Desc: Used for buffers, this sets the maximum speed, in meters per second, at which the buffer can stop a train. If the Train passes the track-side object travelling faster than the buffer speed it will derail. If it's traveling below, or equal, to the buffer speed the train will stop harmlessly.

follow-gradient[edit]

Type: Boolean
Desc: Specifies that the object should be vertically perpendicular to the track gradient when placed. If 0 (default) the asset will point straight up.

placeable-on-splines-of-group[edit]

Introduced:trainz-build 3.5
Type: KUID list container, TBD.
Desc: A list of KIND Asset-group describing the spline types on which this trackside object may be placed. This object cannot be placed on a spline unless the spline is a member of one of the groups specified here. If not specified, the list defaults to a single entry, Asset-groups <kuid:30501:100043>.

search-limit[edit]

Type: Boolean
Desc: Search limit objects are used by the Driver AI and indicate the direction of travel for a section of track.

speedlimit[edit]

Type: Decimal
Desc: Sets the speed limit, in meters per second, for the track it is placed on, after the object. If this tag is provided with no value, the speed limit will be set to 100m/s.

trackmark[edit]

Type: Boolean
Desc: Specifies if the object is a trackmark. Trackmarks can be used to place consists in [[Scripting|TrainzScript}}.

trackside[edit]

Type: Float
Compulsory: 3.4
Desc: The distance, in meters, the object will be placed from the center of the track. Negative values will put the object on the left side of the track, and positive values will place it on the right.


Example Config.txt[edit]

Sample config.txt file for a trackside asset, with the Standard Tags excluded for brevity:

kind "scenery"
trackside -2.8
light 1
follow-gradient 0
mesh-table
{
  default
  {
    mesh "CatchPoint.im"
    auto-create 1
  }
}

Downloads[edit]

Attach sample files here?

Notes[edit]

Footnotes[edit]