GRFSpecs - Recent changes [en-gb]

VariationalAction2/Towns

Zephyris — Tue, 20 Oct 2026 21:29:41 GMT

Add cargo production

@@ Line 9: / Line 9: @@
 |-
 |41||W (B)||{{ottdp| |}}||Town index<ref>In OpenTTD this variable is word-sized, in TTDPatch this variable is byte-sized.</ref>
 |-
 |60||D||{{ottdp|16|no|}}||Land info for nearby tiles.
 |-
 |82||W||{{ottdp| |}}||Population
@@ Line 46: / Line 62: @@
 TTDPatch only: This variable has a value between 0 and 69 (inclusive).
-=== Land info for nearby tiles (62) ===
+=== Town properties (42) ===
 === Population (82) ===

Action5

Zephyris — Tue, 20 Oct 2026 21:07:11 GMT

← Older revision		Revision as of 21:07, 20 October 2026
(One intermediate revision by the same user not shown)
Line 132:		Line 132:

	\|-		\|-
	\|1A,9A\|\|{{ottdp\|15\|no\|}}\|\|Rocky overlay sprites, 5 sets of 19 (normal, 1/4 snowy, 2/4 snowy, 3/4 snowy and 4/4 snowy) base rock overlay sprites\|\|95		\|1A,9A\|\|{{ottdp\|15\|no\|}}\|\|Rocky overlay sprites, 5 sets of 19 (normal, 1/4 snowy, 2/4 snowy, 3/4 snowy and 4/4 snowy) base rock overlay sprites\|\|{{ottdp\|16\|no\|}} 116 {{ottdp\|15\|no\|}} 95
	\|-		\|-
	\|1B,9B\|\|{{ottdp\|15\|no}}\|\|Bridge deck overlay sprites, 4 sets of 6 for each of road, rail, monorail and maglev\|\|24		\|1B,9B\|\|{{ottdp\|15\|no}}\|\|Bridge deck overlay sprites, 4 sets of 6 for each of road, rail, monorail and maglev\|\|24
Line 413:		Line 413:

	==== 1A / 9A Overlay rocks sprites ====		==== 1A / 9A Overlay rocks sprites ====
	Overlay sprites to draw snowy rocks. These are drawn on top of ~~the~~ snowy or partially snowy ground sprites when a rocky tile has snow on it.		Overlay sprites to draw snowy rocks, rocks in desert and coast/water rocks. These are variously drawn on top of snowy or partially snowy ground sprites when a rocky tile has snow on it, on desert ground sprites when the rocky tile is in a desert, or on coast or water sprites when there are rocks on water.

	95 sprites are required. This corresponds to 5 sets of 19 sprites, one for each of the 19 slopes in the same order as terrain sprites in the base graphics. The 5 sets are 1 stage of plain rocks (~~currently~~ ~~unused~~) and 4 stages of snowy rocks (from 1/4 to 4/4). All 4 stages of snowy rocks are required - if you do not want to define sprites specific to all of these stages then simply re-use sprites across multiple stages.		95 sprites are required. This corresponds to 5 sets of 19 sprites, one for each of the 19 slopes in the same order as terrain sprites in the base graphics. The 5 sets are 1 stage of plain rocks (used for desert rocks and coast/water rocks) and 4 stages of snowy rocks (from 1/4 to 4/4). All 4 stages of snowy rocks are required - if you do not want to define sprites specific to all of these stages then simply re-use sprites across multiple stages.

			Up to 114 sprites can be provided. The optional 6th set of 19 sprites are dedicated overlay sprites for rocks on coast and water, and will be used if provided.

	==== 1B / 9B Bridge deck overlay sprites ====		==== 1B / 9B Bridge deck overlay sprites ====

Action0/Vehicles/Trains

Peter1138 — Tue, 20 Oct 2026 14:30:06 GMT

Custom cargo ageing period (2B)

