Skip to content
OpenTS Manual

UndeploysInto

The UnitType a structure turns back into when it is taken down.

Specification
Applies to
AircraftTypeBuildingTypeInfantryTypeUnitType
File
rules.ini
Section
[<ObjectType ID>]
Value
class
When omitted
none
rules.ini
[GACNST]
UndeploysInto=MCV ; Mobile Construction Vehicle

Taking such a structure down produces one vehicle of the named type instead of credits and survivors. It is placed on the structure’s own cell when the structure is one of the deployed-vehicle kinds and one cell to the south-east otherwise, facing the direction that kind deploys at. It carries over the structure’s health as a proportion of its own full strength, floored at one point, and takes over the side its artwork follows, its selection group, its crew experience, any limpet drone clamped to it, its attached tag, its selection and any move order the structure was holding. Everything that was shooting at the structure retargets onto the vehicle, except an engineer trying to capture it, which loses its target. Only if the vehicle cannot be placed at all is the money refunded instead.

The “structure sold” announcement is suppressed and no crew leaves the building. A structure holding no archived destination also becomes ready to finish its deconstruction partway through the animation rather than only at its last frame.

Not every structure that names a type may actually undeploy. The undeploy path also requires the structure to be one of the deployed-vehicle kinds, or a mobile war factory or limpet mine, or — outside a campaign game — a structure with an archive target belonging to a human house in a session where redeploying is enabled. A ConstructionYard=yes structure refuses in a campaign game, refuses for a computer house anywhere, and refuses in any session where redeploying is switched off.

Naming a type also makes the structure count as a vehicle rather than a building. It takes the move cursor, it can be given a destination and answers a movement test against the target cell, and a band selection picks it up the way it picks up a unit instead of requiring a click of its own. A construction yard is deliberately excluded from the selection and vehicle-counting parts of that, so it keeps behaving like a structure.

A name that matches no registered UnitType registers a new, unconfigured vehicle under that name rather than failing. The values none and <none> resolve to nothing at all, exactly as if the key had been left out.

See also — DeploysInto