IMM_OWHERE
Keywords: IMM_OWHERE, WIZ_OWHERE
=== STAFF MANUAL ===
Usage: owhere <keyword>
owhere <vid>
Description:
Find every live object instance in the world that matches a
search term, and report where each one currently sits. Use it
to track a unique item, confirm a reset produced the right
objects, or hunt down a missing keyed item that a player
claims has vanished.
Search Modes:
The argument is parsed first as a virtual ID; if it is a
well-formed VID, the search matches objects whose prototype
VID is exactly equal. Otherwise the argument is treated as a
keyword and matched against each object's keyword list via
isname. Short-form VIDs (:<number>) inherit the current
room's zone, so searching for an object in the zone you are
standing in does not require repeating the zone tag.
Output:
Each matching instance produces a numbered row. The
display adapts to where the object actually is:
Lying in a room:
O<n>. <name> - [<vid>] <room name>
In a character's inventory:
O<n>. <name> - carried by <name>
Equipped on a character:
O<n>. <name> - worn by <name>
Inside another container:
O<n>. <name> - inside <container>, which is
- <recursively-printed location>
Otherwise unlocated:
O<n>. <name> - in an unknown location
If no matches are found, the command prints:
Couldn't find any such thing.
Visibility:
The search honors normal staff visibility -- objects you
cannot see are silently skipped. Additionally, an object
carried by someone you cannot see is also skipped, so you
cannot use owhere to out a hidden player through their
inventory.
Restrictions:
- Available to any immortal. No permission flag is
checked; the level gate in the command table is the
only guard.
- An empty argument prints the usage block and
performs no search.
- Results are paged inline; there is no filter for
capping the number of hits, so a broad keyword on a
heavily populated world can produce a long list.
Notes:
- For mobs, see mwhere. For a player-name search,
see where.
- oindex <zone> gives a zone-scoped view of object
prototype counts; owhere is the complementary live
instance locator.
Related Helpfiles: WIZ_MWHERE, WIZ_WHERE
=== END MANUAL ===