Trainz/Kinds/kind scenery-trackside

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

Trainz Annotated Reference Pages Trainz Asset Maintenance and Creation

TOC | Beginnings | Fun | AM&C | Creation | InBook Refs | ORP Refs:  • Index • Containers • Kinds • Tags | Appendixes  • Vers

Glossary

HKeys-CM

HKeys-DVR

HKeys-SUR

HKeys-WIN

Mouse use

Notations

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

Parent Classes

• KIND Scenery

Child Classes

• KIND MOSpeedboard
• KIND MOSignal

Supported Tags

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

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

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

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

Type: Boolean

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

speedlimit

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

Type: Boolean

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

trackside

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

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

Attach sample files here?

Notes