|
| 1 | +## Condefinition |
| 2 | + |
| 3 | +### What it does |
| 4 | + |
| 5 | +Condefinition reads incoming roll templates and looks for imposed conditions and saving throws. It displays button(s) in chat that allow you to: |
| 6 | + |
| 7 | +- Quickly apply a corresponding token marker |
| 8 | +- Define the condition |
| 9 | +- Track concentration |
| 10 | +- Roll saving throws |
| 11 | +- Apply damage from spells or effects triggered by saving throws |
| 12 | + |
| 13 | +- If the roll template contains a saving throw, it gives a button for the saving throw. Press the button and click on a target to roll the appropriate save. With **GroupCheck** installed, it runs a groupcheck save. If you have [**Apply Damage**](https://app.roll20.net/forum/post/3631602/script-groupcheck-roll-checks-saves-et-cetera-for-many-tokens-at-once/?pageforid=4359153#post-4359153) installed, it also applies damage. |
| 14 | + |
| 15 | +- If the roll template contains an imposed condition, it creates a button to define the condition. If there's a cross-reference in the definition, it creates an inline link. You can hover or whisper/broadcast the text to players. |
| 16 | + |
| 17 | +- You can toggle that condition on selected tokens. Assigning token markers requires **TokenMod**, and for improved function, **LibTokenMarkers**. Default status markers are included, and the configuration handout allows you to customize these. |
| 18 | + |
| 19 | +- If installed via One-Click, this Mod will also auto-install **GroupCheck**, **TokenMod**, and **LibTokenMarkers** if they’re missing. **[Apply Damage](https://app.roll20.net/forum/post/3631602/script-groupcheck-roll-checks-saves-et-cetera-for-many-tokens-at-once/?pageforid=4359153#post-4359153)** must be installed manually. |
| 20 | + |
| 21 | +- In addition to official conditions, it tracks many common features that benefit from markers (e.g., Raging, Hunter's Mark, Hexblade's Curse). |
| 22 | + |
| 23 | +- The Concentration condition marker also tracks concentration and prompts for a Constitution Save when damaged. |
| 24 | + |
| 25 | +- Compatible with Classic and Jumpgate VTT, and the 2014 or 2024 D&D sheets. Advanced configuration requires JavaScript knowledge. |
| 26 | + |
| 27 | +### What it can't do |
| 28 | + |
| 29 | +There are some limitations: |
| 30 | + |
| 31 | +- Primarily designed for GMs and NPCs. Players may see buttons, but full use is GM-facing. |
| 32 | +- Conditions are matched to tokens, not character sheets (intentional, for individual instances like multiple goblins). |
| 33 | +- Some condition wordings may be missed, especially in non-WotC content. |
| 34 | +- Currently, all buttons and definitions are whispered to the controller of the NPC. If needed, this could change based on whisper settings. |
| 35 | + |
| 36 | +### Helper Scripts |
| 37 | + |
| 38 | +- **Required:** `TokenMod`, `libTokenMarkers` |
| 39 | +- **Optional/Recommended:** `GroupCheck`, [`Apply Damage`](https://app.roll20.net/forum/post/3631602/script-groupcheck-roll-checks-saves-et-cetera-for-many-tokens-at-once/?pageforid=4359153#post-4359153) |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +## Operation |
| 44 | + |
| 45 | +### **Buttons** |
| 46 | + |
| 47 | +Whenever a condition is implied in chat, or the report function is used on a token, a button is created. Each button has three parts: |
| 48 | + |
| 49 | +- **Middle:** Sends the condition definition to the GM. Some include cross-links to related conditions (e.g., *Unconscious* also includes *Incapacitated*). |
| 50 | +- **Left side:** Word balloon icon that sends the condition to all players. |
| 51 | +- **Right side:** Toggles the token marker for selected tokens. |
| 52 | + |
| 53 | + |
| 54 | + |
| 55 | +--- |
| 56 | + |
| 57 | +### **List All Common Condition Definitions** |
| 58 | + |
| 59 | +Type `!condef-all` in chat to display all official condition buttons. This does not include extras like *Raging* or *Marked*, just the official conditions. |
| 60 | + |
| 61 | + |
| 62 | + |
| 63 | +--- |
| 64 | + |
| 65 | +### **Concentration** |
| 66 | + |
| 67 | +When a token takes damage and has a concentration marker, Condefinition calculates and prompts a Constitution Save. |
| 68 | + |
| 69 | +Example: "Morrigan" takes 30 damage while concentrating. The script detects the marker and produces a save button. |
| 70 | + |
| 71 | +Note: This requires **GroupCheck** configured for both 2014 and 2024 sheets. |
| 72 | + |
| 73 | + |
| 74 | + |
| 75 | +--- |
| 76 | + |
| 77 | +### **Report** |
| 78 | + |
| 79 | +Select tokens and run `!condef-report`. The script creates condition buttons for each token with active markers. These buttons only affect the associated token. |
| 80 | + |
| 81 | + |
| 82 | + |
| 83 | +--- |
| 84 | + |
| 85 | +### **Automation of Abilities that Force Saving Throws** |
| 86 | + |
| 87 | +Requires both **GroupCheck** and manually installed [`Apply Damage`](https://app.roll20.net/forum/post/3631602/script-groupcheck-roll-checks-saves-et-cetera-for-many-tokens-at-once/?pageforid=4359153#post-4359153). The spell or ability must be sent to chat with its Description turned on to trigger automation. |
| 88 | + |
| 89 | + |
| 90 | + |
| 91 | +The button works like the concentration check: left half rolls saves for all selected tokens, and optionally applies damage. |
| 92 | + |
| 93 | + |
| 94 | + |
| 95 | +--- |
| 96 | + |
| 97 | +## Configuration |
| 98 | + |
| 99 | +Supports conditions from both 2014 and 2024 rule sets. Can switch between default token markers or the author's "Easy to Read" marketplace markers. |
| 100 | + |
| 101 | +### The Condefinitions Handout |
| 102 | + |
| 103 | +Use `!condef help` or `!condef config` to access settings. |
| 104 | + |
| 105 | +Condition definitions are stored in a handout named **Condefinitions** and consist of 4-line entries separated by an empty line: |
| 106 | + |
| 107 | +1. **Line 1:** Condition name |
| 108 | +2. **Line 2:** Regex to match keywords (e.g., "poisoned|toxic") |
| 109 | +3. **Line 3:** One-line definition (can include simple HTML) |
| 110 | +4. **Line 4:** Name of the token marker |
| 111 | + |
| 112 | +To update, save the handout and click **Update Conditions** in chat. Use the **Code** style when pasting definitions. |
| 113 | + |
| 114 | +**Tip:** Duplicate the handout before editing, in case you need to roll back. |
| 115 | + |
| 116 | +If you use a custom marketplace set for token markers, feel free to share your config — just ensure clean, plain text and wrap in the `Code` style. |
| 117 | + |
| 118 | + |
0 commit comments