IMM_CEDIT
Keywords: IMM_CEDIT, WIZ_CEDIT
=== STAFF MANUAL ===
Usage: cedit <clan #>
cedit save
Description:
OLC editor for clan records. Opens a numbered clan in the
standard menu-driven editor so its top-level properties can
be rewritten without hand-editing the clans file. Editing an
ID that does not yet exist creates a new clan at that number,
seeded with the placeholder name and tag "New Clan" and a
default rank list. Use cedit save as a standalone command to
flush every clan in memory to disk.
Main Menu:
1 Name .......... Clan display name. Free-form string.
2 Tag ........... Short abbreviation used in chat
headers and rosters.
3 Owner ......... Clan leader, entered by character
name. The name is resolved to an
account ID -- an unknown name stores
as no owner.
4 Room .......... Clan home room. Accepts a room
virtual ID or a resolvable room name;
an unresolved value clears the slot.
5 Savings ....... Integer clan bank balance.
6 Races ......... Race-bitflag toggle submenu. Pick
a numbered race from the list to flip
its bit; enter 0 to return. <ANY> in
the summary means no restriction.
7 Member Limit .. Maximum member count. 0 is the
explicit unlimited value and is
displayed as (Unlimited) in the menu.
Q Quit .......... Leave the editor. If any field was
changed you are prompted "Do you wish
to save this clan?"; Y saves the draft
into the live index and writes the
clans file, N discards.
Standalone Save:
cedit save flushes every in-memory clan to disk at once
without opening the editor. Useful after a batch of edits or
before a copyover. The save is logged to the staff wiznet as:
OLC: <name> saves all clans
A normal interactive save is logged on exit as:
OLC: <name> edits clan <id>
Restrictions:
- Requires the Clans staff permission.
- The argument must be a positive integer or the
literal word save. Numbers <= 0 are rejected with
"Clan number must be > 0."; non-numeric arguments
other than save return "Yikes! Stop that, someone
will get hurt!".
- An interactive cedit session with no argument
prompts "Specify a clan ID to edit.".
Notes:
- Saving a new clan inserts it into the clan index
in sorted order and calls Clan::RebuildRelations so
cross-clan opinion data picks up the addition
immediately.
- New clans are created with a default set of ranks;
rank composition itself is not edited in cedit.
- Clearing the Room field (by entering a value that
does not resolve) sets the clan home to an empty
virtual ID rather than refusing the edit.
Related Helpfiles: CLANSTAT, WIZ_FORCEENLIST
=== END MANUAL ===