Skip to content
OpenTS Manual

MaxDebris

The number of pieces of wreckage a destroyed object may throw.

Specification
Applies to
AircraftTypeBuildingTypeInfantryTypeUnitType
File
rules.ini
Section
[<ObjectType ID>]
Value
integer
When omitted
0
rules.ini
[MYTANK] ; a UnitType registered in [VehicleTypes]
MaxDebris=6
DebrisTypes=MYSCRAP,MYTIRE ; VoxelAnimTypes registered in [VoxelAnims]
DebrisMaximums=4,2

A figure of zero turns wreckage off, and it is the first thing tested, so neither debris list is consulted at all. Above zero, the figure is a budget rather than a count, and which list it is spent on depends on whether the type declares DebrisTypes of its own:

  • With a list, the budget is handed out along it in order — up to the matching DebrisMaximums figure from each entry, and only as far as the budget stretches — and every piece is created at the object’s center, owned by the object’s house. A budget larger than the sum of those figures simply goes unspent; the walk stops at the end of the list.
  • Without a list, a count is drawn at random from zero up to the budget and that many [AudioVisual] MetallicDebris animations are created, each picked independently, twenty leptons above the object’s center.

The wreckage is thrown before any Explodes=yes blast and after the death voice. An object that lost its footing and fell, and then died within ten leptons of water, leaves the death path before either and throws nothing.

See also — DebrisTypes, DebrisMaximums, MetallicDebris, ExplosiveVoxelDebris