Macro Button is a module for Foundry VTT that allows you to drag and drop Macros directly onto the canvas to create interactive buttons. These buttons act as shortcuts, allowing you (and optionally your players) to trigger macros directly from the scene. I've picked the idea for it from this old module: https://github.com/Kekilla0/Note-Macro seemed like a good solution.
- Drag & Drop: Easily create buttons by dragging Macros from your directory onto the scene.
- Customizable: Change icons, labels, sizes, and positioning.
- Permissions: Grant players access to specific macro buttons.
- Sync: Button states and updates are synchronized across all connected clients.
https://github.com/mordachai/macro-button/releases/latest/download/module.json
- Open your Macro Directory.
- Drag a Macro and drop it anywhere on the canvas (Scene).
- A button will appear at that location with the Macro's default icon.
- Left-Click: Executes the linked Macro.
- Right-Click (GM Only): Opens the configuration dialog.
- Single Button: Right-click the button and use the Delete button at the bottom of the configuration dialog.
- Bulk Delete: Use the Journal Notes tool in the Scene Controls (left toolbar) to select and delete buttons normally. This is useful for removing multiple buttons at once.
Right-clicking a button (as a GM) opens the configuration dialog where you can adjust:
- Icon: Click the image to upload or select a custom icon.
- Name: Type a custom label for the button.
- Reset Buttons: If you've customized the name or icon, a small Reset (undo) button will appear. Clicking it restores the button's name or icon to match the original Macro.
- Automatic Sync: By default, if you update the name or icon of the original Macro, the button will automatically update to match—unless you have set a custom name or icon for that button.
- Show Name:
- Always Visible: Label is always shown.
- On Hover Only: Label appears when the mouse hovers over the button.
- Never (Icon Only): No text label is displayed.
- Name Position: Place the label Above, Below, Left, or Right of the icon.
- Button Size: Choose between Small, Medium, or Big.
- Name Size: Adjust the text size (Small, Medium, Big).
- Player Visible: Check this to allow players to see and click the button. (Default is GM only).
Buttons can execute multiple macros in sequence. The Linked Macros section in the configuration dialog shows all macros currently linked to the button as clickable content links.
- Adding Macros: Drag and drop macros from your Macro Directory onto the Linked Macros section to add them.
- Viewing Macros: Click any linked macro name to open its sheet.
- Removing Macros: Click the X button next to a macro to unlink it from the button.
- Execution Order: When the button is clicked, all linked macros execute in the order they appear (top to bottom).
- Icon/Name Sync: The button's icon and name sync with the first macro in the list (unless customized).
This project is licensed under the MIT License.