This page lists observed Bugs and odd quirks of the Character Sheet-system, especially those related to coding, editing & updating character sheets.

Character Sheet Development
Getting Started

General

Reference

Tools & Tips

Git/GitHub

Other

See Restrictions for quirks that aren't explicit bugs.
See BCS/Updates for previously fixed bugs, of bugs that may have a fix under public testing on the Dev Server

Note: The "Month Year" mention at end is a guaranteed last observation of the bug, or when it was documented.

Bugs

Inline Styles Sanitization^(Forum) - Uploading new sheets to roll20 causes any inline CSS in the HTML to no longer work, and this isn't seen in Sheet Sandbox. - May 2024
- Roll20 is working on a fix^{May 22nd}

Jumpgate

issues with character sheets, both with the old system and the Beacon SDK comes and goes with Jumpgate being updated. Sometimes issues only occur in Jumpgate games, but in rare cases issues might have also affected non-jumpgate games.

Beacon

??

General

Sheet code/editing bugs that doesn't fit other categories.

GIFs doesn't load correctly on Roll Templates See issue #6166 April 2020
using optgroup in <select> doesn't work on custom sheets, even though it works on existing sheets like Free Spacer
- discussion^(Forum) May 2021
- workaround: CSS_Wizardry#Optgroup
"Newly-dropped characters now must fully resolve before closing the window"
- report^(Forum) by Keith May 2021
- possibly fixed
changing default value of attributes will change untouched values of existing sheet. May 2021
- Ex. <input value="a"> to <input value="b">
- example of instance of this bug being reverted
Unicode character in CSS "content" breaks roll templates^(Forum) Andreas J. (talk) 14:49, 12 August 2021 (UTC)
certain emojis & unicode characters are removed from character sheets, so can't be reliably used. Use images instead. Dec 2021

Translation

translation special character bug discussion^(Forum) May 2021
- avoid placing symbols & special characters in translations. Could HTML Entities be used instead?
language-dependent sheet changes doesn't seem to work. See #9053 for details. Summer 2021. Discussions of the bug:
- Language specific styling? July 2023
- CSS language specific styling (lang-undefined). Kludge. - June 2024
Sheet Sandbox & Translation key refresh issue -- May 2022
- you need to manually reload page if you use getTranslationByKey() and have uploaded new translation.json in the sandbox
- getTranslationByKey() throws a the key is not in the translation object error when the key is in the translation file, in the sandbox if you don't make the page reload.
- seems the translation object as far as getTranslationByKey() is concerned is not updated when you use the sandbox widget to upload a fresh translation.json

Repeating Sections

Action button (sheetworker) does not work when placed in a repeating section table March 2022 - found by Peter B.
position dissociating for action buttons in rep sections bug discussion^(Forum) Feb 2022
Button name's containing an underscore e.g "attack_roll" inside a repeating section, ARE NOT DETECTED by the on("clicked:- listener. Vince -details^(Forum)
"Ghost Rows" in repeating sections when a dash '-' is used in the section name full description & reporduction steps^(Forum) - found by Peter B. Jan 2021
any regular attributes with _repeating in the attribute-name do not trigger API events. i.e. delete_repeating_rows will fail. observation by Vince^(Forum) Aug 2021
Using <table> inside Repeating Sections might interfere with sheetworkers. Details: Button/Sheetworker not working^(Forum) (Jan 2022)
- Work around: If you set the action button to have position: relative; then action buttons work! These positions also work: absolute and sticky. All other positions seems to render the button inoperable

div.repcontainer:not(.editmode) div.repitem td button[type="action"],
div.repcontainer:not(.editmode) div.repitem th button[type="action"] {
    position: relative;
}

