|
|
| (7 intermediate revisions by 5 users not shown) |
| Line 1: |
Line 1: |
| ==Macro How To==
| | #REDIRECT [[:Category:How To]] |
| | |
| ===How to automate updating a token property===
| |
| | |
| This section expects that you are already familiar with how to add [[Macros:introduction|macro buttons]] to the MapTool user interface.
| |
| | |
| ====Example: Updating Hit Points====
| |
| | |
| Let's say you have a property to represent hit points. We'll call our property '''HP'''. Now we want some easy way to update '''HP''', so we're going to create a [[macro button]] that executes a [[macro]].
| |
| | |
| First, consider how you want this to work. We want a window to popup on the screen and ask the user to enter a number. That number will be subtracted from '''HP''', so the user can use a positive number to represent damage and a negative number to represent healing. (We'll show another approach later.)
| |
| | |
| The first step will be to prompt for the number. MapTool has this ability built-in. All we need to do is use a variable name that doesn't exist yet and MapTool will popup the prompt! The name of the variable is part of the prompt, so we'll use a descriptive name. How about '''AmountOfDamage'''?
| |
| | |
| <source lang="mtmacro" line>
| |
| [ damage = AmountOfDamage ]
| |
| </source>
| |
| | |
| Notice the extra variable name and the equals sign? That tells MapTool to calculate whatever is on the right of the equals sign and store the result into the variable on the left. In this case, there's no formula, so this becomes simply a copy -- from the variable '''AmountOfDamage''' to '''damage'''. But when MapTool tries to read the value of the variable and it doesn't exist, the popup will automatically appear! That's perfect for what we want!
| |
| | |
| Now the next step is to subtract that from the '''HP''' property. Fortunately, what you learned in the last paragraph can be used again:
| |
| | |
| <source lang="mtmacro" line>
| |
| [ damage = AmountOfDamage ]
| |
| [ HP = HP - damage ]
| |
| </source>
| |
| | |
| This time the second line calculates the formula on the right ('''HP - damage''') and stores the result into ... '''HP'''? Isn't that going to screw up our '''HP''' value?
| |
| | |
| No, it doesn't screw it up, but it does ''replace'' that value with the result. And because '''HP''' is a property, the result is stored back into the token's property. If you were to right-click on the token and save it to an external file, the new value of '''HP''' is stored with it. When the token is later reloaded, that value will come with it.
| |
| | |
| If you want to add to the hit points instead, you have two choices: either the user can enter a negative number, or you can change the '''-''' to a '''+'''. The first option is easy because it puts the burden on the user! The second option is really an option -- who wants to edit their macro every time they want to switch from damage to healing? Another choice not listed above would be to create a second macro. Then there could be one macro for adding damage and one for adding healing.
| |
| | |
| There's a few things still needed here to make this a little prettier, but those are future steps. Go ahead and try this out right now on a token that you create in MapTool. (The default property type, ''Basic'', includes a property named '''HP'''.) And try adding the second macro as well, just for the practice. (Believe me, the more practice you get early in the process, the easier it will become later on.)
| |
| | |
| ====Example: Let's Rest for a Minute...====
| |
| | |
| ((macro that uses another property, '''HPmax''', to reset hit points back to maximum))
| |
| | |
| So let's say that you now have a macro button that prompts you to change the token's hit points through damage or healing as described above. How do we reset their hit points to their maximum when they rest?
| |
| | |
| We already know that we have a '''HP''' and '''HPmax''' properties, so when they are healed up we simply need to copy the value in '''HPmax''' into '''HP'''. That should give you what you need to create a simple one-line macro:
| |
| | |
| <source lang="mtmacro" line>
| |
| [ HP = HPmax ]
| |
| </source>
| |
| | |
| Simple, right? But for the sake of argument, let's expand on this a bit. Instead of restoring all of the hit points to the creature, we will prompt the user for the number of hours that the creature will be resting. For my demonstration, I'm assuming that there's a property named '''Level'''. If it rests for less than 24 hours, it gets back '''Level*2''' hit points. If it rests for 24 hours or more, it gets back '''Level*6'''.
| |
| | |
| <source lang="mtmacro" line>
| |
| [ hours = NumberOfHours ]
| |
| [ healing = if(hours < 24, Level * 2, Level * 6) ]
| |
| [ HP = HP + healing ]
| |
| </source>
| |
| | |
| You may notice the [[Macros:Functions:if|if()]] function on the second line. One word of warning when using the [[Macros:Functions:if|if()]] function: both the true and the false sections are executed! For that reason, you may want the [[Macros:Branching_and_Looping#IF_Option|IF()]] option instead. Note that the syntax is slightly different between the two, so be careful about which one you choose.
| |
| | |
| ====Example: One Macro to Rule Them All====
| |
| | |
| ((macro that uses [[Macros:Functions:input|input()]] to prompt for values with radiobuttons))
| |