IMM_OEDIT
Keywords: IMM_OEDIT, WIZ_OEDIT
=== STAFF MANUAL ===
Usage: oedit <vid>
Description:
Interactive editor for object prototypes. Opens the target
VID in a menu-driven session where every field on an item --
names, descriptions, type, values, flags, affects, weapon and
armor side-data, scripts, applies, and extras -- can be edited
from a single screen. Edits are held in a scratch copy until
you quit the editor; only then are they written back to the
prototype.
If the VID does not exist yet, oedit creates a new
placeholder object at that number with the starter strings
"an unfinished object" / "unfinished object" / "An unfinished
object is lying here." and the ITEM_WEAR_TAKE flag set so
you can pick it up immediately for testing.
Main Menu:
1 Namelist (keywords) 2 S-Desc
3 L-Desc 4 A-Desc (long read)
5 Type 6 Extra flags
7 Race restriction 8 Wear flags
9 Weight A Affect flags
B Timer D Values (type-specific)
V MP cost P SP cost
E Applies menu F Extra descriptions
C Clan restriction L Level restriction
K Class restriction H Faction
M Max attachments U Auras
I Attachment slots S Scripts
Q Quit
Extra rows appear depending on item type:
T Weapon tags (only when type = weapon)
X Combat effects (only when type = armor or grenade)
Y DOT applies (only when type = grenade)
O Optic range (only when ITEM_OPTIC flag set)
(Has Variables) after the script list indicates that
one or more initial globals are set on this object.
Saving:
On Q, if anything was modified you are prompted to save.
Saving copies the scratch ObjData into the live obj_index
entry and swaps the trigger list, behavior sets, and initial
globals into place. The destination zone is marked dirty so
its .obj file is rewritten on the next OLC save pass.
Saving also performs two small side cleanups:
- The ITEM_DELETED flag is cleared automatically,
bringing the object back if it was previously marked
for soft-deletion.
- If the type has been changed away from weapon and
the object still carried gun-info metadata, that
metadata is freed so the prototype stays clean.
Restrictions:
- Requires the OLC staff permission and build access
to the target zone.
- Creating a new object at a VID requires permission
on the destination zone, same as any other OLC add.
- Two staff cannot have the same object open at once;
ocopy, omove, and other commands that touch a
locked prototype refuse with a "currently being
edited by <name>" message.
Related Helpfiles: WIZ_MEDIT, WIZ_REDIT, WIZ_ZEDIT
=== END MANUAL ===