Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Script:Blood And Honor: Automatic blood spatter, pooling and trail effects

From Roll20 Wiki

Revision as of 21:57, 8 January 2015 by Brian (Talk | contribs)

Jump to: navigation, search
API ScriptAuthor: John C.
Version: 0.7
Last Modified: 2015-01-08
Code: Blood And Honor
Dependencies: None
Conflicts: None

Blood and Honor is an automatic way to add lightweight blood effects to your campaign, without any animations or commands.

How it works:

Any token in the object layer that has a bar3 (health) value less than or equal to its max has a chance to bleed. The chance goes up depending on how severe the damage is.

Spatter

Any time a token's health bar is changed so that it's total value is half or less of its maximum, a randomly selected, offset and rotated blood graphic will be placed on the map layer beneath it. The exact formula is as such - the system rolls a dice with as many sides as the max health value. If that roll exceeds the current health value, a blood spatter appears. The larger the amount of damage taken at once, the bigger the spatter will be.

Trails

If a token moves while at or below half health, a smaller blood graphic will appear where it moves to based on the chances described above. Less health = more blood.

Pool

If a token's bar3 value falls 0 or below, a large pool of blood graphic appears on the map layer beneath it.

Configuration

Stop bleeding

Putting noblood in any token's GM Notes will cause it to never bleed.

Clear the map of blood

Use the !clearblood command in chat and all blood will move to the top left corner of the map for convenient removal.

Change color

There are currently three custom colors, but you can easily add your own in the script. Put one of the following into the GM Notes if you want the token to bleed a color other than red:

bloodcolor_orange, bloodcolor_purple, bloodcolor_blue

NOTE: YOU MUST SET YOUR OWN IMAGE URLS IN THE SCRIPT! You can put as many of either type (spatters or pools) as you wish, and it will choose from them randomly. See this page for more details.

Changelog

v.0.7 (2015-01-08)

  • Size of spatters determined by amount of damage received
  • Addressed stability issue (trails) with cooldown timer

v.0.6 (2015-01-07)

  • Added support for TheAaron's GM Auth module

v.0.5 (2015-01-06)

  • Added on "ready" event to keep funny things from happening
  •  !clearblood command will move all blood to top left corner of map

v.0.4 (2015-01-05)

  • [bugfix] "noblood" check now properly passes all bleeding types

v.0.3 (2015-01-05)

  • [bugfix] blood pools now appear properly
  • Adding to bar3_value will no longer cause bleeding if the token is still below half health

v.0.2 (2015-01-05)

  • Added layer check to make sure nothing bleeds on the non-object layers.
  • Fixed tabs and spacing

v.0.1 (2015-01-05)

  • Release

See Also