BetteRoll20 Install

From 5etools Community Wiki
Revision as of 14:26, 1 December 2019 by Modnar (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

framless
v1.16.11


Overview: The BetteR20 script works to modify the local session of Roll20's platform. While some of the script's abilities will seem to change Roll20, it more works as an interpreter changing what you see or it works behind the scenes taking actions as if you yourself had taken various steps. 



Getting Started/Checking your system

Are you on a Mobile, or a PC.

If on a PC

1️⃣ You must have either Chrome or Firefox as the browser.
You cannot use Waterfox, or Chrome for Opera, Internet Explorer, etc.
2️⃣ The Install must be the most current version of either.
3️⃣ Install TamperMonkey  (for Chrome / Firefox ) on your browser
4️⃣ Confirm it is installed (you may need to close all session of the browser and restart the browser)
5️⃣ Install R20ES
6️⃣ The Script(s)
Get5eToolscom.png
BetteR20 comes in two "flavors", Better20 core and Better20 5eTools which you get by going to Get.5e.Tools
  • Choose which of the scripts you'll be using
  • Core (General UI features - not specific to 5e games)
  • 5eTools (Which already includes core + a set of 5eTools specific features)
  • If you install both - ensure only one BetteR20 script is enabled. (You may install both. It's not suggested, and you may only have one active).
  • Click on either BetteR20 Core or BetteR20 5eTools at the Get.5e.Tools  site.(versions will likely be different on the live site)


If things are set up correctly, you should get a screen like this:
(for new installs)
thumb
(for attempting to update via file link after installation the script, unless modified, or prevented by the user, should automatically update)
Forced Update


In the tampermonkey dashboard you should see a listing for the for the script you've chosen with the enabled toggle next to as green (ie enabled)
  • Head over to Roll20 and test if its working properly. If it is you'll see a message like this in the chat window.
Example notification
NOTE: The Versions of TamperMonkey and the script may have udpated since the photo was taken, Tampermonkey will automatically update as new versions become available, currently BetteR20 requires manual updates.


Now is a great time to...Give Thanks.
IF your script is not working.....





What to do if your script will not update/install.

(All of the following assume that you've not modified the default Tampermonkey settings. To Make sure when you click on a link it works (in Chrome)

Go into Chrome -> More Tools -> Extensions, then in the Tampermonkey section -> Details and under Site Access, click "On All Sites".


1️⃣ Confirm you have the latest version of (non beta) tampermonkey

2️⃣ Confirm you have the lastest of either FF or Chrome browsers (all other browsers, waterfox, opera, etc etc are not supported)

3️⃣ Confirm you ..

have VTTes installed and enabled
are using only one instance of the Better20 script at a time. (delete others you are not using)
have not failed to assign a character sheet 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.


4️⃣ Go to https://get.5e.tools

does that work? (can you install the script? (see installation notes above)
if so. go no further, if not...

5️⃣Go to https://get.5e.Tools

does that work? (can you install the script? (see installation notes above)
if so. go no further, if not...

6️⃣ CTRL + F5

THIS IS THE STEP THAT MOST OFTEN RESOLVES THE ISSUE, READ IT COMPLETELY and CAREFULLY BEFORE ACTING UPON IT

7️⃣ copy this https://get.5e.tools/script/betteR20-5etools.user.js?v=

paste it to the address bar in your browser, type something random -ie an alphanumerical keyboard mash (example: `232qv5q3asdhiou9ajl34aadgaeae43avasdfasfak` or `Mrt00tsbutt5`) at the end of that address (after the ?v=) to cache bust the ISP/CDN's stored information. It should be long enough to think your mash is unique from the several thousand possible users before you (7 or more characters at least).
does that work? (can you install the script? (see notes above)
if so. go no further, if not...


8️⃣ Delete the script from tampermonkey's dashboard and try again from step 1 (ignoring this step on the second pass)

does that work? (can you install the script? (see notes above)
if so. go no further, if not try manually updating the script

Manually Updating the Script

This can be a bit technical for the unfamiliar. For this you will need a simple text editor. A simple text editor (such as Windows Notepad) will not offer to format text (no bold, italics, Colors, or even fonts).

🛆 If prompted to download the .js script, note the file name (often betteR20-<either core/5etools>-user.js, and then open it in a simple text editor

🛆 If the browser just shows the code.

Check to make sure Tampermonkey is installed, enabled and current.
If Chrome, make sure that in Chrome
> More Tools
> Extensions, then under
> Tampermonkey
> find the Details and under Site Access,
> click "On All Sites"
Copy the code presented to the browser into a simple text editor.

▶️Open Tampermonkey's Dashboard

right click tampermonkey,
choose dashboard

▶️Click the plus sign tab which will open the <New Userscript> Editor.

▶️Delete the prepopulated script code in the editor.

click in the text field and ctrl+A then delete, or
click at the beginning or end of the pre-populated text and hold down Del or Backspace until the text is erased.

Paste the code into tampermonkey's editor.

Click on and change <New Userscript> to betteR20- and then either core if using core, or 5etools if using the full tools.

Under File, -> Save



If that didn't work, you'll want to joing the Discord server and post in the #BetteR20 Issues channel that you've tried everything here, and please include the following phrase to denote that you have. Legend... wait for it ...ary





Now you may wish to familiarize yourself with:

Troubleshooting (***REVIEW ABOVE FIRST***)

Better20 Script's Features

VTT es Extension's Features

Roll20 (only better) FAQ