Skip to content

unit:type

Read the canonical unit classification, including unknown.

Signature

unit:type()

Contract and usage

unit:type()

Returns player, companion, npc, object or unknown.

Unit Identity And Lifetime

Every GosUnit state-reading method raises stale_unit after its world generation expires. unit:handle() is the exception and remains available so the unit can be reacquired with a fresh world:resolve(handle).

Within one world, repeated lookups of the same unit compare equal with ==. Values from different generations compare unequal even when their handles match.

Full world and units contract