Skip to content

Latest commit

 

History

History
 
 

AreasOfEffect

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Areas of Effect

v1.6.1 Updates

  • Fixed unicode icons in chat menu.

GMs, your spellcasting players will love you for this script! It lets you create graphical areas of effect for various spells and other powers, and then your players can create these effects by drawing lines specifying their range, origin, and angle. Areas of effect can be created from any graphic that you have uploaded to your library.

AoE menu

When the script is installed, it creates a macro for all GMs of the game to display its main menu in the chat. This macro is also visible and usable by all players in the game, but only GMs are allowed to save new areas of effect. Players can only spawn them.

Creating Areas of effect

To create an area of effect, follow these steps:

  1. Place the graphic you want to create an effect out of onto the VTT.
  2. Draw a straight line over it from the origin of the effect to its end/edge.
  3. Select both the line and the graphic.
  4. Open the Areas of Effect menu using its macro and select Save Effect.
  5. Name the effect, and you're done!

The effect will now appear in your list of saved areas of effect. Only GMs can save areas of effect.

Viewing/Spawning Areas of Effect

To view the list of saved areas of effect, open the script's menu from its macro and select Apply an Effect. The list will show each effect with its name, a preview of its graphic, and GMs will also have a button they can use to delete effects.

To spawn an area of effect from this list, follow these steps:

  1. Draw a straight line from the desired origin of the effect to its desired range.
  2. Select the line.
  3. Click the effect to apply to the line from the list of saved areas of effect.

OR

  1. Select the token the effect originates from.
  2. Click the arrow button for the effect.
  3. Click the target token for the effect's endpoint.

Both GMs and players can spawn areas of effect!

_Note: Currently it is not possible to create effects from graphics purchased from the market place due to certain restrictions specified here: https://wiki.roll20.net/API:Objects#imgsrc_and_avatar_property_restrictions

However, you can download them from your Roll20 purchased assets library and then upload them to your game in order to make use of them with this script ._

Help

My scripts are provided 'as-is', without warranty of any kind, expressed or implied.

That said, if you experience any issues while using this script, need help using it, or if you have a neat suggestion for a new feature, please shoot me a PM: https://app.roll20.net/users/46544/ada-l

When messaging me about an issue, please be sure to include any error messages that appear in your API Console Log, any configurations you've got set up for the script in the VTT, and any options you've got set up for the script on your game's API Scripts page. The more information you provide me, the better the chances I'll be able to help.

Show Support

If you would like to show your appreciation and support for the work I do in writing, updating, maintaining, and providing tech support my API scripts, please consider buying one of my art packs from the Roll20 marketplace:

https://marketplace.roll20.net/browse/publisher/165/ada-lindberg