The name for this Attachment trait. This name can be used by the piece to read properties from attached pieces. For example if the Attachment name were Sibling, then the property Sibling_LocationName would contain the LocationName property of the first currently attached piece.

A short description of this trait for your own reference.

If selected, the piece will automatically attach itself to other pieces which have an Attachment trait with an identical attachment name; this can be used to easily and quickly attach pieces together. When selected, none of the advanced options for attaching and detaching pieces will be displayed. When this option not selected, the advanced options for attaching and detaching pieces will be shown.

If selected, the attachment is allowed to attach to this piece (i.e., itself) if conditions are otherwise met. If not selected, the Attachment will never attach to itself in any circumstances.

Determines whether existing attachments are cleared before adding new attachments.

If this option is selected, then whenever the key command to attach pieces executes, all existing attachments are first cleared before adding any pieces that match the command.

If this option is selected, then adding attachments will never detach pieces — meaning that executing the attach key command a second or subsequent time will only potentially add attachments, never remove any.

Determines what happens when another piece with an Attachment trait sharing the same Attachment Name attaches to this piece. Can be used to create two-way and multi-way attachments.

Nothing additional happens. This is the default setting, and useful for creating "one-way" attachments.

This piece adds that piece to its list of attachments—​in other words a mutual attachment is formed. This setting is useful for creating mutual or "two-way" attachments.

This piece adds that piece to its list of attachments. This piece also adds to its attachment every other piece that the new piece has attached (using an Attachment trait with the same Attachment Name). This setting is useful for creating "multi-way" attachments. NOTE: it will also normally result in the piece being attached to itself, unless the Allow attachment to self box is unchecked.

Name of the right-click context menu item to attach pieces. If left blank, no context menu item will appear.

A Key Command or Named Key Command that initiates attachment of pieces.

Fast Match selections can be used to improve the performance of "slow" piece filters.

If further refinement of which target pieces should be attached is needed, or if you do not wish to use Fast Match pre-selections, an Additional Matching Expression can be used. Only Game Pieces which match the specified Property Match Expression will become attached. Note that the properties named in this expression are evaluated against the properties of the target pieces, not the properties of the piece creating the Attachment. For example if you provided the expression { CurrentZone == "Europe" }, that would use the CurrentZone property of each potential target piece (checking if it is "Europe") to determine whether to attach it. If you want to compare a property in the target pieces against the value of a property in this piece, then use $property$. All $…​$ property references will be evaluated against this piece before testing against other pieces. Note that this will often mean the expression needs to be put inside of quotation marks if the property in question is a string value. For example if the expression provided is { CurrentZone == "$CurrentZone$" } then the CurrentZone of each potential target piece will be checked against $CurrentZone$ which will read the CurrentZone of the issuing piece.

Select how the Attachment command will be applied to pieces in a Deck. Options are All pieces, No pieces, or Fixed number of pieces. If Fixed number of pieces is selected, a field appears to allow entry of the number of Pieces in the Deck to affect, starting at the top of the Deck. Thus, selecting 1 for the fixed number would cause only the top card or piece in a Deck to be attached. An Expression can be used. Note that such an expression will be evaluated once at the beginning of the attachment (not each time a candidate piece is being checked).

If selected, the command will only attach pieces located within a specified distance of this piece.

Only others pieces within this distance, inclusive, of this piece will be attached. If the pieces are on a board with a Hex Grid or Rectangular Grid, then the distance is in units of the grid. Otherwise, the distance is measured in screen pixels.

If selected, then the range is specified as a fixed number. If unselected, then the range will be given by the value of the named property.

The name of a Property that contains the range to use when Fixed Range is not selected.

Determines what happens when the Clear Matching or Clear All key command is used to remove one of our existing attachments.

Nothing additional happens. This is the default setting.

Severs the other piece’s attachment to this one as well (assuming it has one from an Attachment trait with the same Attachment Name)

Name of the right-click context menu item to clear ALL current attachments (by this individual Attachment trait). If left blank, no context menu item will appear.

A Key Command or Named Key Command that initiates the clearing of ALL current attachments (by this individual Attachment trait).

Name of the right-click context menu item to clear current attachments that match an expression. Only pieces attached by this Attachment trait will be affected.

A Key Command or Named Key Command that initiates the clearing of current attachments that match an expression. Only pieces attached by this Attachment trait will be affected.

An expression determining which current attachments will be cleared when the above key command is executed. See Additional matching expression, above, for further information on how these expressions work.