[Script] CombatTracker

CombatTracker

• Discord: Atheos#1095
• Roll20: https://app.roll20.net/users/1226016/robin
• Roll20 Thread: https://app.roll20.net/forum/post/6349145/script-combattracker
• Github: https://github.com/RobinKuiper/Roll20APIScripts
• Reddit: https://www.reddit.com/user/robinkuiper/
• Patreon: https://patreon.com/robinkuiper
• Paypal.me: https://www.paypal.me/robinkuiper

CombatTracker will be a great help in battles. Easily keep tracks of who's turn it is, use a turn timer, let players progress to the next turn by themselves, adding/removing conditions, etc. It has a lot of customizable configuration options.

StatusInfo

If you use my StatusInfo script, it will also add the markers set there automatically to the selected token(s), and it will add a condition to this script if you manually (or through TokenMod/StatusInfo) set a marker that has a condition in StatusInfo.

Commands

• !ct - Shows the CombatTracker menu.
• !ct config - Shows the config menu.
• !ct favorites - Shows the favorites menu.
• !ct conditions - Shows a list of known conditions from StatusInfo and favorites.
• !ct show - Shows a list of conditions on selected tokens.
• !ct start - Starts the combat, if you have tokens selected it will try to roll initiative for them and add them to the tracker.
• !ct stop - Stops the combat (closes the turntracker, removes the marker, clears the turnorder list, etc.).
• !ct next - Goes to the next turn (a player can also use this if it is his turn).
• !ct prev - Goes to the previous turn (gm only).
• !ct sort - Sort the turnorder.
• !ct add [condition name] [?duration] [?direction] [?message] - Adds a condition to the selected token(s) (duration is optionally (how much rounds.)).
  • [?duration] - Optional duration, set 0 for no duration.
  • [?direction] - The direction per turn, eg. -1, -3, +1, +3.
  • [?message] - A message that will be visible.
• !ct remove [condition name] - Removes a condition from the selected token(s).
• !ct reset conditions - Resets all conditions.
• !ct st - Stops the timer for this turn.
• !ct pt - Pause timer toggle for this turn.

Conditions

Commands

• !ct conditions - Shows a list of known conditions from StatusInfo and favorites.
• !ct show - Shows a list of conditions on selected tokens.
• !ct add [condition name] [?duration] [?direction] [?message] - Adds a condition to the selected token(s) (duration is optionally (how much rounds.)).
  • [?duration] - Optional duration, set 0 for no duration.
  • [?direction] - The direction per turn, eg. -1, -3, +1, +3.
  • [?message] - A message that will be visible.
• !ct remove [condition name] - Removes a condition from the selected token(s).
• !ct reset conditions - Resets all conditions.

Favorites

Here you can create, add and edit favorite conditions. By clicking on the name it will be added to the selected token(s).

• Name - The name of the condition.
• Duration - How long the condition lasts (0 for no duration).
• Direction - The direction the duration will go to, eg. -1, -3, +1, +3.
• Message - A small message that will be visible when it's the characters turn.

Config

• Command - The command used for this script, eg. !ct.
• Ini. Attribute - The initiative bonus attribute used in the character sheet that you are using, defaults to initiative_bonusused in the 5e OGL sheet.
• Marker Img. - Image (url) you want to use as a marker.
• Stop on Close - Stop the combat on turnorder close (removes the marker, clears the turnorder list, etc.).
• Auto Pull Map - If you want to pull the page to the token (same as shift + hold left click). Works only for the GM due to API limitations.

Turnorder Config

• Auto Roll Ini. - If you want to autoroll (and add) the selected tokens' initiative when you start combat.
• Reroll Ini. p. Round - Reroll initiative on every round.
• Auto Sort - Toggle the auto sorting of the turnorder.
• Skip Custom Items - Automatically skip custom items in the tracker.

Timer Config

• Turn Timer - If you want to use the timer.
• Time - The time per turn (in seconds).
• Auto Skip - Toggle if we should auto skip the turn when the timer hits zero.
• Show in Chat - Announce remaining time in chat at intervals.
• Show on Token - Show a timer above the current token.
• Token Font - The font used for the token timer.
• Font Size - The font size used for the token timer.

Announcement Config

• Announce Turn - Announces who's turn it is in chat.
• Announce Round - Announces the round in chat.
• Announce Conditions - If you don't announce the turn, you can choose to only announce conditions in chat.
• Shorten Long Name - If you want to shorten a long name in chat.
• Use FX - If you want to use some special effect with the turn change.
  • FX Type - The name-color of the FX you want to use, for custom FX use the id.

Macro Config

The macro (ability) should be in the characters abilities tab.

• Run Macro - Toggle if we should run the macro on a characters turn.
• Macro Name - The name of the macro.

Changelog

v0.2.6

• Custom items will now count down/up correctly when applied.
• Set initiative die in the config.
• Sort turnorder with !ct sort.
• Bugfixes.

v0.2.5

