IMM_TINDEX
Keywords: IMM_TINDEX, WIZ_TINDEX
=== STAFF MANUAL ===
Usage: tindex
tindex <zone>
Description:
List every script (trigger) prototype in a zone, annotated
with its live instance count. Unlike tlist, which is just a
VID + name dump, tindex also shows how many copies of each
script are currently running attached to live entities -- the
number in front of the VID is pulled from the prototype's
GetCount. Use it to find scripts that never fire, scripts
with leaked instances, or to verify that a fresh reset attached
everything a zone's reset script promises.
Argument:
<zone> ........ The zone tag to list. Omit to use the zone
you are currently standing in. An unrecognized
tag returns:
'<arg>' is not a valid zone.
Output:
The listing is paged and sorted by VID. Each row has the form:
<count> <vid> - <script name>
Where <count> is blank when no live instances exist, <vid>
is the script's virtual ID, and <script name> is the
trigger's name as set in scriptedit.
The header reads "Scripts in zone '<tag>':" -- the engine
uses "scripts" rather than "triggers" because both terms
refer to the same prototype list internally.
An empty zone shows "None!" after the header. If the listing
would exceed the internal output buffer, it is truncated and
terminated with:
*** OVERFLOW ***
In that case, drill down with tlist <zone>:<namespace> to
inspect a smaller slice.
Restrictions:
- Requires the OLC staff permission.
- The argument is matched against the full zone tag --
partial or prefix matches are not accepted.
Notes:
- Prototypes flagged TRIG_DELETED still appear in the
listing; check the trigger's flags in sstat if the
instance count is always zero.
- tindex iterates the full trig_index range for the
zone, so listing large zones can be slightly slower than
tlist.
Related Helpfiles: WIZ_MINDEX, WIZ_OINDEX, WIZ_ZLIST
=== END MANUAL ===