IMM_DELETE
Keywords: IMM_DELETE, IMM_UNDELETE, WIZ_DELETE, WIZ_UNDELETE
=== STAFF MANUAL ===
Usage: delete <mob | obj | room | trig> <vid>
undelete <mob | obj | room | trig> <vid>
Description:
Flag or unflag a prototype as deleted. The entry is not
actually torn out of the running game -- instead, the matching
deleted bit is toggled on the prototype (MOB_DELETED on mobs,
ITEM_DELETED on objects, ROOM_DELETED on rooms, TRIG_DELETED
on triggers) so that the editors, listers, and stat commands
hide it and the entry stops being considered for new resets.
undelete clears the same bit, bringing the entry back.
The zone is marked dirty after the toggle, so the change
is written to the zone file on the next regular OLC save for
that zone -- persistence is automatic once a save runs.
Arguments:
type ......... One of mob, obj, room, or trig.
Abbreviations are accepted; script is
treated as a synonym for trig.
vid .......... The target prototype's virtual ID in
zone:number (or zone:namespace:number)
format. An invalid VID format prints the
usage line.
Output:
On success, nothing is printed to you directly -- the
action is recorded on the staff wiznet instead, in the
form:
OLC: <name> marks <type> <vid> as deleted.
OLC: <name> marks <type> <vid> as undeleted.
Common failure messages:
That zone is not valid.
You don't have permission to (un)delete that.
That is not a valid <type>.
Restrictions:
- Requires the OLC staff permission.
- Staff below Admin level can only (un)delete within
zones they have build access to. Admin-level staff
bypass the zone permission check entirely.
- Both the type keyword and a valid VID are required;
either missing argument reprints the usage line.
Notes:
- delete is reversible by design: until the zone is
saved after a purge of deleted entries, undelete can
still recover the prototype. Treat the deleted flag as
a soft-delete marker rather than a destructive action.
- Entries flagged deleted no longer appear in medit,
oedit, redit, scriptedit lists, nor in mstat/
ostat/rstat/sstat output, and are skipped by the
OLC menu iterators.
- For a bulk range operation, use massdelete /
massundelete instead of running this command in a
loop -- it takes a zone:start / zone:end pair and
marks every matching prototype in one pass.
Related Helpfiles: WIZ_MASSDELETE
=== END MANUAL ===