IMM_RCOPY
Keywords: IMM_RCOPY, WIZ_RCOPY
=== STAFF MANUAL ===
Usage: rcopy <source vid> <destination vid>
Description:
Duplicate a room to a fresh virtual ID. Unlike mcopy / ocopy,
the copy is a content-only duplicate: the source room's name,
description, sector, room flags, and extra descriptions are copied
into a new RoomData at the destination, but anything that lives
off the room -- exits, room triggers, or the room's entry in the
zone reset list -- is not brought along.
Use rcopy when you want to clone a room's look-and-feel as a
starting point for a new area: cave walls, a building interior, a
stretch of corridor. Link the result in with dig afterwards, and
use scriptedit / zedit to restore any triggers or resets you
need.
Copied Fields:
Name .............. Room title.
Description ....... Main room text.
Sector ............ Terrain sector.
Flags ............. Full room flag bitset.
Extra descs ....... Every keyword-triggered extra.
Not Copied:
Exits ............. The destination is created with no
links in any direction. Dig them in
yourself.
Room triggers ..... Any attached triggers or behavior
sets on the source are left behind.
Zone resets ....... Reset commands targeting the source
room are untouched; the new room has
no resets until you add them.
Map symbol ........ Any custom map symbol or overlay
data attached to the source.
Arguments:
<source vid> ..... Virtual ID of the source room. Short
form :<number> inherits the zone from
the current room; full
<zone>:<number> targets any zone.
<destination vid> Virtual ID the new room will occupy.
Short form inherits the source VID's
zone rather than the current room's.
Output:
On success the invoker sees:
Copied room <src> to <dst>.
And the staff wiznet records:
OLC: <name> copies room <src> to <dst>
Restrictions:
- Requires the OLC staff permission and build access
to the destination zone.
- Both arguments are required. Omitting one prints
the shared usage line for the whole copy family:
"Usage: [rcopy|ocopy|mcopy|scriptcopy] <source>
<destination>".
- The destination VID must be well-formed and its
zone must already exist; otherwise the command reports
"Invalid destination VirtualID." or "The destination
zone does not exist.".
- The source room must already exist
("Source room not found.").
- The destination must be empty -- rcopy refuses to
overwrite:
"You cannot copy over an existing room."
Notes:
- The zone save is deferred. Your edit is live
immediately, but the new room only hits disk on the
next OLC save for the destination zone -- usually as
soon as you quit out of an editor or run
massolcsave.
- To copy a chain of rooms, run rcopy on each source
and link them together with dig; there is no bulk
variant of this command.
Related Helpfiles: WIZ_MCOPY, WIZ_OCOPY, WIZ_SCRIPTCOPY
=== END MANUAL ===