DebrisTypes
The voxel wreckage a destroyed object throws, spent in list order against its debris budget.
- Applies to
- AircraftTypeBuildingTypeInfantryTypeUnitType
- File
rules.ini- Section
[<ObjectType ID>]- Value
- list of VoxelAnimTypes
- When omitted
(empty)
[MYTANK] ; a UnitType registered in [VehicleTypes]MaxDebris=6DebrisTypes=MYSCRAP,MYTIRE ; VoxelAnimTypes registered in [VoxelAnims]DebrisMaximums=4,2The list is only reached when MaxDebris is above zero, and it replaces the generic fallback rather than adding to it: a type with a budget and no list of its own throws MetallicDebris animations instead.
Entries are spent strictly in order. Each entry contributes a count drawn at random from zero up to its own DebrisMaximums figure, trimmed to whatever is left of the budget, and the pieces are created at the object’s center owned by the object’s house. The walk stops as soon as the budget runs out or the list ends, so a later entry is reached only when the earlier ones drew low counts — an entry after several generous ones may never appear at all.
Writing DebrisTypes=none empties the list and sends the type back to the fallback. Writing the key with nothing after the = is a different thing: the read finds no value and keeps whatever an earlier rules file set.