The easiest way to organize macros is to put them in the Attributes and Abilities tab of character sheets. Create a new character sheet for each categroy of macro, and put all your macros in. This has the added bonus of not fucking up any html character replacement in the macros. Then you can use the checkboxes under each ability macro to put it in your bar.
If you want to share macros with players, share the character sheet with them, and instruct them to put the macros in their macro bars and name them however they want.
The exception is macros that you want to use by typing insteaad of clicking a macro button. Then you should make them as regular macros so you can type #whatever to call the macro in chat.
Naming Macros
Macros can take up a lot of space on your macro bar! The easiest way to fix this is to use emoji to name them. When renaming a macro in your macro bar, you can either copy-paste an emoji from https://emojipedia.org/ or if you have the newest version of windows you can type Windows Key + . to bring up an emoji picker in any text box.
You can recolor and rename macro buttons by right-clicking them.
Bars
All these macros assume the following bar configuration:
Bar 1: AC
Bar 2: Other_Resource
Bar 3: HP
I use Bar 3 for HP because it sits on top of the upper edge of the token, which means that having tokens stacked above each other doesn't hide the health bar accidentally. In the settings page I recolor Bar 1 to blue, Bar 2 to red, and Bar 3 to green.
GM Macros
I've got these organized in the saame way I have them organized in the picture above, organized by color, with the emoji I use (if you want to copy me outright.) All macros below are stored in a character sheet called "GM" unless otherwise noted.
Pink (Tables & Generators)
NPC Generator 👤
Coming soon!
Treasure 💰
Rolls treasure based on enemies.
Uses: Robin Kueper's Treasure
!treasure ?{Selected or manual?|
Selected,s ?{Individual or Hoard?|individual|hoard}|
Manual,?{Individual or Hoard?|individual|hoard } ?{CR } ?{How many?} }
Wild Magic Surge 💥
Rolls on the Wild Magic table. Requires a table called Wild-Magic. This macro should be stored in the PC Macro Sheet because PCs can also use it, but the GM should also keep it in their bar.
Used for riding mounts or carrying torches. This macro should be stored in the PC Macro Sheet because PCs can also use it.
Uses: Carry Tokens
!CARRY_TOKENS_MENU
Flight 🕊
Use for flying. This macro should be stored in the PC Macro Sheet because PCs can also use it.
Uses: Flight
!fly ?{How many feet?|0}
Orange (Token and Character Effects)
Exhaustion 😫
Adds one level of exhaustion. Exhaustion must be stored in the first class resource on every PC's sheet (which you should have set up
already if you're using my long/short rest macros, right? ;)
Uses: ChatSetAttr
!setattr --modb --silent --sel --class_resource|?{Add or Subtract?|Add,+1|Subtract,-1}
/desc Exhaustion ?{Add or Subtract?|Add,gain|Subtract,lose}
Status ⚠
This allows anyone to quickly assign a condition status marker to themself. Easy to edit to add more. Nice becaues you can type to find something in a dropdown and because this standardizes the condition markers.
This macro should be stored in the PC Macro Sheet because PCs can also use it.
Adds or removes inspiration from the selected PC (will also work for NPCs if you create the Inspiration attribute on their sheets.)
Uses: Robin Kueper's Inspiration Tracker
!inspiration
Green (Combat)
Combat ⚔
Opens combat menu. Select tokens and click Start to start combat.
Uses: Robin Kueper's Combat Tracker
!ct
End of Turn 🔚
Moves the turn tracker forward. This macro should be stored in the PC Macro Sheet because PCs can also use it.
Uses: Robin Kueper's Combat Tracker
!ct next
GM Sheet 📄
Brings up a party sheet for the selected tokens.
Uses: GMSheet
!gmsheet
Red (Damage and Healing)
Deal Damage 💢
Deals damage to a targeted token. I store this macro on the PC Macro Sheet because I have me PCs deal damage to the baddies after rolling. This saves me time, especially when the roll20 token bubbles are very slow to load.
Same as above, but can target up to 5 tokens. If you want to target less than 5, just select the same token multiple times to fill up the remaining targets (it will still only apply the damage once.)
!group-check {{
--hideformula
--?{Output|Whisper,whisper|Public,public}
--?{Ability Check|Acrobatics|Animal Handling|Arcana|Athletics|Deception|History|Insight|Intimidation|Investigation|Medicine|Nature|Perception|Performance|Persuasion|Religion|Sleight of Hand|Stealth|Survival}
--ro ?{Roll Type|Normal,roll1|Advantage,adv|Disadvantage,dis}
--subheader vs DC ?{DC}
--process
}}
Dark Red (Time and Weather)
Calendar 📅
Just the calendar menu because I can't remember these commands.
Uses: Calendar
!cal
Tomb of Annihilation Day & Weather Generator 🌄
Coming Soon!
White (Speaking)
Languages 🗣
Allows you and PCs to "speak" other languages. This macro should be stored in the PC Macro Sheet because PCs can also use it.
This one requires some set up: Create a character sheet for every language in your game, then assign that character to the players whose characters can speak that language. If you have more languages or different languages than are listed in the macro, you'll
need to edit the macro to reflect that.
/w ?{What language?|Draconic|Dwarven|Chultan|Elven|Gnomish|Goblin|Halfling|Infernal|Thieves' Cant} ?{Message}
/em speaks in a language you don't understand.
Whisper to a Token 🤐
This is stored in the Macro tab because it can also be called as #wch (see below.) I just like having a button for it.
Token Macros for the GM
Token macros require a token to be selected, so they're good for things that act on tokens. Store this macro in the normal Macro Tab and set it to be a token macro, since you'll only ever need it when having tokens selected.
Bump
Make sure you have bump set to auto push and auto slave in the script library settings, and you can basically control the whole script with this button.
Uses: Bump
!bump
Chat Macros for the GM
Default Token
Sets currently selected token as the default token for the character its assigned to. Make this a button at the beginning of the game when people are making lots of characters but after that it can just be a chat macro.
!token-mod --set defaulttoken
PC Macros
All the below macros should be stored on a character sheet called "Macros" that is shared with and editable by all players. Instruct your players to put these macros in their macro bar and rename/recolor them to their liking.
Find the code for these macros in the above GM section.
Carry Tokens 🏋️♂️
Flight 🕊
Status ⚠
End of Turn 🔚
Deal Damage 💢
Deal Multiple Damage 💢👥
Heal 💉
Language 🗣
Resting
All the below macros should be stored on a character sheet called "Resting" that is shared with and editable by all players.
It's important that your players use ONE of the below long rest and ONE of the below short rest macros depending on how many class resources they have which refill on a short and/or long rest. Once they choose the correct macro, they should add it to their macro bar and rename/recolor it to their liking.
You MUST instruct your players to organize their class resources from left to right, top to bottom, like this:
Exhuastion is FIRST
Next are all abilities that come back on a short AND/OR long rest
Next are al abilities that come back on ONLY a long rest.
ALL of the long rest macros use these scripts: 5e OGL Companion, ChatSetAttr ALL of the short rest macros use these scripts: ChatSetAttr
Long Rest
Long Rest 0
Removes 1 exhaustion and refills spell slots, hp, and hd.
!longrest @{selected|character_name}
!modbattr --modb --sel --class_resource|-1 --fb-header Long Rest Taken --fb-content Refilled HP, Hit Dice, and Spell Slots. Exhaustion is _CUR0_. **Don't forget to prepare spells!**
Long Rest 1
Removes 1 exhuastion, refills spell slots, hp, and hd, and refills one class resource.
!longrest @{selected|character_name}
!modbattr --sel --class_resource|-1 --other_resource|@{selected|other_resource|max} --fb-header You took a long rest. --fb-content Refilled HP, Hit Dice, Spell Slots, and @{selected|other_resource_name}. Exhaustion is _CUR0_. **Don't forget to prepare spells!**
Long Rest 2
Same song and dance as above, 2 class resources.
!longrest @{selected|character_name}
!modbattr --sel --class_resource|-1 --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --fb-header You took a long rest. --fb-content Reset HP, Hit Dice, Spell Slots, @{selected|other_resource_name}, and @{selected|repeating_resource_$0_resource_left_name}. Exhaustion is _CUR0_. **Don't forget to prepare spells!**
Long Rest 3
Same song and dance as above, 3 class resources.
!longrest @{selected|character_name}
!modbattr --sel --class_resource|-1 --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --repeating_resource_$0_resource_right|@{selected|repeating_resource_$0_resource_right|max} --fb-header You took a long rest. --fb-content Refilled HP, Hit Dice, Spell Slots, @{selected|other_resource_name}, @{selected|repeating_resource_$0_resource_left_name}, and @{selected|repeating_resource_$0_resource_right_name}. Exhaustion is _CUR0_. **Don't forget to prepare spells!**
Long Rest 4
Same song and dance as above, 4 class resources.
!longrest @{selected|character_name}
!modbattr --sel --class_resource|-1 --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --repeating_resource_$0_resource_right|@{selected|repeating_resource_$0_resource_right|max} --repeating_resource_$1_resource_left|@{selected|repeating_resource_$1_resource_left|max} --fb-header You took a long rest. --fb-content Refilled HP, Hit Dice, Spell Slots, @{selected|other_resource_name}, @{selected|repeating_resource_$0_resource_left_name}, @{selected|repeating_resource_$0_resource_right_name}, and @{selected|repeating_resource_$1_resource_left_name}. Exhaustion is _CUR0_. **Don't forget to prepare spells!**
Short Rest
Short Rest 0
Basically just gives players a button to hit to roll hit dice.
!modbattr --replace --sel --other_resource|@{selected|other_resource|0} --fb-header You took a short rest. --fb-content [Roll Hit Dice](~selected|hit_dice)
Short Rest 1
Refills one class resource + button to roll hit dice.
!setattr --replace --sel --other_resource|@{selected|other_resource|max} --fb-header You took a short rest. --fb-content Refilled @{selected|other_resource_name}. [Roll Hit Dice](~selected|hit_dice)
Short Rest 2
Refills two class resources + button to roll hit dice.
!setattr --replace --sel --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --fb-header You took a short rest. --fb-content Refilled @{selected|other_resource_name} and @{selected|repeating_resource_$0_resource_left_name}. [Roll Hit Dice](~selected|hit_dice)
Short Rest 3
Refills three class resources + button to roll hit dice.
!setattr --replace --sel --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --repeating_resource_$0_resource_right|@{selected|repeating_resource_$0_resource_right|max} --fb-header You took a short rest. --fb-content Refilled @{selected|other_resource_name}, @{selected|repeating_resource_$0_resource_left_name}, and @{selected|repeating_resource_$0_resource_right_name}. [Roll Hit Dice](~selected|hit_dice)
Short Rest 4
Refills four class resources + button to roll hit dice.
!setattr --replace --sel --other_resource|@{selected|other_resource|max} --repeating_resource_$0_resource_left|@{selected|repeating_resource_$0_resource_left|max} --repeating_resource_$0_resource_right|@{selected|repeating_resource_$0_resource_right|max} --repeating_resource_$1_resource_left|@{selected|repeating_resource_$1_resource_left|max} --fb-header You took a short rest. --fb-content Refilled @{selected|other_resource_name}, @{selected|repeating_resource_$0_resource_left_name}, @{selected|repeating_resource_$0_resource_right_name}, and @{selected|repeating_resource_$1_resource_left_name}. [Roll Hit Dice](~selected|hit_dice)
Chat Macros for Everyone
These macros can be found in the collection tab or by typing # in chat. Not important enough to clutter things up with buttons. Players can add these to their macro bar if they want.
