KDRenewable

KDRenewable ensures that a supply of an object is always available to the player. Whenever the player's inventory stack count of the object drops below a threshold, a new instance of the object is created at the KDRenewable marker's position. Only one new instance may exist at a time, so another will not be created until the previous one has been picked up or destroyed.

The renewable object is identified by a ScriptParams link with the data Renewable from the KDRenewable marker to an archetype. This script correctly handles the standard T2 crystal types, looking for the corresponding arrows in inventory. It also correctly handles archetypes (or their parents) with Transmute links, as used by the Transmogrify script in Public Scripts.

The renewable_threshold parameter specifies the maximum stack count of the object that may be in the player's inventory. The renewable_frequency parameter specifies how often the inventory check is performed. At each interval, if the inventory stack count is below the threshold and any previously created instance has been consumed, a new instance is created.

By default, the new instance is created without a physics model to avoid, for example, a bomb or projectile immediately making impact. (Once an object has entered and left the player's inventory, the engine will make it physical again.) As such, the marker should be positioned and rotated appropriately for the object being created. If the renewable_physical parameter is true, however, any physics model on the created object will not be removed (though neither will one be added if the archetype does not specify one).