Callback: Decide input and output cargo types

From GRFSpecs
Revision as of 01:00, 4 November 2018 by Frosch (talk | contribs) (Add note about ordering of cargotypes.)
Jump to navigationJump to search

Decide input and output cargo types (14B,14C)

Supported by OpenTTD 0.6 (r11177)0.6 Supported by TTDPatch 2.6 (r1718)2.6

These callbacks are called when the industry is built, and allow customizing the input and output cargo types dynamically. However, you are only allowed to reduce the number of accepted/produced cargos. Industry properties 25 and 26 should always be a superset of the returned cargotypes.

Both callbacks are called repeatedly, with the lowest byte of variable 10 starting from zero and increasing after every call; you should return a cargo type each time, or FFh to terminate the list. (A failed callback terminates the list, too.) The same limitations apply as for callback 14A: industry tiles aren't yet placed, and some industry variables contain junk. You can use random action2s, however. The interpretation of the returned value depends on two factors: the current GRF version number and the presence of a cargo translation table:

GRF version Has cargo translation table Interpretation
6 or below Climate-dependent cargo slot number
7 or above No Cargo bit
7 or above Yes Index in the translation table

The callback results replace the content of properties 25 and 26. If you use these callbacks, it is recommended to not use industry properties 10..13, 1C..1E and 25..28, which depend on the order of cargotypes, but instead use production callback version 2.

Supported by OpenTTD 1.91.9 Not supported by TTDPatch If industry property 1A flag 18 is clear, these callbacks are called at most for 3 input and 2 output cargos. If flag 18 is set, this compatibility restriction is removed and the callbacks are called more often.

In both cases return FFh as the last element to terminate the lists.