|
|
| (One intermediate revision by one user not shown) |
| Line 1: |
Line 1: |
| − | {{script overview
| + | #REDIRECT [[Script:Blood and Honor]] |
| − | |name=Blood-and-Honor
| + | |
| − | |author={{user profile|242509|John C.}}
| + | |
| − | |version=0.8
| + | |
| − | |lastmodified=2015-01-08}}
| + | |
| − | | + | |
| − | '''Blood and Honor''' is an automatic way to add lightweight blood effects to your campaign, without any animations or commands.
| + | |
| − | | + | |
| − | 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. 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 chance for a blood spatter to appear is: <code>(max - current) / max</code>. In other words, the percentage of ''missing'' heath is the chance to water the fields with blood. The larger the amount of damage taken at once, the bigger the spatter will be.
| + | |
| − | | + | |
| − | 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 creates more blood. If a token's bar3 value falls to 0 or below, a large pool of blood graphic appears on the map layer beneath it.
| + | |
| − | | + | |
| − | === Syntax ===
| + | |
| − | {{syntaxbox top|Blood And Honor: Automatic blood spatter, pooling and trail effects}}
| + | |
| − | {{API command|clearblood}}
| + | |
| − | {{syntaxbox end}}
| + | |
| − | | + | |
| − | If [[Script:IsGM Auth Module|IsGM Auth Module]] is installed and <code>useIsGM</code> is set to <code>true</code>, the <code>!clearblood</code> command will be restricted to GM use only.
| + | |
| − | | + | |
| − | The <code>!clearblood</code> command will move all of the blood splatter graphics to the top left corner of the map so that they can be quickly deleted.
| + | |
| − | | + | |
| − | === Configuration ===
| + | |
| − | Adding the text <code>noblood</code> in any token's GM Notes will cause it to never bleed.
| + | |
| − | | + | |
| − | Add one of the following keywords into the GM Notes of a token if you want the token to bleed a color other than red: <code>bloodcolor_orange</code>, <code>bloodcolor_purple</code>, <code>bloodcolor_blue</code>
| + | |
| − | | + | |
| − | '''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 [https://wiki.roll20.net/API:Objects#imgsrc_and_avatar_property_restrictions this page] for more details.'''
| + | |
| − | | + | |
| − | === Changelog ===
| + | |
| − | {{changelog version|0.8|2015-01-08|* Switched order of GM Auth module checks (thanks Brian)
| + | |
| − | * [bugfix] ironed out a syntax error}}
| + | |
| − | {{changelog version|0.7|2015-01-08|* Size of spatters determined by amount of damage received
| + | |
| − | * Addressed stability issue (trails) with cooldown timer}}
| + | |
| − | {{changelog version|0.6|2015-01-07|* Added support for TheAaron's GM Auth module}}
| + | |
| − | {{changelog version|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}}
| + | |
| − | {{changelog version|0.4|2015-01-05|* [bugfix] "noblood" check now properly passes all bleeding types}}
| + | |
| − | {{changelog version|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}}
| + | |
| − | {{changelog version|0.2|2015-01-05|* Added layer check to make sure nothing bleeds on the non-object layers.
| + | |
| − | * Fixed tabs and spacing}}
| + | |
| − | {{changelog version|0.1|2015-01-05|* Release}}
| + | |
| − | | + | |
| − | === See Also ===
| + | |
| − | * [https://www.youtube.com/watch?v=b-BhZRLwOZU&feature=youtu.be Explanatory video for this script]
| + | |
| − | * [https://app.roll20.net/forum/post/1477230/script-blood-and-honor-automatic-blood-spatter-pooling-and-trail-effects-lightweight#post-1477230 Forum post]
| + | |
