@tag detail (@Tag)



@TAG
====

Add, view, search or delete Tags on any object.

Usage::

    @tag <obj>                      – list tags on an object
    @tag <obj> = <tag>[:<category>] – add/replace tag
    @tag/del <obj> = <tag>[:<cat>]  – remove one tag
    @tag/del <obj>                  – clear *all* tags on <obj>
    @tag/search <tag>[:<category>]  – find objects with a given tag

Quick summary
-------------
• Tags are free-form strings used for grouping, searching, locks, scripts
  and – in the case of *zone* – world navigation.

• The **zone** category now stores the *full* hierarchical path *in one tag*.

    lobby/human_resources/training        (good)
    lobby, human_resources, training      (legacy – avoid)

• Prefer the helper ``@setzone`` when tagging rooms – it prevents orphaned
  ancestor tags and enforces the slash-delimited convention.

Search examples::

    @tag/search green                   # any "green" tag in any category
    @tag/search rooms:material          # tag "rooms" in "material" category
    @tag/search lobby:zone              # rooms *in or under* lobby (exact)

Python::

    rooms = evennia.search_tag("lobby", category="zone", matchtype="startswith")

Locks::

    @lock exit = traverse:tag(lobby, zone)

See also: ``help ZONES``, ``help setzone``

Building