Difference between revisions of "Action0/Vehicles"

From GRFSpecs
Jump to navigationJump to search
m (Bot: Automated text replacement (-OTTD +OpenTTD, -TTDP +TTDPatch ))
m (heading size)
Line 1: Line 1:
 
== Introduction ==
Action 0 properties common to all vehicle types
+
Action 0 properties common to all vehicle types:
 
Defining properties of vehicles.
 
 
= Introduction =
 
 
 
The four vehicle types (trains, road vehicles, ships and planes) all have some common properties, which are described here.
 
The four vehicle types (trains, road vehicles, ships and planes) all have some common properties, which are described here.
   
= Properties =
+
== Properties ==
   
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
!Number !!Version !!Size !!Description !!Available for articulated parts
+
!Number !!Version !![[GRFActionsDetailed|Size]]!!Description !!Available for articulated parts
 
|-
 
|-
 
|00 || ||W||date of introduction||no
 
|00 || ||W||date of introduction||no
Line 28: Line 24:
 
TTDPatch only: Properties 00 to 06 only apply to new games, or when using [[ResetVehicleData|Cht: ResetVehicles]].
 
TTDPatch only: Properties 00 to 06 only apply to new games, or when using [[ResetVehicleData|Cht: ResetVehicles]].
   
= Description =
+
== Description ==
   
== Date of introduction ==
+
=== Date of introduction ===
   
 
The date is specified as number of days since 1920 where TTD counts 365,25 days in a year. It will have a random number from 0 to 511 days added to it at the start of every new game, or after using "Cht: ResetVehicles" (TTDPatch).  Note that TTD stops updating vehicle type data after the game ends in 2050, so all dates of introduction should be no later than in 2044, to ensure that all vehicle types can be introduced and reach their maximum reliability.
 
The date is specified as number of days since 1920 where TTD counts 365,25 days in a year. It will have a random number from 0 to 511 days added to it at the start of every new game, or after using "Cht: ResetVehicles" (TTDPatch).  Note that TTD stops updating vehicle type data after the game ends in 2050, so all dates of introduction should be no later than in 2044, to ensure that all vehicle types can be introduced and reach their maximum reliability.
Line 40: Line 36:
 
