|
|
| (7 intermediate revisions by 2 users not shown) |
| 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;">
| + | #redirect[[Script:Status Tracker]] |
| − | <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">'''Dependencies:''' None </span><br>
| + | |
| − | <span style="font-variant:small-caps">'''Conflicts:''' Unknown </span>
| + | |
| − | </div>
| + | |
| − | | + | |
| − | '''Note: This page is under development <br> 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: if a token is marked as knocked down (a condition), its 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.
| + | |
| − | <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.
| + | |
| − | | + | |
| − | 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.
| + | |
| − | | + | |
| − | <br clear="both">
| + | |
| − | === Use ===
| + | |
| − | Note: Command format is identical
| + | |
| − | Note: All commands need
| + | |
| − | | + | |
| − | * help [2][all] Display this message. With no argument it displays only this first page.
| + | |
| − | | + | |
| − | * setoption [flag/gmSecurity/Option or show] [name or show]=[value or show]
| + | |
| − | Set a state value that controls how this script functions. show will display the current values without changing anything. '
| + | |
| − | flags are boolean so must be set to true or false. gmSecurity control what commands need to be run by gm as opposed to allowing player to run them. Valid values are api, chat, both, none. '
| + | |
| − | Options accept any value.
| + | |
| − | | + | |
| − | * uninstall Remove all statusTracker entries from state. Note that fresh versions will reappear again the next time the session is started unless you disable or remvoe this script.
| + | |
| − | | + | |
| − | === 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. <br>
| + | |
| − | More than one command may be present in the same input line by separating them with a Tilde (~).
| + | |
| − | | + | |
| − | === Configuration ===
| + | |
| − | The behavior of this script can be radically changed by minor adjustments to certain options with the "SetOptions" or "Set" command. The format if the command is "SetOptions [catagory] [name]=[value] The following list shows the category and name, along with their default value.
| + | |
| − | | + | |
| − | {{param description top}}
| + | |
| − | {{param description|name=options chatprefix ="!st~"|value=Any chat message that starts with this string is handled by this script. If you don't like typing tildes alot, you could for example set this to "!st", "!st ", or any other string you like so long as it will and conflict with your other scripts and it starts with an exclamation point. Note that !eot does not have an option to change it and is always handled by this script.}}
| + | |
| − | {{param description|name=flags image =true|value=While this is set to true, the tracker graphic will be placed under the token whose turn it is. Setting this to false disables the tracker graphic.}}
| + | |
| − | {{param description|name=flags rotation =true|value=While this is set to true, the tracker graphic will have animated rotation when it first moves to a new token.}}
| + | |
| − | {{param description|name=flags archive =false|value=When this is false (default) the noarchive option is appended to public chat messages this script sends. If this is set to true, the output of this script will be saved in the chat archive. }}
| + | |
| − | {{param description|name=flags clearonclose =true|value=When true, automatically clear the turn order when it is closed.}}
| + | |
| − | {{param description|name=flags logStartup =true|value=When this is true we post a brief console log when the script starts.}}
| + | |
| − | {{param description|name=flags logCommandLine =false|value=When this is true we post a copy of each input command line to the log. This a debugging tool.}}
| + | |
| − | {{param description bottom}}
| + | |
| − | | + | |
| − | gmSecurity controls what commands can be issued by players. GM's can always run any command. Some commands are always forbidden to all players who are not GM. GM's can use these options to allow all players to run some additional commands. Each gmSecurity option can have one of 4 valid values: api, chat, both, none.
| + | |
| − | * none: This command can never be run in any way by players who are not GM. Only GM's can run these commands.
| + | |
| − | * chat: Only the GM can run this command from a chat command. However another API script can cause this command to be executed even when the player action that ran the other script was from a non-GM player. This is considered fairly secure since only GM approved scripts can be loaded in a campaign.
| + | |
| − | * api: Not certain why this option would ever be used, but it means that players do not have to be GM to issue chat commands to this script, but players can not initiate api calls to this script.
| + | |
| − | * both: Players have open access to this command via ether chat messages or api calls.
| + | |
| − | The commands, and the default values are as follows: set gmSecurity start=chat, stop=chat, pause=chat.
| + | |
| − | | + | |
| − | === Changelog ===
| + | |
| − | | + | |
| − | {{changelog version|1.00|upcoming|StatusTracker Release}}
| + | |
| − | {{changelog version|0.082|2015-09-23|Original source TrackerJacker by Ken L.}}
| + | |
