IMM_CRASH
Keywords: IMM_CRASH, WIZ_CRASH, CRASH
=== STAFF MANUAL ===
Usage: crash
crash <vid>
Description:
Despite the name, crash does not crash anything. It prints
the next unused room VID in a given namespace -- the next
free slot above the highest-numbered room currently assigned
in that namespace. Use it when you are about to add a new
room with dig or redit and want to grab the smallest
unallocated number without scanning the zone by hand.
Argument:
<vid> .......... Any virtual ID whose namespace you want
to query. The namespace is extracted and
used for the lookup; the numeric part of
the argument is ignored. Short form
:<number> or full <zone>:<namespace>:<number>
both work.
(no argument) .. Uses the VID of the room you are
currently standing in, which is the most
common way to find the next slot while
already building inside a zone.
An argument that does not parse as a valid VID is
silently replaced with the current room's VID, so you
can pass garbage and still get a useful answer for where
you are standing.
Output:
The command prints a single line containing the next
available room VID in its normal
<zone>:<namespace>:<number> form:
human:camp:1234
Restrictions:
- Requires Coder level. There is no permission
flag; the level check in the command table is the
only guard.
- crash only reports -- it does not reserve, lock,
or otherwise claim the returned VID. Another builder
creating a room in the same namespace between your
query and your edit could grab the same number.
Notes:
- For the analogous operation on mobs, objects, or
scripts, use the matching OLC command rather than
crash -- this helper only walks the room index.
- The command name is a historical misnomer. Do not
run it expecting diagnostic information about an
actual crash; for that, check the mudlog and the
syslog stream.
=== END MANUAL ===