Difference between revisions of "Character Sheets"
From Roll20 Wiki
m |
Andreas J. (Talk | contribs) m (→Related Pages) |
||
(160 intermediate revisions by 41 users not shown) | |||
Line 1: | Line 1: | ||
− | + | <div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;"> | |
+ | <big>'''''Attention:''''' | ||
+ | ''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/360037773373-Character-Sheet-Tips-and-Tricks Here].''</big> | ||
+ | </div> | ||
+ | ''Main Page'' '''[[Journal#Characters|Journal, "Characters"-section]]''' | ||
+ | [[File:5E OGL Sheet Core v2.6.png|400px|thumbnail|right|'''[[D&D 5E by Roll20]]''' Character Sheet]] | ||
+ | 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. | ||
+ | =Choosing a Character Sheet= | ||
+ | '''[[File:Cs.png|300px|right]]''' | ||
− | + | ==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. | ||
− | == | + | ==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. | |
− | + | 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. | |
− | [[File: | + | [[File:Cs1.png|thumb|400px|Game Settings|left]] |
− | 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 "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. | + | <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.}} | ||
+ | |||
+ | <div style='clear: both;'></div> | ||
+ | |||
+ | [[File:Journal1.0.jpg|thumb|The Add button in the Journal Tab|right|400px]] | ||
+ | |||
+ | ==Add Individual Sheets In-Game== | ||
+ | The Gamemaster (or anyone promoted to GM) can 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. | ||
+ | |||
+ | Regardless of how you create the Character entry, Roll20 will randomly generate a placeholder for the Character entry's Name. | ||
+ | |||
+ | <br> | ||
+ | <br> | ||
+ | |||
+ | =Character Sheet Basics= | ||
+ | |||
+ | [[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. | ||
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. | 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. | ||
Line 21: | Line 52: | ||
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. | ||
− | 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 " | + | {{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> | ||
+ | <br> | ||
+ | <br> | ||
+ | == Repeating Sections == | ||
+ | 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 <span style="font-family:Pictos;">&</span> button beneath the section to add a new entry. | ||
− | + | You can click the <span style="font-family:Pictos;">(</span> "Modify/Lock"-button to enable deleting existing entries, or reorganizing them. | |
− | == | + | {{Ambox |
+ | |nocat=true | ||
+ | | type = content | ||
+ | | text = Some of the features of '''Repeating Sections''' do not work when the [[Character_Sheets#Character_Sheet_in_a_separate_window|Character Sheet is in a separate window]]. | ||
+ | }} | ||
+ | == 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. | ||
− | ''Interaction with Attributes'' | + | To acquire the contents of a sheet roll button: |
+ | # Click on the sheet roll button. | ||
+ | # 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]] <code>c c</code>). When it's focused, a blue outline appears around it. | ||
+ | # Press the up arrow key on your keyboard. | ||
+ | # The contents of the sheet roll button will then populate the text chat input box. | ||
+ | <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. | ||
+ | |||
+ | === 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. | ||
+ | [[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 simply drag the button off the bar. | ||
+ | |||
+ | === Initiative Rolls === | ||
+ | For an Initiative roll to end up on the [[Turn_Tracker#Character_Sheet|Turn Tracker]], a [[Token|token]] '''must''' first be selected, otherwise the roll only appears in the {{Text Chat}}. | ||
+ | |||
+ | The Initiative roll can be made from a character sheet or use stats from one, but doesn't have to. See [[Dice Reference#Roll To Initiative]] for details on initiative rolls. | ||
+ | |||
+ | See also [[Linking Tokens to Journals|Linking Tokens to Characters]]. | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | =Advanced Character Sheet Usage= | ||
+ | |||
+ | '''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 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. | ||
− | ''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>@{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). | ||
− | ''Interaction with the API'' | + | 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. |
+ | |||
+ | '''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. | 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. | ||
+ | |||
+ | <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. | ||
+ | |||
+ | '''Modifying a Community 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: | ||
+ | |||
+ | # 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 Github repository for the community sheets: [https://github.com/Roll20/roll20-character-sheets https://github.com/Roll20/roll20-character-sheets] | ||
+ | # 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. | ||
+ | # 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. | ||
+ | # '''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= | ||
+ | [[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 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''' - you can't drag-n-drop from the compendium to the sheet when it's in its own window | ||
+ | * '''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 | ||
+ | |||
+ | [[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> | ||
+ | <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= | ||
+ | |||
+ | 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]]. | ||
+ | |||
+ | ==Character Sheet Guides== | ||
+ | Here is a list of some of the Guides for popular or well-documented character sheet. See also: '''[[:Category:Character Sheet Documentation|Full list of Character Sheet Guides]]'''<br /> | ||
+ | [[:Category:Character Sheet Documentation|Full list of Character Sheet Guides]] | ||
+ | |||
+ | * '''[[5E|D&D 5E]]''' | ||
+ | ** [[D&D 5E by Roll20]] - The most used sheet on Roll20 | ||
+ | ** [[DnD5e Shaped Character Sheet|D&D 5E (Shaped)]] - The second-most popular D&D 5E sheet | ||
+ | ** [[DnD5E Community Contributed | D&D 5E (Community Contributed)]] | ||
+ | <br> | ||
+ | * '''[[Pathfinder]]/Pazio''' | ||
+ | ** [[Pathfinder_Second_Edition_Official|Pathfinder Second Edition by Roll20]] | ||
+ | ** [[Pathfinder_Official|Pathfinder (1E) by Roll20]] | ||
+ | ** [[Pathfinder_Character_Sheet|Pathfinder (1E) Community Sheet]] | ||
+ | <br> | ||
+ | |||
+ | '''Other Official/Publisher-made Sheets''' | ||
+ | |||
+ | * [[Burn Bryte]] | ||
+ | * [[Earthdawn - FASA Official]] | ||
+ | * [[Fate by Evil Hat]] | ||
+ | * [[Free Spacer]] | ||
+ | * [[Official Savage Worlds]] | ||
+ | * [[Stargate|Stargate RPG]] | ||
+ | |||
+ | '''Other well-documented sheets:''' | ||
+ | |||
+ | * [[ADnD 2nd Edition Character sheet|AD&D 2E]] | ||
+ | * [[ADnD 2nd Edition Character sheet Simplified| AD&D 2E (Simplified)]] | ||
+ | * [[Genesys]] | ||
+ | * [[Heroes Unlimited 2E]] | ||
+ | * [[Palladium Fantasy 1E]] | ||
+ | * [[Palladium Fantasy 2E]] | ||
+ | * [[Star_Wars_WEG_D6_character_sheet|Star Wars D6/WEG]] | ||
+ | * [[Star_Wars_Saga_Edition_Character_Sheet|Star Wars Saga Edition]] | ||
+ | * [[Torg Eternity Community Sheet|Torg Eternity]] | ||
+ | * [[Zweihänder Grim & Perilous]] | ||
+ | |||
+ | =Related Pages= | ||
+ | * {{Journal}}-tab - Other aspects of the character sheet | ||
+ | * [[Character Vault]] - Where you can save character from one game and then export it to another game | ||
+ | * [[Adding Character Sheet]] - Guide for both adding individual characters to a game, and for adding a Character Sheet Template to it. | ||
+ | * [[Tokens]] | ||
+ | ** [[Linking Tokens to Journals|Linking Tokens to Characters]] | ||
+ | * [[Complete Guide to Macros & Rolls]] | ||
+ | <br/> | ||
+ | <br/> | ||
+ | [[Category:Docs]] |
Revision as of 15:29, 26 September 2020
Attention: 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: Here.
Main Page Journal, "Characters"-section
![](/images/f/f0/5E_OGL_Sheet_Core_v2.6.png)
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.
Contents |
Choosing a Character Sheet
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.
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 to enter their own HTML and CSS. Finally, you need to click the (Save Changes) button found at the bottom of the screen.
![]() | 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. |
Add Individual Sheets In-Game
The Gamemaster (or anyone promoted to GM) can add individual character sheets in-game that can be assigned to people. You go to the 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 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 placeholder for the Character entry's Name.
Character Sheet Basics
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.
![]() | 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. |
Repeating Sections
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 & button beneath the section to add a new entry.
You can click the ( "Modify/Lock"-button to enable deleting existing entries, or reorganizing them.
![]() | Some of the features of Repeating Sections do not work when the Character Sheet is in a separate window. |
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:
- Click on the sheet roll button.
- 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. - Press the up arrow key on your keyboard.
- 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.
Drag and Drop Buttons
You can drag and 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 (cog icon) before the drag and drop function will work. You can then turn it back on after you arrange your macro buttons.
![](/images/b/bb/Turn-Tracker-Init-from-sheet.gif)
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 Turn 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 use stats from one, but doesn't have to. See Dice Reference#Roll To Initiative for details on initiative rolls.
See also Linking Tokens to Characters.
Advanced Character Sheet Usage
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.
Interaction with Macros and Abilities
You can reference sheet values in your Macros and Abilities by referencing the corresponding Attribute. For example, @{Character Name|Strength}
would use the "Strength" attribute, which is also the "Strength" field on the sheet (which would have name='attr_Strength'
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).
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, /roll 1d20+@{Character Name|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.
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.
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);
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 wiki to learn more.
Modifying a Community 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:
- 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 Github repository for the community sheets: https://github.com/Roll20/roll20-character-sheets
- 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.
- 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.
- 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
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 - you can't drag-n-drop from the compendium to the sheet when it's in its own window
- 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
Building a Character Sheet
This is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account. |
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
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.
Character Sheet Guides
Here is a list of some of the Guides for popular or well-documented character sheet. See also: Full list of Character Sheet Guides
Full list of Character Sheet Guides
- D&D 5E
- D&D 5E by Roll20 - The most used sheet on Roll20
- D&D 5E (Shaped) - The second-most popular D&D 5E sheet
- D&D 5E (Community Contributed)
- Pathfinder/Pazio
Other Official/Publisher-made Sheets
- Burn Bryte
- Earthdawn - FASA Official
- Fate by Evil Hat
- Free Spacer
- Official Savage Worlds
- Stargate RPG
Other well-documented sheets:
- AD&D 2E
- AD&D 2E (Simplified)
- Genesys
- Heroes Unlimited 2E
- Palladium Fantasy 1E
- Palladium Fantasy 2E
- Star Wars D6/WEG
- Star Wars Saga Edition
- Torg Eternity
- Zweihänder Grim & Perilous
Related Pages
- N Journal-tab - Other aspects of the character sheet
- Character Vault - Where you can save character from one game and then export it to another game
- Adding Character Sheet - Guide for both adding individual characters to a game, and for adding a Character Sheet Template to it.
- Tokens
- Complete Guide to Macros & Rolls