'''Cargo types in TTD'''

Definitions of cargo types used in TTD and the Patch

For setting the various action 0 properties of vehicles, various way of specifying the cargo type are used. Typically, there is one property that sets the default cargo type, and another property that sets the cargo types available for refitting in a bit mask.

The following table lists the values to use for these properties, as well as the values to use for [[Action3|action 3]].

{| class="wikitable
|-
! Column
! Name
! Usage
|-
| Type A
| Cargo bit
| Use this cargo type in action 3. When using a [[Action0/Global Settings#Cargo_translation_table_.2809.29|cargo translation table]], this is the

position in the translation table. If there is no cargo translation table, the cargo bit is defined by property 08 for new cargos.
|-
| Bit value
|
| Add these bit values to find the value to give the refit mask property (this is -+1 << cargobit+-)
|-
| Type B
| Cargo slot
| Use this cargo type to set the default cargo type of vehicles (note, this is climate dependent!). For new cargos this is the ID used in Action 0 and Action 3 of the cargo-defining NewGRF.
|}

Note, when New Cargos are being used, you can only rely on Type A values when using a cargo translation table. Type B values depend on the actual NewGRF (and its version) defining the new cargos; so, unless you test for a specific (industry) NewGRF you cannot rely on any value for Type B.

That means, to be compatible to any new cargos, you have to set the default cargo of refittable vehicles to "first refittable". However, you can kind of rely on passengers being slot 0 and mail being slot 2.

{| class="wikitable
|-
! Type A
! Bit Value
! Type B
! Cargo
! style="background: #FFA020; color: black" | [http://www.tt-wiki.net/wiki/ECS ECS]
! style="background: #0000C0; color: white" | Type B
! style="background: #0CDDA0; color: white" | [http://www.tt-wiki.net/wiki/FIRS FIRS]
|-
| 00
| 1
| 00
| Passengers
| +
| 00
| +
|-
| 01
| 2
| 01
| Coal
| +
| 01
| +
|-
| 02
| 4
| 02
| Mail
| +
| 02
| +
|-
| 03
| 8
| 03
| Oil
| +
| 03
| +
|-
| 04
| 10
| 04
| Livestock
| +
| 04
| +
|-
| 05
| 20
| 05
| Goods
| +
| 05
| +
|-
| 06
| 40
| 06
| Grain/Wheat/Maize
| +
| 06
| +
|-
| 07
| 80
| 07
| Wood
| +
| 07
| +
|-
| 08
| 100
| 08
| Iron Ore
| +
| 08
| +
|-
| 09
| 200
| 09
| Steel
| +
| 09
| + (Metal)
|-
| 0A
| 400
| 0A
| Valuables/Gold/Diamonds
| +
| 0A
| Milk
|-
| 0B
| 800
| 09
| Paper
| Food
| 0B
| Food
|-
| 0C
| 1000
| 0B
| Food
| Paper
| 0C
| Raw Sugar
|-
| 0D
| 2000
| 04
| Fruit
| +
| 0D
| Fruit and Vegetables
|-
| 0E
| 4000
| 08
| Copper Ore
| Fish
| 0E
| Fish
|-
| 0F
| 8000
| 09
| Water
| Wool
| 0F
| Wool
|-
| 10
| 10000
| 01
| Rubber
| Potash
| 10
| Clay
|-
| 11
| 20000
| 01
| Sugar
| Sand
| 11
| Sand
|-
| 12
| 40000
| 03
| Toys
| Glass/Ceramics
| 12
| Manufacturing Supplies
|-
| 13
| 80000
| 04
| Batteries
| Wood products
| 13
| Lumber
|-
| 14
| 100000
| 05
| Candy (Sweets)
| Dyes
| 14
| Scrap Metal
|-
| 15
| 200000
| 06
| Toffee
| Fertiliser
| 15
| Farm Supplies
|-
| 16
| 400000
| 07
| Cola
| Oil seeds
| 16
| Plant Fibres
|-
| 17
| 800000
| 08
| Cotton Candy (Candyfloss)
| Refined products
| 17
| Chemicals
|-
| 18
| 1000000
| 09
| Bubbles
| Vehicles
| 18
| Engineering Supplies
|-
| 19
| 2000000
| 0A
| Plastic
| Petrol
| 19
| Petrol
|-
| 1A
| 4000000
| 0B
| Fizzy Drinks
| Bricks
| 1A
| Gravel
|-
| 1B
| 8000000
| 0B
| Paper<ref name="moreindustries">Only in temperate climate, with the "moreindustriesperclimate" switch, i.e. disabled when "newcargos" is switched on.</ref>
| Sulphur
| 1B
| Bauxite
|-
| 1C
| 10000000
| 08
| undefined; unused slot in arctic climate
| Cement
| 1C
| Building Materials
|-
| 1D
| 20000000
| -
| undefined; unused slot
| Fibre crops
| 1D
| Alcohol
|-
| 1E
| 40000000
| -
| undefined; unused slot
| Lime stone
| 1E
| Reserved1
|-
| 1F
| 80000000
| -
| undefined; unused slot
| Tourists
| 1F
| Reserved2
|-
| n/a
| n/a
| FF
| colspan="4" | Use first <ref name="firstrefittable">"first" means first wrt. cargo slot, type B. I.e. this is purely up to the cargo-defining NewGRF and cannot be influenced by the vehicle NewGRF.</ref> refittable cargo type as default cargo. See also [[VehicleRefitting|vehicle refitting]].
|-
| FE
| n/a
| n/a
| colspan="4" | Used in action 3 for stations to disable default
|-
| FF
| n/a
| n/a
| colspan="4" | Shown in purchase list
|}

<references />

== Cargo Labels ==

The following cargo labels have been defined so far:

{| class="wikitable
|-
! Label
! Cargo Description
! [[Action0Cargos#Cargo classes 16|Cargo classes]]
! colspan="3" | Notes
|-
| align="center" colspan="6" | '''TTD Default Cargos'''
|-
| PASS
| Passengers
| 0001 Passengers
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| COAL
| Coal
| 0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| MAIL
| Mail
| 0002 Mail
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
|OIL_
| Oil
| 0040 Liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| LVST
| Livestock
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| GOOD
| Goods
| 0004 Express
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| GRAI
| Grain
| 0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
| Temperate; see also WHEA, MAIZ, CERE
|-
| WOOD
| Wood
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| IORE
| Iron Ore
| 0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| STEL
| Steel
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
| Renamed "Metal" in FIRS.
|-
| VALU
| Valuables
| 0008 Armoured
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
| Temperate; see also GOLD, DIAM
|-
| PAPR
| Paper
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| WHEA
| Wheat
| 0010 Bulk
|
|
| Arctic; see also GRAI, MAIZ, CERE
|-
| FOOD
| Food
| 0084 Express, refrigerated
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| GOLD
| Gold
| 0008 Armoured
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
| Arctic; see also VALU, DIAM
|-
| RUBR
|Rubber
|0040 Liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| FRUT
| Fruit
| 0090 Bulk, refrigerated
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| MAIZ
| Maize
| 0010 Bulk
|
|
| Tropic; see also GRAI, WHEA, CERE
|-
| CORE
| Copper Ore
| 0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| WATR
| Water
| 0040 Liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| DIAM
| Diamonds
| 0008 Armoured
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
| Tropic; see also VALU, GOLD
|-
| SUGR
| Sugar
| 0010 Bulk
|
|
| Toyland
|-
| TOYS
| Toys
| 0020 Piece goods
|
|
| Toyland
|-
| BATT
| Batteries
| 0020 Piece goods
|
|
| Toyland
|-
| SWET
|Sweets (Candy)
|0004 Express
|
|
| Toyland
|-
| TOFF
|Toffee
|0010 Bulk
|
|
| Toyland
|-
| COLA
|Cola
|0040 Liquid
|
|
| Toyland
|-
| CTCD
|Cotton Candy (Candyfloss)
|0010 Bulk
|
|
| Toyland
|-
| BUBL
|Bubbles
|0020 Piece goods
|
|
| Toyland
|-
| PLST
|Plastic
|0040 Liquid
|
|
| Toyland; see also PLAS
|-
| FZDR
|Fizzy Drinks
|0020 Piece goods
|
|
| Toyland
|-
| align="center" colspan="6" | '''NewCargos'''
|-
| AORE
|Bauxite (Aluminium ore)
|0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| BEER
|Alcohol
|0064 Express, piece goods, liquids
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| BDMT
|Building Materials
|0220 Piece goods, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| BRCK
|Bricks
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| CERA
|Ceramics
| 0020 Piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| CERE
|Cereals
| 0210 Bulk, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|<ref name="ecs_cargo_change" />
|-
| CLAY
|Clay
|0210 Bulk covered/sheltered
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| CMNT
|Cement
| 0210 Bulk covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| COPR
|Copper
|0020 Piece goods
|
|
|
|-
| DYES
|Dyes
| 0060 Piece goods, liquids
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| ENSP
|Engineering Supplies
|0024 Express, piece goods
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| FERT
|Fertiliser
| 0030 Bulk, piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|<ref name="ecs_cargo_change" />
|-
| FICR
|Fibre crops
| 0030 Bulk, piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| FISH
|Fish
| 0084 Express, refrigerated
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| FMSP
|Farm Supplies
|0024 Express, piece goods
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| FRVG
|Fruit (and optionally Vegetables)
|00A4 Express, piece goods, refrigerated
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| FUEL
|Fuel
|0040 Liquid
|
|
|Use PETR for refined-oil fuel
|-
| GEAR
|Locomotive regearing
|8000 Special
|
|
|
|-
| GLAS
|Glass
| 0420 Piece goods, oversized
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| GRVL
|Gravel / Ballast
|0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| LIME
|Lime stone
| 0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| MILK
|Milk
|00C4 Express, liquid, refrigerated
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| MNSP
|Manufacturing Supplies
|0024 Piece Goods, express
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| OLSD
|Oil seed
| 0210 Bulk, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|<ref name="ecs_cargo_change" />
|-
| PETR
|Petrol / Fuel Oil
| 0040 Liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| PLAS
|Plastic
| 0060 Piece goods, liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| POTA
|Potash
| 0210 Bulk, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|<ref name="ecs_cargo_change" />
|-
| RCYC
|Recyclables
|0220 Piece Goods, covered
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| RFPR
|Refined products
| 0040 Liquid
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| RSGR
|Raw Sugar
|0010 Bulk
|
|
| Deprecated in FIRS. See SGBT and SGCN
|-
| SAND
|Sand
| 0010 Bulk
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| SCMT
|Scrap Metal
|0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| SCRP
|Scrap Metal
|0010 Piece Goods
|
|
| Deprecated in FIRS, use SCMT instead
|-
| SGBT
|Sugar beet
|0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
| not in tropical
|-
| SGCN
|Sugarcane
|0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
| only tropical
|-
| SULP
|Sulphur
| 0210 Bulk, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|<ref name="ecs_cargo_change">ECS cargo classes changed as of Dec 31, 2010</ref>
|-
| TOUR
|Tourists
| 0005 Passengers, express
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| TWOD
|Tropic Wood
|0020 Piece goods
|
|
|
|-
| VEHI
|Vehicles
| 0420 Piece goods, oversized
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
|
|
|-
| WDPR
|Wood Products
| 0030 Bulk, piece goods
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|-
| WOOL
|Wool
| 0220 Piece goods, covered/sheltered
| style="background: #FFCC00; color: black" | [[ttwiki:ECS|ECS]]
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|<ref name="ecs_cargo_change" />
|-
| WSTE
|Waste
|0010 Bulk
|
| style="background: #1AD74C; color: white" | [[ttwiki:FIRS|FIRS]]
|
|}

<references />

If you write or publish a NewGRF which introduces a new cargo label, please also add a comment where the new label is used.

Action14

2011-08-05T18:39:47Z

Eddi: /* Syntax */

'''''Static GRF Information'''''

== Introduction ==

Static GRF Information

This action allows to specify additional information about the GRF. Every piece of information is considered optional and non-essential, thus OpenTTD/TTDPatch will ignore unknown parts and not display any error. The action is also meant to allow interfacing non-official extensions/patches for OpenTTD.

Currently this action can be used to define
* {{ottdp|1.1|no|ottdrev=r20250}} translations for the name and description of the GRF. (Those from action 8)
* {{ottdp|1.1|no|ottdrev=r20254}} the palette (DOS, Windows) the GRF needs, or whether the palette does not matter.
* {{ottdp|1.1|no|ottdrev=r20255}} the number, format and purpose of GRF parameters. (allowed values, names, descriptions, ...)
* {{ottdp|1.1|no|ottdrev=r20960}} version information and compatibility to older versions of the same GRF.

The action itself is available since OpenTTD r20250. TTDPatch ignores the action since r2334, so no skipping is needed. The action is only allowed for GRF version 7 or above.

The action is processed while scanning for GRFs and their action 8 descriptions. This scanning stops when encountering an action 8, thus action 14 needs to appear earlier in the GRF.

== Syntax ==

The data is provided using nestable chunks, and looks as follows:

<pre><sprite-number> * <length> 14 <chunks ...> 00</pre>

Where <chunks ...> is one or a sequence of

<pre>"C" <identifier> <chunks ...> 00</pre>

<pre>"B" <identifier> <length> <binary-data></pre>

<pre>"T" <identifier> <language-id> <text> 00</pre>

These three types of chunks define branch nodes (containers) and binary and textual leafs in a tree-like information structure. A piece of information is identified by the path in the information tree. E.g. the text leaf node at "INFO" -> "DESC" provides translatable descriptions for the GRF. It does not matter how many action 14 appear in a GRF, and which information is defined in which. Information with different identifier paths or same identifier paths (but e.g. different language-ids) can be set in the same action 14 or in multiple. If information is assigned to the same identifier-path multiple times, the information adds up resp. the last set information wins.

Chunks with unknown identifiers are just skipped including their subchunks. Following chunks are processed nevertheless.

{| class="wikitable"
|-
! '''Element'''
! [[GRFActionsDetailed|'''Size''']]
! '''Description'''
|-
| <sprite-number>
| dec
| A sequential sprite number
|-
| <length>
| dec
| The total number of bytes in the action
|-
| 14
| B
| Action 14
|-
| "C"/"B"/"T"
| B
| chunk type (container/binary/text)
|-
| <identifier>
| 4*B
| Unique identifier for the chunk (see below)
|-
| <chunks ...>
| *
| Any number of sub chunks.
|-
| <length>
| W
| Number of bytes of binary data following.
|-
| <binary-data>
| length*B
| Binary data
|-
| <language-id>
| B
| Which of TTD's languages the text is used for, see [[action4]]. (only GRF version >= 7 language codes allowed)
|-
| <text>
| S
| Text data
|}

== Descriptions ==
=== Custom information for non-official extensions/patches ("CSTM" -> <extension-id> -> ...) ===

<pre>-1 * -1 14 "C" "CSTM"
"C" <extension-id>
... whatever suits you ...
00
00
00</pre>

Due to the purely-optional character of action 14 it is especially meant for non-official extensions/patches. However, to avoid conflicts custom additions should go into the "CSTM" chunk. Every extension may define its own subchunk with its own custom 4 byte <extension-id> below the "CSTM" chunk. The format of the subchunks below the <extension-id> chunk is freely defineable.

The information there could be used e.g. to notify an extension that the GRF knows about it. Consecutively the extension might then enable custom GRF features and notify the GRF about their existance e.g. via variable 8D. Versions of OpenTTD without the extension will then just skip the "CSTM" chunk and return the usual value in variable 8D.

=== GRF name ("INFO" -> "NAME") and description ("INFO" -> "DESC") ===

<pre>-1 * -1 14 "C" "INFO"
"T" "NAME" <language-id> "Translatable GRF name" 00
"T" "DESC" <language-id> "Translatable GRF description" 00
00
00</pre>

Below the top-level chunk "INFO" you can use the leaf-chunks "NAME" and "DESC" to define name and description for additional languages. The information provided in action 8 is used for "other" languages (id 7F).

=== GRF palette ("INFO" -> "PALS") ===

<pre>-1 * -1 14 "C" "INFO"
"B" "PALS" \w1 <palette>
00
00</pre>

Specifies the palette the sprites in the GRF are meant for.

{| class="wikitable"
|-
!'''<palette>'''
!'''Meaning'''
|-
|"D"
|DOS palette
|-
|"W"
|Windows palette
|-
|"A"
|Any palette. (e.g. when the GRF does not contain any sprites)
|}

=== GRF version ("INFO" -> "VRSN") ===

<pre>-1 * -1 14 "C" "INFO"
"B" "VRSN" \w4 \d<version>
00
00</pre>

Specifies the version of the GRF. This version is then used (by OpenTTD) to internally order GRFs with the same GRFID. That order will determine which GRF is loading as "compatible" GRF and which GRFs to show in the list of GRFs. By default a GRF has version 0.

If all GRFs (with the same GRFID) have version 0 all will be shown in the list of GRFs. If the highest version is shared by multiple GRFs one is randomly chosen as "compatible" GRF. As such it is important to prevent releasing multiple GRFs with the same version number.

If you set a version for the GRF, you should also set the 'minimal compatible version' MINV! Else it will default to the value of VRSN, which results in the GRF only being considered compatible to itself (resp. same version).

=== Minimal compatible GRF version ("INFO" -> "MINV") ===

<pre>-1 * -1 14 "C" "INFO"
"B" "MINV" \w4 \d<version>
00
00</pre>

Specifies the minimal version of GRFs with the same GRFID this GRF is still compatible with.

You have to set MINV after VRSN, and MINV has to be smaller or equal to VRSN.

When loading a game which used an older version of your GRF which is no longer installed, the newest installed version of your GRF will be picked which is still compatible to the version used before. Older GRFs are never considered compatible to GRFs with newer versions though.

If you do not set MINV, but set VRSN, then the GRF is only considered compatible to GRFs with the same version.

If you set MINV to 0, the GRF is also considered compatible to old GRFs without any version information (VRSN).

=== GRF parameters ===

This section describes how to specify information about GRF parameters, and what settings are stored in them. By default a GRF comes with 128 settings, that is a dword setting for every of the 128 GRF parameters.

==== Number of settings ("INFO" -> "NPAR") ====

<pre>-1 * -1 14 "C" "INFO"
"B" "NPAR" \w1 <number-of-settings>
00
00</pre>
Defines the number of settings a GRF provides. This is independant from the number of allowed GRF parameters, as multiple settings might go into the same GRF parameter (e.g. bitmasks).

==== Setting name ("INFO" -> "PARA" -> <setting-number> -> "NAME") and description ("INFO" -> "PARA" -> <setting-number> -> "DESC") ====

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"T" "NAME" <language-id> "Name of setting" 00
"T" "DESC" <language-id> "Setting description" 00
00
00
00
00</pre>

Defines a name for a setting.

The settings are numbered and identified using <setting-number>. Valid values are 0 up to ("INFO" -> "NPAR") - 1.

==== Setting to GRF parameter mapping ("INFO" -> "PARA" -> <setting-number> -> "MASK") ====

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"B" "MASK" \w<length> \b <grf-parameter> [ \b <first-bit> [ \b <num-bit> ] ]
00
00
00
00</pre>

Specifies which GRF parameter is used to store a setting in.

{| class="wikitable"
|-
|<length>
|A chunk length of 1 to 3 is allowed.
|-
|<grf-parameter>
|GRF parameter (0 to 127) to store the setting in. Default value is the same as <setting-number>.
|-
|<first-bit>
|First bit in the GRF parameter to use for the setting. Default value is "0".
|-
|<num-bit>
|Number of bits to use for the setting in the GRF parameter. Default value is "32".
|}

If you do not specify <first-bit> and <num-bit> the setting uses the whole GRF parameter by default. If you do not specify any "MASK" chunk at all, the setting will use the GRF parameter with the same number as <setting-number>.

So if you do not need to store multiple settings in one parameter, you do not need "MASK" chunks.

Note: You cannot store a setting across/using multiple GRF parameters.

==== Setting type ("INFO" -> "PARA" -> <setting-number> -> "TYPE") ====

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"B" "TYPE" \w1 <setting-type>
00
00
00
00</pre>

Specifies the type of a setting.

{| class="wikitable"
|-
!'''<setting-type>
!'''Meaning'''
|-
|0
|Integer (unsigned) or enumeration. The GUI displays "<" and ">" buttons to change the setting resp. allows entering a value from a query window.
|-
|1
|Boolean. The GUI displays a toggle button to switch the setting on or off.
|}

The defaut value is "0".

==== Allowed value range ("INFO" -> "PARA" -> <setting-number> -> "LIMI") ====

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"B" "LIMI" \w8 \d<minimum-value> \d<maximum-value>
00
00
00
00</pre>

Sets minimal and maximal allowed value for integer/enumeration settings.

The default values are "0" resp. "2^32 - 1".

==== Enumeration values ("INFO" -> "PARA" -> <setting-number> -> "VALU") ====

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"C" "VALU"
"T" \d<setting-value> <language-id> "Enumeration value" 00
...
00
00
00
00
00</pre>

This chunk allows you to specify texts to display instead of the raw value for integer/enumeration. You can also specify texts only for some of the valid values. So if a setting e.g. allows values betweeen 0 to 42 you can instruct the GUI to show "none" instead of "0".

==== Default value ("INFO" -> "PARA" -> <setting-number> -> "DFLT") ====

Available since OpenTTD r20602.

<pre>-1 * -1 14 "C" "INFO"
"C" "PARA"
"C" \d<setting-number>
"B" "DFLT" \w4 \d<value>
00
00
00
00</pre>

Sets the default value for a setting.

If you set "DFLT" for any setting the behavior of the "reset" functionality changes. Normally it would unset all parameters. If you have any "DFLT" field in your NewGRF then all parameters are unset after which all settings are set to their default value or to 0 if no default is provided. This means that using ActionD with opcode+80 doesn't work for any user-changeable parameter when you use a "DFLT" field.

This "reset" functionality happens when adding a NewGRF to a configuration or when the user presses the reset button in the parameter window.