diff --git a/evennia/objects/objects.py b/evennia/objects/objects.py index 660dc4de01..0f7bfa7ced 100644 --- a/evennia/objects/objects.py +++ b/evennia/objects/objects.py @@ -386,13 +386,16 @@ class DefaultObject(ObjectDB, metaclass=TypeclassBase): searchdata (str or obj): Primary search criterion. Will be matched against `object.key` (with `object.aliases` second) unless the keyword attribute_name specifies otherwise. - **Special strings:** + + Special strings: + - `#`: search by unique dbref. This is always a global search. - `me,self`: self-reference to this object - `-` - can be used to differentiate between multiple same-named matches. The exact form of this input is given by `settings.SEARCH_MULTIMATCH_REGEX`. + global_search (bool): Search all objects globally. This overrules 'location' data. use_nicks (bool): Use nickname-replace (nicktype "object") on `searchdata`. typeclass (str or Typeclass, or list of either): Limit search only @@ -432,8 +435,9 @@ class DefaultObject(ObjectDB, metaclass=TypeclassBase): otherwise. Returns: - match (Object, None or list): will return an Object/None if `quiet=False`, - otherwise it will return a list of 0, 1 or more matches. + Object, None or list: Will return an `Object` or `None` if `quiet=False`. Will return a + list with 0, 1 or more matches if `quiet=True`. If `stacked` is a positive integer, this + list may contain all stacked identical matches. Notes: To find Accounts, use eg. `evennia.account_search`. If