IMM_DIG
Keywords: IMM_DIG, WIZ_DIG
=== STAFF MANUAL ===
Usage: dig <direction> <vid>
Description:
Create a bidirectional exit between the room you are
standing in and the room named by <vid>. If the destination
room does not exist yet, dig creates it on the spot with a
placeholder name and description, so this is the fastest way
to grow a zone one step at a time. Both the forward exit and
its reciprocal are linked in one call, and both affected zones
are marked dirty so a regular OLC save writes the change to
disk.
Arguments:
<direction> ..... Any of the eight compass directions or
up / down. Abbreviations are accepted
through the usual direction parser.
<vid> ........... The destination's virtual ID. Short
form :<number> inherits the current
room's zone; full <zone>:<number> (or
<zone>:<namespace>:<number>) targets a
specific zone. The zone must already
exist.
New Destination:
If the destination VID has no room yet, the game creates
one with:
Name: A freshly dug room.
Desc: You are in a freshly dug room.
You see a confirmation line:
New room created: <vid>
The new room is inserted into the world immediately and
is ready for redit to flesh out.
Output:
On success the invoker sees:
New exit created <dir> to <vid> - zone '<tag>'.
The action is logged to the staff wiznet as:
OLC: <name> creates exit from <src> <dir> to <dst>.
Restrictions:
- Requires the OLC staff permission and build access
to both the source and destination zones.
- If the source room already has an exit in the named
direction, dig refuses:
"There's already an exit in that direction!" Use
rmexit first.
- If the destination room already has an exit coming
back in the opposite direction, dig refuses:
"The destination room already has an exit going in
the opposite direction!" This guards against
accidentally overwriting an existing link.
- Either room being open in an active redit session
blocks the command -- the editor has the room locked
and the game reports which staff member has it open.
- Missing arguments, a bad direction, or an invalid
VID print usage help: "Syntax: dig <direction>
<vnum>".
Notes:
- The created exits are blank (no key, no flags, no
description). Follow up with redit on either side to
adjust door flags, keys, or custom descriptions.
- dig is reversible with rmexit <direction> in the
source room -- it removes both halves of the link when
the reciprocal is intact.
Related Helpfiles: WIZ_RMEXIT, WIZ_REDIT
=== END MANUAL ===