Difference between revisions of "Script:StatusTracker"
From Roll20 Wiki
| Line 1: | Line 1: | ||
<div style="float: {{{1|right}}}; width: 200px; padding: 5px; border: 1px solid #777; margin: 0 15px 15px 15px; background-color: #efefef;"> | <div style="float: {{{1|right}}}; width: 200px; padding: 5px; border: 1px solid #777; margin: 0 15px 15px 15px; background-color: #efefef;"> | ||
| − | + | <span style="text-align:center;display:block;font-size:1.4em">API Script</span> | |
| − | + | <span style="font-variant:small-caps">'''Author:''' {{user profile|633707|ChrisD}} </span><br> | |
| − | + | {{script version|0.182}}<br> | |
| − | + | {{script lastmodified date| 2017-02-05}}<br> | |
<!-- | <!-- | ||
<span style="font-variant:small-caps">'''Code:''' [https://github.com/Roll20KenL/Roll20_API_Scripts/blob/master/trackerjacker.js TrackerJacker] </span><br> | <span style="font-variant:small-caps">'''Code:''' [https://github.com/Roll20KenL/Roll20_API_Scripts/blob/master/trackerjacker.js TrackerJacker] </span><br> | ||
--> | --> | ||
| − | + | <span style="font-variant:small-caps">'''Dependencies:''' None </span><br> | |
| − | + | <span style="font-variant:small-caps">'''Conflicts:''' Unknown </span> | |
</div> | </div> | ||
| Line 16: | Line 16: | ||
* Track conditions using status markers. Track duration of conditions. | * Track conditions using status markers. Track duration of conditions. | ||
* Automatically adjust attributes based upon conditions. IE: when knocked down or blessed, your stats change. | * Automatically adjust attributes based upon conditions. IE: when knocked down or blessed, your stats change. | ||
| + | <br> | ||
| − | '''StatusTracker''' is based upon [https://wiki.roll20.net/Script:TrackerJacker TrackerJacker] by Ken L. However while some routines are almost untouched, I heavily rewrote others and added the ability to track and use attribute changes based upon token level conditions. (IE: if a token is marked as knocked down (a condition), his attack value (an attribute of the associated character) can be automatically | + | '''StatusTracker''' is based upon [https://wiki.roll20.net/Script:TrackerJacker TrackerJacker] by Ken L. However while some routines are almost untouched, I heavily rewrote others and added the ability to track and use attribute changes based upon token level conditions. (IE: if a token is marked as knocked down (a condition), his attack value (an attribute of the associated character) can be automatically adjusted when referencing the knocked down token, while remaining the same for all other tokens). |
| − | Like [https://wiki.roll20.net/Script:TrackerJacker TrackerJacker] and [https://app.roll20.net/forum/permalink/931415/ TurnMarker], it uses a graphic image that follows beneath tokens to indicate who's turn it is. | + | Like [https://wiki.roll20.net/Script:TrackerJacker TrackerJacker] and [https://app.roll20.net/forum/permalink/931415/ TurnMarker], it uses a graphic image that follows beneath tokens to indicate who's turn it is. It also optionally announces round numbers, whose turn it is, etc. The real function however of '''StatusTracker'''' is to track statuses and duration's with an easily accessible interface that's intuitive, and to allow token level adjustment of attributes based upon those conditions. |
| − | + | ||
| − | The real function however of '''StatusTracker'''' is to track statuses and duration's with an easily accessible | + | |
<br clear="both"> | <br clear="both"> | ||
| Line 35: | Line 34: | ||
They can be comma or white-space delimited (commas are needed to delimit blank or empty fields). | They can be comma or white-space delimited (commas are needed to delimit blank or empty fields). | ||
Parameters with values may have ether equal signs or colons between them. | Parameters with values may have ether equal signs or colons between them. | ||
| − | Values may optionally have double or single quotes around them. | + | Values may optionally have double or single quotes around them |
| + | (required if value contains certain things such as white-space, comma's or tilde's). | ||
Labels may usually be skipped on Commands with mandatory parameters if you put all required parameters in order. <br> | Labels may usually be skipped on Commands with mandatory parameters if you put all required parameters in order. <br> | ||
More than one command may be present in the same input line by separating them with a Tilde (~). | More than one command may be present in the same input line by separating them with a Tilde (~). | ||
| + | === Configuration === | ||
=== Changelog === | === Changelog === | ||
| − | {{changelog | + | |
| − | {{ | + | {{changelog version|1.07|2015-09-23| |
| + | * Added: ability for players to add their own statuses to tokens they control (it's not possible for tokens they don't control without a large support structure). Uses the same syntax. | ||
| + | * Added: ability to have secret hidden statuses on any token. Whenever a status is not assigned a marker, it's considered 'hidden'. Note that you can't currently assign an empty parameter for markers when editing, only on creating a new status and or applying a favorite that has no marker. | ||
| + | * Fixed: a rare issue with findCurrentToken where it would attempt to pull an element from an empty turn order. | ||
| + | * Fixed: a rare issue with updateAllTokenMarkers where the received token status string is undefined.}} | ||
| + | {{changelog version|1.01|2015-08-31| | ||
| + | * Fixed: !tj -reset not performing as expected. | ||
| + | * Added: ability for !eot to work for the GM while the tracker is active. | ||
| + | * Added: ability for the tracker graphic to follow the token as it switches between the GM and token layers.}} | ||
| + | {{changelog version|1.00|2015-08-30|* Release}} | ||
| + | |||
| + | |||
| + | |||
| + | {{changelog version|1.00|upcoming| | ||
| + | * StatusTracker Release}} | ||
| + | {{changelog version|0.082|2015-09-23| | ||
| + | Original source TrackerJacker by Ken L.}} | ||
Revision as of 14:48, 5 February 2017
API Script
Author: ChrisD
Version: 0.182
Last Modified: 2017-02-05
Dependencies: None
Conflicts: Unknown
Note: This page is under development
StatusTracker is not live yet.
- Track turns and initiatives.
- Track conditions using status markers. Track duration of conditions.
- Automatically adjust attributes based upon conditions. IE: when knocked down or blessed, your stats change.
StatusTracker is based upon TrackerJacker by Ken L. However while some routines are almost untouched, I heavily rewrote others and added the ability to track and use attribute changes based upon token level conditions. (IE: if a token is marked as knocked down (a condition), his attack value (an attribute of the associated character) can be automatically adjusted when referencing the knocked down token, while remaining the same for all other tokens).
Like TrackerJacker and TurnMarker, it uses a graphic image that follows beneath tokens to indicate who's turn it is. It also optionally announces round numbers, whose turn it is, etc. The real function however of StatusTracker' is to track statuses and duration's with an easily accessible interface that's intuitive, and to allow token level adjustment of attributes based upon those conditions.
Contents |
Use
TODO
Notes
All commands are parsed with maximum flexibility. Parameters may optionally have a hyphen in front of them.
They can be comma or white-space delimited (commas are needed to delimit blank or empty fields).
Parameters with values may have ether equal signs or colons between them.
Values may optionally have double or single quotes around them
(required if value contains certain things such as white-space, comma's or tilde's).
Labels may usually be skipped on Commands with mandatory parameters if you put all required parameters in order.
More than one command may be present in the same input line by separating them with a Tilde (~).
Configuration
Changelog
v1.07 (2015-09-23)
- Added: ability for players to add their own statuses to tokens they control (it's not possible for tokens they don't control without a large support structure). Uses the same syntax.
- Added: ability to have secret hidden statuses on any token. Whenever a status is not assigned a marker, it's considered 'hidden'. Note that you can't currently assign an empty parameter for markers when editing, only on creating a new status and or applying a favorite that has no marker.
- Fixed: a rare issue with findCurrentToken where it would attempt to pull an element from an empty turn order.
- Fixed: a rare issue with updateAllTokenMarkers where the received token status string is undefined.
v1.01 (2015-08-31)
- Fixed: !tj -reset not performing as expected.
- Added: ability for !eot to work for the GM while the tracker is active.
- Added: ability for the tracker graphic to follow the token as it switches between the GM and token layers.
v1.00 (2015-08-30)
- Release
v1.00 (upcoming)
- StatusTracker Release
v0.082 (2015-09-23)
Original source TrackerJacker by Ken L.