The \w<date> escape sequence is especially useful here. See [[GRFActionsDetailed#Byte order|the discussion of escape sequences]] for further information.
 
The \w<date> escape sequence is especially useful here. See [[GRFActionsDetailed#Byte order|the discussion of escape sequences]] for further information.
   
== Reliability decay speed ==
+
=== Reliability decay speed ===
   
The reliability decay speed is set when a new vehicle is bought, and specifies how quickly the reliability decays after servicing.  The initial TTD default for all vehicles is 20.  If a vehicle goes without servicing for a long time, or if it gets very, very old, this number increases, meaning faster decay and more breakdowns.  Larger numbers mean faster decay, smaller number slower decay.  If set to 0, reliability never decreases in normal operation.
+
The reliability decay speed is set when a new vehicle is bought, and specifies how quickly the reliability decays after servicing.  The initial TTD default for all vehicles is 20.  If a vehicle goes without servicing for a long time, or if it gets very, very old, this number increases, meaning faster decay and more breakdowns.  Larger numbers mean faster decay, smaller number slower decay. If set to 0, reliability never decreases in normal operation.
   
== Vehicle life ==
+
=== Vehicle life ===
   
 
The number of years before a particular vehicle is considered too old and needs replacing,
 
The number of years before a particular vehicle is considered too old and needs replacing,
   
== Model life ==
+
=== Model life ===
   
 
The number of years that this model can be bought in the game (if PersistentEngines is off).  Usually this should be at least twice or three times as  long as the vehicle life.  When starting a new game, a random amount between 31 months and 17 years is added to this as well.
 
The number of years that this model can be bought in the game (if PersistentEngines is off).  Usually this should be at least twice or three times as  long as the vehicle life.  When starting a new game, a random amount between 31 months and 17 years is added to this as well.
Line 77: Line 73:
 
Note: This property also works for wagons since TTDPatch 2.5 beta 7 resp. OpenTTD r14680.
 
Note: This property also works for wagons since TTDPatch 2.5 beta 7 resp. OpenTTD r14680.
   
== Climate availability ==
+
=== Climate availability ===
   
 
This is a bit mask of the climates in which this model is available.  Simply add the values for the climates:
 
This is a bit mask of the climates in which this model is available.  Simply add the values for the climates:
Line 98: Line 94:
 
If you need a vehicle not to be available through the purchase menu, e.g. a locomotive tender being part of an articulated vehicle (locomotive and tender), you may use a value of zero for the bit mask. Same procedure works for vehicles to be used exlusively by TTDPatch's AI, but not by a human player.
 
If you need a vehicle not to be available through the purchase menu, e.g. a locomotive tender being part of an articulated vehicle (locomotive and tender), you may use a value of zero for the bit mask. Same procedure works for vehicles to be used exlusively by TTDPatch's AI, but not by a human player.
   
== Load amount ==
+
=== Load amount ===
 
 
This is the amount of cargo transferred per unit of time if using gradualloading.  The default is 5 for trains and road vehicles, 10 for ships and 20 for aircraft.
 
This is the amount of cargo transferred per unit of time if using gradualloading.  The default is 5 for trains and road vehicles, 10 for ships and 20 for aircraft.
   

Revision as of 08:25, 16 June 2011

Introduction

Action 0 properties common to all vehicle types: The four vehicle types (trains, road vehicles, ships and planes) all have some common properties, which are described here.

Properties

Number Version Size Description Available for articulated parts
00 W date of introduction no
02 B reliability decay speed no
03 B vehicle life in years no
04 B model life in years no
06 B climate availability should be zero
07 2 B load amount yes

TTDPatch only: Properties 00 to 06 only apply to new games, or when using Cht: ResetVehicles.

Description

Date of introduction

The date is specified as number of days since 1920 where TTD counts 365,25 days in a year. It will have a random number from 0 to 511 days added to it at the start of every new game, or after using "Cht: ResetVehicles" (TTDPatch).  Note that TTD stops updating vehicle type data after the game ends in 2050, so all dates of introduction should be no later than in 2044, to ensure that all vehicle types can be introduced and reach their maximum reliability.

In TTDPatch: If the property value is 729 (2D9h) or less, i.e. before 1922, the random number is not added and the vehicle is introduced at exactly the given date.

In OpenTTD: Since r16929 the start date is not randomised in the first two years after game-start (no matter whether before or after 1922).

The \w<date> escape sequence is especially useful here. See the discussion of escape sequences for further information.

Reliability decay speed

The reliability decay speed is set when a new vehicle is bought, and specifies how quickly the reliability decays after servicing.  The initial TTD default for all vehicles is 20.  If a vehicle goes without servicing for a long time, or if it gets very, very old, this number increases, meaning faster decay and more breakdowns.  Larger numbers mean faster decay, smaller number slower decay. If set to 0, reliability never decreases in normal operation.

Vehicle life

The number of years before a particular vehicle is considered too old and needs replacing,

Model life

The number of years that this model can be bought in the game (if PersistentEngines is off).  Usually this should be at least twice or three times as  long as the vehicle life.  When starting a new game, a random amount between 31 months and 17 years is added to this as well.

If the early retirement property (26/1B/16/16) is not set, the model life works like this:

Phase Duration Reliability
1 7 to 38 months increases from 48-73% to 75-100%
2 prop. 04 less 8 years stays constant at peak, 75-100%
3 10 to 20.5 years decreases from peak to 25-50%

(the ranges in time and reliability are randomized at the start of each game)

At the end of phase 3, the model is retired and removed from the purchase list.  Note that when the model reliability starts dropping in phase 3, so does the reliability of every single vehicle of this make in the game.

Setting this property to 0xFF means the model will never expire.

If persistentengines is on, the model never gets to within two years of the end of phase 2, it is kept in phase 2 as long as at least one vehicle of this make is in the game.

If the early retirement property is set, the vehicle is retired this many years before the end of phase 2 (can be negative if desired), but not if persistentengines would keep the model alive.

Note: This property also works for wagons since TTDPatch 2.5 beta 7 resp. OpenTTD r14680.

Climate availability

This is a bit mask of the climates in which this model is available.  Simply add the values for the climates:

Bit Value Climate
0 1 Temperate
1 2 Arctic
2 4 Tropical
3 8 Toyland

For example, 1+2+4 = 07 would make a vehicle available in all climates except Toyland.

If you need a vehicle not to be available through the purchase menu, e.g. a locomotive tender being part of an articulated vehicle (locomotive and tender), you may use a value of zero for the bit mask. Same procedure works for vehicles to be used exlusively by TTDPatch's AI, but not by a human player.

Load amount

This is the amount of cargo transferred per unit of time if using gradualloading.  The default is 5 for trains and road vehicles, 10 for ships and 20 for aircraft.

Note: For aircraft carrying both passengers and mail this property is broken (wrt. mail) in TTDPatch and OpenTTD before r14672.

Since OpenTTD r14672 this property is used for passengers, while mail uses 1/4 (rounded up). You can use callback 12 to control load amounts for passengers and mail independently.