Difference between revisions of "Callback: Vehicle Start/stop check"
From GRFSpecs
Jump to navigationJump to search (grf version 8) |
(use new grf templates) |
||
| Line 5: | Line 5: | ||
bit 1 of variable B2. If set, the vehicle is currently stopped and if clear, the vehicle is moving (or at least, not stopped manually). |
bit 1 of variable B2. If set, the vehicle is currently stopped and if clear, the vehicle is moving (or at least, not stopped manually). |
||
| − | {{ |
+ | {{grfTill|7}} For GRF version 7 and below the valid return values are: |
{| |- |
{| |- |
||
|00..FE|| Display error message using D0xx (D000..D0FE) text as second line. |
|00..FE|| Display error message using D0xx (D000..D0FE) text as second line. |
||
| Line 18: | Line 18: | ||
|} |
|} |
||
| − | {{ |
+ | {{grfFrom|8}} For GRF version 8 and above the valid return values are: |
{| |- |
{| |- |
||
|00..3FF|| Display error message using D0xx (D000..D3FF) text as second line. |
|00..3FF|| Display error message using D0xx (D000..D3FF) text as second line. |
||
Latest revision as of 13:29, 1 April 2012
Vehicle Start/stop check (31)
This callback is called whenever a player (or the AI) tries to start or stop a vehicle. This is mainly useful for preventing vehicles from leaving the depot unless a given condition is met. To check whether a vehicle is being started or stopped, check bit 1 of variable B2. If set, the vehicle is currently stopped and if clear, the vehicle is moving (or at least, not stopped manually).
GRFv≤7 For GRF version 7 and below the valid return values are:
| 00..FE | Display error message using D0xx (D000..D0FE) text as second line. |
| FF | Start/stop action shall succeed. |
| 100..1FE | Display error message using D0xx (D100..D1FE) text as second line. |
| 200..2FE | Display error message using D0xx (D200..D2FE) text as second line. |
| 300..3FE | Display error message using D0xx (D300..D3FE) text as second line. |
GRFv≥8 For GRF version 8 and above the valid return values are:
| 00..3FF | Display error message using D0xx (D000..D3FF) text as second line. |
| 400 | Start/stop action shall succeed. |
The callback is always used when defined, no bit in the action 0 property needs to be set to activate it.
