<div id="death-save-social" style="height:36px; background:rgba(255, 255, 255, 0.7); display: flex;text-align:center; padding-top:2px">
<span style="flex:1;">
<a href="https://discord.gg/wwH7DQc" title="Discord"><img height="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/discord.svg"/></a></span>
<span style="flex:1">
<a href="https://twitter.com/death_save_dev" title="Twitter"><img height="32" width="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/twitter.svg" /></a></span>
<span style="flex:1">
<a href="https://twitch.tv/teamDEATHSAVE" title="Twitch"><img height="32" width="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/twitch.svg" /></a></span>
<span style="flex:1">
<a href="https://www.youtube.com/channel/UCxhr66d1sjfXU4SQ5MEqPvg" title="YouTube"><img height="32" width="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/youtube.svg" /></a></span>
</div><br/>

![https://img.shields.io/endpoint?url=https%3A%2F%2Ffoundryshields.com%2Fversion%3Fstyle%3Dflat%26url%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fdeath-save%2Fcombat-utility-belt%2Fmaster%2Fmodule.json](https://img.shields.io/endpoint?url=https%3A%2F%2Ffoundryshields.com%2Fversion%3Fstyle%3Dflat%26url%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fdeath-save%2Fcombat-utility-belt%2Fmaster%2Fmodule.json)<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-30-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->

![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/death-save/combat-utility-belt) 
[![GitHub downloads (latest)](https://img.shields.io/badge/dynamic/json?label=Downloads@latest&query=assets[?(@.name.includes('zip'))].download_count&url=https://api.github.com/repos/death-save/combat-utility-belt/releases/latest&color=green)](https://github.com/death-save/combat-utility-belt/releases/latest)
[![Forge Installs](https://img.shields.io/badge/dynamic/json?label=Forge%20Install%20Base&query=package.installs&suffix=%&url=https://forge-vtt.com/api/bazaar/package/combat-utility-belt&colorB=brightgreen)](https://forge-vtt.com/)


# Combat Utility Belt
*made with ❤ by [DEATH SAVE DEVELOPMENT](https://deathsave.dev)*


---
**[📚Wiki/How-To](https://github.com/death-save/combat-utility-belt/wiki)**    
**[🐛Issues/Bugs](https://github.com/death-save/combat-utility-belt/issues)**    
**[💬Contact](#death-save-social)**    
**[📜Changelog](https://github.com/death-save/combat-utility-belt/blob/master/CHANGELOG.md)**    
**[📦Installation](#installation)**    
**[🛠 Gadgets](#gadgets)**    
**[👏Thanks/Attribution](#thanksattribution)**

---
> Every ~~hero~~ GM needs gadgets to keep their game safe from dastardly players up to no good! And where better to store those gadget than on your very own Combat Utility Belt!    
This handy-dandy combat aid comes packed with a bunch of gadgets to ensure you get a TPK every time...
## Features (Gadgets)
### Core
* CUBputer
* Enhanced Conditions
* Triggler
### Additional
* Hide Names
* Award XP
* Pan/Select
* Reroll Initiative
* Temporary Combatants
* Miscellaneous Actor/Token
### D&D5e specific
* Concentrator
* Mighty Summoner


# Installation
~~Simply wrap the belt around your waist and affix the clasp.~~

1. Navigate to the Foundry Setup screen and click on the Modules tab
2. Click Install Module and look for Combat Utility Belt
3. Once the Combat Utility Belt is installed, open your desired world and ~~wreak havoc on your players~~ navigate to the **Settings > Manage Modules** and enable the module then **Settings > Module Settings** and enable the gadget settings you want!


# Gadgets
<details>
  <summary>Click to show</summary>
  
## Award XP
Provides an option to distribute XP to player-characters at the end of combat

## Concentrator
*(D&D5e only)*

![concentrator](https://github.com/death-save/media/blob/master/combat-utility-belt/concentrator.gif)

A DM is responsible for all sorts of things, but keeping track those pesky spell casters and their concentration is one more thing that you shouldn't have to worry about!

With this gadget, you can make sure that those *irritating* spellcasters are always checked whenever the concentrating status is applied. Now they'll be careful about getting hit by that goblin sneaking around!

## CUBputer
Although it's not technically a gadget, think of the CUBputer as the control room for your ~~evil~~ operation. Provides critical configuration options for CUB's gadgets.

## Enhanced Conditions

![enhanced-conditions](https://github.com/death-save/media/blob/master/combat-utility-belt/enhanced-conditions.gif)

It's not enough to *show* your players when their poisoned, you want to really drive it  home by linking the condition so they can wallow in misery as they fail their ability checks.

This gadget creates a dynamo-powered link between status effect icons and reference entries (Journal, Item, or compendium) with further info on that status effect.

### Condition Lab

The ideal place to concoct your ~~nefarious~~ heroic combination of status icons and condition names, as well as link Conditions to Active Effects.

*I like the Deadly STD one!*

## Hide Names

![hide-npc-names](https://github.com/death-save/media/blob/master/combat-utility-belt/hide-npc-names.gif)

Maybe you forgot that your NPC's name reveals a dark secret about their past, or maybe you forgot to give them a name.

Fret no more, for this gadget replaces NPC names with a replacement of your choice. Personally, I'm a fan of Melvin.


## Mighty Summoner
*(D&D5e only) Druid Circle of the Shepherd class feature support*    
Rolls additional dice for summoned creatures

## Miscellaneous Actor/Token Enhancements

### Quick Edit Token Resource from Combat Tracker
Easily edit your tracked token resource directly from the Combat Tracker

### Roll Hostile HP
Roll token HP when dropping on the scene

### Token Effect Icon Size
Select from a range of options to set the size of status effect icons on tokens

## Pan/Select
Pans the camera to and/or selects active combatants during combat

## Reroll Initiative

![reroll-initiative](https://github.com/death-save/media/blob/master/combat-utility-belt/reroll-initiative.gif)

The BBEG rolled a 2 for initiative? Not anymore! This gadget rerolls initiative for all combatants each round.

Glorious chaos!

## Temporary Combatants
Track lair actions, environmental effects and more as Temporary Combatants that last only as long as the current combat encounter!

## Triggler
Trigger the addition or removal of Conditions, and/or the execution of Macros based on changes to actor/token properties such as HP
</details>

---

# Thanks/Attribution
Firstly thank you to all my [patrons](https://patreon.com/deathsave), you make module development extra special!

Secondly I want to shout out the awesome contributors for this module (see: [contributors](#contributors-)). Whether it's code, translations, or bugs/suggestions, without your help Combat Utility Belt would not be as awesome as it is! 

I would also like to acknowledge that many of the functions found in the Combat Utility Belt are inspired by [Roll20 API scripts](https://github.com/RobinKuiper/Roll20APIScripts) written by @RobinKuiper (namely the Combat Tracker, Death Tracker and StatusInfo ones).

Concentration icon made by [Freepik](https://www.flaticon.com/authors/freepik) from [Flat Icon](www.flaticon.com)

## Donations/Sponsorship
Any support you can provide is greatly appreciated! Check out the `Sponsor this project` section in the right-hand sidebar.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tr>
    <td align="center"><a href="https://github.com/Reaver01"><img src="https://avatars3.githubusercontent.com/u/1864450?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Reaver01</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=Reaver01" title="Code">💻</a></td>
    <td align="center"><a href="https://swendrowski.us"><img src="https://avatars1.githubusercontent.com/u/15639841?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Cody Swendrowski</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=cswendrowski" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/JacobMcAuley"><img src="https://avatars2.githubusercontent.com/u/12160735?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jacob McAuley</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=JacobMcAuley" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/Moerill"><img src="https://avatars1.githubusercontent.com/u/26152015?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Moerill</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=Moerill" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/BrotherSharper"><img src="https://avatars3.githubusercontent.com/u/41280723?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brother Sharp</b></sub></a><br /><a href="#translation-BrotherSharper" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/drdwing"><img src="https://avatars1.githubusercontent.com/u/66671688?v=4?s=100" width="100px;" alt=""/><br /><sub><b>drdwing</b></sub></a><br /><a href="#translation-drdwing" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/rinnocenti"><img src="https://avatars3.githubusercontent.com/u/3178127?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Renato Innocenti</b></sub></a><br /><a href="#translation-rinnocenti" title="Translation">🌍</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/HonzoNebro"><img src="https://avatars2.githubusercontent.com/u/5500663?v=4?s=100" width="100px;" alt=""/><br /><sub><b>HonzoNebro</b></sub></a><br /><a href="#translation-HonzoNebro" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/apoapostolov"><img src="https://avatars0.githubusercontent.com/u/4083812?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Apostol Apostolov</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3Aapoapostolov" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://github.com/Zamrod"><img src="https://avatars1.githubusercontent.com/u/12570777?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Zamrod</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3AZamrod" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://github.com/Rawrly85"><img src="https://avatars3.githubusercontent.com/u/53245027?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rawrly85</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3ARawrly85" title="Bug reports">🐛</a></td>
    <td align="center"><a href="http://stu.scot"><img src="https://avatars1.githubusercontent.com/u/6506599?v=4?s=100" width="100px;" alt=""/><br /><sub><b>STU</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=grandseiken" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/MikauSchekzen"><img src="https://avatars0.githubusercontent.com/u/2879734?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tijmen Bok</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=MikauSchekzen" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/shaun-newsome"><img src="https://avatars0.githubusercontent.com/u/7287194?v=4?s=100" width="100px;" alt=""/><br /><sub><b>shaun-newsome</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=shaun-newsome" title="Code">💻</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/tposney"><img src="https://avatars2.githubusercontent.com/u/4486143?v=4?s=100" width="100px;" alt=""/><br /><sub><b>tposney</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=tposney" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/tpendragon"><img src="https://avatars1.githubusercontent.com/u/2806645?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Trey Pendragon</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=tpendragon" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/hmqgg"><img src="https://avatars1.githubusercontent.com/u/36689909?v=4?s=100" width="100px;" alt=""/><br /><sub><b>hmqgg</b></sub></a><br /><a href="#translation-hmqgg" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/SalieriC"><img src="https://avatars1.githubusercontent.com/u/1230041?v=4?s=100" width="100px;" alt=""/><br /><sub><b>SalieriC</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3ASalieriC" title="Bug reports">🐛</a></td>
    <td align="center"><a href="http://sleys.net/blog"><img src="https://avatars2.githubusercontent.com/u/105347?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Bob Sleys</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3Absleys" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://github.com/trdischat"><img src="https://avatars1.githubusercontent.com/u/52774325?v=4?s=100" width="100px;" alt=""/><br /><sub><b>trdischat</b></sub></a><br /><a href="#ideas-trdischat" title="Ideas, Planning, & Feedback">🤔</a></td>
    <td align="center"><a href="https://github.com/kandashi"><img src="https://avatars2.githubusercontent.com/u/1347785?v=4?s=100" width="100px;" alt=""/><br /><sub><b>kandashi</b></sub></a><br /><a href="#ideas-kandashi" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3Akandashi" title="Bug reports">🐛</a> <a href="#question-kandashi" title="Answering Questions">💬</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/DanOrc"><img src="https://avatars1.githubusercontent.com/u/9914380?v=4?s=100" width="100px;" alt=""/><br /><sub><b>DanOrc</b></sub></a><br /><a href="#ideas-DanOrc" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/death-save/combat-utility-belt/issues?q=author%3ADanOrc" title="Bug reports">🐛</a> <a href="#question-DanOrc" title="Answering Questions">💬</a></td>
    <td align="center"><a href="https://github.com/acd-jake"><img src="https://avatars1.githubusercontent.com/u/67855941?v=4?s=100" width="100px;" alt=""/><br /><sub><b>acd-jake</b></sub></a><br /><a href="#translation-acd-jake" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/FuyuEnnju"><img src="https://avatars.githubusercontent.com/u/55729032?v=4?s=100" width="100px;" alt=""/><br /><sub><b>长耳</b></sub></a><br /><a href="#translation-FuyuEnnju" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/Wibble199"><img src="https://avatars.githubusercontent.com/u/3984322?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Will Bennion</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=Wibble199" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/flamewave000"><img src="https://avatars.githubusercontent.com/u/3588046?v=4?s=100" width="100px;" alt=""/><br /><sub><b>flamewave000</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=flamewave000" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/WallaceMcGregor"><img src="https://avatars.githubusercontent.com/u/17795541?v=4?s=100" width="100px;" alt=""/><br /><sub><b>WallaceMcGregor</b></sub></a><br /><a href="#translation-WallaceMcGregor" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/Hertzila"><img src="https://avatars.githubusercontent.com/u/7857080?v=4?s=100" width="100px;" alt=""/><br /><sub><b>hertzila</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=hertzila" title="Code">💻</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/Autmor"><img src="https://avatars.githubusercontent.com/u/66399049?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Autmor</b></sub></a><br /><a href="https://github.com/death-save/combat-utility-belt/commits?author=Autmor" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/MichalGolaszewski"><img src="https://avatars.githubusercontent.com/u/46850235?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Michał Gołaszewski</b></sub></a><br /><a href="#translation-MichalGolaszewski" title="Translation">🌍</a></td>
  </tr>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
