Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Character Sheet Development/Bugs & Quirks"

From Roll20 Wiki

Jump to: navigation, search
(LCS)
m
(34 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{main| Building Character Sheets}}
+
{{revdate}}{{BCS}}
 +
 
 +
 
 +
This page lists observed Bugs and odd quirks of the [[Character Sheet]]-system, especially those related to [[BCS|coding, editing & updating character sheets]].
 
{{NavSheetDoc}}
 
{{NavSheetDoc}}
 +
* See '''[[Character_Sheet_Development/Restrictions|Restrictions]]''' for quirks that aren't explicit bugs.
 +
* See '''[[Character_Sheet_Development/Feature_Updates|BCS/Updates]]''' for previously fixed bugs, of bugs that may have a fix under public testing on the [[Dev Server]]
  
Listing random quirks of the sheet system, especially those related to coding, editing & updating character sheets.
+
'''Note:''' The "Month Year" mention at end is a guaranteed last observation of the bug, or when it was documented.
 
+
'''Note:''' The "Month Year" mention at end is a guaranteed last observation of the bug.
+
  
 
=Bugs=
 
=Bugs=
 
  
 
==General==
 
==General==
 
Sheet code/editing bugs that doesn't fit other categories.
 
Sheet code/editing bugs that doesn't fit other categories.
  
