Skip to content

Object Tags

Tags can be used to govern how objects interact with some of the tools described in this section.

Standard Interaction Rules

Tags govern interaction between features (Zones, Snap-Points, etc.) and objects (Cards, Dice, etc.).

  • If the feature has no tags, then it will interact with every object, regardless of what tags the object has.
  • If the feature has one or more tags, then it will interact only with objects which share at least one of those tags.

Features which utilize tags

  • Hidden Zones
  • Randomize Zones
  • Hand Zones
  • Fog of War Zones
  • Layout Zones
  • Scripting Zones
  • Snap Points


To add a tag to an object or feature, right-click and select the Tags menu item. This will open the Tags window:

Tags Window

Clicking on a tag will toggle it being enabled for that object. The host may add further tags by typing the tag name into the input at the bottom.


Only the host may create new tags, but any promoted player may toggle already existing tags.

Snap Point Creation Tags

Editting tags on a lot of snap points would quickly get tedious; instead it is better to set the default snap-point tags:

Snap-Point Creation Tags

Whatever tags you select for these will be applied to every snap point created from then on.

Object-Object Interactions

By default tags do not affect how objects interact with each other; however you may add such functionality with scripting. For example, the following script will add tag checking to objects entering containers, using the standard interaction rules described above. It will also add all the container tags to an object when the object is removed from the container.

function tryObjectEnterContainer(container, object)

    allow_interaction = not container.hasAnyTag() or container.hasMatchingTag(object)
    -- The above is the standard tag interaction rule:
    -- If the 'feature' does not have any tags, or if the
    -- feature and object share a tag.

    return allow_interaction

function onObjectLeaveContainer(container, object)
    for i, tag in pairs(container.getTags()) do

Edit Tags Window

The host has access to the Edit Tags window (via Modding->Tags in the top toolbar).

Edit Tags

Hovering over a tag in this window will highlight all objects on the table which have that tag, or, if you already have objects selected, which of those selected objects have that tag.

Clicking on a tag will set the object selection to the highlighted objects.

You may delete the tag, removing it from all objects, by clicking the Delete button.