Merge branch 'Roll20:master' into master

Author: keithcurtis1

AttackMaster/5.3.0/attackMaster.js

@@ -2,8 +2,8 @@
     "$schema": "https://github.com/DameryDad/roll20-api-scripts/blob/AttackMaster/AttackMaster/Script.json",
     "name": "AttackMaster",
     "script": "attackMaster.js",
-    "version": "5.0.6",
-    "previousversions": ["1.036","1.038","1.039","1.041","1.042","2.046","1.3.00","1.3.01","1.3.02","1.3.03","1.4.01","1.4.02","1.4.03","1.4.04","1.4.05","1.4.06","1.4.07","1.5.01","1.5.02","1.5.03","2.1.0","2.2.0","2.3.0","2.3.1","2.3.2","2.3.3","3.0.0","3.1.2","3.2.0","3.2.1","3.3.0","3.4.0","3.5.0","4.0.1","4.0.2","4.0.3","4.0.4","5.0.0","5.0.1","5.0.2","5.0.3","5.0.4","5.0.5"],
+    "version": "5.3.0",
+    "previousversions": ["1.036","1.038","1.039","1.041","1.042","2.046","1.3.00","1.3.01","1.3.02","1.3.03","1.4.01","1.4.02","1.4.03","1.4.04","1.4.05","1.4.06","1.4.07","1.5.01","1.5.02","1.5.03","2.1.0","2.2.0","2.3.0","2.3.1","2.3.2","2.3.3","3.0.0","3.1.2","3.2.0","3.2.1","3.3.0","3.4.0","3.5.0","4.0.1","4.0.2","4.0.3","4.0.4","5.0.0","5.0.1","5.0.2","5.0.3","5.0.4","5.0.5","5.0.6"],
     "description": "AttackMaster API for AD&D 2E provides functions to manage weapons, armour & shields, including taking weapons in hand and using them to attack, ranged weapon range and ammo management; penalties & bonuses for non-proficiency, proficiency, specialisation & mastery; 1-handed, 2-handed or many-handed weapons, and multi-weapon attacks.\n[AttackMaster Documentation](https://wiki.roll20.net/Script:AttackMaster) \n\n### Related APIs\nThis API works best with the RPGMaster series of APIs\n[RPGMaster Documentation](https://wiki.roll20.net/RPGMaster) \n\n### Getting Started\n* After installation, add the commands `!attk --menu` and `!attk --other-menu` as Ability Macros on Character Sheets of Characters, NPCs & Monsters that will use the API, and tick 'Show as Token Action'.  These menus will then be available to Players controlling those sheets and give access to all common commands used in game-play.",
     "authors": "Richard E.",
     "roll20userid": "6497708",

AttackMaster/attackMaster.js

@@ -2,8 +2,8 @@
     "$schema": "https://github.com/DameryDad/roll20-api-scripts/blob/CommandMasterAPI/CommandMaster/Script.json",
     "name": "CommandMaster",
     "script": "CommandMaster.js",
-    "version": "5.0.3",
-    "previousversions": ["1.020","1.022","1.024","1.025","2.027","1.3.00","1.3.01","1.3.02","1.3.03","1.3.04","1.4.01","1.4.02","1.4.04","1.4.05","1.4.06","1.4.07","1.5.01","2.1.0","2.2.0","2.3.0","2.3.1","2.3.2","2.3.3","3.0.0","3.1.2","3.2.0","3.2.1","3.3.0","3.5.0","3.5.1","4.0.1","4.0.2","5.0.0","5.0.1","5.0.2"],
+    "version": "5.3.0",
+    "previousversions": ["1.020","1.022","1.024","1.025","2.027","1.3.00","1.3.01","1.3.02","1.3.03","1.3.04","1.4.01","1.4.02","1.4.04","1.4.05","1.4.06","1.4.07","1.5.01","2.1.0","2.2.0","2.3.0","2.3.1","2.3.2","2.3.3","3.0.0","3.1.2","3.2.0","3.2.1","3.3.0","3.5.0","3.5.1","4.0.1","4.0.2","5.0.0","5.0.1","5.0.2","5.0.3"],
     "description": "The CommandMaster API is part of the RPGMaster suite of APIs for Roll20, and manages the initialisation of a Campaign to use the RPGMaster APIs, communication and command syntax updates between the APIs and, most importantly for the DM, easy menu-driven setup of Tokens and Character Sheets to work with the APIs.\n\n[CommandMaster Documentation](https://wiki.roll20.net/Script:CommandMaster) \n[RPGMaster Documentation](https://wiki.roll20.net/RPGMaster) \n### Getting Started\n1. Run `!cmd --initialise` and add the player macros created to the Macro Bar, then\n2. Select tokens and use the `Token Setup` macro bar button just created to add all relevant Action Buttons to the token(s) (plus set the tokens/Characters up in any other way provided in the menu displayed) \n3. Once steps 1 & 2 have been done, the players and DM can then use the buttons displayed at the top of the screen when their character's token is selected to perform all actions needed in normal play.",
     "authors": "Richard E.",
     "roll20userid": "6497708",

AttackMaster/script.json

