Cosmere Useful Macros

This module is a community collection of macro commands that is intended to be used for the Cosmere RPG system on FoundryVTT. This module adds a Macro Compendium with macros that can be added to the FoundryVTT hotbar. Each macro calls functions from the module itself, so once imported, the macros will never need to be re-imported when the module updates.

List of Macros

0. Master Useful Macro

This macro will create a pop-up dialog that will allow you to use every other macro in the module. Only one space on the macro hotbar is required to access all of the macros in this module!

1. Token Disposition Picker

This macro will change the token disposition of all selected tokens between Neutral, Friendly, or Hostile depending on the option chosen in a pop-up dialog box. If this macro is used on a token from an official Cosmere RPG module, the color of the token ring will change to match the new disposition: gold for Neutral, Blue for Friendly, and red for Hostile.

2. Infuse Dun Spheres

This macro will convert all loot items on a character from Dun Sphere currency (mk ○) to Infused Spheres currency (mk ●) for all selected tokens. For each selected token, a chat message will apear to say whether any dun spheres were infused. This macro will only work when using the Cosmere RPG game system.

3. Mass Invisibility

This macro will add or remove the Invisible condition from all selected tokens. 

4. See Invisibility

This macro will enable or disable the See Invisibility vision mode for all selected tokens. When See Invisibility is enabled by this macro, the vision mode of the token is changed to Light Amplification as a visual indicator that the vision mode is enabled.

5. Token Size Picker

This macro will change the token height and token width of all selected tokens depedning on the option chosen in a pop-up dialog box. The options in the dialog box are Medium, Large, Huge, Gargantuan, and Small as the character sizes are defined by the Cosmere RPG.

6. Configure Token with Bar Brawl

This macro will configure resource bars with the [Bar Brawl](https://foundryvtt.com/packages/barbrawl) for a token's Health, Focus, and Investiture. To see the results of this macro, the __Bar Brawl__ module must be installed and activated. This macro will only work when using the Cosmere RPG game system.

7. Configure Token Senses

This macro provides a pop-up dialog to quickly configure the token vision for all selected tokens, enabling or disabling five vision modes and setting them to an actor's Senses Range. This macro will only work when using the Cosmere RPG game system.

8. Group Long Rest

 This macro will perform a Long Rest to all targeted actors. A dialog pop-up will allow which actors are chosen and if to reduce exhaustion, reduce injury duration, or to refill investiture. Options for targeted actors include all selected tokens, all characters, or all game actors. A chat message will appear in the chat log for each character that takes a Long Rest. This macro will only work when using the Cosmere RPG game system.
 

9. Use Token Skill

This macro provides a pop-up dialog that will list all of a selected token's skills. Clicking on a skill will use it as if the skill were used from the character sheet. This macro will only work when using the Cosmere RPG game system.

10. Nonlethal Defeat

This macro will mark all selected tokens as "Defeated" if they are in combat and will apply the Unconcious condition with a large overlay to the tokens as well. Using the macro again on tokens will remove the Defeated marker and the Unconcious condition.

Contributing

To contribute a macro to this repository:
1. Add the macro code in a function as a seperate `.js` file in the `/macros` folder
2. Add a line to `CUM-index.js` to import the function
3. Add the function to the object in `CUM-index.js` that gets globalized
4. Create a macro in FoundryVTT that calls the function and add it to the module's compendium.