Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Turn Tracker"

From Roll20 Wiki

Jump to: navigation, search
m
m (place tool-link)
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;">
+
{{revdate}}{{ToolboxNav}}{{HCbox| {{hc|articles/360039178634-Turn-Tracker Here}} }}
<big>'''''Attention:'''''
+
[[File:Turn01.png|thumb|left|600px|Turn Tracker on the [[Toolbar]] ]]{{gm only tool}}
''Roll20 is no longer maintaining this document on the community wiki. For the most up-to-date information please visit this page on our help center for assistance: [https://roll20.zendesk.com/hc/en-us/articles/360039178634-Turn-Tracker Here].''</big>
+
{{#evp:youtube|hFOxs45TRgc|How to use the Turn Tracker (Jan 11, 2022)|right|660}}
</div>
+
The Roll20 '''{{Turn Tracker}}''' exists to aid [[GM|you]] and your [[players]] with turn-based games by presenting an interactive list to the group. This feature is intentionally not automated, so that more game types are able to use it. It's also known as the '''Initiative Tracker'''.  
The Roll20 '''<span style="font-family:Pictos;">t</span> Turn Tracker''' exists to aid you and your players with turn-based games by presenting an interactive list to the group. This feature is intentionally not automated, so that more game types are able to use it. It's also known as the '''Initiative Tracker'''.  
+
  
To open the Turn Tracker, click on the Turn Tracker button on the Toolbox. Note that while only the GM can open the Turn Tracker, once it is open it will be visible to all players as well.
+
To open the Turn Tracker, click on the {{Turn Tracker}} button on the [[Toolbar]]. Note that while only the [[GM]] can open the Turn Tracker, once it is open it will be visible to all [[players]] as well.
[[File:Turn01.png|thumb|right|600px]]
+
<br clear=left>
 +
=Turn Tracker=
 
== Adding Turns ==
 
== Adding Turns ==
[[File:Turn-Tracker-Init-from-sheet.gif|right|thumb|500px]]
 
 
There are a few ways you can add new entries to the Turn Tracker.
 
There are a few ways you can add new entries to the Turn Tracker.
 
<br>
 
<br>
 
<br>
 
<br>
 
===Character Sheet===
 
===Character Sheet===
 
 
If you use a [[Character Sheet|character sheet]] and want to add a roll from it to the Turn Tracker automatically, you '''must''' first select the associated token before performing the roll.
 
If you use a [[Character Sheet|character sheet]] and want to add a roll from it to the Turn Tracker automatically, you '''must''' first select the associated token before performing the roll.
  
 
If no token is selected, the roll only appears in the [[Text Chat]] with a warning: ''You wanted to send the result of this roll to the turn tracker, but no valid token was selected!''.
 
If no token is selected, the roll only appears in the [[Text Chat]] with a warning: ''You wanted to send the result of this roll to the turn tracker, but no valid token was selected!''.
  
Selecting the wrong token will use the stats from the character sheet, but place the selected, (wrong) Token on the tracker.
+
Selecting the wrong token will use the stats from the character sheet used for the roll, but place the selected, (wrong) Token on the tracker.
<br>
+
[[File:Turn-Tracker-Init-from-sheet.gif|center|thumb|800px]]
<br>
+
 
<br>
+
<br clear=all>
 
===Token Only===
 
===Token Only===
 
[[File:Turn03.png|thumb|left|220px]]
 
[[File:Turn03.png|thumb|left|220px]]
Line 41: Line 39:
 
After the token turn has been added, the token's image and name (if set) will appear in the turn list. Note that if the token is on the GM Layer, the name will be greyed to indicate that the turn is not being shown to players.
 
After the token turn has been added, the token's image and name (if set) will appear in the turn list. Note that if the token is on the GM Layer, the name will be greyed to indicate that the turn is not being shown to players.
  
Additionally, selecting a token and [[Dice_Reference#Roll_To_Initiative|rolling for initiative]] with the <code>&{tracker}</code> at the end of the roll will automatically set the token into the turn order.  For example <code>/roll 1d20 + 5 &{tracker}</code>.
+
Additionally, selecting a token and [[Dice_Reference#Roll_To_Initiative|rolling for initiative]] with the <code>&{tracker}</code> at the end of the roll will automatically set the token into the turn order.  For example <code>/roll 1d20 + 5 &{tracker}</code>.<br clear=all>
<br>
+
===Card===
<br>
+
You can add cards to the turn tracker: [[Cards#Using_Cards_for_Initiative_Order]]
<br>
+
<br>
+
<br>
+
 
+
 
=== Custom Item ===
 
=== Custom Item ===
{{#ev:youtube|IArm4PYAIws||left|400px|Quick video showing how to add a custom item to the tracker.-[https://app.roll20.net/users/2225609/nick-o Nick O.]}}
+
{{#evp:youtube|IArm4PYAIws|Quick video showing how to add a custom item to the tracker. by Nick O.|right|400}}
 
You can also add character/creatures/objects to the turn order that aren't already associated with an existing token by using the '''&quot;Add Custom Item&quot;''' field. Just fill out the name of the item and click the '''Add''' button to include it in the tracker.
 
You can also add character/creatures/objects to the turn order that aren't already associated with an existing token by using the '''&quot;Add Custom Item&quot;''' field. Just fill out the name of the item and click the '''Add''' button to include it in the tracker.
  
Optionally you can add a '''Round Calculation''' to custom items. These calculations are completed every time the custom item reaches the top of the Turn Tracker. This is particularly useful for setting up a "Round Count" object that increases by one every rotation, or setting depreciating buffs that decrease every round. For example, entering "+1" will increase the value at the start of every turn, while "-1" will decrease the value by 1 at the start of every turn (useful for tracking things like buffs or other temporary conditions).  Note that this only works when there are more than one items on the Turn Tracker.  
+
Optionally you can add a '''Round Calculation''' to custom items. These calculations are completed every time the custom item reaches the top of the Turn Tracker. This is particularly useful for setting up a "Round Count" object that increases by one every rotation, or setting depreciating buffs that decrease every round. For example, entering "+1" will increase the value at the start of every turn, while "-1" will decrease the value by 1 at the start of every turn (useful for tracking things like buffs or other temporary conditions).  Note that this only works when there are more than one items on the {{Turn Tracker}}.  
  
 
You can even reference these values the same way you would Attributes by using the syntax:<code>@{tracker|Item Name}</code>. This can be used to simulate systems that use an Escalation Die mechanic or fetch the value of a token's turn order.
 
You can even reference these values the same way you would Attributes by using the syntax:<code>@{tracker|Item Name}</code>. This can be used to simulate systems that use an Escalation Die mechanic or fetch the value of a token's turn order.
<br>
+
<br clear=all>
<br>
+
== Advancing Turns ==
<br>
+
To advance to the next turn in the tracker, simply press the arrow button, and the current turn at the top of the list will be moved to the bottom.
<br>
+
 
 +
== Removing Turns ==
 +
To remove a turn, simply mouseover the turn in the list, and then click on the red trash can icon that appears over the token image.
 +
 
 +
If you want to clear all turns at once, you can press the blue Turn Order Setting Button, and click the red '''Remove All Turns''' (Clear List) button to completely reset the Turn Tracker.
 
== Adding Values ==
 
== Adding Values ==
  
The Turn Tracker allows you to add a value next to each token. You can use this spot to keep track of initiative or any other stat that you want to note about the turn. There are several ways to add token values, all of which can be accomplished by both the GM and players.
+
The Turn Tracker allows you to add a value next to each token. You can use this spot to keep track of initiative or any other stat that you want to note about the turn. There are several ways to add token values, all of which can be accomplished by both the [[GM]] and [[players]].
 +
 
 +
The easiest method is to simply click on the number next to the Token and type in a new number. Press {{button|Return}}/{{button|↵ Enter}} after typing and the new value will be saved.
  
The easiest method is to simply click on the number next to the Token and type in a new number. Press Return/Enter after typing and the new value will be saved.
+
===Initiative Macros===
 +
{{main|Macros/Initiative}}
  
 
Alternatively, you can drag the result of a roll from the chat box to the Turn Tracker and drop it in the numerical field.
 
Alternatively, you can drag the result of a roll from the chat box to the Turn Tracker and drop it in the numerical field.
  
Values can also be added or subtracted from chat using the + or - flags with the <code>&{tracker}</code> command like so:
+
Values can also be added or subtracted from chat using the <code>+</code> or <code>-</code> flags with the <code>&{tracker}</code> command like so:
 
<br />
 
<br />
* <code>/roll 1d20 + 5 &{tracker:+}</code>
+
* <code>/roll 1d20 + 2 &{tracker}</code>  ''(rolls 1d20+2 for initiative. If the token already have an initiative, it will be rerolled)''
* <code>/roll 1 &{tracker:-}</code>
+
* <code>/roll 1d20 + 5 &{tracker:+}</code>   ''(adds 1d20+5 to the initiative of the selected token.)''
* <code>[[10 &{tracker:-}]]<br /></code>
+
* <code>/roll 1 &{tracker:-}</code>   ''(subtracts 1 from the selected token's initiative)''
[[File:TurnOrderSettings.jpg|right|thumb|400px|Turn Order Setting]]
+
* <code>[[10 &{tracker:-}]]</code>  ''(subtracts 10 from the selected token's initiative)''
 +
* <code><nowiki>&{template:default} {{name=Bob's Initiative}} {{Result=[[1d20+@{Bob|dex_bonus}+@{Bob|init_bonus} &{tracker}]]}}</nowiki></code>   ''(rolls initiative based on stat's from a character sheet named "Bob", using the [[Roll_Template#Default|default roll template]] )''
 +
<br>[[File:TurnOrderSettings.jpg|right|thumb|400px|Turn Order Setting]]
 
If the selected token isn't already in the turn tracker, then it is added with the value that was rolled and the additional flag is ignored.
 
If the selected token isn't already in the turn tracker, then it is added with the value that was rolled and the additional flag is ignored.
 +
<br>
 
<br>
 
<br>
 
<br>
 
<br>
Line 81: Line 85:
 
To re-order the turns, you can simply click and drag on a turn and then move it up or down in the list.
 
To re-order the turns, you can simply click and drag on a turn and then move it up or down in the list.
  
If you press the blue Turn Order Settings Button, you can reorder and sort the current list either numerically or alphabetically.
+
If you press the {{button|{{gear}}|blue}}(Turn Order Settings)-Button, you can reorder and sort the current list either numerically or alphabetically.
 
=== Turn Order Settings ===
 
=== Turn Order Settings ===
Clicking on the blue gear button at the bottom of the Turn Tracker will bring up the '''Turn Order Settings'''. Here you can choose between a series of sorting methods: numerically, alphabetically, and by card suit.
+
Clicking on the {{button|{{gear}}|blue}} button at the bottom of the {{Turn Tracker}} will bring up the '''Turn Order Settings'''. Here you can choose between a series of sorting methods: numerically, alphabetically, and by card suit.
 
<br>
 
<br>
 
<br>
 
<br>
Line 91: Line 95:
 
<br>
 
<br>
 
<br>
 
<br>
== Advancing Turns ==
+
== Turn Tracker Visibility ==
To advance to the next turn in the tracker, simply press the arrow button, and the current turn at the top of the list will be moved to the bottom.
+
  
== Removing Turns ==
+
The [[GM]] controls the {{Turn Tracker}}. It shows on [[player]]'s screens when the GM opens it, and closes for all players when the GM closes it.
To remove a turn, simply mouseover the turn in the list, and then click on the red trash can icon that appears over the token image.
+
  
If you want to clear all turns at once, you can press the blue Turn Order Setting Button, and click the red '''Remove All Turns''' (Clear List) button to completely reset the Turn Tracker.
+
== Turn Tracker on Multiple Pages ==
  
== Turn Tracker Visibility ==
+
{{Turn Tracker}} can track tokens from any combination of pages, and there’s no need to close it when switching between pages. The [[GM]] sees all items in the list, but [[players]] will only see the items that are located on their current page.
  
The GM controls the turn tracker. It shows on player's screens when the GM opens it, and closes for all players when the GM closes it.
 
 
== Turn Tracker on Multiple Pages ==
 
  
Turn Tracker can track tokens from any combination of pages, and there’s no need to close it when switching between pages. The GM sees all items in the list, but players will only see the items that are located on their current page.
+
=Tricks=
 +
{{:Turn Tracker/Tricks}}
 +
=API=
 +
{{apiboxRec}}
 +
{{:Turn Tracker/API}}
  
== See Also ==
+
= See Also =
 
* [[Character Sheet]]
 
* [[Character Sheet]]
 
* [[Tokens]]
 
* [[Tokens]]
 
* [[Complete Guide to Macros & Rolls]]
 
* [[Complete Guide to Macros & Rolls]]
 
** [[Dice Reference#Roll To Initiative]]
 
** [[Dice Reference#Roll To Initiative]]
* '''[[Toolbox Overview|Toolbox(sidebar)]]'''
+
* '''[[Toolbar]]'''
** <span style="font-family:Pictos Custom;">w</span> [[Select and Pan Tool]]
+
** {{Select}}
** <span style="font-family:Pictos;">b</span> [[Layers]]
+
** {{Layers}}
** <span style="font-family:Pictos Custom;">i</span> [[Drawing Tools]]
+
** {{Drawing}}
** <span style="font-family:Pictos;">e</span> [[Custom FX|FX Tool]]
+
** {{FX Tool}}
** <span style="font-family:Pictos;">s</span> [[Zoom|Zoom Tool]]
+
** {{Zoom}}
** [[File:Ruler.png|middle|15px]] [[Ruler|Ruler Tool]]
+
** {{Ruler}}
** <span style="font-family:Pictos;">E</span> [[Fog of War]]
+
** [[Place Tool]]
** <span style="font-family:Pictos;">t</span> [[Turn Tracker]]
+
** {{fow}} / {{Darkness}}([[UDL]])
** <big><span style="font-family:dicefontd20;">t</span></big> [[Dice Rolling GUI]]
+
** {{Turn Tracker}}
 +
** {{DiceGUI}}
 
** <span style="font-family:Pictos;">?</span> [[Toolbox_Overview|Help Tool]]  
 
** <span style="font-family:Pictos;">?</span> [[Toolbox_Overview|Help Tool]]  
* API Scripts
 
** [[Script:Group Initiative]]
 
** [[Script:Highlight Token at Top of Initiative]]
 
 
<br>
 
<br>
 
<br>
 
<br>
 
[[Category:Docs]]
 
[[Category:Docs]]
 +
[[Category:Toolbar]]
 +
[[Category:Tokens]]
 +
[[Category:Macros]]
 +
[[Category:Combat/Initiative]]

Latest revision as of 14:56, 11 March 2023

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Here .

Turn Tracker on the Toolbar
How to use the Turn Tracker (Jan 11, 2022)

The Roll20 t Turn Tracker exists to aid you and your players with turn-based games by presenting an interactive list to the group. This feature is intentionally not automated, so that more game types are able to use it. It's also known as the Initiative Tracker.

To open the Turn Tracker, click on the t Turn Tracker button on the Toolbar. Note that while only the GM can open the Turn Tracker, once it is open it will be visible to all players as well.

Contents

[edit] Turn Tracker

[edit] Adding Turns

There are a few ways you can add new entries to the Turn Tracker.

[edit] Character Sheet

If you use a character sheet and want to add a roll from it to the Turn Tracker automatically, you must first select the associated token before performing the roll.

If no token is selected, the roll only appears in the Text Chat with a warning: You wanted to send the result of this roll to the turn tracker, but no valid token was selected!.

Selecting the wrong token will use the stats from the character sheet used for the roll, but place the selected, (wrong) Token on the tracker.

Turn-Tracker-Init-from-sheet.gif


[edit] Token Only

Turn Order Add Token.png





To add a token without an associated character sheet to the tracker, right click on a token on the tabletop, and choose "Add Turn" from the menu that appears. Note that you can add multiple turns for the same token if desired.





Turn Order Initial State.png




After the token turn has been added, the token's image and name (if set) will appear in the turn list. Note that if the token is on the GM Layer, the name will be greyed to indicate that the turn is not being shown to players.

Additionally, selecting a token and rolling for initiative with the &{tracker} at the end of the roll will automatically set the token into the turn order. For example /roll 1d20 + 5 &{tracker}.

[edit] Card

You can add cards to the turn tracker: Cards#Using_Cards_for_Initiative_Order

[edit] Custom Item

Quick video showing how to add a custom item to the tracker. by Nick O.

You can also add character/creatures/objects to the turn order that aren't already associated with an existing token by using the "Add Custom Item" field. Just fill out the name of the item and click the Add button to include it in the tracker.

Optionally you can add a Round Calculation to custom items. These calculations are completed every time the custom item reaches the top of the Turn Tracker. This is particularly useful for setting up a "Round Count" object that increases by one every rotation, or setting depreciating buffs that decrease every round. For example, entering "+1" will increase the value at the start of every turn, while "-1" will decrease the value by 1 at the start of every turn (useful for tracking things like buffs or other temporary conditions). Note that this only works when there are more than one items on the t Turn Tracker.

You can even reference these values the same way you would Attributes by using the syntax:@{tracker|Item Name}. This can be used to simulate systems that use an Escalation Die mechanic or fetch the value of a token's turn order.

[edit] Advancing Turns

To advance to the next turn in the tracker, simply press the arrow button, and the current turn at the top of the list will be moved to the bottom.

[edit] Removing Turns

To remove a turn, simply mouseover the turn in the list, and then click on the red trash can icon that appears over the token image.

If you want to clear all turns at once, you can press the blue Turn Order Setting Button, and click the red Remove All Turns (Clear List) button to completely reset the Turn Tracker.

[edit] Adding Values

The Turn Tracker allows you to add a value next to each token. You can use this spot to keep track of initiative or any other stat that you want to note about the turn. There are several ways to add token values, all of which can be accomplished by both the GM and players.

The easiest method is to simply click on the number next to the Token and type in a new number. Press Return/↵ Enter after typing and the new value will be saved.

[edit] Initiative Macros

Main Page: Macros/Initiative

Alternatively, you can drag the result of a roll from the chat box to the Turn Tracker and drop it in the numerical field.

Values can also be added or subtracted from chat using the + or - flags with the &{tracker} command like so:

  • /roll 1d20 + 2 &{tracker} (rolls 1d20+2 for initiative. If the token already have an initiative, it will be rerolled)
  • /roll 1d20 + 5 &{tracker:+} (adds 1d20+5 to the initiative of the selected token.)
  • /roll 1 &{tracker:-} (subtracts 1 from the selected token's initiative)
  • [[10 &{tracker:-}]] (subtracts 10 from the selected token's initiative)
  • &{template:default} {{name=Bob's Initiative}} {{Result=[[1d20+@{Bob|dex_bonus}+@{Bob|init_bonus} &{tracker}]]}} (rolls initiative based on stat's from a character sheet named "Bob", using the default roll template )

Turn Order Setting

If the selected token isn't already in the turn tracker, then it is added with the value that was rolled and the additional flag is ignored.




[edit] Turn Order

To re-order the turns, you can simply click and drag on a turn and then move it up or down in the list.

If you press the y(Turn Order Settings)-Button, you can reorder and sort the current list either numerically or alphabetically.

[edit] Turn Order Settings

Clicking on the y button at the bottom of the t Turn Tracker will bring up the Turn Order Settings. Here you can choose between a series of sorting methods: numerically, alphabetically, and by card suit.






[edit] Turn Tracker Visibility

The GM controls the t Turn Tracker. It shows on player's screens when the GM opens it, and closes for all players when the GM closes it.

[edit] Turn Tracker on Multiple Pages

t Turn Tracker can track tokens from any combination of pages, and there’s no need to close it when switching between pages. The GM sees all items in the list, but players will only see the items that are located on their current page.


[edit] Tricks

[edit] API


There are a number of API Scripts that improves the handling of the t Turn Tracker and Initiative in general.

  • GroupInitiative -- Adds the selected tokens to the turn order after rolling their initiative + configurable data. Also has commands for open/close/reset Turn Tracker.
  • TurnMarker1 -- provides a visual marker to show which token's turn it is & centers map on them.
  • CombatMaster(Forum) -- API for improving various aspects of combat. Automating condition duration in combat, Initiative improvement, and more. Version of CombatMaster in API Drowdown might not be latest version, check thread/CombatMaster repo for latest version.
  • InitiativeTrackerPlus -- Initiative and effect tracker with other features.
  • Script:RoundMaster
  • More APIs: API:Script Index - Combat


[edit] See Also