BetteR20 FAQ

From 5etools Community Wiki
Jump to: navigation, search


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 ctrl + F to search for specific content.

However; please be reminded that additional resources exist to give greater information;

BetteR20 FAQ

What is BetteR20?

See Better20's User Guide
In brief, its not 5eTools, its a tampermonkey script that modifies Roll20 adding a number of useful features.

How do I Install it?

For Better20 see BetteR20 Installation Guide. which will guide you through how to do that.
For Roll20 Ehancement Suite (R20es/VTTes) R20es/VTTes Installation Guide see which will guide you through how to do that.

How do I use it?

Each of 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)

How do I Import _____________ ?

If you are trying in import content; it will depend upon who you are in the game...

- Adventures/Modules :
- Backgrounds :
- Character :
- Class :
- Deck :
- Feats :
- Items :
- Objects :
- Optional Features :
- Psionics :
- Race :
- Spells :
- Items :
- Maps :
- Monsters :

  • Macros
  • Tokens
Temporary Import (via handouts)
- Backgrounds :
- Class :
- Deck :
- Feats :
- Items :
- Optional Features :
- Psionics :
- Race :
- Spells :

How do I Report a Typo?

There are none. (Kidding.) You'd leave a comment below or visit the [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!

Roll20 Confirmation.png

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.
betteR20-5etools v1.16.16 
initialising, please wait...

betteR20-5etools v1.16.16

Need help? Join our [[1]].

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.

Why doesn't my Dynamic Lighting/Libre Audio/Animated Background/Foreground/Weather work for my player(s)?

Most likely, because your player(s) is not using BetteR20, or don't have it configured correctly.

It's not working! or Its 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 BetteR20/Roll20

My Roll20 Session is hung - or - I get an "Uh uh" Message from R20ES and the features never show up.

please go HERE and follow the installation guide, you most likely have something misconfigured.

How do I update the Script? How do I check what the current version of the script is?

By default, the script automatically updates when the browser loads.

  • TamperMonkey Dashboard Version Check.PNG
    You can check what version you are using by going to and checking the listed version number and then checking the version number of the script listed on TamperMonkey's Dashboard.
Check for User Scriptupdates.PNG

You may manually update the script by:

  • Selecting to [Check for userscript updates] from TamperMonkey's menu.
  • Clicking 

You may have to restart the browser to get TamperMonkey to register the update

If that doesn't work, head over to the installation guide which walks you thru installation/updates

Template:FAQ B20ExternalArt

I've lost all the images in my External Art Library!

Search the Journal for the betteR20-art handout file. If it's not there, or empty you have to recreate it. It's a good idea to save the contents of that file into a local text file or online file so that should you want to make a new game or if you experience such a problem you can recover from such quickly.

My players are not seeing my image(s)!

You've likely found a source that their ISP is blocking or that they don't have the rights to view. See [
You get a copy of the image and upload it to an image hosting service like imgur .

OR. leave a message below or in the community and we'll see if it can be added to the Art Repo 

How do I get rid of these labels on my tokens?

Take a look at the Draw token Layer on Tokens feature; and then visit the R20ES Config to disable it through such.

I want to get my Online images from Roll20 so I can free up my disk quota

If you are familiar with browser scripts, you should look into this script.

If you are not...
click expand ----->
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');}());
  1.  In Chrome, create a bookmark with the above code block as the URL.
  2.  Go to the Your Library page.
  3.  Scroll to the bottom of the page and keep scrolling until all of your images are loaded.
  4.  Scroll back up to the top of the page.
  5.  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.
  6.  Click each image to cause it to be downloaded at its original resolution.

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.

Why won't this link work?

Presumably you're either speaking about an External Image, Animated Background, Audio file / Playlist, or Custom JSON.
You must use a direct file link, for more information click up the feature link for that feature's guidance and resources.

Macro toolbar/ Buttons have disappeared!

Check the Config Editor's interface tab and make sure the Horizontal Toolbar UI Opacity is not set to 0.00.

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.

How do I Report a Bug?

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

All I have is Cilantro, where can I find Corriander?

They are the same thing.

I have an idea I think would be AWESOME!

That's Great! Leave a comment below, or come to the [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).

I deleted all the content of my folder by accident, how do I get it back!?

You have deleted a folder with content that you wish to keep, and now you cannot find it.
Work Around:
You may see about recovering the game from a previous save state, be aware that will overwrite ANYTHING you've done since that backup date.
Otherwise. But, in general, You don't. It's gone.

Players can define sight

Players are able to modify their token's light/vision settings, giving themselves darkvision or better vision than they should have potentially.
Work Around:
This is as designed. If your players modify their visual settings/light emitting, their field of vision will change on the map. Monitor such and maek sure they are not cheating and address such directly.

Files are not Showing

If you have just restored (un-archived) or added several journal entries (characters/handouts) it may not list those within the tool.
Work Around: to bypass this, make a new folder and pull one of the journal entries that didn't show into the folder.
Restart the Journal Cleaner, the entries should now be listed.
REASON: Documents that are archived are always there, just not shown. Moving them around while Unarchived forces the tool to see them - more so if they move into a folder, which archived journal entries can do.
You may also restart the session to reload the journal.

My Drawing Tools/Character Macros are gone!

The Macro Horizontal Toolbar UI element includes the buttons from Character Sheet macros and details for the Vertical tool bar UI element (such as drawing). If you have to delete your configuration file if it becomes corrupt, and even on some upgrades for BetteR20, the stored value for this drops to 0, which means those elements appear to "gone", until you mouse over their area. When you mouse over the area, the UI element appears. What causes the corruption/loss of that configuration is unknown, however; see the workaround for a solution for such.
Work Around:
If you lose sight of the Macro toolbar, check the Config Editor's interface tab and make sure it's not set to 0.00.

Using Dynamic lighting + AFOW + Animated backgrounds leads to unexpected results Libre audio tracks might not play for users who join the session as the track is playing.


Stop the track and have people who cannot hear it reload the page. Once they have loaded back in, start the track.

Table does not trigger Dice Roller
Tables will have what appears to be a viable mathematical header column, but clicking upon the column does not generate a result inside the Dice Roller window.
This is because the Table presentation automatically reviews the first column's header for specific information (a dice roller compatible formatted entry (ie. d20, d100 or the like), or must be specifically told how to respond by the person who made the table entry for the website in their homebrew addition, or the requested command is too complicated for the Dice Roller to understand as it may include a request for information (in the example picture + level which the roller has no way of knowing.
Table nonrollable.png
Work Around :
The DM must calculate the results manually and then determine what the resulting value would be for the players. [open the Dice Roller, and generate a result and then modify the result by the required factor(s) - in the example table (see image) you would enter d100 into the dice roller and then add the character level (which the site has no way to know)].
The topic is covered in greater depth in Homebrewing tables