* '''Using the word <code>eval</code> anywhere in the sheet code will stop everything from working.''' Roll20 have put is as a security measure to prevent eval to be used even in a roundabout way. You cant have attribute or class names that includes it.  
+
* '''GIFs doesn't load correctly on Roll Templates''' See [https://github.com/Roll20/roll20-character-sheets/issues/6166 issue #6166] April 2020
** this also prevent you from import google fonts that happen to have "eval" as part of the name
+
* '''using [[BCS#Dropdown_menu|optgroup]] in <code><nowiki><select></nowiki></code> doesn't work on custom sheets''', even though it works on existing sheets like [[Free Spacer]]
* '''using optgroups in select doesn't work on custom sheets''', even though it works on existing sheets like [[Free Spacer]]
+
 
** {{fpl|10017485/ discussion}} May 2021
 
** {{fpl|10017485/ discussion}} May 2021
 +
** workaround: [[CSS_Wizardry#Optgroup]]
 
* '''"Newly-dropped characters now must fully resolve before closing the window"'''
 
* '''"Newly-dropped characters now must fully resolve before closing the window"'''
 
** {{fpl|10066145/ rapport}} by [[Keith]] May 2021
 
** {{fpl|10066145/ rapport}} by [[Keith]] May 2021
 
** possibly fixed
 
** possibly fixed
* '''translation special character bug''' {{fpl|10111515 discussion}} May 2021
 
** avoid placing symbols & special characters in translations
 
 
* '''changing default value of attributes will change untouched values of existing sheet.''' May 2021
 
* '''changing default value of attributes will change untouched values of existing sheet.''' May 2021
 
** Ex. <code><input value="a"></code> to <code><input value="b"></code>
 
** Ex. <code><input value="a"></code> to <code><input value="b"></code>
 
** {{repo|Roll20/roll20-character-sheets/pull/8955 example of instance of this bug being reverted}}
 
** {{repo|Roll20/roll20-character-sheets/pull/8955 example of instance of this bug being reverted}}
 +
* {{fpl|10308595/ Unicode character in CSS "content" breaks roll templates}} [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 14:49, 12 August 2021 (UTC)
 +
* [https://app.roll20.net/forum/post/10576120/cant-appear-to-use-certain-emojis-in-a-character-sheet certain emojis & unicode characters are removed] from character sheets, so can't be reliably used. Use images instead. Dec 2021
 +
===[[i18n|Translation]]===
 +
* '''translation special character bug''' {{fpl|10111515 discussion}} 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 [https://github.com/Roll20/roll20-character-sheets/issues/9053 #9053] for details. Summer 2021
 +
* '''Sheet Sandbox & Translation key refresh issue''' -- May 2022
 +
** you need to manually reload page if you use {{c|getTranslationByKey()}} and have uploaded new {{c|translation.json}} in the sandbox
 +
** {{c|getTranslationByKey()}} throws a {{c|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 {{c|getTranslationByKey()}} is concerned is not updated when you use the sandbox widget to upload a fresh {{c|translation.json}}
 +
===[[Repeating Sections]]===
 +
* [https://app.roll20.net/forum/post/10721712/action-button-javascript-slash-sheetworker-does-not-work-when-placed-in-a-repeating-section-table 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 {{fpl|10676203/ bug discussion}} Feb 2022
 +
* [[Button]] name's containing an underscore e.g "attack_roll"  inside a [[Repeating Section|repeating section]], ARE NOT DETECTED by the <code>on("clicked:</code>- listener. {{fpl|7337736/ Vince -details}}
 +
* '''"Ghost Rows"''' in repeating sections when a dash '-' is used in the section name {{fpl|9643364 full description & reporduction steps}} - found by [[Peter B.]] Jan 2021
 +
* any regular attributes with {{code|_repeating}} in the attribute-name do not trigger API events. i.e. {{code|delete_repeating_rows}} will fail. {{fpl|10341225/ observation by Vince}} Aug 2021
 +
* Using {{code|<nowiki><table></nowiki>}} inside [[Repeating Sections]] might interfere with [[sheetworkers]]. Details: {{fpl|10631126 Button/Sheetworker not working}} ''(Jan 2022)''
  
==Sheetworkers==
+
===Sheetworkers===
 
Bugs in how [[sheetworkers]] function.
 
Bugs in how [[sheetworkers]] function.
  
 
[[Sheet_Worker_Scripts#JavaScript_Restrictions|JavaScript Restrictions]]
 
[[Sheet_Worker_Scripts#JavaScript_Restrictions|JavaScript Restrictions]]
  
* '''"Ghost Rows"''' in repeating sections when a dash '-' is used in the section name {{fpl|9643364 full description & reporduction steps}} - found by [[Peter B.]] Jan 2021
+
* [https://app.roll20.net/forum/permalink/10540011/ odd behavior with default values] December 2021
* '''a bug with the API using setWithWorker()''' {{fpl|10058777 discussion}} [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 09:00, 26 May 2021 (UTC)
+
* {{code|setAttrs}} only updating the last value in a list in routine called with <code>setWithWorkers()</code> - {{fpl|10440734/ thread}} Reported Oct. 2021
 
+
* {{fpl|10270267/ Sheet workers are now both case sensitive, and case-insensitive. (probably a bug)}} [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 15:34, 25 July 2021 (UTC)
  
 
==CSE==
 
==CSE==
 
Bugs related to [[CSE|Character Sheet Enhancement(CSE)]].
 
Bugs related to [[CSE|Character Sheet Enhancement(CSE)]].
  
* Roll template styling sometimes completely disappears and doesn't work when trying to convert from [[LCS]] to CSE. [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 12:57, 21 April 2021 (UTC)
+
* [[BCS/Roll Templates|Roll Template]]-styling sometimes completely disappears and doesn't work when trying to convert from [[LCS]] to CSE. [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 21 April 2021  
** {{fpl|10006227/ thread discussiong issues.}}
+
** {{fpl|10006227/ thread discussing issues.}}
 +
** https://app.roll20.net/forum/post/10618214/roll-template-broken-in-production-but-works-as-custom-sheet-or-in-a-sandbox Jan 2022
  
 
* '''[[Macro_Guide#HTML_replacement|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.
 
* '''[[Macro_Guide#HTML_replacement|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]]
 
** 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 <code>&amp;quot;</code> should be changed to <code>&amp;amp;quot;</code>.
 
** Workaround: since nested quotes and/or queries that include special characters may break in CSE-mode, try substituting the ampersand character as well. ie <code>&amp;quot;</code> should be changed to <code>&amp;amp;quot;</code>.
 +
** Roll20 have {{fpl|10260308/ under testing}} improvements to make html characters redundant
  
 
* in some cases, <code>.charsheet</code> needs to be added to the CSS classes, which previously worked fine with [[Legacy Sheet]]
 
* in some cases, <code>.charsheet</code> needs to be added to the CSS classes, which previously worked fine with [[Legacy Sheet]]
 
** '''ex.''' <code>.charsheet span{ width: 150px;}</code>, instead of <code>span{ width: 150px;}</code>
 
** '''ex.''' <code>.charsheet span{ width: 150px;}</code>, instead of <code>span{ width: 150px;}</code>
* Asterisks disappearing from CSS comments. {{fpl|10007462 examples & discussion}}
+
* Asterisks disappearing from CSS comments. {{fpl|10007462 examples & discussion}} April 2021
 
** [[Chris D.]] may have uncovered strange behavior with CSS comments using multiple asterisk characters. eg <code>/******/</code>
 
** [[Chris D.]] may have uncovered strange behavior with CSS comments using multiple asterisk characters. eg <code>/******/</code>
 
** [[Scott C.]] notes that this may be an older bug{{source|https://app.roll20.net/forum/permalink/10007760/}} and suggests to use <code>#</code> instead.  eg <code>/*######*/</code>  
 
** [[Scott C.]] notes that this may be an older bug{{source|https://app.roll20.net/forum/permalink/10007760/}} and suggests to use <code>#</code> instead.  eg <code>/*######*/</code>  
* detail & summary element styling is inconsistent between browsers/versions {{fpl|10029180/ details}}
+
** probably same cause [https://app.roll20.net/forum/permalink/10773374/ Rolltemplate styling not registering?] March 2022
 
+
* [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details details] & [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary summary]-element styling is inconsistent between browsers/versions {{fpl|10029180/ details}} April 2021
* '''fixed''' <strike>issues with @import</strike> {{fpl|10024551/ Release Note for April 27, 2021}}
+
* [https://app.roll20.net/forum/post/10749479/bug-rolltemplates-inconsistent-handling-of-image-urls-resulting-in-missing-images-on-rolltemplates Inconsistent handling of image URLs resulting in missing images on Rolltemplates]
** <strike>if a @import exists, it seems it might result in roll20 ignoring the first instance of the next css class in the file, workaround is to add an empty, "sacrificial" version of the class first that will be eaten up, and the one after will work normally </strike>
+
** To avoid having images behave differently on Rolltemplates, either manually encode your whitespaces to <code>%20</code>
 +
** Change your sheet folder to not have whitespaces at all to avoid this problem all together
  
==LCS==
+
==Legacy Sheet==
 
Bugs that only affect [[Legacy Sheet|Legacy Character Sheets(LCS)]].
 
Bugs that only affect [[Legacy Sheet|Legacy Character Sheets(LCS)]].
  
Line 64: Line 84:
 
* '''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. <code>logo.jpg</code> to <code>logo2.jpg</code>.
 
* '''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. <code>logo.jpg</code> to <code>logo2.jpg</code>.
 
** {{repo|Roll20/roll20-character-sheets/issues/8380 discussion on the bug}}
 
** {{repo|Roll20/roll20-character-sheets/issues/8380 discussion on the bug}}
** This minor bug have been observed occasionally since 2019(?) ([[User:1223200|1223200]] ([[User talk:1223200|talk]]) 15:39, 5 May 2021 (UTC))
+
** This minor bug have been observed occasionally since 2019(?) ([[User:1223200|1223200]] ([[User talk:1223200|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: [https://github.com/Roll20/roll20-character-sheets/issues/10367 #10367 The Between], [https://github.com/Roll20/roll20-character-sheets/issues/10188 #10188 Mutant Year Zero], [https://github.com/Roll20/roll20-character-sheets/issues/9948 #9948 Vast Grimm], [https://github.com/Roll20/roll20-character-sheets/pull/10419 PR #10419 - ADnD 2E Revised]]
 +
** [https://github.com/Roll20/roll20-character-sheets/pull/10419#issuecomment-1088006100 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 [[BCS/Updates#March_2|March 2021]] [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 10:06, 5 April 2022 (UTC)''
  
 
=See Also=
 
=See Also=
 
* [[Building_Character_Sheets#Restrictions]] - Documented restrictions on how code is to be written.
 
* [[Building_Character_Sheets#Restrictions]] - Documented restrictions on how code is to be written.
* [[Building_Character_Sheets#Common_Mistakes|Common_Mistakes]] - related to sheet coding
+
* [[Building_Character_Sheets#Common_Mistakes|Common Mistakes - Character Sheet Development]]
 +
* [[Character Sheet Development/Updates]] - Changelog of recent bugfixes
  
<br>
 
<br>
 
 
[[Category:Character Sheet Creation]]
 
[[Category:Character Sheet Creation]]

Revision as of 13:41, 26 May 2022


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.

Contents

Bugs

General

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

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

Sheetworkers

Bugs in how sheetworkers function.

JavaScript Restrictions

CSE

Bugs related to Character Sheet Enhancement(CSE).

  • 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 &quot; should be changed to &amp;quot;.
    • Roll20 have under testing(Forum) improvements to make html characters redundant

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)

Github

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

See Also