Nieda-Harsas Bureau of Tourism
Sample MapTool Macros
Here are a few samples of macros for MapTool. Feel free to use them if you wish.
The following power macros are meant to display a power that your character uses in MapTool. In order to make them easily customizable, I’ve taken a modular design approach. There are 3 module macros that build the sample power output shown here:
Module 1: The Power Button Macro
This is the button that is actually pressed in MapTool, and will be the same name as the power activated. In the example above, the name of this macro is Healing Strike. This macro creates the variables needed for the DisplayPower and DisplayAttack macros. Each variable in the macro (hopefully self-explanatory as to what they represent) will most likely need to be changed for each individual power button created.
Go To Power Button Macro Code
Module 2: The DisplayPower Macro
This macro creates the Header Tables (appropriately colored by power type), Power Description Tables, and Flavor Text Table shown above. There are four types of Power Description Tables: Hit, Miss, Effect, and Special. If a power does not use one, a variable entry of “none” will tell the macro not to display that particular table. If needed, this macro also calls the DisplayAttack macro.
Go To DisplayPower Macro Code
Module 3: The DisplayAttack Macro
This macro creates the Attack and Damage Tables shown above if the power calls for them. This macro can roll multiple attack rolls if needed, and will also distinguish crit and natural 1 attack rolls. The attack input prompt is shown below:
Go To DisplayAttack Macro Code
Each background color and font color are designed to be easily customized. Want your encounter powers header table to be a brighter red? Edit the Display Power macro and change the bgcolor listed under the Encounter switch option from 660000 to FF0000. The colors are listed in the hexadecimal RGB format, so unfortunately you’re limited to 16,777,216 color options, of which 216 are considered “web-safe”.
In the DisplayPower macro, it’s possible to choose custom background and font colors for the header and flavor text tables for each type of power (At Will, Encounter, Daily, and Item), and also the power description tables.
In the DisplayAttack macro, it’s possible to choose a custom background color, as well as custom font colors for attack rolls, the damage roll, and the crit and/or natural 1 text.
The best part of this module based approach as opposed to including the full code in each power button is that when you customize the DisplayPower or DisplayAttack colors, you update all your Power display tables in one swoop. No need to tediously edit each and every power macro button just because you wanted a brighter red on your encounter powers display.
Here are examples of other powers:
Self Health Macros:
The following macros are meant to update your MapTool character token when your character takes damage, receives healing, receives temporary HP, etc. They each call a macro named Health Report that displays an informative table in chat.
Health Report Macro
The Health Report macro generates the following table showing the character’s remaining HP, surges, and temp HP.
Go To Health Report Macro Code
Take Damage Macro
The Take Damage macro does exactly what its name implies. However, it is smart enough to ensure your character loses temp HP before real HP. It also sets your tokens HP bar appropriately. If the damage causes your character to be bloodied, it will also set your token state to “bloodied”. It does NOT set the “dead” state when your HP is 0 or below, but feel free to add that option if you wish. Lastly, the macro calls the Health Report macro.
Go To Take Damage Macro Code
Receive Healing Macro
The Receive Healing macro works much like the Take Damage macro, only in reverse. It adjusts token HP, the HP bar, and the bloodied state as needed. Additionally, it also prompts the user for surges used. So the macro also adjusts token surges and the surge bar accordingly. The macro then calls the Health Report macro.
Go To Receive Healing Macro Code
Temp HP Macro
The Temp HP macro prompts the user for Temp HP the character has gained. If it is greater than the Temp HP your character already has, it sets temp HP to the new amount. If your character already has more temp HP than the amount gained, the temp HP remains the greater amount. The macro then calls the Health Report macro.
Go To Temp HP Macro Code
Saving Throw Macro
The Saving Throw macro prompts for any modifiers to the saving throw, then displays a table and reports whether or not the saving throw was successful.
Go To Saving Throw Macro Code
Player Action Macros:
The Initiative macro prompts for any modifiers and then rolls initiative for the character token. It also places the token in the initiative list at the appropriate spot.
Go To Initiative Macro Code
Ability and Skill Check Macro
The Ability and Skill Check macro prompts the user to select the appropriate ability or skill and for any modifiers. The macro then displays a table showing the check result and flavor text customizable for each check type.
Here is the Ability and Skill Check prompt:
And here is the output table to the chat window:
Go To Ability and Skill Check Macro Code
Extended Rest Macro
The Extended Rest macro processes the equivalent of an extended rest in game for your character token. HP and surges are set to maximum. Temp HP is set to zero. HP and surge bars are set to full. Action points are set to 1. The macro then calls the Health Report macro.
Go To Extended Rest Macro Code
Go to Main Page