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 "Character Sheets"

From Roll20 Wiki

Jump to: navigation, search
(Character Sheet Guides)
(Character Sheet in a separate window)
 
(50 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;">
+
{{revdate}}{{HCbox|{{hc|articles/360037773373-Character-Sheet-Tips-and-Tricks Character Sheet Tips & Tricks}} }}
<big>'''''Attention:'''''
+
''Main Page'' '''[[Journal#Characters|Journal, "Characters"-section]]'''
''Roll20 is no longer maintaining this document on the community wiki. For the most up-to-date information please visit this page on our [http://Roll20.net/help Help Center] for assistance: [https://roll20.zendesk.com/hc/en-us/articles/360037773113-Character-Sheets Here]. For more information you can email us at Team@roll20.net''</big>
+
</div>
+
  
[[File:5E OGL Sheet Core v2.6.png|400px|thumbnail|right|'''D&D 5E by Roll20''' Character Sheet]]
+
[[File:5E OGL Sheet Core v2.6.png|400px|thumbnail|right|The '''[[D&D 5E by Roll20]]''' Character Sheet, the most popular sheet used on Roll20]]
Character Sheets allow you to use a digital sheet that's similar to a traditional paper character sheet while playing your game in Roll20. The creator of a game can choose a character sheet template when setting up the game, and all characters in the game will use that sheet template.
+
'''Character Sheets''' allow you to use a digital sheet that's similar to a traditional paper character sheet while playing your game in Roll20. The [[GM#Creator|creator]] of a game can choose a character sheet template when setting up the game, and all characters in the game will use that sheet template.
  
==Choosing a Character Sheet==
+
The character sheet is an optional sub-section of the [[Character]], along with the [[Character#Bio_.26_Info_Tab|Bio]]- and [[Character#Attributes_.26_Abilities_Tab|Attributes&Abilites]]-tabs.
 +
=Choosing a Character Sheet Template=
 +
Depending on what game system you want to play, or even choosing between options available for some systems, you must decide what template, if any, to use in your game.
  
'''[[File:Cs.png|300px|right]]'''
+
If you choose '''None''', then all [[characters]] will only have a [[#Bio|Bio]] & [[#Attributes & Abilites|Attributes & Abilites]]-tabs, but no tab for "Character Sheet."
 +
[[File:Sheet-template-none.png|300px|thumbnail|right| How a sheet without template looks like]] [[File:Cs.png|400px|thumbnail|right| The menu to choose '''Character Sheet Template''']]
  
===Starting a New Game===
+
==Starting a New Game==
  
When starting a new game, you have the option to choose the Character Sheet you want to use from the handy drop-down available on the New Game creation screen. The Character sheet template can be changed after game creation as well. If you're making a Game that's a copy based on an existing Game, the copy will keep all relevant character sheet information to match the original. Finally, you need to click the (I'm Ready, Create Game) button to save.
+
When starting a new game, you (as the game's [[GM#Creator|Creator]]) have the option to choose the '''Character Sheet Template''' you want to use from the handy drop-down available on the New Game creation screen. The Sheet Template can be changed after game creation form the [[Game Settings]]-page. If you're making a Game that's a copy based on an existing Game, the copy will keep all relevant sheet template information to match the original. Finally, you need to click the (I'm Ready, Create Game) button to save.
  
===For an Existing Game===
+
==For an Existing Game==
  
 
To change or add Character Sheet, the Creator of the game should visit the Game Settings page. This page is accessed from the [[Game_Management#Settings|'''Settings dropdown''']] on the [[Game_Management#Game_Details|'''Game Details''']] page. Links to the Game Details pages of games that you belong to can be found on the [https://app.roll20.net/campaigns/search/ '''My Games'''] page.
 
To change or add Character Sheet, the Creator of the game should visit the Game Settings page. This page is accessed from the [[Game_Management#Settings|'''Settings dropdown''']] on the [[Game_Management#Game_Details|'''Game Details''']] page. Links to the Game Details pages of games that you belong to can be found on the [https://app.roll20.net/campaigns/search/ '''My Games'''] page.
  
In the Character Sheet Template section, select a template from the dropdown. '''Pro''' subscribers can also choose Custom to enter their own HTML and CSS.  Finally, you need to click the (Save Changes) button found at the bottom of the screen.
+
In the Character Sheet Template section, select a template from the dropdown. '''[[Pro]]''' subscribers can also choose '''Custom''', and then enter their own HTML/CSS/Translation code into the [[Sheet Editor]].  Finally, you need to click the '''(Save Changes)''' button found at the bottom of the screen.
  
 
[[File:Cs1.png|thumb|400px|Game Settings|left]]
 
[[File:Cs1.png|thumb|400px|Game Settings|left]]
Line 25: Line 26:
 
<div style='clear: both;'></div>
 
<div style='clear: both;'></div>
  
{{mbox | text = '''Note:''' You may need to remove any Attributes that you already have on your existing Characters if they conflict with the names of the attributes on the sheet template's auto-calculating values. If you are seeing weird results with rolls from the sheet, remove your attributes.}}
+
{{mbox | text = '''Note:''' You may need to remove any Attributes that you already have on your existing Characters, if they conflict with the names of the attributes on the new sheet template's [[Auto-Calc|auto-calculating values]]. If you are seeing weird results with rolls from the sheet, remove your attributes.}}
  
 
<div style='clear: both;'></div>
 
<div style='clear: both;'></div>
  
 
[[File:Journal1.0.jpg|thumb|The Add button in the Journal Tab|right|400px]]
 
[[File:Journal1.0.jpg|thumb|The Add button in the Journal Tab|right|400px]]
===Add Individual Sheets In-Game===
 
To add individual character sheets in-game that can be assigned to people, you go to the [[Journal#Adding_Characters|Journal tab]] and click on the '''+ Add''' button and select '''Character''' from the dropdown menu.
 
  
You can also add a character by right-clicking an existing folder in the Journal tab and selecting '''Add Character''' from the '''[[Journal#Folder_Options|Folder Options]]''' menu. Adding new '''Characters''' or '''Handouts''' using the right-click method places them directly into the right-clicked folder.
+
==Add Individual Sheets In-Game==
 +
The Game's [[Creator]] (or anyone promoted to [[GM]]) can add individual character sheets in-game that can be assigned to people([[players]] can't do so). You go to the {{Journal}}-tab and click on the '''+ Add''' button and select '''Character''' from the dropdown menu.  
  
Regardless of how you create the Character entry, Roll20 will randomly generate a placeholder for the Character entry's Name.
+
'''[https://help.roll20.net/hc/en-us/articles/360037772613-Change-Log#june-8-2023-0-1 June 2023]:''' GMs now have an option to make it possible for players to create their own character sheets, and it's off by default.
 +
 
 +
You can also add a character by right-clicking an existing folder in the {{Journal}}-tab, and selecting '''Add Character''' from the '''[[Journal#Folder_Options|Folder Options]]''' menu. Adding new '''Characters''' or '''Handouts''' using the right-click method places them directly into the right-clicked folder.
 +
 
 +
Regardless of how you create the Character entry, Roll20 will randomly generate a random name for the new Character.
  
 
<br>
 
<br>
 
<br>
 
<br>
  
==Character Sheet Basics==
+
=Character Sheet Basics=
  
[[File:Charsheetexample2.gif|framed|right|Drag and drop sheet buttons to the macro quick bar.]]
+
[[File:Charsheetexample2.gif|thumbnail|right|550px|Drag and drop sheet buttons to the macro quick bar.]]
  
 
If there is a character sheet template enabled for your game, there will be a new tab on when you open up a Character in your Journal labeled "Character Sheet". Clicking this tab will open the Character Sheet. The layout and look of your sheet, as well as what fields are available, will be determined by the template that the creator of the game has chosen.
 
If there is a character sheet template enabled for your game, there will be a new tab on when you open up a Character in your Journal labeled "Character Sheet". Clicking this tab will open the Character Sheet. The layout and look of your sheet, as well as what fields are available, will be determined by the template that the creator of the game has chosen.
Line 49: Line 53:
  
 
Some fields may have default values already included. You can modify these values as needed for your particular Character. Some fields are also auto-calculating. As you fill out other parts of the sheet, those fields will auto-update to reflect their new values. You cannot modify those fields directly.
 
Some fields may have default values already included. You can modify these values as needed for your particular Character. Some fields are also auto-calculating. As you fill out other parts of the sheet, those fields will auto-update to reflect their new values. You cannot modify those fields directly.
 
+
<br clear=all>
 
{{mbox | text = '''Useful Tip:''' To the left of the Character name is a popout button. Click to pop your info window out into a new browser window. Visit the '''[[My Settings]]''' page to set popout windows to automatic.}}
 
{{mbox | text = '''Useful Tip:''' To the left of the Character name is a popout button. Click to pop your info window out into a new browser window. Visit the '''[[My Settings]]''' page to set popout windows to automatic.}}
 +
<br>
  
===== Repeating Sections =====
+
== Sheet Rolls ==
In addition to fields, your sheet may feature repeating sections. These are sections (for example, the "Skills" section in the example sheet shown to the right) where you can put more than one item in a list. Just click the "Add" button beneath the section to add a new entry. You can click the "Modify" button to delete existing entries.
+
 
+
===== Sheet Rolls =====
+
 
Your sheet may also feature roll buttons. These are pre-defined rolls included with the sheet which allow you to quickly make attacks, roll checks, etc. These rolls will use the values that you have filled in on the sheet to function, so they're always up-to-date.
 
Your sheet may also feature roll buttons. These are pre-defined rolls included with the sheet which allow you to quickly make attacks, roll checks, etc. These rolls will use the values that you have filled in on the sheet to function, so they're always up-to-date.
  
 
To acquire the contents of a sheet roll button:
 
To acquire the contents of a sheet roll button:
 
# Click on the sheet roll button.
 
# Click on the sheet roll button.
# Focus the [[Text_Chat#Chatting|Text Chat's input box]] (by clicking into to it, or using the [[Advanced_Shortcuts|Advanced Shortcut]] <code>c c</code>). When it's focused, a blue outline appears around it.
+
# Focus the <span style="font-family:Pictos;">q</span> [[Text_Chat#Chat|Text Chat's input box]] (by clicking into to it, or using the [[Advanced_Shortcuts|Advanced Shortcut]] {{button|C}} {{button|C}}). When it's focused, a blue outline appears around it.
# Press the up arrow key on your keyboard.
+
# Press the {{button|&uarr;}}(up arrow) key on your keyboard.
# The contents of the sheet roll button will then populate the text chat input box.
+
# The contents of the sheet roll button will then populate the Text Chat input box.
 
<br>
 
<br>
To acquire the [[Journal#Abilities|Ability call]] corresponding to that sheet roll button, drag the sheet button down to the [[Macros#Macro_Bar|Macro Quick Bar]], click on what you just dragged down, and then complete steps 2 to 4.
+
To acquire the [[Character#Abilities|Ability call]] corresponding to that sheet roll button, drag the sheet button down to the [[Macros#Macro_Bar|Macro Quick Bar]], click on what you just dragged down, and then complete steps 2 to 4.
  
===== Drag and Drop Buttons =====
+
=== Drag and Drop Buttons ===
You can drag and drop sheet buttons to the [[Macros#Macro_Bar|macro quick bar]]. Buttons may be dragged directly off of the character sheet and placed onto the Macro Quick Bar at the bottom of the screen, simply by clicking and dragging the button into place. The buttons can be removed by dragging the button out of the quick bar into open space, the button will turn red and then vanish when the mouse is released. Please note, if you have the pop-out option enabled for the character sheets you must first disable it under your user settings (cog icon) before the drag and drop function will work. You can then turn it back on after you arrange your macro buttons.
+
You can [[Drag & Drop]] sheet buttons to the [[Macros#Macro_Bar|macro quick bar]]. Buttons may be dragged directly off of the character sheet and placed onto the Macro Quick Bar at the bottom of the screen, simply by clicking and dragging the button into place. The buttons can be removed by dragging the button out of the quick bar into open space, the button will turn red and then vanish when the mouse is released. Please note, if you have the pop-out option enabled for the character sheets you must first disable it under your user settings ({{gear}}cog icon) before the drag and drop function will work. You can then turn it back on after you arrange your macro buttons.
 +
[[File:Turn-Tracker-Init-from-sheet.gif|right|thumb|500px|Example of an Initiative Roll that appears on the {{Turn Tracker}} ]]
 +
To delete a button that was added to the macro bar, drag the button off the bar.
  
To delete a button that was added to the macro bar simply drag the button off the bar.
+
=== Initiative Rolls ===
 +
For an Initiative roll to end up on the <span style="font-family:Pictos;">t</span>[[Turn_Tracker#Character_Sheet|Turn Tracker]], a [[Token|token]] '''must''' first be selected, otherwise the roll only appears in the {{Text Chat}}.
  
==Advanced Character Sheet Usage==
+
The Initiative roll can be made from a character sheet, or reference stats from a sheet, but doesn't have to. See [[Dice Reference#Roll To Initiative|Dice Reference - Initiative]], for more details.
 +
{{clear}}
 +
== Repeating Sections ==
 +
{{main|Repeating Section}}
 +
{{:Repeating Section}}
 +
==Link Token==
 +
{{#evp:youtube|c-JmxkjLnDU|Connecting Tokens to Character Sheets, 6min(Sep 2021)|right|400}}
 +
[[Linking Tokens to Journals|Linking Token to a Character]] is a good idea to make character sheets quicker & easier to use. Only the [[GM]] can updates the [[Journal#Default_Token|Default Token]] of a character.
  
 +
If a [[token]] is linked to a character sheet, you can open up the character sheet by pressing {{button|Shift}} & double-clicking the token.
 +
{{clear}}
 +
=Default Sheet Settings=
 +
'''Default Sheet Settings''' will determine default values & settings for any new character sheets added to the {{Journal}}, which the [[GM]] can change from the [[Game_Settings_Page#Default_Sheet_Settings|Game Settings Page]].
 +
 +
 +
If you want to apply these settings to '''existing''' character sheets in the game, go to {{My Settings}} in-game, and press the [[My_Settings#Apply_Default_Settings|Apply Default Settings]]-button.
 +
=Advanced Usage=
 +
 +
==Attributes==
 +
{{main|Character#Attributes}}
 
'''Interaction with Attributes'''
 
'''Interaction with Attributes'''
  
Sheets in Roll20 are a presentation layer for the Attributes system. This means that every field on the sheet is "backed" by a corresponding Attribute on the Character. For example, if there is a field called "Strength" on the sheet, there will also be an attribute called "Strength" in the Attributes & Abilities listing tab. As you update the sheet, the attribute is updated, and vice versa. This also allows you to link the sheet to a token the same way you would link an Attribute to a token, via the "Represents" box on the Token Settings dialog.  
+
Sheets in Roll20 are a presentation layer for the Attributes system. This means that every field on the sheet is "backed" by a corresponding Attribute on the Character. For example, if there is a field called "Strength" on the sheet, there will also be an attribute called "Strength" in the [[Journal#Attributes_.26_Abilities_Tab|Attributes & Abilities]]-tab. As you update the sheet, the attribute is updated, and vice versa. This also allows you to link the sheet to a [[token]] the same way you would link an Attribute to a token, via the "Represents" box on the Token Settings dialog.  
  
 +
==Macros and Abilities==
 +
{{main|Macro Guide}}
 
'''Interaction with Macros and Abilities'''
 
'''Interaction with Macros and Abilities'''
  
You can reference sheet values in your Macros and Abilities by referencing the corresponding Attribute. For example, <code>@{Character Name|Strength}</code> would use the "Strength" attribute, which is also the "Strength" field on the sheet (which would have <code>name='attr_Strength'</code> in the sheet builder). If the Sheet has a "Strength" field which hasn't been edited yet by the player, then the result of the variable will be either the default value for the field specified on the sheet by the sheet designer, or it will be "" (an empty string).
+
You can reference sheet values in your Macros and Abilities by referencing the corresponding Attribute. For example, <code>@{Bob|strength}</code> would use the <code>strength</code> attribute, which is also the <code>strength</code> field on the sheet (which would have <code>name='attr_strength'</code> in the sheet code). If the Sheet has a <code>strength</code> field which hasn't been edited yet by the [[player]], then the result of the variable will be either the default value for the field specified on the sheet by the sheet designer, or it will be "" (an empty string).
  
Note that at present you cannot reference auto-calculated values or sheet rolls from the character sheet using the auto-complete function (discussed in [[Macros]]) in custom macros on the abilities page or in the text chat. You can, however, reference all of them by typing them out manually (for example, <code>/roll 1d20+@{Character Name|STR-mod}</code> for a strength check using the Pathfinder character sheet). You can also create an ability that contains the macro or sheet roll(s) you wish to use, and then you can reference that ability with the auto-complete function. To find the specific name of a given auto-calculated field, read the specific notes about the character sheet you are using. Some sheets have tooltips telling you the name of the attribute, but this is at the discretion of the sheet author.
+
Note that at present you cannot reference [[Auto-Calc|auto-calculated]] values or sheet rolls from the character sheet using the auto-complete function (discussed in [[Macros]]) in custom macros on the abilities page or in the {{Text Chat}}. You can, however, reference all of them by typing them out manually (for example, <code>/roll 1d20+@{Alice|STR-mod}</code> for a strength check using the Pathfinder character sheet). You can also create an ability that contains the macro or sheet roll(s) you wish to use, and then you can reference that ability with the auto-complete function. To find the specific name of a given auto-calculated field, read the specific notes about the character sheet you are using. Some sheets have tooltips telling you the name of the attribute, but this is at the discretion of the sheet author.
  
'''Interaction with the API'''
 
  
Since all sheet fields are attributes, you can simply use the existing API methods for Attributes to read or update sheet values as needed. Note that if a sheet field has not been edited yet for a Character, that Character will not have an attribute for that field. So be sure to check for "undefined" Attributes when fetching values. Once a sheet has been edited for a Character, the Attribute is available to the API for reading. You can always write to the Attribute even if the sheet hasn't been edited yet by creating that Attribute yourself -- the sheet in-game will update accordingly.
+
==Roll Templates==
 +
{{main|Roll Templates}}
 +
 
 +
Roll Templates are a special facet of the Character Sheets system which can be added by the sheet author to provide additional layout and styling options for the display of roll results in the {{Text Chat}}
 +
 
 +
* [[D&D 5e by Roll20 Roll Templates]]
 +
* [[Pathfinder by Roll20/Roll Templates]]
 +
* [[:Category:Roll Templates]]
 +
 
 +
==API==
 +
{{pro only|section}}{{apiboxRec}}
 +
Since all sheet fields are attributes, you can simply use the existing [[API]] methods for Attributes to read or update sheet values as needed. Note that if a sheet field has not been edited yet for a Character, that Character will not have an attribute for that field. So be sure to check for "undefined" Attributes when fetching values. Once a sheet has been edited for a Character, the Attribute is available to the API for reading. You can always write to the Attribute even if the sheet hasn't been edited yet by creating that Attribute yourself -- the sheet in-game will update accordingly.
  
 
You can get the value of attributes via the following function call.  If the attribute has not been edited, it returns the default value, if it is an auto-calc value, it returns the auto-cal formula, not the calculated value.  Note that value_type appears to be optional.
 
You can get the value of attributes via the following function call.  If the attribute has not been edited, it returns the default value, if it is an auto-calc value, it returns the auto-cal formula, not the calculated value.  Note that value_type appears to be optional.
Line 91: Line 126:
 
<code>getAttrByName(character_id, attribute_name, value_type);</code>
 
<code>getAttrByName(character_id, attribute_name, value_type);</code>
  
'''Roll Templates'''
 
  
Roll Templates are a special facet of the Character Sheets system which can be added by the sheet author to provide additional layout and styling options for the display of roll results. See the '''[[Roll_Templates|Roll Templates]]''' wiki to learn more.
+
'''Character Sheet related APIs:'''
 +
* '''[[Script:ChatSetAttr|ChatSetAttr]]''' -- Create, modify, and delete character attributes via chat commands or macros. ChatSetAttr can be embedded into normal macros.
 +
* '''[[Script:Group_Initiative]]''' -- A way to quickly roll initiative for multiple characters
 +
* '''[[Script:GroupCheck]]''' -- A way to quickly roll a group check for everyone and see if they succeed
 +
* [[Script:CharSheet|CharSheet]] -- Allow players to create their own character sheets.
 +
* [[Script:Ammo|Ammo]] -- Provides inventory management for ammunition stored in an attribute of a character. Can be used with any char sheet
 +
* {{fpl|9888024/ PlayerCharacters}} -- Player & Character Manager. List all Player Characters divided by Player for the GM, or all assigned Characters for a Player. Add Characters for GM and Players.
 +
* {{fpl|6213379/ PublicSheet}} -- Creates a "public" version of character sheets that players can't edit, which mirrors the ''actual'' character sheet.
 +
* {{fpl|9934364/ Reporter}} -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
 +
* {{fpl|4742980/ Observer}} -- Manages observer players, who are given the visibility (and control) of all player characters. This is useful for both podcasting views and local play on a single player screen.
 +
* {{fpl|5281433/ Welcome Package}} -- API create and assigns character sheets to new people who join a game
 +
* See more: '''[[API:Script Index]]'''
  
'''Modifying a Community Sheet'''
+
==Modifying Community Sheet==
 +
{{pro only|section}}
 +
If you are interested in creating your own Character Sheet for a new game system, improving an existing sheet, or creating your own sheet that's fully customized for your individual play style, you can build your own custom character sheet .
 +
 
 +
Read More at '''[[Building Character Sheets]]''' & [[Use Custom Sheet]]
  
 
If you run a slightly modified version of a common game system (such as Pathfinder with your own homebrew rules), you may want to modify the existing sheet. To do so, you must be a '''Pro''' subscriber. If you are:
 
If you run a slightly modified version of a common game system (such as Pathfinder with your own homebrew rules), you may want to modify the existing sheet. To do so, you must be a '''Pro''' subscriber. If you are:
  
# Go to the Game Details => Game Settings page of your game (outside of the game). Make sure that the "Custom" option is selected under the Character Sheet Template section. You will see an editor with 3 tabs.
+
# Go to the [[Game_Management#Game_Details_Page|Game Details]] => [[Game Settings]] page of your game (outside of the game). Make sure that the "Custom" option is selected under the Character Sheet Template section. You will see an editor with 3 tabs.
# Go to the Github repository for the community sheets: [https://github.com/Roll20/roll20-character-sheets https://github.com/Roll20/roll20-character-sheets]
+
# Go to the {{repo|Roll20/roll20-character-sheets Github repository}} for the community sheets.
 
# Find the folder for the sheet you are using (e.g. "Pathfinder").
 
# Find the folder for the sheet you are using (e.g. "Pathfinder").
 
# There should be an HTML file and a CSS file in the folder. You can ignore any other files. Copy the contents of the HTML file and paste them into the HTML/Layout tab of the sheet editor for your game. Do the same for the CSS file and the CSS/Style tab.
 
# There should be an HTML file and a CSS file in the folder. You can ignore any other files. Copy the contents of the HTML file and paste them into the HTML/Layout tab of the sheet editor for your game. Do the same for the CSS file and the CSS/Style tab.
Line 106: Line 155:
 
# '''NOTE:''' If you decide to use a custom version of a community sheet, you will not receive future updates for the community sheet.
 
# '''NOTE:''' If you decide to use a custom version of a community sheet, you will not receive future updates for the community sheet.
  
==Character Sheet in a separate window==
+
 
 +
 
 +
=Character Sheet in a separate window=
 
[[File:Char-sheet-pop-out-button.png|thumb|Highlighted in red, the button to open a character in a separate window|right|300px]]
 
[[File:Char-sheet-pop-out-button.png|thumb|Highlighted in red, the button to open a character in a separate window|right|300px]]
It's possible to have the character sheet "popped out" in a separate browser window from Roll20, but while in this mode, a number of things does work quite as well as when it's viewed inside the VTT. The popping out feature is more of a convenience during play to keep the window uncluttered, but if you want to make lots of changes to the sheet, it's generally a good idea to not have it "popped out".
+
It's possible to have the character sheet "popped out" in a separate browser window from Roll20, but while in this mode, a number of things don't work quite as well as when it's viewed inside the VTT. The popping out feature is more of a convenience during play to keep the window uncluttered, but if you want to make lots of changes to the sheet, it's generally a good idea to not have it "popped out".
  
'''Things that doesn't work when sheet is in a separate window:'''
+
'''Things that don't work when sheet is in a separate window:'''
  
* '''Charactermancer doesn't work.''' - You might be open it, but the final step to finish building doesn't work.
+
* '''[[Charactermancer]] doesn't work.''' - You might be able to open it, but the final step to finish building doesn't work.
* '''Can't drag-n-drop''' - you can't drag-n-drop from the compendium to the sheet when it's in it's own window
+
* '''Can't [[drag-n-drop]]''' - drag-n-drop from the {{compendium}} to the sheet when it's in its own window is inconsistent, and doesn't work in all situations.
* '''Can't re-order things in repeating sections''' - You can check/uncheck the "lock" and delete entries, but not re-order them
+
* '''Can't re-order things in [[#Repeating Sections]]''' - You can check/uncheck the "lock" and delete entries, but not re-order them
* '''Edit "Bio & Info"-tab''' - when you press on the edit button, Roll20 opens the sheet inside the main Roll20 application on the "Bio & Info" page for the sheet
+
* '''Edit "[[Character#Bio_.26_Info_Tab|Bio & Info]]"-tab''' - when you press on the edit button, Roll20 opens the sheet inside the main Roll20 application on the "Bio & Info" page for the sheet
* '''Nothing in the "Attributes & Abilities"-tab can be re-ordered''' - you can add & delete Attributes and add Abilities, but not re-order them
+
* '''Nothing in the "[[Journal#Attributes_.26_Abilities_Tab|Attributes & Abilities]]"-tab can be re-ordered''' - you can add & delete Attributes and add Abilities, but not re-order them
 +
* '''The "Share with Players" button disappears.
  
 
[[File:Char-sheet-popped-out.png|thumb|Example of how the character sheet looks while in a separate window(Firefox 75/Linux Mint 19/April 14th 2020)|left|500px]]
 
[[File:Char-sheet-popped-out.png|thumb|Example of how the character sheet looks while in a separate window(Firefox 75/Linux Mint 19/April 14th 2020)|left|500px]]
<br>
+
<br clear=all>
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
<br>
+
==Building a Character Sheet==
+
{{pro only}}
+
If you are interested in creating your own Character Sheet for a new game system, improving an existing sheet, or creating your own sheet that's fully customized for your individual play style, you can build your own custom character sheet .
+
  
Read More at '''[[Building Character Sheets]]'''
+
=Community Sheets=
  
==Community Sheets==
+
There is a library of sheets contributed by the community that you can choose to use instead of creating your own from scratch. If you want to help improve those sheets or add a sheet for a new game, see the {{repo|Roll20/roll20-character-sheets Github repository}} and [[Beginner's Guide to GitHub]].
  
There is a library of sheets contributed by the community that you can choose to use instead of creating your own from scratch. If you want to help improve those sheets or add a sheet for a new game, see the [https://github.com/Roll20/roll20-character-sheets Github repository] and [[Beginner's Guide to GitHub]].
 
  
<div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;">
+
[[BCS|Editing & building character sheets]] require [[Pro]] subscription.
<big>''Welcome everyone! Roll20 is now maintaining official documentation, FAQs, and help articles on the [https://roll20.net/help Roll20 Help Center.] The Roll20 Wiki is now for Community documentation & tips only. Please be sure to visit for the most up-to-date information and assistance!''</big>
+
</div>
+
  
[[File:File:Roll20-overview-2020.png|framed|400px|right]]
+
You can request the community to create new sheets here: {{forum|10137951/character-sheet-requests-q3-2021 Character Sheet Requests Q3 2021}}
Welcome to the Roll20 Community Wiki! This Wiki is the central repository of information about Roll20, including the Roll20 Documentation, community-provided tips and tricks, guides for using Roll20 with your favorite tabletop game, and more!
+
  
As with everything Roll20-related, we rely on the community to help us create and maintain this information. So if you have some tips and tricks or other information to share, feel free to jump right in and contribute. [[Help:Contents|Check out our Wiki Help page for more info.]]
+
==Character Sheet Guides==
 +
Here is a list of some of the Guides for popular or well-documented character sheet. See also the '''[[:Category:Character Sheet Documentation|Full list of Character Sheet Guides]]'''<br />
  
=The Roll20 Virtual Tabletop=
+
* '''[[5E|D&D 5E]]'''
<div style="float: left; width: 45%; margin-right: 5%; margin-top: 20px;">
+
** '''[[D&D 5E by Roll20]]''' - The most used sheet on Roll20
==Getting Started==
+
** [[DnD5e Shaped Character Sheet|D&D 5E (Shaped)]] - The second-most popular D&D 5E sheet
* '''[[Tutorial|In-App Tutorial for GMs]]:''' Roll20 has a built-in tutorial straight in the app to familiarize new GMs to the Roll20 platform
+
** [[DnD5E Community Contributed | D&D 5E (Community Contributed)]]
* '''[[Introduction To Tabletop RPGs|Introduction to tRPGs]]:''' Never played a tabletop RPG before, but would like to know how? This video series should help bring a new gamer up to speed.
+
<br>
* '''[[Video and Voice Chat]]:''' How to get video and voice chatting set up in a Roll20 Game
+
* '''[[Pathfinder]]/Pazio'''
* '''[[Code of Conduct]]:''' The official Roll20 Code of Conduct expected on our site.
+
** [[Pathfinder_Second_Edition_Official|Pathfinder Second Edition by Roll20]]
* '''[[Forum Posting]]:''' A walkthrough on how navigate and post on our official [https://app.roll20.net/forum forums]
+
** [[Pathfinder_Official|Pathfinder (1E) by Roll20]]
* '''[[Keyboard Shortcuts|Keyboard Shortcuts Reference]]:''' Our list of keyboard shortcuts for experienced users
+
** [[Pathfinder_Character_Sheet|Pathfinder (1E) Community Sheet]]
* '''[https://roll20.zendesk.com/hc/en-us/articles/360037772613-Change-Log Changelog]:''' A list of all major revisions and updates to the Roll20 Platform
+
* '''[[Game Management]]''': How to create, organize, and manage your games
+
** '''[[Game Settings Page]]'''
+
 
<br>
 
<br>
  
==The User Interface==
+
'''[[:Category:Official Sheet|Official(by Roll20)]] sheets/[[:Category:Publisher Sheet|Publisher-made]] Sheets'''
[[File:Roll20 Interface.jpg|right|thumb|400px]] The Roll20 Interface is broken down into four sections:<br /><br />
+
'''1. The Tabletop:''' This is the largest portion of the playspace. This is where you set up your battle maps or board game play mats and where you'd place your tokens or meeples. You can also use it as a dry erase board.<br /><br />
+
'''2. The Tabletop Toolbox:''' This toolbar on the left side of the Tabletop lists the various tools used for moving art assets, drawing, writing, measurement, rolling, and other that affect or interact with the Tabletop in some fashion.<br /><br />
+
'''3. The Page Toolbar:''' When you click on the little tab on the top of the screen, this pulls down the Page Toolbar. This is where you can store multiple scenes (Pages) for the Tabletop and bounce players between them.<br /><br />
+
'''4. The Sidebar:''' Lastly is the Sidebar on the right side of the screen. This has multiple tabs that manage the in-game chat, music/audio, character sheets and handouts, and Roll20's settings.<br />
+
<div style="clear:both;"></div>
+
<div style="float: left; width: 45%; margin-right: 5%; margin-top: 20px;">
+
'''The Tabletop'''
+
* [[Tabletop Overview]]
+
* [[Aligning Maps]]
+
* [[Manipulating Graphics]]
+
* [[Token Features]]<br />
+
</div>
+
<div style="float: right; width: 45%; margin-left: 5%; margin-top: 20px;">
+
'''The Page Toolbar'''
+
* [[Page Toolbar|Page Toolbar Overview]]
+
* [[Page Settings]]
+
</div>
+
<div style="clear:both;"></div>
+
<div style="float: left; width: 45%; margin-right: 5%; margin-top: 20px;">
+
'''The Tabletop Toolbox'''
+
* [[Toolbox Overview]]
+
* [[Select and Pan Tool]]
+
* [[Layers]]
+
* [[Drawing Tools]]
+
* [[Fog of War]]
+
* [[Turn Tracker]]
+
* [[Dice Rolling GUI]]
+
</div>
+
<div style="float: right; width: 45%; margin-left: 5%; margin-top: 20px;">
+
'''The [[Sidebar]]'''
+
* [[Text Chat]]
+
* [[Art Library]]
+
* [[Journal]]
+
* [[Compendium]]
+
* [[Jukebox]]
+
* [[Collections]]
+
* [[My Settings]]
+
** [[Advanced Shortcuts|Advanced Keyboard Shortcuts]]
+
</div>
+
<div style="clear:both;"></div>
+
<br />
+
  
==Gameplay==
+
* [[Burn Bryte]]
<div style="float: left; width: 45%; margin-right: 5%; margin-top: 20px; margin-bottom: 20px;">
+
* [[Earthdawn - FASA Official V2]]
'''Rolling Dice'''
+
* [[Fate by Evil Hat]]
* [[How to Roll Dice]]
+
* [[Free Spacer]]
* [[3D Dice]]
+
* [[Official Savage Worlds]]
* [[Dice Reference]]
+
* [[Stargate|Stargate RPG]]
* [[Macros]]
+
<br>
* [[QuantumRoll]]
+
'''Other well-documented sheets:'''
* [[Playing Cards]]
+
<br>'''Tips'''
+
* [[Geomorphic Map Tiles]]
+
* [[Linking Tokens to Journals]]
+
* [[Useful Macros]]
+
* [[Using Roll20 while Playing In-Person]]
+
<br />
+
[[:Category:Tips|See all Tips and Tricks »]]
+
  
<br>'''Troubleshooting'''
+
* [[ADnD 2nd Edition Character sheet|AD&D 2E]]
* [[Solving Technical Issues]]
+
* [[ADnD 2nd Edition Character sheet Simplified| AD&D 2E (Simplified)]]
* [[Video and Voice Chat Troubleshooting]]
+
* [[Genesys]]
* [[Optimizing Roll20 Performance|Optimizing Roll20's Performance]]
+
* [[Heroes Unlimited 2E]]
* [[Customer Support FAQ]]
+
* [[Palladium Fantasy 1E]]
</div>
+
* [[Palladium Fantasy 2E]]
<div style="float: right; width: 45%; margin-left: 5%; margin-top: 20px; margin-bottom: 20px;">
+
* [[Star Wars D6 Sheet|Star Wars D6/WEG]]
'''System Guides'''
+
* [[|D&D|Dungeons and Dragons]] | [[5E]] | [[4E|Dungeons and Dragons 4th Edition]] | [[3.5E|Dungeons and Dragons 3.5]]  
+
* [[Pathfinder]]
+
* [[Shadowrun]]
+
* [[GURPS]]
+
* [[Savage_Worlds_Tabbed|Savage Worlds]]
+
* [[Star_Wars_WEG_D6_character_sheet|Star Wars D6]]
+
 
* [[Star_Wars_Saga_Edition_Character_Sheet|Star Wars Saga Edition]]
 
* [[Star_Wars_Saga_Edition_Character_Sheet|Star Wars Saga Edition]]
 
* [[Torg Eternity Community Sheet|Torg Eternity]]
 
* [[Torg Eternity Community Sheet|Torg Eternity]]
 
* [[Zweihänder Grim & Perilous]]
 
* [[Zweihänder Grim & Perilous]]
* [[Genesys]]
 
* [[Earthdawn - FASA Official]]
 
* [[OSR|OSR (Old School Revival)]]
 
* [[Cypher System-Monte Cooke Games|Cypher System]]
 
<br />
 
[[:Category:Games|See all System Specific Guides »]]
 
</div>
 
<div style="clear:both;"></div>
 
 
==Beyond the Application==
 
<div style="float: left; width: 45%; margin-right: 5%; margin-top: 20px;">
 
'''Your Games and Content'''
 
* [[Best Practices for Files on Roll20]]
 
<br>'''Finding A Group'''
 
* [[Looking for Group|Looking for Group Tool]]
 
* [[Player Directory]]
 
* [[Private Messaging]]
 
* [[Community and Safety features]]
 
</div>
 
<div style="float: right; width: 45%; margin-left: 5%; margin-top: 20px;">
 
'''Broadcasting your Games'''
 
* [[Online Role Playing:Index]]
 
* [[Live Stream and Record Game Sessions]]
 
<br>'''Site Policy'''
 
* [[Acknowledgements]]
 
* [[Terms of Service and Privacy Policy]]
 
* [[Terms_of_Service_and_Privacy_Policy#Notification_of_Copyright_Infringement_.28DMCA_Policy.29|DMCA]]
 
* [[Code of Conduct]]
 
* [[Marketplace Asset EULA]]
 
* [[Security]]
 
</div>
 
<div style="clear:both;"></div>
 
</div>
 
<div style="float: left; width: 45%; margin-top: 20px;">
 
<div style="background:#E8F5FF; border: 3px solid #07C; padding: 10px;">
 
 
==Subscriber Features==
 
'''[https://app.roll20.net/account/supporter Subscription Page]:''' A list of our subscription tiers, their perks, and how to upgrade your account. <br />
 
'''[[Subscription FAQ|Roll20 Plus & Pro Subscription FAQ]]'''
 
<div style="float: left; width: 45%; margin-right: 5%; margin-bottom: 20px;">
 
* [[Dynamic Lighting]]
 
* [[Advanced Fog of War]]
 
* [[Mobile Tablet Support]]
 
* [[Custom FX]]
 
* [[Roll20_Table_on_Tablet_Support|Table on Tablet]]
 
</div>
 
<div style="float: right; width: 45%; margin-left: 5%; margin-bottom: 20px;">
 
* [[Dev Server]]
 
* [[Transmogrifier]]
 
* [[My Vault|The Character Vault]]
 
</div>
 
<div style="clear:both;"></div>
 
===Custom Sheet Creation===
 
* [[Building Character Sheets]]: The How-To for making your own character sheets ''(for Pro Subscribers Only)''
 
** [[Sheet Worker Scripts]]: An advanced feature of the Character Sheets system which allows the sheet author to specify JavaScript which will execute during certain events, such as whenever the values on a sheet are modified.
 
** [[Roll Templates]]: These are a special facet of the Character Sheets system which provide additional layout and styling options for the display of roll results.
 
* [[Beginner%27s_Guide_to_GitHub|Beginner's Guide to GitHub]]: How to upload a character sheet for community use
 
* [[Character Sheet i18n]]: How to set up your Sheet to be easily translated into other languages
 
<br>
 
 
===Roll20 API Content===
 
A Pro Subscriber benefit, the Roll20 API allows users to write their own scripts which alters many of the default processes of Roll20.
 
<div style="float: left; width: 45%; margin-right: 5%; margin-bottom: 20px;">
 
'''Getting Started'''
 
*[[API:Introduction|API: An Introduction]]
 
*[[API:Use Guide| API: Use Guide]]
 
<br />'''API Reference'''
 
*[[API:Objects|Objects]]
 
*[[API:Events|Events]]
 
*[[API:Chat|Chat Events and Functions]]
 
*[[API:Utility Functions|Utility Functions]]
 
*[[API:Function documentation|Function documentation]]
 
*[[API:Sandbox Model|Sandbox Model]]
 
*[[API:Debugging|Debugging]]
 
*[[API:Cookbook|Cookbook]]
 
</div>
 
<div style="float: right; width: 45%; margin-left: 5%; margin-bottom: 20px;">
 
'''Cookbook (Examples)'''
 
*[[API:Basic Examples|Basic Examples]]
 
*[[API:Advanced Examples|Advanced Examples]]
 
*[https://app.roll20.net/forum/category/46806 API Scripts Forum]
 
<br />'''Community Scripts'''
 
*[[API:Script Index|Script Index]]
 
</div>
 
<div style="clear:both;"></div>
 
[[:Category:API|See all API Pages »]]
 
</div>
 
<br />
 
 
==Character Sheets==
 
This section explains how character sheets work within Roll20 as well as provide guides for some of the available community sheets.
 
* [[Character Sheets|Character Sheet Basics]]: How to add a character sheet to a campaign
 
* [[Charactermancer]]: How to use the guided character creation and leveling tool
 
* [[Character Sheet Index]]: This is a list of every sheet we currently have available on the Roll20 Character Sheet Database
 
* [[Building Character Sheets|Building Character Sheets]]: How to go about building a character sheet
 
** [[Sheet Worker Scripts|Adding Sheet Workers]]: How to add Javascript Sheet Workers for enhanced functionality
 
** [[Roll Templates|Adding Roll Templates]]: How to design Roll Templates to make your sheet output awesome
 
** [[Character Sheet i18n|Adding Multi-Language Support]]: How to setup your sheet for Internationalization
 
 
<br>
 
===Character Sheet Documentation===
 
<div style="float:left; width: 45%; margin-right: 5%; margin-top: 20px;">'''13th Age'''
 
* '''[[13th Age Official Sheet]]''*'''''
 
* [[13th Age Legacy Sheet]]
 
<br>
 
'''Dungeons & Dragons'''
 
* ''5th Edition''
 
** '''[[D&D 5E by Roll20]]''*'''''
 
** [[DnD5e Shaped Character Sheet|D&D 5E (Shaped)]]
 
** [[DnD5E Community ContributedD&D 5E (Community Contributed)]]
 
* ''4th Edition''
 
** [[DnD4e Character Sheet]]
 
<br>
 
'''Dungeon World'''
 
* '''[[Dungeon World Official|Dungeon World Official Sheet]]*'''
 
<br>
 
'''GUMSHOE'''
 
* '''[[GUMSHOE Official Sheet]]*'''
 
</div>
 
<div style="float: right; width: 45%; margin-left: 5%; margin-top: 20px;">
 
'''World of Darkness'''
 
* '''[[New World Of Darkness Official Sheet|Chronicles of Darkness Official Sheet]]''*'''''
 
'''Pathfinder'''
 
* '''[[Pathfinder Official | Pathfinder Official Sheet]]*'''
 
* '''[[Pathfinder Second Edition Official | Pathfinder Second Edition Official Sheet]]*'''
 
* [[Pathfinder Community Sheet | Pathfinder Community Sheet]]
 
<br>
 
'''Savage Worlds'''
 
* [[Savage Worlds Tabbed]]
 
<br>
 
'''Starfinder'''
 
* '''[[Starfinder Official]]*'''
 
<br>
 
'''Star Wars'''
 
* [[Star Wars WEG D6 character sheet|Star Wars D6]]
 
* [[SWRPG-API-Compatible|Star Wars FFG RPG]]
 
* [[Star Wars Saga Edition Character Sheet|Star Wars Saga Edition]]
 
* [[StarWars5E-Sheet]]
 
</div>
 
<div style= clear:both;></div>
 
<br>
 
''<nowiki>*</nowiki> Character Sheets designed and supported officially by Roll20''
 
<br>
 
<br>
 
[[:Category:Character Sheet Documentation|See all Character Sheet Guides &raquo;]]
 
<br />
 
<br />
 
 
==The Roll20 Marketplace==
 
===General Info===
 
* [[Marketplace Asset EULA]]
 
* [[How to Access Marketplace Content]]
 
<br>
 
===Guides for Content Creators===
 
* [[Creating Marketplace Assets]]
 
* [[Creating Marketplace Modules]]
 
<br>
 
===Modules===
 
====Wizards of the Coast====
 
* Lost Mine of Phandelver
 
* [[Storm King's Thunder]]
 
* [[Volo's Guide to Monsters]]
 
* [[Monster Manual]]
 
 
====Monte Cook Games====
 
* [[Cypher_System-Monte_Cooke_Games|The Strange: Rulebook & The Curious Case of Tom Mallard]]
 
* [[Cypher_System-Monte_Cooke_Games|The Strange: Dark Spiral]]
 
<br>
 
<br />
 
  
==This Wiki in Other Languages==
+
* '''{{hc|categories/360003712814-Roll20-Character-Sheets by Roll20 sheets}}''' - official documentation
[[Page d'accueil (Français)]] (French) »
+
  
===Related===
+
=Related Pages=
* [[Journal#Adding_Characters|Add Character Sheets In-Game]]
+
* {{Journal}}-tab - Other aspects of the character sheet
 +
* [[Character Vault]] - where you can import/export characters between games, saving the associated Bio, Avatar, and Token image + settings.
 +
* [[Adding Character Sheet]] - Guide for both adding individual characters to a game, and for adding specific Character Sheet Template to a campaign.
 +
* [[Tokens]]
 +
** '''[[Linking Tokens to Journals|Linking Tokens to Character sheets]]'''
 +
* [[Complete Guide to Macros & Rolls]]
 +
* [[Transmogrifier]] ({{Pro}}) - useful for moving characters between games in bulk
 
<br/>
 
<br/>
 
<br/>
 
<br/>
 
[[Category:Docs]]
 
[[Category:Docs]]
 +
[[Category:Character Sheets]]

Latest revision as of 15:34, 17 June 2024

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Character Sheet Tips & Tricks .

Main Page Journal, "Characters"-section

The D&D 5E by Roll20 Character Sheet, the most popular sheet used on Roll20

Character Sheets allow you to use a digital sheet that's similar to a traditional paper character sheet while playing your game in Roll20. The creator of a game can choose a character sheet template when setting up the game, and all characters in the game will use that sheet template.

The character sheet is an optional sub-section of the Character, along with the Bio- and Attributes&Abilites-tabs.

Contents

[edit] Choosing a Character Sheet Template

Depending on what game system you want to play, or even choosing between options available for some systems, you must decide what template, if any, to use in your game.

If you choose None, then all characters will only have a Bio & Attributes & Abilites-tabs, but no tab for "Character Sheet."

How a sheet without template looks like
The menu to choose Character Sheet Template

[edit] Starting a New Game

When starting a new game, you (as the game's Creator) have the option to choose the Character Sheet Template you want to use from the handy drop-down available on the New Game creation screen. The Sheet Template can be changed after game creation form the Game Settings-page. If you're making a Game that's a copy based on an existing Game, the copy will keep all relevant sheet template information to match the original. Finally, you need to click the (I'm Ready, Create Game) button to save.

[edit] For an Existing Game

To change or add Character Sheet, the Creator of the game should visit the Game Settings page. This page is accessed from the Settings dropdown on the Game Details page. Links to the Game Details pages of games that you belong to can be found on the My Games page.

In the Character Sheet Template section, select a template from the dropdown. Pro subscribers can also choose Custom, and then enter their own HTML/CSS/Translation code into the Sheet Editor. Finally, you need to click the (Save Changes) button found at the bottom of the screen.

Game Settings
The Add button in the Journal Tab

[edit] Add Individual Sheets In-Game

The Game's Creator (or anyone promoted to GM) can add individual character sheets in-game that can be assigned to people(players can't do so). You go to the N Journal-tab and click on the + Add button and select Character from the dropdown menu.

June 2023: GMs now have an option to make it possible for players to create their own character sheets, and it's off by default.

You can also add a character by right-clicking an existing folder in the N Journal-tab, and selecting Add Character from the Folder Options menu. Adding new Characters or Handouts using the right-click method places them directly into the right-clicked folder.

Regardless of how you create the Character entry, Roll20 will randomly generate a random name for the new Character.



[edit] Character Sheet Basics

Drag and drop sheet buttons to the macro quick bar.

If there is a character sheet template enabled for your game, there will be a new tab on when you open up a Character in your Journal labeled "Character Sheet". Clicking this tab will open the Character Sheet. The layout and look of your sheet, as well as what fields are available, will be determined by the template that the creator of the game has chosen.

The most basic way to interact with a sheet is simply by filling in values. You can type in text boxes, choose from drop-down menus, use checkboxes and radio buttons, etc. As you fill out the sheet, all of your changes are automatically saved.

Some fields may have default values already included. You can modify these values as needed for your particular Character. Some fields are also auto-calculating. As you fill out other parts of the sheet, those fields will auto-update to reflect their new values. You cannot modify those fields directly.


[edit] Sheet Rolls

Your sheet may also feature roll buttons. These are pre-defined rolls included with the sheet which allow you to quickly make attacks, roll checks, etc. These rolls will use the values that you have filled in on the sheet to function, so they're always up-to-date.

To acquire the contents of a sheet roll button:

  1. Click on the sheet roll button.
  2. Focus the q Text Chat's input box (by clicking into to it, or using the Advanced Shortcut C C). When it's focused, a blue outline appears around it.
  3. Press the (up arrow) key on your keyboard.
  4. The contents of the sheet roll button will then populate the Text Chat input box.


To acquire the Ability call corresponding to that sheet roll button, drag the sheet button down to the Macro Quick Bar, click on what you just dragged down, and then complete steps 2 to 4.

[edit] Drag and Drop Buttons

You can Drag & Drop sheet buttons to the macro quick bar. Buttons may be dragged directly off of the character sheet and placed onto the Macro Quick Bar at the bottom of the screen, simply by clicking and dragging the button into place. The buttons can be removed by dragging the button out of the quick bar into open space, the button will turn red and then vanish when the mouse is released. Please note, if you have the pop-out option enabled for the character sheets you must first disable it under your user settings (ycog icon) before the drag and drop function will work. You can then turn it back on after you arrange your macro buttons.

Example of an Initiative Roll that appears on the t Turn Tracker

To delete a button that was added to the macro bar, drag the button off the bar.

[edit] Initiative Rolls

For an Initiative roll to end up on the tTurn Tracker, a token must first be selected, otherwise the roll only appears in the q Text Chat.

The Initiative roll can be made from a character sheet, or reference stats from a sheet, but doesn't have to. See Dice Reference - Initiative, for more details.

[edit] Repeating Sections

Main Page: Repeating Section

[edit] Using

Example of deleting & reordering a repeating section on the D&D 5E by Roll20-sheet.


In addition to fields, your character sheet may feature one or more repeating section , where you can dynamically change a list by adding/reordering/removing entries to them.

How the Repeating sections buttons look may vary between character sheets for different systems, but this is how the buttons usually look:

  • Add: Click on the &-button in the bottom-left corner of the repeating section to add a new entry.
  • Modify: Click the ( "Modify/Lock"-button to enable deleting existing entries, or reorganizing them.
    • Reorder: Press and hold the -symbol of a specific row, and then drag it up- or downwards to change it's position. (left side)
    • Delete: Press the #-icon of of a specific row, to delete it. You get no warning, so it's deleted right away. (right side)
    • When you're done deleting/re-ordering things, click on the )(bottom right) to exit the edit mode for the rep section


For info on coding rep sections for character sheets, see: Character Sheet Development/Repeating Section

[edit] Link Token

Connecting Tokens to Character Sheets, 6min(Sep 2021)

Linking Token to a Character is a good idea to make character sheets quicker & easier to use. Only the GM can updates the Default Token of a character.

If a token is linked to a character sheet, you can open up the character sheet by pressing Shift & double-clicking the token.

[edit] Default Sheet Settings

Default Sheet Settings will determine default values & settings for any new character sheets added to the N Journal, which the GM can change from the Game Settings Page.


If you want to apply these settings to existing character sheets in the game, go to y My Settings in-game, and press the Apply Default Settings-button.

[edit] Advanced Usage

[edit] Attributes

Main Page: Character#Attributes

Interaction with Attributes

Sheets in Roll20 are a presentation layer for the Attributes system. This means that every field on the sheet is "backed" by a corresponding Attribute on the Character. For example, if there is a field called "Strength" on the sheet, there will also be an attribute called "Strength" in the Attributes & Abilities-tab. As you update the sheet, the attribute is updated, and vice versa. This also allows you to link the sheet to a token the same way you would link an Attribute to a token, via the "Represents" box on the Token Settings dialog.

[edit] Macros and Abilities

Main Page: Macro Guide

Interaction with Macros and Abilities

You can reference sheet values in your Macros and Abilities by referencing the corresponding Attribute. For example, @{Bob|strength} would use the strength attribute, which is also the strength field on the sheet (which would have name='attr_strength' in the sheet code). If the Sheet has a strength field which hasn't been edited yet by the player, then the result of the variable will be either the default value for the field specified on the sheet by the sheet designer, or it will be "" (an empty string).

Note that at present you cannot reference auto-calculated values or sheet rolls from the character sheet using the auto-complete function (discussed in Macros) in custom macros on the abilities page or in the q Text Chat. You can, however, reference all of them by typing them out manually (for example, /roll 1d20+@{Alice|STR-mod} for a strength check using the Pathfinder character sheet). You can also create an ability that contains the macro or sheet roll(s) you wish to use, and then you can reference that ability with the auto-complete function. To find the specific name of a given auto-calculated field, read the specific notes about the character sheet you are using. Some sheets have tooltips telling you the name of the attribute, but this is at the discretion of the sheet author.


[edit] Roll Templates

Main Page: Roll Templates

Roll Templates are a special facet of the Character Sheets system which can be added by the sheet author to provide additional layout and styling options for the display of roll results in the q Text Chat

[edit] API

Since all sheet fields are attributes, you can simply use the existing API methods for Attributes to read or update sheet values as needed. Note that if a sheet field has not been edited yet for a Character, that Character will not have an attribute for that field. So be sure to check for "undefined" Attributes when fetching values. Once a sheet has been edited for a Character, the Attribute is available to the API for reading. You can always write to the Attribute even if the sheet hasn't been edited yet by creating that Attribute yourself -- the sheet in-game will update accordingly.

You can get the value of attributes via the following function call. If the attribute has not been edited, it returns the default value, if it is an auto-calc value, it returns the auto-cal formula, not the calculated value. Note that value_type appears to be optional.

getAttrByName(character_id, attribute_name, value_type);


Character Sheet related APIs:

  • ChatSetAttr -- Create, modify, and delete character attributes via chat commands or macros. ChatSetAttr can be embedded into normal macros.
  • Script:Group_Initiative -- A way to quickly roll initiative for multiple characters
  • Script:GroupCheck -- A way to quickly roll a group check for everyone and see if they succeed
  • CharSheet -- Allow players to create their own character sheets.
  • Ammo -- Provides inventory management for ammunition stored in an attribute of a character. Can be used with any char sheet
  • PlayerCharacters(Forum) -- Player & Character Manager. List all Player Characters divided by Player for the GM, or all assigned Characters for a Player. Add Characters for GM and Players.
  • PublicSheet(Forum) -- Creates a "public" version of character sheets that players can't edit, which mirrors the actual character sheet.
  • Reporter(Forum) -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
  • Observer(Forum) -- Manages observer players, who are given the visibility (and control) of all player characters. This is useful for both podcasting views and local play on a single player screen.
  • Welcome Package(Forum) -- API create and assigns character sheets to new people who join a game
  • See more: API:Script Index

[edit] Modifying Community Sheet

If you are interested in creating your own Character Sheet for a new game system, improving an existing sheet, or creating your own sheet that's fully customized for your individual play style, you can build your own custom character sheet .

Read More at Building Character Sheets & Use Custom Sheet

If you run a slightly modified version of a common game system (such as Pathfinder with your own homebrew rules), you may want to modify the existing sheet. To do so, you must be a Pro subscriber. If you are:

  1. Go to the Game Details => Game Settings page of your game (outside of the game). Make sure that the "Custom" option is selected under the Character Sheet Template section. You will see an editor with 3 tabs.
  2. Go to the Github repository for the community sheets.
  3. Find the folder for the sheet you are using (e.g. "Pathfinder").
  4. There should be an HTML file and a CSS file in the folder. You can ignore any other files. Copy the contents of the HTML file and paste them into the HTML/Layout tab of the sheet editor for your game. Do the same for the CSS file and the CSS/Style tab.
  5. Make your modifications. Those modifications will only apply to this game, and they don't have to approved by anyone else. You can find more information about how to create new fields and other sheet tools on the Building Character Sheets page.
  6. NOTE: If you decide to use a custom version of a community sheet, you will not receive future updates for the community sheet.


[edit] Character Sheet in a separate window

Highlighted in red, the button to open a character in a separate window

It's possible to have the character sheet "popped out" in a separate browser window from Roll20, but while in this mode, a number of things don't work quite as well as when it's viewed inside the VTT. The popping out feature is more of a convenience during play to keep the window uncluttered, but if you want to make lots of changes to the sheet, it's generally a good idea to not have it "popped out".

Things that don't work when sheet is in a separate window:

  • Charactermancer doesn't work. - You might be able to open it, but the final step to finish building doesn't work.
  • Can't drag-n-drop - drag-n-drop from the i Compendium to the sheet when it's in its own window is inconsistent, and doesn't work in all situations.
  • Can't re-order things in #Repeating Sections - You can check/uncheck the "lock" and delete entries, but not re-order them
  • Edit "Bio & Info"-tab - when you press on the edit button, Roll20 opens the sheet inside the main Roll20 application on the "Bio & Info" page for the sheet
  • Nothing in the "Attributes & Abilities"-tab can be re-ordered - you can add & delete Attributes and add Abilities, but not re-order them
  • The "Share with Players" button disappears.
Example of how the character sheet looks while in a separate window(Firefox 75/Linux Mint 19/April 14th 2020)


[edit] Community Sheets

There is a library of sheets contributed by the community that you can choose to use instead of creating your own from scratch. If you want to help improve those sheets or add a sheet for a new game, see the Github repository and Beginner's Guide to GitHub.


Editing & building character sheets require Pro subscription.

You can request the community to create new sheets here: Character Sheet Requests Q3 2021(Forum)

[edit] Character Sheet Guides

Here is a list of some of the Guides for popular or well-documented character sheet. See also the Full list of Character Sheet Guides



Official(by Roll20) sheets/Publisher-made Sheets


Other well-documented sheets:

[edit] Related Pages