Post by Deleted on Feb 21, 2015 2:25:07 GMT -5
All right, so this is about the spell format on Roll20. It allows you to press the dice icon located to the left side of the spell (http://puu.sh/g65fA/2947cf8be3.png) and have your spell instantly be cast with all the appropriate information specific for your character. I'm going to start off by giving basic instructions that you should first begin on, then I'm going to list the code, and below the code I'm going include what goes in the sections of the code prior listed.
Step 1: Basic Input
Most of these are easily understandable, but there are a few things that need addressed regardless because they could possibly cause confusion. Those are the only ones we'll go over until we get to the actual code.
Prepped: We don't prep a specific amount of a single spell here in Aldium, so leave this field as 0.
Range: Put the range as specified for your caster level (or whatever the case may be), not the base range (as in 100 ft + 10 ft/level). Example: 1,120 ft. Be sure to include ft., otherwise it won't show the range.
Duration: Again, put the duration as specified for you, not the base duration. Example: 19 minutes or 19 rounds.
Save Effect: Of course put the save or None (if no save is required), but be sure to list if a failed save results in half damage, partial damage, or if it negates entirely. Example: Reflex half, Will negates, or Fort partial.
Step 2: Description
Beside the word "Description", click [show]. You'll now see a blank box. Don't put the description of the spell here; instead, put the link of the spell. Example: aldium.wikidot.com/fireball (include http://). When you cast your spell using the dice icon (as indicated above), your spell link will list itself at the bottom of your cast.
Step 2: THE CODE
Beside the words "Macro Text", click [show]. You'll now see a box full of code:
/em casts @{name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}; Spell Resistance: @{sr}
@{description}
EXCEPT...we may have some more stuff to put there, right? What about targeting a specific person/creature? What about a ranged touch attack roll? A damage roll? No problem, you just plug a few things in. Here's how you do it:
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}
Spell Resistance: @{sr}
Ranged Touch: [[ATTACK]]
Damage Result: [[DAMAGE]]
@{description}
See what I did there? I kept everything from Saving Throw and up as is (except I added "at @{target|token_name}!", added Ranged Touch and Damage Result, and kept @{description}. You can add just about anything here you need, but let's not get ahead of ourselves.
Where you see [[ATTACK]], replace the word ATTACK with your attack roll. Example: [[1d20+15]]. Oh is it a touch attack instead of a ranged touch? Ok. Replace "Ranged Touch" with "Touch". Simple as that.
Where you see [[DAMAGE]], just like with ATTACK above, replace the word DAMAGE with your damage roll. Example: [[4d6]]
"What does /em casts @{name} at @{target|token_name}! do anyway?"
It makes it so it says "<your name> casts <spell> at <targeted token name>" when you cast a spell. When you go to cast the spell, it'll ask you to choose a target. The target is called a token, which is the pic you see of a person/creature on the board, hence "token_name". You don't have to fill these out, it auto puts the name of the token you select.
"Ok, but what if the spell allows more than one target?"
If you have more than one target for a spell, simply list the targets after the first when you're telling your DM what you're doing. If you don't require a target at all for a spell, remove that line and instead use "/em casts @{name}!" (without quotations of course).
If you're experienced and (very) quick at doing the codes as you're casting (I'm stressing this a lot because you don't want to hold up the quest any longer than you already are; if you have a problem with this, you'll be told to not do it ever again), then you can use the code below in order to target multiple targets during one casting of the spell:
/em casts @{name} at @{target|token_name} and @{target|Target2|token_name}!
Got more than 2 targets? Copy the @{target|Target2|token_name} line and change 2 to 3. More than that? Rinse and repeat. You could potentially have a line that looks like this:
/em casts @{name} at @{target|token_name}, @{target|Target2|token_name}, @{target|Target3|token_name}, @{target|Target4|token_name}, and @{target|Target5|token_name}!
OR!
You could set a spell where you can decide which targets you choose, but you don't get the benefits of clicking a token when doing it. Instead, you manually put in your targets.
Rather than putting @{target|token_name}, add the line /em casts @{name} at ?{Targets|Targets}! instead. Now when you go to cast, a pop-up box will appear and ask for your targets. Be sure you've looked over the board so you know which targets you'd like to have; if you need to look at it again, be sure to click Cancel before clicking on the board, otherwise, the code could cause a conflict when you go to cast something again.
"I have Spell Focus, right? How do I include that?" Well I'm glad you asked. Look at the line for Saving Throw.
Now watch this:
DC [[@{spellclass-0-level-2-savedc}+1]]
See the +1? That's how. That just added an extra +1 to your save DC. Same thing with Greater Spell Focus, you'd just put +2.
"I have a spell that lists a certain effect that's a little difficult to remember, or is just too time consuming to remember. What do?" Oh you mean like, I don't know, Spell Resistance? Check it out. Put the Effect under Damage Result (or Saving Throw if you don't have a need for the attack and damage lines, as per this particular spell), then include what the effect is. Here's an example:
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}
Spell Resistance: @{sr}
Effect: SR 32
That easy.
Ok, so let's see the code all together with what we've talked about, minus anything Spell Focus related and the part of the code that's already on the sheet.
Ranged Touch: [[ATTACK]]
Damage Result: [[DAMAGE]]
Effect: here
"V. Really? You made a forum post about something THAT easy?" Yes. Yes I did. But wait.....there's more. What if you have multiple to-hits and multiple damages? I got you, check it out.
[[1d20+15]], [[1d20+15]], [[1d20+15]]
[[4d6]], [[4d6]], [[4d6]]
Just like that. You include another bracket of your spell attack/damage however many times you need to attack/deal damage. It's so easy, even a neanderthal could do it ("often imitated, never duplicated").
What if your spell doesn't have a save DC? Then you should delete (but you don't necessarily have to because it still shows the word None beside it) the line: DC [[@{spellclass-0-level-2-savedc}]],
Please note the space after the comma; that needs to be included in your deletion so it all arranges properly.
Let's see an example of a spell all put together, then we'll check out how it looks when finally rolled.
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 6
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-6-savedc}]], @{save}
Spell Resistance: @{sr}
Ranged Touch: [[1d20+13]]
Damage: [[36d6]]
Alternate Damage (partial): [[5d6]]
@{description}
BAM!
Now for what it looks like rolled. I click the dice icon on the sheet, then....
For the final act of the show, let's see a couple examples like above, except for a spell without a save DC: first, the code; second, what it looks like rolled.
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: @{save}
Spell Resistance: @{sr}
Ranged Touch: [[1d20+13]], [[1d20+13]], [[1d20+13]]
Damage Result: [[4d6+4]], [[4d6+4]], [[4d6+4]]
@{description}
There's everything you need in a spell. Now, I know it's tempting to want to add a line for base SP, but refrain from doing so. With ED in effect, the amount of SP it costs to cast a spell will only go up, so might as well avoid that so no one gets confused unintentionally. Stick to this format and all will be good in the R20 universe (and your DM and fellow players will thank you).
Step 1: Basic Input
Most of these are easily understandable, but there are a few things that need addressed regardless because they could possibly cause confusion. Those are the only ones we'll go over until we get to the actual code.
Prepped: We don't prep a specific amount of a single spell here in Aldium, so leave this field as 0.
Range: Put the range as specified for your caster level (or whatever the case may be), not the base range (as in 100 ft + 10 ft/level). Example: 1,120 ft. Be sure to include ft., otherwise it won't show the range.
Duration: Again, put the duration as specified for you, not the base duration. Example: 19 minutes or 19 rounds.
Save Effect: Of course put the save or None (if no save is required), but be sure to list if a failed save results in half damage, partial damage, or if it negates entirely. Example: Reflex half, Will negates, or Fort partial.
Step 2: Description
Beside the word "Description", click [show]. You'll now see a blank box. Don't put the description of the spell here; instead, put the link of the spell. Example: aldium.wikidot.com/fireball (include http://). When you cast your spell using the dice icon (as indicated above), your spell link will list itself at the bottom of your cast.
Step 2: THE CODE
Beside the words "Macro Text", click [show]. You'll now see a box full of code:
/em casts @{name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}; Spell Resistance: @{sr}
@{description}
EXCEPT...we may have some more stuff to put there, right? What about targeting a specific person/creature? What about a ranged touch attack roll? A damage roll? No problem, you just plug a few things in. Here's how you do it:
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}
Spell Resistance: @{sr}
Ranged Touch: [[ATTACK]]
Damage Result: [[DAMAGE]]
@{description}
See what I did there? I kept everything from Saving Throw and up as is (except I added "at @{target|token_name}!", added Ranged Touch and Damage Result, and kept @{description}. You can add just about anything here you need, but let's not get ahead of ourselves.
Where you see [[ATTACK]], replace the word ATTACK with your attack roll. Example: [[1d20+15]]. Oh is it a touch attack instead of a ranged touch? Ok. Replace "Ranged Touch" with "Touch". Simple as that.
Where you see [[DAMAGE]], just like with ATTACK above, replace the word DAMAGE with your damage roll. Example: [[4d6]]
"What does /em casts @{name} at @{target|token_name}! do anyway?"
It makes it so it says "<your name> casts <spell> at <targeted token name>" when you cast a spell. When you go to cast the spell, it'll ask you to choose a target. The target is called a token, which is the pic you see of a person/creature on the board, hence "token_name". You don't have to fill these out, it auto puts the name of the token you select.
"Ok, but what if the spell allows more than one target?"
If you have more than one target for a spell, simply list the targets after the first when you're telling your DM what you're doing. If you don't require a target at all for a spell, remove that line and instead use "/em casts @{name}!" (without quotations of course).
If you're experienced and (very) quick at doing the codes as you're casting (I'm stressing this a lot because you don't want to hold up the quest any longer than you already are; if you have a problem with this, you'll be told to not do it ever again), then you can use the code below in order to target multiple targets during one casting of the spell:
/em casts @{name} at @{target|token_name} and @{target|Target2|token_name}!
Got more than 2 targets? Copy the @{target|Target2|token_name} line and change 2 to 3. More than that? Rinse and repeat. You could potentially have a line that looks like this:
/em casts @{name} at @{target|token_name}, @{target|Target2|token_name}, @{target|Target3|token_name}, @{target|Target4|token_name}, and @{target|Target5|token_name}!
OR!
You could set a spell where you can decide which targets you choose, but you don't get the benefits of clicking a token when doing it. Instead, you manually put in your targets.
Rather than putting @{target|token_name}, add the line /em casts @{name} at ?{Targets|Targets}! instead. Now when you go to cast, a pop-up box will appear and ask for your targets. Be sure you've looked over the board so you know which targets you'd like to have; if you need to look at it again, be sure to click Cancel before clicking on the board, otherwise, the code could cause a conflict when you go to cast something again.
"I have Spell Focus, right? How do I include that?" Well I'm glad you asked. Look at the line for Saving Throw.
DC [[@{spellclass-0-level-2-savedc}]]
Now watch this:
DC [[@{spellclass-0-level-2-savedc}+1]]
See the +1? That's how. That just added an extra +1 to your save DC. Same thing with Greater Spell Focus, you'd just put +2.
"I have a spell that lists a certain effect that's a little difficult to remember, or is just too time consuming to remember. What do?" Oh you mean like, I don't know, Spell Resistance? Check it out. Put the Effect under Damage Result (or Saving Throw if you don't have a need for the attack and damage lines, as per this particular spell), then include what the effect is. Here's an example:
Saving Throw: DC [[@{spellclass-0-level-2-savedc}]], @{save}
Spell Resistance: @{sr}
Effect: SR 32
That easy.
Ok, so let's see the code all together with what we've talked about, minus anything Spell Focus related and the part of the code that's already on the sheet.
Ranged Touch: [[ATTACK]]
Damage Result: [[DAMAGE]]
Effect: here
"V. Really? You made a forum post about something THAT easy?" Yes. Yes I did. But wait.....there's more. What if you have multiple to-hits and multiple damages? I got you, check it out.
[[1d20+15]], [[1d20+15]], [[1d20+15]]
[[4d6]], [[4d6]], [[4d6]]
Just like that. You include another bracket of your spell attack/damage however many times you need to attack/deal damage. It's so easy, even a neanderthal could do it ("often imitated, never duplicated").
What if your spell doesn't have a save DC? Then you should delete (but you don't necessarily have to because it still shows the word None beside it) the line: DC [[@{spellclass-0-level-2-savedc}]],
Please note the space after the comma; that needs to be included in your deletion so it all arranges properly.
Let's see an example of a spell all put together, then we'll check out how it looks when finally rolled.
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 6
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: DC [[@{spellclass-0-level-6-savedc}]], @{save}
Spell Resistance: @{sr}
Ranged Touch: [[1d20+13]]
Damage: [[36d6]]
Alternate Damage (partial): [[5d6]]
@{description}
BAM!
Now for what it looks like rolled. I click the dice icon on the sheet, then....
For the final act of the show, let's see a couple examples like above, except for a spell without a save DC: first, the code; second, what it looks like rolled.
/em casts @{name} at @{target|token_name}!
School: @{school}; Level 2
Casting Time: @{cast-time}
Components: @{components}
Range: @{range}
Targets/Area: @{targets}
Duration: @{duration}
Saving Throw: @{save}
Spell Resistance: @{sr}
Ranged Touch: [[1d20+13]], [[1d20+13]], [[1d20+13]]
Damage Result: [[4d6+4]], [[4d6+4]], [[4d6+4]]
@{description}
There's everything you need in a spell. Now, I know it's tempting to want to add a line for base SP, but refrain from doing so. With ED in effect, the amount of SP it costs to cast a spell will only go up, so might as well avoid that so no one gets confused unintentionally. Stick to this format and all will be good in the R20 universe (and your DM and fellow players will thank you).