Character Sheet Development/Bugs & Quirks
From Roll20 Wiki
Page Updated: 2023-12-24 |
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.
Character Sheet Development
Getting Started
- Using Custom Sheets
- Building Sheets
(Main Page) - Glossary
- Code Restrictions
- Best Practice
- Common Mistakes
- Tutorials
- Examples, Templates
- Pattern Libraries
- HTML & storing data
- CSS & Styling
General
- Updates & Changelog
- Known Bugs
- Character Sheet Enhancement(CSE)
- Custom Roll Parsing
- Legacy Sheet(LCS)
- (upcoming) Beacon SDK
Reference
- Buttons
- Repeating Sections
- Sheetworkers
- Roll Templates
- sheet.json
- Translation
- Auto-Calc
- Advanced
- All SheetDev Pages
Tools & Tips
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.
Contents |
Bugs
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"
- 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
- Ex.
- 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. CouldHTML Entities be used instead?
- language-dependent sheet changes doesn't seem to work. See #9053 for details. Summer 2021
- Sheet Sandbox & Translation key refresh issue -- May 2022
- you need to manually reload page if you use
getTranslationByKey()
and have uploaded newtranslation.json
in the sandbox -
getTranslationByKey()
throws athe 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 freshtranslation.json
- you need to manually reload page if you use
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
andsticky
. All other positions seems to render the button inoperable
- Work around: If you set the action button to have
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.
- odd behavior with default values December 2021
-
setAttrs
only updating the last value in a list in routine called withsetWithWorkers()
- 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
- 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 ofspan{ width: 150px;}
- ex.
- 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 and suggests to use
#
instead. eg/*######*/
- probably same cause Rolltemplate styling not registering? March 2022
- Chris D. may have uncovered strange behavior with CSS comments using multiple asterisk characters. eg
- 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
- To avoid having images behave differently on Rolltemplates, either manually encode your whitespaces to
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
tologo2.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