Character Sheets are a new feature in Roll20 which allow you to use a digital sheet that's similar to a traditional paper character sheet while playing your game. 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

Starting a New Campaign

When starting a new campaign, you can choose the Character Sheet you want to use from the handy drop-down available on the New Campaign creation screen. If you're making a Campaign that's a copy based on an existing Campaign, the copy will keep all relevant character sheet information to match the original.

For an Existing Campaign

To select a character sheet, the GM should navigate to Campaign Settings (My Campaigns > View Details > Campaign Settings). In the Character Sheet Template section, select a template from the dropdown. Mentors can also choose Custom to enter their own HTML and CSS.

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.

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 "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.

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 entires.

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.

Advanced Character Sheet Usage

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 Mentor-level subscriber. If you are:

1. Go to the Campaign Details => Campaign Settings page of your campaign (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: https://github.com/Roll20/roll20-character-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 campaign. Do the same for the CSS file and the CSS/Style tab.
5. Make your modifications. Those modifications will only apply to this campaign, 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 below under "Building a Sheet."

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. Mousing over the field in the Pathfinder sheet will give you the name. (I have not personally tested any other character sheets --Caelen (talk) 11:14, 10 July 2014 (EDT))

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);

Building a Character Sheet

Template:Mentors only

To build a sheet from scratch, choose the "Custom" option in the drop-down of your Campaign Settings page when choosing a character sheet template. You will be presented with an editor allowing you to build the sheet. The editor has three tabs: HTML/Layout, CSS/Styling, and Preview.

<input type="radio" name="attr_tab" class="sheet-tab sheet-tab1" value="1" checked="checked" />Character Sheet | Monster Sheet  <input type="radio" name="attr_tab" class="sheet-tab sheet-tab2" value="2"/>

   AC Surprised: <input type="text" name="attr_ACsurprise" class="sheet-short" />   

   <input type="radio" name="attr_tab2" class="sheet-tab sheet-tab1" value="1" checked="checked" />Basic Encumbrance

   <input type="radio" name="attr_tab2" class="sheet-tab sheet-tab2" value="2"/>Advanced Encumbrance

   <input type="radio" name="attr_tab3" class="sheet-tab sheet-tab2" value="2"/>Players Option

   <input type="number" name="attr_plat" class="sheet-nobut"> PP
   <input type="number" name="attr_gold" class="sheet-nobut"> GP
   <input type="number" name="attr_elec" class="sheet-nobut"> EP
   <input type="number" name="attr_silv" class="sheet-nobut"> SP
   <input type="number" name="attr_copp" class="sheet-nobut"> CP

   Total GP value from gems: <input type="text" name="attr_gemsvalue" class="short">
   
Total GP value from other items: <input type="text" name="attr_othervalue" class="short">

   Gems
<textarea name="attr_gems"></textarea>
   Other Items Of Value
<textarea name="attr_otherval"></textarea>

       <tr>
           <td><input type="text" name="attr_henchname"></td>
           <td><input type="text" name="attr_henchac" class="sheet-short"></td>
           <td><input type="text" name="attr_henchrace"></td>
           <td><input type="text" name="attr_henchlvl" class="sheet-short"></td>
           <td><input type="text" name="attr_henchatknum" class="sheet-short"></td>
           <td><input type="text" name="attr_henchthac" class="sheet-short"></td>
           <td><input type="text" name="attr_henchdmg" class="sheet-short"></td>
           <td><input type="number" name="attr_henchhp" class="sheet-tiny" value="@{HP}"/>/<input type="number" name="attr_henchhpmax" class="sheet-tiny" /></td>
           <td><input type="text" name="attr_henchnotes"></td>
   </tr>