← Older revision		Revision as of 14:30, 20 October 2026
Line 463:		Line 463:
	== Custom cargo ageing period (2B) ==		== Custom cargo ageing period (2B) ==

	This property allows to modify the period in ticks after which cargo carried by the vehicle is aged. By default, cargo is aged every 185 ticks. A value of 0 disables ageing of cargo. This property can be modified via [[Callbacks#Change_vehicle_properties_.2836.29\|callback 36]]. This alters the rate of change along the X-axis of the cargo payment while the cargo is in this vehicle.		This property allows to modify the period in ticks after which cargo carried by the vehicle is aged. By default, cargo is aged every 185 ticks. A value of 0 disables ageing of cargo. This property can be modified via [[Callbacks#Change_vehicle_properties_.2836.29\|callback 36]]. This alters the rate of change along the X-axis of the cargo payment graph while the cargo is in this vehicle.

	== List of always refittable cargo types (2C, 2D) ==		== List of always refittable cargo types (2C, 2D) ==

NML:Vehicles

Peter1138 — Tue, 20 Oct 2026 14:29:44 GMT

Properties common to all vehicle types

← Older revision		Revision as of 14:29, 20 October 2026
(2 intermediate revisions by the same user not shown)
Line 101:		Line 101:
	\| yes		\| yes
	\|		\|
	{{ottd\|1.2\|r22713}} This property specifies after how many ticks cargo is aged. Default value is 185. 74 ticks is equal to 1 day. If set to 0, cargo does not age. ~~Repeated~~ ~~tests have shown that~~ the ~~gameplay effects~~ of ~~this~~ ~~property often do not match~~ the ~~expectations~~ of ~~grf~~ ~~authors.~~ ~~Explaining~~ ~~why~~ ~~requires a detailed understanding of~~ the ~~OpenTTD~~ cargo ~~aging~~ ~~algorithm,~~ ~~and how that works with e.g. different map sizes,~~ vehicle ~~speeds, multi-leg feeder systems, etc. TL;DR avoid using this property unless you absolutely understand the effect it will have~~.		{{ottd\|1.2\|r22713}} This property specifies after how many ticks cargo is aged. Default value is every 185 ticks. 74 ticks is equal to 1 day. If set to 0, cargo does not age. This alters the rate of change along the X-axis of the cargo payment graph while the cargo is in this vehicle.
	\|-		\|-
	\| <code style="color:green">variant_group</code>		\| <code style="color:green">variant_group</code>

Action0/Vehicles/Trains

Peter1138 — Tue, 20 Oct 2026 14:25:27 GMT

Custom cargo ageing period (2B)

← Older revision		Revision as of 14:25, 20 October 2026
(One intermediate revision by the same user not shown)
Line 463:		Line 463:
	== Custom cargo ageing period (2B) ==		== Custom cargo ageing period (2B) ==

	This property allows to modify the period in ticks after which cargo carried by the vehicle is aged. By default, cargo is aged every 185 ticks. A value of 0 disables ageing of cargo. This property can be modified via [[Callbacks#Change_vehicle_properties_.2836.29\|callback 36]].		This property allows to modify the period in ticks after which cargo carried by the vehicle is aged. By default, cargo is aged every 185 ticks. A value of 0 disables ageing of cargo. This property can be modified via [[Callbacks#Change_vehicle_properties_.2836.29\|callback 36]]. This alters the rate of change along the X-axis of the cargo payment while the cargo is in this vehicle.

	Changing this value from the default does not automatically make the vehicle earn more or less. Predicting the effect is complicated, as it depends on many things, including: vehicle speed, route length, route delays, transfer credits, the payment curve set by the cargo, and whether the cargo is already aged from a previous transfer when the vehicle loads it.

	Authors are advised that tests show this property can lead to disappointment. Avoid, or use with caution.

	== List of always refittable cargo types (2C, 2D) ==		== List of always refittable cargo types (2C, 2D) ==

Badge labels

Rito12 — Sat, 17 Oct 2026 20:17:57 GMT

Test - copy data from https://github.com/Rito13/BaNaNaS-get_badge_labels/blob/main/gen_docs/badges/public_labels.mediawiki

Show changes

VariationalAction2/Vehicles

Brickblock1 — Wed, 14 Oct 2026 21:28:43 GMT

Variables

← Older revision		Revision as of 21:28, 14 October 2026
(2 intermediate revisions by the same user not shown)
Line 43:		Line 43:
	\|-		\|-
	\|63\|\|D\|\|{{ottdp\|1.11\|no\|ottdrev=g868d84bbf}}\|\|Test track-type of tile against another track-type\|\|no		\|63\|\|D\|\|{{ottdp\|1.11\|no\|ottdrev=g868d84bbf}}\|\|Test track-type of tile against another track-type\|\|no
			\|-
			\|64\|\|D\|\|{{ottdp\|15\|no}}\|\|Count badge occurence\|\|no
	\|-		\|-
	\|65\|\|D\|\|{{ottdp\|15\|no}}\|\|Test if rail or road type of the current type occupied by the vehicle has that specific badge attached\|\|no		\|65\|\|D\|\|{{ottdp\|15\|no}}\|\|Test if rail or road type of the current type occupied by the vehicle has that specific badge attached\|\|no
Line 363:		Line 365:

	The remaining bytes are reserved, and must be masked.		The remaining bytes are reserved, and must be masked.

			=== Count badge occurence (64) ===

			{{ottdp\|15\|no}}

			The 60+x parameter is the badge ID to look for, and the returned value is the number of vehicles in the consist that have this badge. If used with VarAction2 type 81, only the current vehicle and onwards will be check, with VarAction2 type 82, all vehicles in the consist will be counted.

	=== Test if rail or road type of the current tile occupied by the vehicle has that specific badge attached (65) ===		=== Test if rail or road type of the current tile occupied by the vehicle has that specific badge attached (65) ===

NML:Vehicles

Brickblock1 — Thu, 08 Oct 2026 20:02:11 GMT

Vehicle callbacks

← Older revision		Revision as of 20:02, 8 October 2026
Line 1,321:		Line 1,321:
	\| {{nml\|0.7.5}} {{ottd\|14.0}} Trains		\| {{nml\|0.7.5}} {{ottd\|14.0}} Trains
	\| No		\| No
	\| 0		\| 0 .. 100
	\| Probability of reversing rail vehicle, i.e. facing forward or backward, when purchased.		\| Probability of reversing rail vehicle, i.e. facing forward or backward, when purchased.
	\|-		\|-

Action0/Objects

Andythenorth — Thu, 01 Oct 2026 10:35:17 GMT

removed dead link

← Older revision		Revision as of 10:35, 1 October 2026
Line 53:		Line 53:
	\|}		\|}

	Check [http://pics.lakie.net/newObject-ActionStructure.png Lakie's Graphical Representation of the newObject Specifications]

	== Descriptions ==		== Descriptions ==