• Fixed a "bug" where the marker wouldn't show on the first turn when initiative is not rolled with CT.
• Toggle auto skip turn when timer runs out.
• Optionally show auto initiative roll in chat.
• !ct next bugfix.

v0.2.4

• Changed config menu, turnorder settings now in seperate menu.
• Optionally run a character macro (ability) on the characters turn.
• Optionally turn off auto sorting turnorder.
• Optionally reroll initiative every round.
• FX will now not show when a token is on the gmlayer.

v0.2.3

• Optionally whisper turns to gm.
• Bugfix where StatusInfo conditions got the same duration.

v0.2.2

• Optionally skip custom items.
• Improved condition show menu, with button to show custom messages or StatusInfo descriptions.

v0.2.1

• Some fixes and improvements by The Aaron
• Bugfixes

v0.2.0

• Optionally auto Pull (Works only for DM due to API limitations)
• Optionally use FX on turn change.
• Fixed condition round counter.
• Logical shit & bugfixes.

v0.1.13

• Bugfixes

v0.1.12

• Show a list of conditions on selected tokens, !ct show.
• Show a list of known conditions (from StatusInfo and favorites), !ct conditions.

v0.1.11

• !ct menu expanded.
• Players can see Round number now.
• Save and use favorite conditions.
• Possibility to add a custom message to a condition.
• Possibility to add a direction to the duration of a condition, eg. +1, +3, -1, -3.
• Possibility to pause the timer, !ct pt will toggle the pause. There also is a button in the menu, !ct menu or !ct.
• Possibility to shorten a long name in the chat announcements.
• Possibility to go to the previous turn.
• Fixed initiative attribute config option.

v0.1.10

• Fixed a bug were conditions with StatusInfo support didn't get the duration provided (needs StatusInfo update to).
• Fixed a bug were selecting tokens by dragging caused an error.
• Some small fixes.

v0.1.9 - 02-05-2018

• Good connection with StatusInfo
• Add/remove conditions.
• Whisper hidden turns to gm.
• Better initiative calculations.
• Changed config menu.
• Changed some styling.
• Bugfixes

v0.1.4 - 27-04-2018

• Fixed a bug were manually going further in the turnorder list didn't work.
• Added the option to stop combat on turnorder list close.

Ini. Attribute - The initiative bonus attribute used in the character sheet that you are using, defaults to `initiative_bonus` used in the 5e OGL sheet.

jarg0n said:

Looks good! I will test using this rather than TurnMarker.

Nice work Robin!
Question;

Ini. Attribute - The initiative bonus attribute used in the character sheet that you are using, defaults to `initiative_bonus` used in the 5e OGL sheet.

 With Pathfinder and 5e Shaped sheet's in mind; can the initiative_bonus be set to any attribute? Thanks

Ravenknight said:

Yup! Amazing! Thanks for sharing, Robin.

Oh, a quick request: Would it be able for the script to show the token name instead of the character name in chat?

Robin said:

Ravenknight said:

Yup! Amazing! Thanks for sharing, Robin.

Oh, a quick request: Would it be able for the script to show the token name instead of the character name in chat?

Thanks for your reply! It should already display the token name.

Ravenknight said:

Then it's not working for me. :( This is how it appear in the chat:

Jerry F. said:

Shaped support?

Vince said:

Nice work Robin!
Question;

Ini. Attribute - The initiative bonus attribute used in the character sheet that you are using, defaults to `initiative_bonus` used in the 5e OGL sheet.

 With Pathfinder and 5e Shaped sheet's in mind; can the initiative_bonus be set to any attribute? Thanks

Yes, it is defaulted to 5e OGL, but you can fill in any attribute name in the config, and it should work, let me know if there are any problems.

Jerry F. said:

Shaped support?

Gozer the Gozerian said:

Is it possible it only displays the first word of tokens with names of more than one word?

Robin said:

Gozer the Gozerian said:

Is it possible it only displays the first word of tokens with names of more than one word?

This would be possible indeed. I think I can add that in the next update.

Ravenknight said:

Another thing I've noticed is that if I add a condition (using !ct add) that have a set token marker and is used by Statusinfo I can't get the duration to work. It does work fine with a condition with another name as seen in the example below. The countdown works fine for "Blind" but when I try to add "Blinded" I get the correct marker on the token but no duration.

Ravenknight said:

Another thing I've noticed is that if I add a condition (using !ct add) that have a set token marker and is used by Statusinfo I can't get the duration to work. It does work fine with a condition with another name as seen in the example below. The countdown works fine for "Blind" but when I try to add "Blinded" I get the correct marker on the token but no duration.

Just tested it, something seems to gone wrong during one of the updates I think. I will take a look in to it.

Jerry F. said:

Hmmm, I tried changing it. Wasn't working, I'll try again tonight after my game.

Ravenknight said:

Adding a Condtion with !ct adds the duration now. However I don't get the nice description of the condition anymore.

Robin said:

Mostly the timer and that it works with my StatusInfo script.
It can than also add conditions to this script by just setting the correspondeing statusmarker manually, with TokenMod or with StatusInfo.

Robin said:

Ravenknight said:

