Action0/Vehicles/Ships

From GRFSpecs
< Action0‎ | Vehicles
Revision as of 03:34, 23 July 2011 by Planetmaker (talk | contribs) (Add version icons)
Jump to navigationJump to search

Introduction

Defining properties of ships.

Properties

Number Version Size Description
08 Supported by OpenTTD ????Supported by TTDPatch ???? B Sprite (FF for new graphics)
09 Supported by OpenTTD ????Supported by TTDPatch ???? B Refittable (0 no, 1 yes)
0A Supported by OpenTTD ????Supported by TTDPatch ???? B Cost factor
0B Supported by OpenTTD ????Supported by TTDPatch ???? B Speed in mph*3.2
0C Supported by OpenTTD ????Supported by TTDPatch ???? B Cargo type, see column 3 (type B) in CargoTypes
0D Supported by OpenTTD ????Supported by TTDPatch ???? W Capacity
0F Supported by OpenTTD ????Supported by TTDPatch ???? B Running cost factor
10 Supported by OpenTTD ????Supported by TTDPatch ???? B Sound effect type (4=cargo ship, 5=passenger ship)
11 Supported by OpenTTD ????Supported by TTDPatch ???? 1 D Bit mask of cargo types available for refitting, see column 2 (bit values) in CargoTypes
12 Supported by OpenTTD ????Supported by TTDPatch ???? 6 B Callback flags bit mask, see below
13 Supported by OpenTTD ????Supported by TTDPatch 2.02.0 (a) B Refit cost, using 1/32 of the default refit cost base
14 Supported by OpenTTD 1.21.2Supported by TTDPatch 2.02.0 (b,g) B Ocean speed fraction, sets fraction of top speed available in the ocean; e.g. 00=100%, 80=50%, FF=0.4%
15 Supported by OpenTTD 1.21.2Supported by TTDPatch 2.02.0 (b,g) B Canal speed fraction, same as above but for canals and rivers
16 Supported by OpenTTD ????Supported by TTDPatch 2.02.0 (b) B Retire vehicle early, this many years before the end of phase 2 (see Action0General)
17 Supported by OpenTTD ????Supported by TTDPatch 2.02.0 (c) B Miscellaneous vehicle flags
18 Supported by OpenTTD ????Supported by TTDPatch 2.02.0 (c) W Refittable cargo classes, see train prop. 28
19 Supported by OpenTTD ????Supported by TTDPatch 2.02.0 (c) W Non-refittable cargo classes, see train prop. 29
1A Supported by OpenTTD 0.60.6Supported by TTDPatch 2.52.5 (d) D Long format introduction date
1B Supported by OpenTTD 0.70.7Not supported by TTDPatch (e) B* Sort the purchase list
1C Supported by OpenTTD 1.11.1Not supported by TTDPatch (f) B Visual effect

Version codes:

Code Version
(a) 2.0.1 alpha 30
(b) 2.0.1 alpha 44
(c) 2.0.1 alpha 58
(d) 2.5 r1210, OpenTTD r7191
(e) OpenTTD r13831
(f) OpenTTD r21240
(g) OpenTTD r22639

Descriptions

Callbacks (12)

For ships, the following callbacks have to be enabled by setting the corresponding bit in property 12 (certain other, not as frequently used callbacks are available without setting a bit here):

Bit Value Variable 0C value Callback
2 4 12 Load amount
3 8 15 Set refitted capacity
5 20 19 show a suffix after the cargo type name
6 40 2D Select color mapping for vehicle
7 80 33 Sound effect callbacks

Bit is the bit you have to set, you do this by adding all the values for all the bits. Variable 0C value is what variable 0C will be set to, for checking it in the VarAction2 for callbacks.

Miscellaneous flags (17)

This is a bit mask, with the following bits:

Bit Value Meaning
0 1 reserved, do not use
1 2 Uses two company colors

Long format introduction date (1A)

Set the vehicle introduction date, in days since the year 0. This takes account of leap years; dividable by 4, but not 100 unless 400. A start date of 1920-01-01 is obtained with a value of 701265 (51 B3 0A 00). This property must be set after property 00 to take effect. In TTDPatch, dates after 2044 will be limited to 2044.

Sort vehicle list (1B)

See sort vehicle list for trains for details.

Visual effect (1C)

See the equivalent train property for information about the meaning of all bits. There is no default effect for ships, therefore values of 00..0F will show no visual effect. Bit 7 (disable wagon power) currently has no meaning and should be left at 0.

Example

To be written