View source for BetteR20 FAQ

{{BetteR20Header}}
__NOTOC__
__INDEX__

This document is a collection of most of the FAQs found within the specific feature's specific guidances, along with some overview documents. I would suggest using search [[File:Ctrl-key.png|framless|x24px|Control]] '''+''' [[File:Fkey.jpg|framless|x24px|F]] (Ctrl+F) to search for specific content.

<br/>
However; please be reminded that additional resources exist to give greater information; 
:* [[Better20 User Guide|'''BetteR20 User Guide''']] or [[R20es: User Guide|'''Roll20 Ehancement Suite (R20es / VTTes) User Guide''']]
:* [[BetteRoll20 Install|'''BetteR20 Installation Guide''']] or [[R20es Install Guide|'''R20es/VTTes Install Guide''']]
:* [[Feature: BetteR20|'''List of Features''']] (sortable by platform; feature subject)

<br/>
=BetteR20 FAQ=

===What is BetteR20?===
: See [[Better20 User Guide|'''Better20's User Guide''']]
: In brief, its not 5eTools, its a tampermonkey script that modifies Roll20 adding [[Feature: BetteR20|'''a number of useful features''']].

<br/>

===Is it a known issue that....?===
: That's an excellent question. Might I direct you to.... [[Template:KnownIssues BetteR20|'''BetteR20's Known Issues''']] Page?

<br>

