MonsterStatsPlugin
Plugins to automatically try to add stats to a newly spawned mini based on the mini name and stats available on Roll20.
About this mod Author’s original text
Monster Stats Plugin
This unofficial TaleSpire mod attempts to set the stats for newly spawned minis based on the default mini name and
stats available on Roll20.
Change Log
1.2.0: Updated for compatibility with Taleweaver update
1.1.1: Fixed packing error. No changes to plugin.
1.1.0: Stat Lookup only done when holding Left+ALT when dropping a mini to the board.
1.1.0: Fixed placement of the CustomData folder to avoid dictionary and banner exceptions.
1.0.0: Initial release.
Install
Use R2ModMan or similar installer to install.
Usage
When placing a mini on the board, hold the LEFT ALT key when clicking the mouse button for the mini drop. This will
tell the plugin that you want to look up the monster stats for that particular mini. When dropping converter props,
do not hold LEFT ALT while dropping, to avoid the monster stats lookup.
Set the desired game system before play using the text box in the top right corner of the screen. The plugin
initially comes with a 5E provider using stats from Roll20. This should allows getting stats for all SRD creatures
and getting stats for any creatures in any digital source books that have been purchaed on Roll20 is the user has
logged in to the account.
This plugin does, initially, have a map between the non-game-specific names used in Talespire and the 5E creature
set which means that adding a creature to the board can result in one of the following possibilities:
- The creature's name is found online and is the only match. In this case the creatures stats will be applied with
no additional interaction.
- The creature's name results in multiple possibilities online. In such a case, the list of possibilities will be
displayed for the user to choose which stats to apply.
- The creature's name does not match any results online. In such a case, a message indicating that the corresponding
creature could not be found is displayed.
There is also the possibility that only option or the selected option from the creature list, results in a creature
that is only available in a source book that the user had not purchased. In such a case, an appropriate message will
be displayed.
Assuming a match is found, the corresponding stats will be copied to the mini if they match the campaign stats.
Currently the plugin collects HP, AC, Speed, STR, DEX, CON, INT, WIS, CHA. Where the ability code stats will show
both the modifier and the stat value.
Dictionary: Refining The Creature Mapping
In some cases the generic Talespire name for creatures will not be found online but stats for the creature actually
exist online. In such a case, the dictionary feature can be used to re-map the creature name to different key words.
Currently this is a manual process but can be done at runtime. In the folder:
`LordAshes-MonsterStatsPlugin\\CustomData\\{Edition}\\`
Where {Edition} is the game system being used such as 5E, the is a file called `Dictionary.json`. This file can be
edited to add additional mappings. It is a simple dictionary where the key is the exact Talepsire creature name and
the value is the keyword or keywords that the plugin should use to look up the creature. For example, the default
entry of:
{
"Orc Warrior": "Orc"
}
Tell the plugin to search for only the word "Orc" when the "Orc Warrior" mini is dropped. This avoids creatures which
have Warrior in the name but may not be orcs.
Custom Content
In addition, the user can add custom creatures and/or override the stats of existing creatures. To do this create a
text file, with the extension "kvp" (key value pair), and a file name that matches the Talespire creature name or the
dictionary value if the Talespire name was changed via the dictionary (see above).
Within the file, enter the stats of the creature, one per line using the format `Stat=Value`. Currently the following
stats are supported:
HP, AC, Speed, STR, STRMod, DEX, DEXMod, CON, CONMod, INT, INTMod, WIS, WISMod, CHA, CHAMod.
For example:
HP=15
AC=13
Speed=30
STR=12
STRMod=
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: