Callback: Vehicle Start/stop check
From GRFSpecs
Jump to navigationJump to searchVehicle 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.