Adding a Condtion with !ct adds the duration now. However I don't get the nice description of the condition anymore.

Did you also update the StatusInfo script?

Gozer the Gozerian said:

I'm still seeing that the script only uses the first word of the token name.

Also, as a feature request, would it be possible to pause the timer?  Sometimes people have technical difficulties, and I'd hate to penalize them for that.

Nover C. said:

The other one also had the ability to add conditions w/ status markers, the durations and save them as favorites for future one click use.
I am not against yours at all, the script user of that one left, so you would be the more active up to date in a sense. 
The timer feature is nice. May I suggest, check his out and see if you can add it to yours - he has a visual marker that appears on the current players' token turn or npc token. 

See what you can get from his script and add it to yours, because eventually one day, his script will break and he is no longer on roll20 to update it and hopefully your is. Like the description - you can add a status, tell it if it is gonna move up or down a # per turn and write a custom description. I love this feature the most, to play around with fluff

Question: Are there any ways of me as a DM to add in a custom condition and get the description shown in chat other then adding it using Statusinfo?

I'm still seeing that the script only uses the first word of the token name.

Also, as a feature request, would it be possible to pause the timer?  Sometimes people have technical difficulties, and I'd hate to penalize them for that.

Hello

I like your scripts! One question : is it possible to add condition via a nice list (!condition style) instead of a query ?

Great work :)

Nover C. said:
edit: ahh, it seems you have a orange little semi circle as the indicator of who's turn.

Walrus said:

This is pretty awesome.  Can only the GM add and remove conditions or can players do so as well? 

Also, any chance we could type in a partial for conditions and have it use the conditions in the config?  For example, instead of typing out Unconscious every time, could it recognize "unc" or should I just change the names of the conditions to abbreviations? (don't really want to do that because then the abbreviation will be output to chat I think)

Garrion said:

Great script! I did find one bug in my initial test and I also have a feature request.

1. When clicking on the macro for the custom Ini. Attribute, no dialog box pops up requesting entry of that attribute name. It only cycles the config page in chat. I'm assuming it should pop up a dialog for you to enter the value like the other options do.

2. Would it be possible to make the Round # show for players in the Turn Order window? Right now it shows the init value of -1 and the red swoosh token image, but no text for the round number. Only the GM can see the current value.

Thanks for the great tool.

• !ct menu expanded.
• Players can see Round number now.
• Save and use favorite conditions.
• Possibility to add a custom message to a condition.
• Possiblity to add a direction to the duration of a condition, eg. `+1`, `+3`, `-1`, `-3`.
• Possibility to pause the timer, `!ct pt` will toggle the pause. There also is a button in the menu, `!ct menu` or `!ct`.
• Possibility to shorten a long name in the chat announcements.
• Possibility to go to the previous turn.
• Fixed initiative attribute config option.

Kilter said:

Would it be possible to import the conditions from statusinfo, instead of recreating them? And maybe a drop down of the list?

Kilter said:

Would it be possible to import the conditions from statusinfo, instead of recreating them? And maybe a drop down of the list?

Kilter said:

Would it be possible to import the conditions from statusinfo, instead of recreating them? And maybe a drop down of the list?

Yeah, I like the Combat Tracker and I have created a ton of my own Conditions in the Statusinfo and they don't seem to really talk to each other.

Jerry F. said:

I guess the better question is, Do I have to build all my StatusInfo Conditions in Combat Tracker as well?

Would it be possible to add a list of current conditions and the ability to remove them without having to write the full name of the condtion? Perhaps just by the use of a button?

Robin said:You mean a list of all conditions known by StatusInfo in chat? With a button to add them to a token?

Ravenknight said:

Robin said:You mean a list of all conditions known by StatusInfo in chat? With a button to add them to a token?

Sorry, I worded that poorly. Right now, if I want to remove a condition from a token, I need to write the name of the condition. I would like to see the ability to select and edit those using a list. 

Walrus said:

A chat menu list of conditions, or a dropdown of conditions sounds good to me, too.  Either that or being able to only type partial names.  I wouldn't think the script would need both.

Would it be possible for a command to show all conditions on a token? Something like "!ct show". If this would also allow for editing and removing statuses via a chat menu (spawned by !ct show).

One of the things that has kept me from using this script is that the Shaped Sheet has radio buttons for all the conditions. I already have a series of macros to fiddle with that, and there is a built in macro to report statuses. Any roadmap for your script to interact with these on-sheet statuses?

Would it be possible for a command to show all conditions on a token? Something like "!ct show". If this would also allow for editing and removing statuses via a chat menu (spawned by !ct show).

Nover C. said:

I still havent used it but been keeping an eye on this thread. awesome job updating and adding new feats. Glad you added some of the Jacker stuff in. To help:

Would it be possible for a command to show all conditions on a token? Something like "!ct show". If this would also allow for editing and removing statuses via a chat menu (spawned by !ct show).

In Jacker - he has something called !tj edit and it shows all the current status on the token and provides 2 or clickable things: 1 delete status from token, 2 edit status