Action0/Houses
Action 0 properties of houses
Action 0 - Properties for houses
Defining properties of houses
{maketoc}
For town buildings (or simply houses), the offset defines the first house ID for this action 0. House IDs, like station IDs, are unique within each grf file, and in total each game can only have 255 IDs for all active grf files.
To start using a house ID, you must first define it by setting its property 08 (see below). If you try to modify a house ID whose property 08 isn't set, your request is ignored, but not reported as an error, either. House IDs, unlike station IDs, need not be set in order, so you can use action 7 to skip action 0s of the houses you don't currently need (for example those houses that don't appear on the current climate anyway). You are advised to do so in order to define as few IDs as possible, leaving space for other GRFs. You don't need to skip all action 0s for a house ID to disable it; skipping the action 0 that sets property 08 is enough.
-=Properties=-
||Number|Version|Size|Description
08|(a)|B|Substitute building type
09|(a)|B|Building flags
0A|(a)|W|Availability years
0B|(a)|B|Population
0C|(a)|B|Mail generation multiplier
0D|(a)|B|Passenger acceptance
0E|(a)|B|Mail acceptance
0F|(a)|B|Goods, food or fizzy drinks acceptance
10|(a)|W|LA rating decrease on removal (should be set to the same value for every tile for multi-tile buildings)
11|(a)|B|Removal cost multiplier (should be set to the same value for every tile for multi-tile buildings)
12|(a)|W|Building name ID
13|(a)|W|Building availability mask
14|(a)|B|House callback flags
15|(a)|B|House override byte
16|(a)|B|Periodic refresh multiplier
17|(b)|4*B|Four random colours to use
18|(b)|B|Relative probability of appearing
19|(c)|B|Extra flags
1A|(d)|B|Animation frames
1B|(d)|B|Animation speed
1C|(e)|B|Class of the building type
1D|(f)|B|Callback flags 2
1E|(f)|D|Accepted cargo types||
When a town decides to expand, each active house type (both old and new ones) has a uniform probability to appear, so the more new houses you define, the fewer old TTD buildings will appear.
(a) Available since TTDPatch 2.0.1 alpha 34
(b) Available since TTDPatch 2.0.1 alpha 35
(c) Available since TTDPatch 2.0.1 alpha 38
(d) Available since TTDPatch 2.0.1 alpha 39
(e) Available since TTDPatch 2.0.1 alpha 43
(f) Available since TTDPatch 2.0.1 alpha 55 vcs 2
-=Comments=-
Substitute building type (08)
This building type will be used instead of your new one if your definition isn't available for any reason (the grf file is not found, for example).
Don't set a substitute building type that is larger than your new one (for example, don't set 14 (stadium) for an 1x1 building) because this may corrupt savegames. Setting this property automatically copies every property of the substitute building to your new building, so you don't have to change properties that are the same as the substitute.
House flags 40 and 80 are exceptions; these flags are never set automatically. Only the first property 08 setting copies properties; if you later change it, properties will stay.
There's a special use of this property beginning from alpha 72: if you set it to FFh, you can disable an old house type. In this case, the ID used must be the number of old house type you want to disable. Disabling only prevents building the type in towns; houses already present on the map will stay unchanged. The type can still be overridden, and overriding affects houses present on the map.
If this house's action 3 appears before this property is set, the action 3 will have no effect.
Building flags (09)
||Bit|Value|Meaning
0|1|This is a 1x1 building
1|2|This building can be built only on flat land (if clear, foundations are automatically displayed on sloped land)
2|4|This is a 2x1 building
3|8|This is a 1x2 building
4|10|This is a 2x2 building
5|20|Animation flag, set in tiles 04 and 05 (large office block). New buildings have a different animation scheme than large office blocks, but animation is still enabled with this bit.
6|40|This building is a church
7|80|This building is a stadium||
If your building isn't 1x1, set flags for the north tile, then define the next 1 or 3 tiles tiles (by setting their property 8). The only bit that can be set in the flags of additional tiles is bit 5 (animation). There should be no property 8 setting between the first tile and the additional tiles.
For 2x2 buildings, the first additional tile is the east one, the second is the west part and the third is the south part. You probably want to set the substitute for additional tiles to a TTD additional tile whose flags are already zero. 2x2 buildings are always built on flat land no matter how bit 1 is set.
Only one church and one stadium can exist in a town; the town won't build buildings with the according flag set until the old church/stadium is removed. (This can be done by either the town or a player)
The animation flag works on a per-tile basis, so you should enable it for additional tiles of multi-tile buildings as well if you want all tiles to be animated.
Availability years (0A)
The low byte is the minimum year, the high is the maximum. The building can only be built between these two years (inclusive). 1920 is added to both bytes before using the values.
Since the year counting stops in 2070 even with EternalGame on, start years above 150 mean "never", and end years above 150 mean "forever".
WARNING: Don't set the start year below 1930 (0Ah) unless you know what you're doing! If TTDPatch finds a building that is available before 1930, it will not build old building types until that year, so you have to provide at least one custom building type that is available before 1930 for every town zone, or TTD may deadlock while trying to create a random game or expand a town.
Population (0B) and Mail generation multiplier (0C)
The population of the town will be increased by the amount set in prop. 0B if this building is built. Additional house parts should have a population of zero. The higher this value is, the more passengers this building generates.
The higher the mail generation multiplier is, the more mail the building generates. For multi-tile buildings, mail generation is done in per-tile basis, so you can specify different values for every tile, although distributing the generation equally between tiles is suggested.
Passenger (0D), Mail (0E) and Good/Food/Fizzy drinks (0F) acceptance
The acceptance is given in units of 1/8th and must not be larger than 8 eighths.
For prop. 0F, positive values indicate that the building accepts goods, and negative values indicate acceptance of food or fizzy drinks (depending on the climate).
Note that the officefood switch may modify acceptance in the sub-arctic and subtropical climates.
All the above three values can be set independently for tiles of multi-tile buildings, since every tile is processed individually when determining what a station accepts.
Building name ID (12)
The ID of the text that should be displayed in the land query window. The name can also be set by action 4 (see there). Should be set to the same value for every tile for multi-tile buildings.
Building availability mask (13)
||Bit|Value|Meaning
0..4|1,2,4,8,10|which town zone(s) the building can be built in
11|800|can appear in sub-arctic climate above the snow line
12|1000|can appear in temperate climate
13|2000|can appear in sub-arctic climate below the snow line
14|4000|can appear in subtropical climate
15|8000|can appear in toyland climate||
This property should be set to zero for additional building tiles.
House callback flags (14,1D)
For houses, the following callbacks can be defined by setting the corresponding bit in property 14:
||Bit|Value|Variable 0C value|Callback
0|1|17|decide whether the house can be built on a given tile
1|2|1A|decide the following frame of the animations
2|4|1B|periodically start/stop the animation
3|8|1C|change animation when construction state changes
4|10|1E|decide the color of the building
5|20|1F|decide the cargos amounts accepted
6|40|20|decide the length of the current animation frame
7|80|21|trigger destruction of building||
Property 1D was introduced after all bits of property 14 were filled. Its usage is the same, only the meaning of bits is different:
||Bit|Value|Variable 0C value|Callback
0|1|2A|decide the cargo types accepted
1|2|2E|custom cargo production
2|4|143|conditional protection||
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 variational action 2 for callbacks.
Callback flags are ignored for additional building tiles.
House override byte (15)
Setting this property makes this building appear instead of the given old TTD building type. Setting the property is ignored if the given old house type is already overridden. You can set this property more than once to override more old building types.
No new house of the overridden types will be built in towns.
This property works in a per-tile basis, so you override tiles of old multi-tile buildings individually, although the old type will still be built if you don't override its north tile.
Periodic refresh multiplier (16)
This is used for random triggers, and sets how often the tile is re-randomized. If you want all tiles to be re-randomized, you must set this (but not necessarily to the same value) for each tile.
If callback 1B is enabled in property 14, it is also called after re-randomizing random bits.
Random colours (17)
This specifies four colors used for random painting (see action 2). Each byte of the dword defines a color, the values are the same as in action 3, except that numbering starts from zero instead of 775. If not set, this defaults to 04 08 0c 06 (red, blue, orange and green, the colors of the modern office building). Can be set to different values for tiles of multi-tile buildings.
Probability (18)
This sets the relative probability of this house being built. Old TTD house types have a probability of 16, and this is the default for new types as well.
Increase (or better multiply) this value to make your building appear relatively more often, or decrease (divide) it to make it rarer. If you set this to zero, the house type never appears. The minimal useful value 1 means it's sixteen times less probable to build this type than a normal type, while the maximum setting of 255 means it's almost sixteen times more probable.
The probability is relative since the absolute probability depends on the count and probability of other houses as well: the more types are available (and the higher their probabilities are), the less the chance is that your type will be chosen.
Extra Flags (19)
||Bit|Value|Meaning
0|1|This building appears during the generation of a town, but not later, i.e. will appear in random games, but new ones won't be built during the game. Useful for buildings that are intended to be historical.
1|2|This building is protected, i.e. towns an AI players won't remove it. Human players can still remove it, so you may need to set a high remove cost/rating to make them think twice.
2|4|Synchronized callback 1B. (for multi-tile buildings)
3|8|Callback 1A needs random bits (from 2.5 beta 2)||
If synchronized callbacks are enabled, callback 1B will be called when the periodic processing reaches the main tile of the building, and not when it reaches the current tile. This is useful if your animation must run synchronously on every tile of the building. If this bit is set, callback 1B is called according to the main tile's property 16, not the current one, to make sure every tile stays in sync.
Animation Frames (1A)
The bottom seven bits define how many frames the animation consists of, minus one. (I.e. 0 means 1 frame, 1 means 2 frames etc.) Currently only those animations are supported that don't have more than 32 frames, so the maximum is 31.
The highest bit is set if the animation is looping, i.e. it should start again from the first frame after showing the last frame. Non-looping animations stop after the last frame, leaving it on the screen. Both kinds of animations start automatically when the building is created. It's recommended to use callback 1B with non-looping animations, so they are played multiple times.
Animation Speed (1B)
This is the amount of time between switching frames.
The default value is 2, which means the switch occurs every 108 milliseconds. Increasing this value by one doubles the wait, i.e. 3 will cause 216 ms delay, while 4 will pause 432 ms, and so on. Values below 2 have the same effect as 2, so the default is the fastest possible setting. The maximum is 16, which means 1769 seconds (approx. half an hour) delay. Settings above this value may cause strange behaviour.
Building Class (1C)
Types that were given the same class byte are considered to be in the same class. If you don't explicitly set this value, the type is considered to have no class (it won't be considered to be class 0). The scope of a class is the current GRF file, so two types are never in the same class if they were defined by different GRF files. Currently, this property affects variable 44 only.
This property is a per-tile one, you can set it for additional tiles as well. It's a better idea, however, to set it for the main tile only, since var. 44 counts tiles, not buildings, and you may count multi-tile multiple times otherwise.
Accepted cargo types (1E)
There may be cases when you want your house to accept something other than the default types (passenger, mail, goods and food). This property allows you to do that. If this property is set to FFFFFFFFh (the default), the meaning of properties 0D, 0E and 0F aren't changed, that is, they are the passenger, mail and goods/food acceptances, accordingly. If this property isn't FFFFFFFFh, the first three bytes must be climate-dependent cargo slot numbers (the fourth byte is ignored). In this case property 0D is the amount of acceptance of the first cargo type given, 0E is the same for the second type and 0F is the same for the third type.
From GRF version 7 and above, the meaning of this property changes: instead of climate-dependent cargo slot numbers, you have to give climate-independent cargo IDs. If your GRF has a cargo translation table, then this ID is the index in that table; otherwise, it's the cargo bit. Acceptance of cargoes not currently present will automatically be disabled.
