Revision as of 12:41, 9 June 2024

Page Updated:   2024-06-09

This is related to Editing(coding) Character Sheets, which require Pro info to be able to use. Main Page: Building Character Sheets

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

• 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

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

See Also

• Building_Character_Sheets#Restrictions - Documented restrictions on how code is to be written.
• Common Mistakes - Character Sheet Development
• Character Sheet Development/Updates - Changelog of recent bugfixes
• Bugs/Missing Feature Parity/Desired Features for Mods Aug 2022 thread by Aaron