@@ -0,0 +1,95 @@
+# HealthColors Changelog
+
+All notable changes to this project will be documented in this file.  
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+---
+
+## [2.0.1] – 2026-04-20
+
+### Fixed
+- Corrected behavior for tokens with health below zero to ensure the "dead" marker is applied consistently.
+- Clamped negative health values to zero for accurate color mapping and consistent visual feedback.
+- Refactored `applyAuraAndDead` to separate dead-marker logic from aura updates, ensuring proper handling of edge cases.
+
+### Changed
+- Updated `percentToHex` to normalize input values, preventing invalid color calculations.
+- Improved code readability and maintainability by restructuring health percentage calculations.
+
+---
+
+## [2.0.0] – 2026-04-08
+
+Major modernization and stability refactor of the entire script, consolidating performance improvements, critical bug fixes, and new user control features. This version represents a complete overhaul from the v1.6.x series.
+
+### Added
+- **Respect Manual Overrides** — the script now only updates visual properties (Aura 1) when a token's internal health bar actually changes. This allows for manual customization of colors, radii, and shapes via the token settings dialog without script interference during movement.
+- **Persistent Default Auras** — tokens at 100% health now default to a clean **Green** Aura 1 (at the configured `AuraSize`) to indicate stability.
+- **JSDoc Documentation** — every function is now fully documented with parameter types, return values, and behavioral descriptions to improve maintainability.
+- **Centralized Configuration** — all default state values, FX definitions, and internal parameters are now managed via unified constants.
+- **FX Recovery Commands** — added `!aura reset-fx` (rebuild default heal/hurt custom FX objects) and `!aura reset-all` (restore all settings to defaults + rebuild default FX + force update).
+- **Public Settings Snapshot** — setting-changing `!aura` commands now post a read-only settings panel to game chat for table visibility.
+- **Aura Detail Commands** — added `!aura a1shape`, `!aura a1tint`, `!aura a2size`, `!aura a2shape`, and `!aura a2tint` to adjust displayed Aura 1/Aura 2 detail values from chat.
+- **Settings Output Command** — added `!aura settings` to post the current settings snapshot to game chat on demand.
+
+### Changed
+- **`_` (Underscore) dependency** — no longer required.
+- **`buttonColor` function** — legacy function completely removed after
+  verifying no external or internal dependencies; superseded by `nameBtn`.
+- **Tautological FX condition** `(UseBlood !== "OFF" || UseBlood !== "NO")`.
+- **`!aura on/off` semantics** — now explicitly sets global enabled state instead of toggling on `on`.
+- **Schema version** — bumped to `1.1.0` to reflect incremental state/data migration changes in the v2.0.0 line.
+
+### Fixed
+- Consistent casing for `checkInstall` and `handleToken` throughout.
+- Initialization of `OneOff` state key to prevent `undefined` collisions.
+- Corrected logic in `playDeath` to ensure jukebox tracks are properly stopped before restarting.
+- Page scale calculation and aura radius math standardized for better precision.
+- Heal and hurt FX color assignment now resolves `startColour`/`startColor` and `endColour`/`endColor` consistently, preventing gray/white fallback artifacts.
+- Default heal/hurt FX random color channels are explicitly neutralized during spawn preparation to preserve configured color fidelity.
+- Added a fallback spawn path that updates and triggers default custom FX by id (`spawnFx`) when definition-based spawning renders colors inconsistently.
+- Tuned default heal/hurt particle profile values for clearer saturation and reduced washed-out appearance in experimental sandboxes.
+- `!aura bar` now validates `1|2|3`, whispers confirmation on change, and immediately runs a full sync to apply the new bar selection.
+- Tokens with no `max` value on the configured bar now have aura/tint cleared, preventing stale health indicators.
+- Configuration output now explicitly includes Aura 2 detail rows in both the GM menu and public settings snapshot.
+- Prevented duplicate settings output: setting-changing commands now publish a single game-chat snapshot instead of both GM and public panels.
+- Aura 2 output values are now sourced from state-backed defaults (`Aura2Size`, `Aura2Shape`, `Aura2Color`) instead of hardcoded labels.
+- Added Aura 1 Shape/Tint rows to settings output and backed them with default state values (`Aura1Shape`, `Aura1Color`).
+- Default heal/hurt custom FX definitions are now synchronized proactively on install/reset and when FX colors change, preventing delayed/stale visual updates after color edits or token lifecycle events.
+
+
+---
+
+## [1.6.1] – 2020-08-20
+
+- Maintenance release. Bug fixes and minor state schema updates.
+
+## [1.6.0] – 2020-08-19
+
+- Added per-character `USEBLOOD` attribute support for custom FX colours and named custom FX overrides.
+
+## [1.5.1] – Earlier
+
+- Added `USECOLOR` per-character attribute to disable aura/tint on individual
+  tokens.
+
+## [1.4.1] – Earlier
+
+- Added heal FX support (`-DefaultHeal` custom FX, `HealFX` colour setting).
+
+## [1.3.2] – Earlier
+
+- Aura size setting (`AuraSize`) and `OneOff` mode added.
+
+## [1.3.1] – Earlier
+
+- Death sound FX (`auraDeadFX`) introduced.
+
+## [1.3.0] – Earlier
+
+- NPC/PC split for dead marker and aura percentage threshold.
+
+## [1.2.0] – Earlier
+
+- Initial public release. Basic red-to-green aura/tint health indicator with
+  GM menu via `!aura`.