Callback: Autoreplace vehicle selection - Revision history

Heresy: Removed all nbsp tags and changed the formatting of the text a bit with some line breaks.

2022-08-30T22:12:53Z

Removed all nbsp tags and changed the formatting of the text a bit with some line breaks.

← Older revision		Revision as of 22:12, 30 August 2022
Line 1:		Line 1:
	== Autoreplace vehicle selection (34) ==		== Autoreplace vehicle selection (34) ==

	This callback is called whenever an old vehicle needs replacing. It ~~returns the vehicle IDs to upgrade the current vehicle to. The vehicle variables are available as usual to decide which IDs would be appropriate to upgrade to.~~		This callback is called whenever an old vehicle needs replacing. <br>
			It returns the vehicle IDs to upgrade the current vehicle to and the vehicle variables are available as usual to decide which IDs would be appropriate to upgrade to.

	The callback is repeatedly called, with the iteration number stored in lowest byte of variable 10. ~~ ~~The .grf file should return all possible IDs one by one, with the best ones listed first. ~~ The~~ ~~patch will use the first vehicle from the list that is available to the player and has the required minimum reliability as set by the autoreplace switch, and abort the callback sequence at this point.~~		The callback is repeatedly called, with the iteration number stored in lowest byte of variable 10. The .grf file should return all possible IDs one by one, with the best ones listed first. <br>
			The patch will use the first vehicle from the list that is available to the player and has the required minimum reliability as set by the autoreplace switch, and abort the callback sequence at this point.

	The callback sequence is also aborted when the returned ID is equal to the current vehicle ID. ~~This~~ ~~is to prevent downgrading, and so you must take care to always return the ID of the vehicle for which the callback is called at the appropriate place in the sequence.~~		The callback sequence is also aborted when the returned ID is equal to the current vehicle ID. <br>
			This is to prevent downgrading, and so you must take care to always return the ID of the vehicle for which the callback is called at the appropriate place in the sequence.

	If the callback fails, i.e. if no suitable ID could be found by any of the callbacks in the generic chain, the vehicle is not upgraded, and is simply renewed instead. ~~ If~~ ~~an ID is available but the player lacks the cash to upgrade, the patch waits for the cash to become available instead of either picking a worse engine or renewing the vehicle.~~		If the callback fails, i.e. if no suitable ID could be found by any of the callbacks in the generic chain, the vehicle is not upgraded, and is simply renewed instead. <br>
			If an ID is available but the player lacks the cash to upgrade, the patch waits for the cash to become available instead of either picking a worse engine or renewing the vehicle.

	For trains, each engine head will be replaced by one vehicle of the new type. ~~ As~~ ~~such, it is advisable for only return "compatible" IDs for trains that require a particular construction or arrangement of engine heads.~~		For trains, each engine head will be replaced by one vehicle of the new type. <br>
			As such, it is advisable for only return "compatible" IDs for trains that require a particular construction or arrangement of engine heads.

	The callback is always used when defined, no bit in the action 0 property needs to be set to activate it.		The callback is always used when defined, no bit in the action 0 property needs to be set to activate it.

Frosch: more strict var 10/18 masking

2015-04-18T12:27:42Z

more strict var 10/18 masking

← Older revision		Revision as of 12:27, 18 April 2015
Line 3:		Line 3:
	This callback is called whenever an old vehicle needs replacing. It returns the vehicle IDs to upgrade the current vehicle to. The vehicle variables are available as usual to decide which IDs would be appropriate to upgrade to.		This callback is called whenever an old vehicle needs replacing. It returns the vehicle IDs to upgrade the current vehicle to. The vehicle variables are available as usual to decide which IDs would be appropriate to upgrade to.

	The callback is repeatedly called, with the iteration number stored in variable 10.  The .grf file should return all possible IDs one by one, with the best ones listed first.  The patch will use the first vehicle from the list that is available to the player and has the required minimum reliability as set by the autoreplace switch, and abort the callback sequence at this point.		The callback is repeatedly called, with the iteration number stored in lowest byte of variable 10.  The .grf file should return all possible IDs one by one, with the best ones listed first.  The patch will use the first vehicle from the list that is available to the player and has the required minimum reliability as set by the autoreplace switch, and abort the callback sequence at this point.

	The callback sequence is also aborted when the returned ID is equal to the current vehicle ID. This is to prevent downgrading, and so you must take care to always return the ID of the vehicle for which the callback is called at the appropriate place in the sequence.		The callback sequence is also aborted when the returned ID is equal to the current vehicle ID. This is to prevent downgrading, and so you must take care to always return the ID of the vehicle for which the callback is called at the appropriate place in the sequence.

Pm-bot: Create a separate page for each callback

2011-06-16T18:58:09Z

Create a separate page for each callback

New page

== Autoreplace vehicle selection (34) ==

This callback is called whenever an old vehicle needs replacing. It returns the vehicle IDs to upgrade the current vehicle to. The vehicle variables are available as usual to decide which IDs would be appropriate to upgrade to.

The callback is repeatedly called, with the iteration number stored in variable 10.  The .grf file should return all possible IDs one by one, with the best ones listed first.  The patch will use the first vehicle from the list that is available to the player and has the required minimum reliability as set by the autoreplace switch, and abort the callback sequence at this point.

The callback sequence is also aborted when the returned ID is equal to the current vehicle ID. This is to prevent downgrading, and so you must take care to always return the ID of the vehicle for which the callback is called at the appropriate place in the sequence.

If the callback fails, i.e. if no suitable ID could be found by any of the callbacks in the generic chain, the vehicle is not upgraded, and is simply renewed instead.  If an ID is available but the player lacks the cash to upgrade, the patch waits for the cash to become available instead of either picking a worse engine or renewing the vehicle.

For trains, each engine head will be replaced by one vehicle of the new type.  As such, it is advisable for only return "compatible" IDs for trains that require a particular construction or arrangement of engine heads.

The callback is always used when defined, no bit in the action 0 property needs to be set to activate it.
[[Category:Callbacks]]