Spray your dungeons with blood!
- Overview
- Features
- Installation
- Settings For House Rules
- Customization
- Performance & Clearing Blood
- Credits and Thanks
Blood 'n Guts is a module for FoundryVTT that draws blood splats on tokens and floors.
- Blood splatter on floor, on tokens, and blood trails behind moving tokens.
- Customizable blood Color based on race or npc type.
- Customizable blood splatter glyphs.
- Blood respects walls, but not see through walls.
- Many options to customize blood size and spread and frequency.
- Can support house rules such as
bloodied at 50% health
- Currently supports DnD5E and PF2E and more to come (please add your request as an issue on the repo)
- Only works on active scenes
Paste the link to the module.json
file into the 'Manifest URL' field in 'Install Module'.
https://raw.githubusercontent.com/edzillion/blood-n-guts/master/src/module.json
Or download the latest zip file here: https://github.com/edzillion/blood-n-guts/releases
Two of the options in Advanced Config help customise when blood splats appear:
Health Threshold
- the percentage of total health to start showing blood.Damage Threshold
- the damage as a percentage of health to show blood.
A common house rule is to show blood at 50% health. This can be achieved by setting Health Threshold = 0.5
and Damage Threshold = 0
. As this is a common rule so a checkbox is included which sets these settings.
⚙️ Since v0.7.2 it is possible to save settings on The Forge. In this case the settings are stored in your Assets Library in a folder called blood-n-guts
. Replace /Data/blood-n-guts
with this folder in the instructions below.
Recomended Forge workflow: install and enable module, files will be created in Assets Library
. Go there are download blood-n-guts
folder. Edit files locally, then upload back to same location.
⚙️ Since v0.6.9 it is now possible to save settings permanently. These settings files are stored in /Data/blood-n-guts/
(note: this is not inside the modules
folder). The files (in JSON format) and the folders will be created for you on install.
- If you add a customisation with the same name as a default - it will overwrite the default with your settings.
- New entries will be added in addition to the defaults.
Blood 'n Guts renders splats as individual glyphs from fonts. You can use this online font face generator to convert a font into the required woff
& woff2
formats: https://transfonter.org/ (just use the default options), it will also provide some sample css.
Steps:
- Copy your font
.woff
and.woff2
files to theData/blood-n-guts/fonts
folder. - Edit the
Data/blood-n-guts/custom.css
to add your@font-family
definition, note the src urls:
@font-face {
font-family: 'Example Font Family';
src: url('../../blood-n-guts/fonts/ExampleFontFile.woff2') format('woff2'),
url('../../blood-n-guts/fonts/ExampleFontFile.woff') format('woff');
font-weight: normal;
font-style: normal;
font-display: swap;
}
- Add an entry in the
Data/blood-n-guts/customSplatFonts.json
file for your new font, this and the css must match.
{
"Example Font Family": {
"name": "Example Font Family",
"availableGlyphs": "ABCDEFGHIJKLMNOP$%&^@!"
}
}
-
You must select only the characters that you want to display. I used FontForge to find the valid character glyphs.
-
Reload the world and you should then be able to select the font in
Advanced Configuration
.
Blood color can be set for race as well as npc type. Just add an entry to the Data/blood-n-guts/bloodColorSettings.json
file. Each entry consists of a name of the race or type (key), and the corresponding color (value), which can be described in a number of ways:
- The full rgba string [r,g,b,alpha] e.g.
"half-elf":"rgba(223, 96, 96, 0.7)",
- A CSS color name e.g.
"elf": "silver",
"name"
tells Blood 'n Guts to read the creature's name for the color to display e.g."dragon": "name",
example (note: keys should all be lowercase!):
{
"beast": "green", // this will override the default color of all beasts
"blob": "name" // this adds a new entry which will display blue for a 'blue blob' red for a 'red blob' etc.
"gnome": "rgba(23, 23, 255, 0.5)" // setting individual red, green, blue, alpha
}
As in other customisations you can override the default levels or add new ones. Example:
{
"Shrieker": { // this will override the default 'Shrieker' settings.
"trailSplatDensity": 9,
"floorSplatDensity": 1,
"tokenSplatDensity": 1,
"trailSplatSize": 25,
"floorSplatSize": 35,
"tokenSplatSize": 25,
"splatSpread": 1,
"healthThreshold": 0.5,
"damageThreshold": 0.33,
"deathMultiplier": 1.5,
"sceneSplatPoolSize": 20
},
"Aboleth": { // this will add a new violence level to the end of the list.
"trailSplatDensity": 10,
"floorSplatDensity": 6,
"tokenSplatDensity": 4,
"trailSplatSize": 90,
"floorSplatSize": 120,
"tokenSplatSize": 60,
"splatSpread": 2.5,
"healthThreshold": 0.9,
"damageThreshold": 0.15,
"deathMultiplier": 2.5,
"sceneSplatPoolSize": 175
}
}
Foundry can start to lag if too many blood splats are being generated. If you are having this problem consider lowering your Violence Level
in settings or the Splat Pool Size
in Advanced Configuration
.
- Everyone has access to change
Violence Level
but only GMs have access toAdvanced Settings
. - GM sets the level appropriate for their needs and then other clients can turn their violence level down if they are having issues.
There are 3 ways to clear blood from the current scene:
- By chat command / chat macro:
/blood clear
(GM and PC) - By clicking the
Wipe Scene Splats
button at the bottom ofAdvanced Configuration
(GM Only) - By clicking the button in the Tile menu on the left (GM Only):
Thanks to @Fyorl @vance @skimble @sky @Monkeyy and @Erecon for tech help. Thanks to @ApoApostolov for testing and feedback.
splatter
font provided by Codin Repshwc rhesus
font provided by Christophe FérayWach Op-Art
font provided by Fernando HaroSigali
font font provided by Dylan CulhaneWM Shapes 1
font provided by WillyMacStarz 2
font provided by Imagex