Linker - Aedif/multi-token-edit GitHub Wiki

Mass Edit allows you to link placeables keeping them together at relative positions to one another whenever you move or rotate them.

Linking is performed through a Linker Menu from which you can manage links by creating new link nodes, connecting placeables to them, removing them, and changing link types.

Linker Menu Example

Accessing Linker Menu

Currently the menu can only be accessed via the Open Linker Menu keybinding which is set to Shift+Q by default.

If the menu is opened without any selected placeables the menu will display all links present on the current scene.

If placeables are selected then only links for those placeables will be shown.

Creating Links

A link node is created via a Dobule-Click on any empty point within the window.

Placeables can then be attached by selecting them on the canvas and clicking the Attach Selected to Link control in the left pane.

https://github.com/user-attachments/assets/e9b40bcc-f938-477c-b4e1-b1deb0bb308d

Multi-Layer Select

Placeables can also be attached from across multiple layers via the Attach Multi-Layer Select to Link control.

Once the the control is clicked the mouse will be transformed into a reticle which can be dragged to select placeables across all layers.

https://github.com/user-attachments/assets/75d2ea21-e692-4653-b147-32585110a15d

Removing Links

Links can be removed in three ways

Selecting a linked placeable on the canvas and using the Remove all links from selected placeables control in the left control pane
Right-Clicking a placeable node which removes the link for just the clicked placeable
Right-Clicking a link node which removes the link for all connected placeables

https://github.com/user-attachments/assets/ee94367b-99d1-4211-abee-e4681667a8f4

Link Types

There are 3 types of links

TWO_WAY; placeables move other placeables and respond to them being moved
SEND; placeables move other placeables but DO NOT respond to them being moved
RECEIVE; placeables DO NOT move other placeables but respond to them being moved

Change Link Type

There are two methods of changing link types

One at a time by Left-Clicking the edge connecting a placeable node to a link node
En masse using Cycle control within the left control pane with a link node selected

https://github.com/user-attachments/assets/a139f298-c727-4e19-ad27-2bbecf728644

Delete Linked Placeables

Linked placeables can be deleted all at once using the red trash can control within the Linker Menu not requiring you to traverse multiple layers to do so manually.

Select any one linked placeable on the canvas and click the control.

https://github.com/user-attachments/assets/63ff634c-2871-497e-b835-29f52c4768d5

Alternatively Delete Selected & Linked keybinding can be used which will accomplish the same thing. It is set to Shift+Delete by default.

Link Token Behavior

To faciliate an easy creation of 'vehicles' a new region behavior type is introduced by the module: Link Token

This behavior links any token dragged into the region using a RECEIVE link, allowing tokens to hop on and off regions.

https://github.com/user-attachments/assets/f13eda0e-4d73-465b-9b25-2984d6ad5f3f

Edit Link Label

To help with organisation of more complex links you are able to assign labels to link nodes. This can be done by Double-Clicking link nodes.

https://github.com/user-attachments/assets/427fd3a2-3a95-4524-8377-81c9dd442dd5

Smart/Quick-Linking

Selected placeables can also be linked and un-linked using L and U keybindings.

When Smart Link (L) is pressed a menu will pop-up with the image of the one of the linked placeables. While the menu is open all subsequent uses of Smart Link (L) will continue attaching selected placeables to that placeable allowing you to switch between layers and link other placeables to it.

https://github.com/user-attachments/assets/7289e2fb-7db7-4db7-88ca-5de251b75c68

If no placeable is selected when initiating Smart Link (L) or Smart Un-Link (U) a multi-layer select will be inidiated allowing you drag over multiple placeables across multiple layers and link/un-link all of them at once.

https://github.com/user-attachments/assets/7d2bf67b-e346-4dfb-a9a5-0f6e992f9a38