IMM_ZEDIT
Keywords: IMM_ZEDIT, WIZ_ZEDIT
=== STAFF MANUAL ===
Usage: zedit
zedit <zone>
zedit new <name>
zedit rename <oldname> <newname>
Description:
Interactive editor for zone-level data. zedit opens the zone
containing your current room; passing a zone tag targets any
other zone. The editor exposes the zone's header metadata
(name, owner, flags, lighting, weather, lifespan, reset mode)
and its reset command list -- the sequence of M / O / G /
E / P / R / D / T / C / * entries that run whenever the
zone resets.
Main Menu:
Z Zone name X Zone comment
T Zone notes (multi-line)
O Zone owner F Flags
L Lifespan (minutes) R Reset mode
I Lighting W Weather
N New command E Edit a command
D Delete a command Q Quit
The reset-mode field cycles between "Never reset",
"Reset when no players are in zone.", and "Normal
reset.". Lighting uses the zone-level setting unless
the ZONE_ALWAYSLIT flag is set, in which case the menu
shows "Always Lit" and the lighting selector is
effectively overridden.
Reset Commands:
The command list is displayed inline in the menu, one per
row with an index number you use for E and D. Each row
renders as:
M Load <mob> [<vid>] -- optional Max / Max/Zone /
Max/Room caps shown after the line.
O Load <obj> [<vid>] into the current room.
G Give it <obj> [<vid>] to the last-loaded mob.
E Equip with <obj> [<vid>], <slot> on the last mob.
P Put <obj> [<vid>] in <container> [<vid>].
R Remove <obj> [<vid>] from room.
D Set door <direction> as <state>.
T Attach script <name> [<vid>] to the last target.
C Do command: <text> (direct command execution).
* <Comment> -- no-op, used for documentation.
Rows support the following extra annotations:
- (xN) prefix when a G / O / R / P command has a
repeat count greater than one.
- [H] / [N] prefix when the command is marked hive
or no-hive for alien zone reset logic.
- "then " prefix when if_flag is set, chaining the
command to the previous one (run only if it
succeeded).
- Trailing Max / Max/Zone / Max/Room / Max/Cont
caps when the command has instance limits set.
Zone Creation and Rename:
zedit new <name> allocates a brand-new zone file on disk
and creates an empty zone in memory. The name must be
alphanumeric and must not start with a digit -- numeric zone
tags are no longer supported. The command checks for
collisions with existing zone tags and zone aliases before
creating anything.
zedit rename <oldname> <newname> renames an existing
zone, rewriting its data files to the new tag. Both names are
lowercased on input.
Both subcommands require OLC Admin. Staff without admin
see "Yikes! Stop that, someone will get hurt!".
Saving:
The editor tracks two separate dirty flags: one for
header-level changes (name, notes, flags, lighting, etc.) and
one for reset-command changes. On quit, if either is set, you
are prompted to save; saving writes back to the live
ZoneData and queues the zone file for resave on the next OLC
save pass.
Restrictions:
- Requires the OLC staff permission.
- Editing a zone you do not own or have builder access
to is blocked by the usual OLC permission check.
- Two staff cannot have the same zone open at once;
the second zedit attempt reports which staff member
has it locked.
- new and rename additionally require OLC Admin.
Related Helpfiles: WIZ_MEDIT, WIZ_OEDIT, WIZ_REDIT
=== END MANUAL ===