Additions to the NewGRF Road Stops Specification in JGR's Patchpack in NML

This document describes the non-standard additions to the NewGRF road stops feature in the Official OpenTTD NML Specifications, as implemented in this patchpack, and the associated NML fork
The additions here are compatible with the specification and OpenTTD 14.0, such that GRFs can run on OpenTTD 14.0 and also optionally use patchpack extensions where available.

These additions and the official specification do not match the obsolete OpenTTD PR #7955 which used a different NewGRF interface.

The feature identifier is FEAT_ROADSTOPS, (the PARENT scope for this feature is the road stop's station's town).
There is no permanent storage associated with this feature.

See the NewGRF additions (NML) document for background information on additions to NML.

See the associated non-NML document for more details on the NewGRF road stops feature.

This feature will be automatically skipped when loaded into a version of OpenTTD which does not support this feature (before 14.0).
If this feature is the only significant thing in this GRF, then version_openttd(14, 0) || extended_feature_test("road_stops") MAY be called and some message, error or other form of signalling to the user used to inform the user that this version of OpenTTD does not support the feature, if the value is false.

Sections:

• IDs
• Properties
• Variables
• Callbacks
• Animation triggers
• Views/rotations
• Syntax example

Road Stop IDs

A road stop is allocated by setting the 'class'-property, which should therefore be set first.
Road stop IDs are NewGRF-local and can be freely chosen in the 0..63999 range, as of version 7 of the road_stops feature.
When loaded into a version of OpenTTD with versions 1 to 6 of the road_stops feature, IDs are limited to the range: 0..254. Any road stops with IDs outside this range will be skipped.

Road Stop Properties

Road Stop Variables

A number of variables are shared between road stops and stations. These are listed on the stations page.

Road Stop Callbacks

Road Stop Animation Triggers

Road stop views/rotations

Syntax example

grf {
	...
}

if (!extended_feature_test("road_stops")) {
	error(FATAL, string(STR_UNSUPPORTED_VERSION));
}


spritelayout spritelayout_roadstop {
	ground {
		...
	}
	building {
		...
	}
}

switch (FEAT_ROADSTOPS, SELF, switch_roadstop, ...) {
	...
}

item (FEAT_ROADSTOPS, item_roadstop)  {
	property {
		class: "TEST";
		availability_type: RST_AVAILABILITY_TYPE_PASSENGER;
		name: string(STR_ROADSTOP_NAME);
		classname: string(STR_ROADSTOP_TEST_CLASS_NAME);
	}
	graphics {
		default: switch_roadstop;
	}
}