IMM_STRING
Keywords: IMM_STRING, WIZ_STRING, IMM_RESTRING, WIZ_RESTRING
=== STAFF MANUAL ===
Usage: string character <name> <field> <value>
string object <name> <field> <value>
Description:
Overwrite the text strings on a character or object in the
running game. The new <value> is taken from the rest of the
command line -- there is no multi-line editor; whatever follows
the field name is used verbatim (color codes included). Changes
apply to the live instance only; for permanent edits on a
prototype, use medit, oedit, or redit.
Abbreviations are accepted for every token, so
string ch fred sh a tired-looking marine is equivalent to the
fully-spelled form.
Target Resolution:
character <name> ... Any character in the world, resolved
with normal staff visibility.
object <name> ...... Resolved against your inventory,
your equipment, and the room you are
standing in. Items elsewhere in the
world return "You can only restring
items in your inventory, equipment, or
the room."
Fields:
name ............ Keyword list. Legal on NPCs and
objects. Players are rejected with
"You can't re-string player's names.".
short ........... Short description (the inline
reference used in act messages). NPCs
and objects only -- players have no
short desc.
long ............ Long / room description. NPCs and
objects only. For NPCs the engine
appends a trailing newline for you.
title ........... Player title only. Mobs return
"Mobs don't have titles.". Retitling a
staff target requires Coder level --
lower-ranked staff see "You can't
restring the title of staff members!".
owner ........... Object ownership transfer. The
argument is the player name of the new
owner. The owner is notified with "You
now own <obj>." and the change is logged
to the staff wiznet as
"(GC) <name> set <obj>'s owner to <new>".
This is the only string field that
writes to the wiznet.
description ..... Not wired up. Returns
"Feature not implemented yet.".
delete-description
Objects only. The <value> is matched
against each extra-description keyword;
the first match is removed. On a miss
you see "Extra description not found.".
Restrictions:
- Requires the Characters staff permission.
- All four tokens (type, name, field, value) are
required; omitting any reprints the usage line.
- Unknown field names return "No such field.".
- Changes are in-memory only on live entities. For a
mob, the string reverts on extract or zone reset; for
an object, the string stays until the object is
destroyed or zone-reset. Use OLC to make them permanent.
=== END MANUAL ===