Sometimes Roll20 adds the repitembroken CSS class to repeating section row, which adds a red outline to the repeating item. The exact circumstances in which the repeating item is deemed broken are unclear:
- this forum post from the Roll20 team says this happens when a deleted row is re-created with the same RowID
- this forum post from Scott C. says this happens when creating new row and editing existing rows with a single setAttrs()
- this post says that it happens when two rows share the same RowID. When that happens, all interactions with the repeating section using that RowID will affect both rows, since they are essentially indistinguishable.
- It has also been observed when creating new, non-duplicated rows with custom RowID using setAttrs() in a new blank character, so there might be other circumstances that trigger this behavior

Sheetworkers

Bugs in how sheetworkers function.

JavaScript Restrictions

odd behavior with default values December 2021
setAttrs only updating the last value in a list in routine called with setWithWorkers() - thread^(Forum) Reported Oct. 2021
Sheet workers are now both case sensitive, and case-insensitive. (probably a bug)^(Forum) Andreas J. (talk) 15:34, 25 July 2021 (UTC)

CSE

Bugs related to Character Sheet Enhancement(CSE).

Roll Template-styling sometimes completely disappears and doesn't work when trying to convert from LCS to CSE. Andreas J. (talk) 21 April 2021
- problem with rolltemplate css June 2022
- https://app.roll20.net/forum/post/10618214/roll-template-broken-in-production-but-works-as-custom-sheet-or-in-a-sandbox Jan 2022
- thread discussing issues.^(Forum) April 2021

HTML replacement characters have been observed to sometimes be converted prematurely after the CSE update was made which can cause sheet roll macros to break.
- Only appears to happen in CSE-mode. reported by Ayethin & Vince
- Workaround: since nested quotes and/or queries that include special characters may break in CSE-mode, try substituting the ampersand character as well. ie " should be changed to &quot;.
- Roll20 have under testing^(Forum) improvements to make html characters redundant

in some cases, .charsheet needs to be added to the CSS classes, which previously worked fine with Legacy Sheet
- ex. .charsheet span{ width: 150px;}, instead of span{ width: 150px;}
Asterisks disappearing from CSS comments. examples & discussion^(Forum) April 2021
- Chris D. may have uncovered strange behavior with CSS comments using multiple asterisk characters. eg /******/
- Scott C. notes that this may be an older bug^[1] and suggests to use # instead. eg /*######*/
- probably same cause Rolltemplate styling not registering? March 2022
details & summary-element styling is inconsistent between browsers/versions details^(Forum) April 2021
Inconsistent handling of image URLs resulting in missing images on Rolltemplates
- To avoid having images behave differently on Rolltemplates, either manually encode your whitespaces to %20
- Change your sheet folder to not have whitespaces at all to avoid this problem all together

Legacy Sheet

Bugs that only affect Legacy Character Sheets(LCS).

In legacy mode, the number comparison functions stop working if the number you are comparing is below zero. mention June 2021^(Forum)

API

API/Mod changes to linked token bars do not trigger sheetworkers, however Mods can be modfified to detect if a linked bar has been changed and in turn, change the linked attribute. TokenMod has been updated to detect and change linked attributes in this manner.

Github

Bug affecting how sheets uploaded to the sheet repo work or function.

replacing sheet images on github doesn't always update on sheet to make sure images change on sheet when updating/replacing them, change their name/reference in the code, eg. logo.jpg to logo2.jpg.
- discussion on the bug
- This minor bug have been observed occasionally since 2019(?) (Andreas J. (talk) May 2021 )
Sometimes merged updates don't go live on Roll20 - have happened both to updates of existing sheets, as well as new sheets not appearing in the sheet menu even if merged & .yaml was updated. (First case Q4 2021 or earlier)
- past instances: Github Issues: #10367 The Between, #10188 Mutant Year Zero, #9948 Vast Grimm, PR #10419 - ADnD 2E Revised]
- renaming files & folders on github might have higher risk of causing this
- Suspicion: it's a bug in roll20's sheet update services that was introduced in March 2021 Andreas J. (talk) 10:06, 5 April 2022 (UTC)