[[File:TamperMonkey_Dashboard_Version_Check.PNG|300px|right]]
==='''How do I update the Script? How do I check what the current version of the script is?'''===
[[File:Check_for_User_Scriptupdates.PNG|left]]
*You can check what version you are using by going to [https://get.5etools.com/ get.5eTools.com] and checking the listed version number, and then check the version number of the script listed on TamperMonkey's Dashboard.


You can also check within Roll20, when you enter a game on Roll20, the system will respond with a loading... notification and then when loaded, the version. (and if you are out of date)


If so head over to the [[BetteRoll20 Install|'''installation guide''']] which walks you thru installation/updates

<br/>

===How do I turn off these===
[[File:R20ES DisplayCurrentLayerOnToken.png|frameless|400px]]
: That is a VTTes feature, and you'll want to check the [[R20es_FAQ | VTTes/R20es FAQ]].


<br/>

===How do I Install it?===
: For Better20 see [[BetteRoll20 Install|'''BetteR20 Installation Guide.''']] which will guide you through how to do that.
: For Roll20 Ehancement Suite (R20es/VTTes) [[R20es Install Guide|'''R20es/VTTes Installation Guide''' ]] see which will guide you through how to do that.
: If you used both previously and it is not seeming to work now (such as you now you cannot import monsters); chances are you need to [[Template:Support:UpdateScript| '''update the script''' ]].
<br/>

===What happened to Import by Category?===
: You likely installed Better20 core, and not BetteR20 5eTools. Core has no DnD 5e content; see [[BetteRoll20 Install|'''BetteR20 Installation Guide.''']] which will guide you through how to install that.
<br/>

===How do I use it?===
: Each of [[Feature: BetteR20|'''BetteR20's features''']] has a separate page on this wiki which will give specifics on how each works, what is required to use it, who can use, and how to troubleshoot, or frequently asked questions.
: In general you'll need to figure out what you want to do, and what feature(s) you can use to accomplish that.
: The most common of those are:
::: Importing content into your game
::: Trying to get Animated Backgrounds to work
::: Trying to get LibreAudio (how to include external audio files into playlists)

<br/>
==='''How do I Import _____________ ?'''===
: If you are trying in import content; it will depend upon who you are in the game...
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;>
<div style="font-weight:bold;line-height:1.6;">[[Feature: Import#DM|DM]]</div>
<div class="mw-collapsible-content">
----
::* [[Feature: Character Importer/Exporter|Character Importer/Exporter]] : 
::* Images : (Tokens; General Art)
::* Audio : (Files / Playlists)
::* Macros : 
::* Tables : 
::* Handouts : 
::: - Adventures/Modules :
::: - Backgrounds :
::: - Character :
::: - Class :
::: - Deck :
::: - Feats :
::: - Items :
::: - Objects :
::: - Optional Features :
::: - Psionics :
::: - Race :
::: - Spells :
::: - Items :
::: - Maps :
::: - Monsters : 
</div></div>

<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;>
<div style="font-weight:bold;line-height:1.6;">[[Feature: Import#Player|Player]]</div>
<div class="mw-collapsible-content">
----
::* Macros
::* Tokens
:: Temporary Import (via handouts)
::: - Backgrounds :
::: - Class :
::: - Deck :
::: - Feats :
::: - Items :
::: - Optional Features :
::: - Psionics :
::: - Race :
::: - Spells :
</div></div>

<br/>
===Why aren't my tokens keeping information? / Why don't players see them moving after I've modified a token?===
: There was an issue being reported that upon modifying a token through "Edit Token" the token appears to be modified for the DM but the player's do not see the change and the token freezes on their screen(s).
: If you suspect this is happening to you... Update.
<br>
:: If you don't / can't update you'll want to disable the script, make the changes you are looking for, then re-enable the script and have your players re-enter/refresh the game. (Obviously this isn't ideal, but you're out of date on the version so.... )

<br>

==='''How do I Report a Typo?'''===
:There are none. (Kidding.) You'd leave a comment below or visit the [[{{5eTCommunitylink}}|community discord]] and give the link to the typo; a screenshot of that, the text and its replacement in #typos-etc, and, thank you for helping make it even better!

<br/>
[[File:Roll20_Confirmation.png|right]]
==='''How do I know if the Script is working?'''===
:Enter into Roll20 into a game, and then wait for all the components to load. (the Roll20 Loading Screen has disappeared). You should see something like this.<br />

 betteR20-5etools {{Better20version}} 
 initialising, please wait...
 
 betteR20-5etools {{Better20version}}
 initialised.
 
 Need help? Join our [[{{5eTCommunitylink}}|Discord]].
 
 Please DO NOT post about this script or 
 any related content in official channels, 
 including the Roll20 forums.
 
 Before reporting a bug on the Roll20 forums,
 please disable the script and check if 
 the problem persists.

If you see that then try to use of the Features the script provides to confirm its working.

<br/>
==Why doesn't my [[Feature: Dynamic Lighting|Dynamic Lighting]]/[[Feature: Libre Audio|Libre Audio]]/[[Feature: Animated Background|Animated Background]]/[[Feature: Foreground|Foreground]]/[[Feature: Weather|Weather]] work for my player(s)?==
:Most likely, because your player(s) is not using BetteR20, or don't have it configured correctly.

<br/>
<br/>

===...Charactermancer...===

: You have a question about Charactermancer? Well, Charactermancer isn't supported.
: That means that if you use charactermancer, then all other issues that arise are on you.  Cannot get the character to export? Cannot get the character to Import? Cannot generate macros? etc etc...
: You are on your own in that.  Sorry, but the charactermancer was changing rapidly enough its better to not try to dev/fix for that feature's benefit.
: Does this mean BetteR20 and VTTes won't work if you use Charactermancer?? No, most often the scripts work. But if you Charactermancer and you've not tested to see if an issue you're having DOESN'T happen when you're NOT using charactermancer... you should.

==='''It's not working! or It's working poorly, What do I do to fix that?'''===
: Well, that's just not going to work.
: If you are looking for help you will need to get specific on what is, or is not working, and if it does or doesn't work with:
:*R20ES enabled w/ BetteR20, ;
:*just with R20ES running and no BetteR20, or
:*just Roll20 by itself it doesn't work.

: Then you'll need to determine....

: you know what, probably best if I just suggest you go to the troubleshooting pages for [[Troubleshooting_BetteR20|BetteR20/Roll20]] 

<br/>
==='''My Roll20 Session is hung''' - or - '''I get an "Uh uh" Message from R20ES and the features never show up.'''===
: please go [[BetteRoll20|'''HERE''' ]] and follow the installation guide, you most likely have something misconfigured.

<br/>
First, Confirm you not done the following

[[File:BetteR20_Loading.png|thumb|400px]]

'''DO NOT...'''

:Do not disable the VTTes extension, or do not fail to install the '''[https://ssstormy.github.io/roll20-enhancement-suite/ R20ES] '''('''VTT Enhancement Suite'''), (see installation notes above) before attempting to Load Roll20.
:If you do not do this, Roll20 will hang upon loading you ''MUST'' have the extension Installed and enabled, 
::*[https://chrome.google.com/webstore/detail/roll20-enhancement-suite/fadcomaehamhdhekodcpiglabcjkepff For Chrome ]
::*[https://addons.mozilla.org/en-US/firefox/addon/roll20-enhancement-suite/ For Firefox]
:if you do not have it installed you will hang on loading (see picture to the right), or get the error pictured below. 
:::[[File:R20es NotLoaded.png|frameless|x100px]]
<br/>
----
[[File:BetteR20_DUAL_install.png|thumb|400px]]

'''DO NOT...'''

: Do not have both '''BetteR20 Core '''& '''BetteR20 5eTools''' enabled at the same time. If you do... you'll hang on load and get an error.

<br /><br /><br /><br /><br /><br /><br /><br/>
----
[[File:R20 failedloadBetteR20.png|frameless|right|400px]]
[[File:R20Console NoCharacterSheet.png|frameless|right|400px]]


'''DO NOT...'''

: Do not fail to assign a character template in the game's '''Settings''' (on Roll20's website) under '''Settings''' -> '''Game Settings''' -> under '''Character Sheet Template''', if you do not,  you'll get an error in the console (and likely the Chat) saying Character Sheet is not defined.

<br /><br /><br /><br /><br /><br /><br /><br/><br/>
----
[[File:Roll20_no_API.png|thumb|400px]]

'''DO NOT...'''

:'''''DO NOT take put the ''RAW'' text of the script's code into Roll20's API Scripts as an'' '''''"untitled.js."''

::(''if that means nothing to you, don't worry. Its only possible to make this mistake if you have a Roll20 Pro level subscription.. and the tampermonkey script is ''not'' a Roll20 API Script)''

<br /><br /><br /><br /><br /><br /><br /><br />

{{FAQ ModuleImporterExporter}}
<br>

==='''I want to get my Online images from Roll20 so I can free up my disk quota'''===
: If you are familiar with [[Resources: Browser Scripts|'''browser scripts''']], you should look into [[Resources:_Browser_Scripts#Dump_my_Art_library_to_a_zip|'''this script''']].

<br/>
:If you are not...
<div class="toccolours mw-collapsible mw-collapsed" style="overflow:auto;>
<div style="font-weight:bold;line-height:1.6;">click expand -----> </div>
<div class="mw-collapsible-content">

 javascript:(function(){ var links=$('div.library_result').map(function(idx,block){ var $block=$(block), img = $block.find('img'), name = $block.find('div.yourtags li').map(function(i,o){return $(o).text();}).toArray().join('_'), ext = img.attr('src').match(/\b(?:thumb|max|original)\b\.(\w*)/)[1]; return $('<a style="border:1px solid #999;float:left;display:block;width:52px;height:52px;" href="'+img.attr('src').replace(/\b(?:thumb|max)\b/,'original')+'" download="'+name+'.'+ext+'"><img style="max-width:50px;max-height:50px;" src="'+img.attr('src')+'"></a>').click(function(){$(this).css('opacity',0.5);}); }).toArray(); $('').html(links).appendTo('body');}());''

# In Chrome, create a bookmark with the above code block as the URL.
# Go to the [https://marketplace.roll20.net/library/ Your Library] page.
# Scroll to the bottom of the page and keep scrolling until all of your images are loaded.
# Scroll back up to the top of the page.
# Select the bookmark you created in step 1. This will cause the execution of the included javascript which will build a block of image thumbnails at the top of the page.
# Click each image to cause it to be downloaded at its original resolution.<br /> 
</div></div>
''Please note: If you delete an image from your Image Library that you are currently using within a campaign, then it will be lost.  Its suggested that you first add to the external image library the desired image, and then replace each instance.''

<br/>

==='''Why won't this link work?'''===
: Presumably you're either speaking about an [[Feature: External Art tool|'''External Image''']], [[Feature: Animated Background|'''Animated Background''']], [[Feature: Libre Audio|Audio file]] / [[Feature: Jukebox Importer/Exporter|'''Playlist''']], or Custom JSON.
: You must use a [[Template:DirectFileAccess|'''direct file link''']], for more information click up the feature link for that feature's guidance and resources.

<br/>

==='''Macro toolbar/ Buttons have disappeared!'''===
: Check the [[Feature: Config Editor|'''Config Editor's''']] interface tab and make sure the [[Feature: Macro Horizontal Toolbar UI|Horizontal Toolbar UI Opacity]] is ''not'' set to 0.00.

<br/>
==='''My 3D Dice will not work/are not available?'''===
:The feature is hard-disabled while the script is active. This solves some of the performance issues around such.
:They are disabled, intentionally, with malicious glee (kidding) by the script.

<br/>
==='''How do I Report a Bug?'''===

:First, you're going to have to walk through basic Troubleshooting steps [[Troubleshooting_BetteR20|Roll20]]; confirm it is not a known issue. The guild will direct where QUALIFIED issues are reported. 

<br/>
==='''All I have is Cilantro, where can I find Corriander?'''===
:They are the same thing.

<br/>
==='''I have an idea I think would be AWESOME!'''===
: That's Great! Leave a comment below, or come to the [[{{5eTCommunitylink}}|'''community discord''']] '''#betteR20-suggestion''' - but, before you leave a suggestion, please see if its already in '''#suggestion-voting''', and perhaps vote for what you'd like to see happen next - as items with the most votes takes the next highest priority.
:: '''Updated: BetteR20 has moved into maintenance mode and while you are welcome to submit suggestions, the developer will be focused upon FoundryVTT's Plutonium, and the Website (5eTools)'''.

<br/>
----
{{FAQCRScaling}}

<br/>
----
{{FAQ ExternalArttool}}

<br/>
----
{{FAQ CharacterImporterExporter}}

<br/>
----
{{FAQ DeleteFolder+itscontent}}

<br/>
----
{{FAQWildFormBuilder}}

<br/>
----

{{FAQ BindDragnDrop}}

<br/>
----
{{KnownIssue CharacterTokenEditor}}

<br/>
----
{{KnownIssue JournalCleaner}}

<br/>
----
{{KnownIssue MacroHorizontalToolbarUI}}

<br/>
----
{{KnownIssuesAnimatedBackground}}

<br/>
----
{{KnownIssuesLibreAudio}}

<br/>
----
{{KnownIssuesTables}}

<br/>
----
{{FAQ Module ImporterExporter}}

<br/>
----
{{FAQ Import Player}}

<br>
----
{{FAQ ImportbyCategory}}

<br>
----
{{FAQ ImportbyCategory:Monster}}