R20es: User Guide

From 5etools Community Wiki
Jump to: navigation, search
R20esLOGO.png

VTTes/R20es v1.15.15

PLEASE NOTE: Roll20 Enhancement Suite (aka VTT es/ R20es), is not part of BetteR20 or 5eTools. However; as BetteR20 requires VTT es/R20es, this Wiki covers its content to (HOPEFULLY) prevent BetteR20 users from requesting help on BetteR20 issues on the VTTes/R20es Discord server or other platforms (Reddit/Roll20.net Forum, etc).


You may have been looking for help on the Roll20 Enhancement Suite (also known as VTTes or R20es) and if so, this will hopefully answer the common questions around such.

So, for that let's directly link to where you likely want to go...

💾Installation Guide
🔧Troubleshooting Guide
📋 Features Guide
🔖 Website
☕ Support development



What it's not

The first thing you should know is that's not 5eTools, and not BetteR20. It's an extension made by Justas "Stormy" Dabrila. It is a way to enhance Roll20 with a number of usability and UI elements that expand, and even simplify running Roll20. His work stands alone, and so these pages reflect users understanding of his work.

Errors made here are reflective only of the author(s), and not of the work Stormy has done.


What it is

The VTT Enhancement Suite (aka VTT es and R20es) is according to its creator An unofficial quality of life and workflow extension for Roll20.

In reality its a work of passion and no small amount of effort, and genius made by a single person, Stormy (Justas Dabrila) its an extension written in javascript, and is an open source project under GPL-3.0.

It is an extension for the browser, which is to say - it's a program that runs only in the browser and only when you access Roll20.net. It does not monitor or share your information nor does it hack the Roll20 website, what it does do it modify the data the website provides to browser so that things work a bit different.

R20es is, in short, safe. Better yet, it makes Roll20 better.


What this page is

How do I get it?

First... can you run it?

MINIMUM REQUIRED BROWSERS:
Chrome : 74+
Firefox : 67+
LATEST VERSION BROWSERS:
Chrome : 76.0.3809.100
Firefox : 68.0.2



KNOWN PROBLEMS WITH BROWSER VERSIONS:
Chrome:
Update branch 73 is bugged, please update to 74.
Firefox:
WaterFox is not supported. It runs on a dated branch of Firefox build
ESR release is also, NOT supported, it runs on version 60, which is lower than the minimum required version for Firefox. Consider switching to the default branch of Firefox.



Then, it depends on what browser you are using.

For Chrome, you go here
For Firefox, you go here

For Opera ... realize you'll get NO support for BetteR20 if you are attempting to use it, but ...

for a more detailed guide - see the 💾 R20es installation guide.

How do you use it?

Mostly, it's going to be about how you play. There are LOTS of features in VTTes/R20es, and you'll need to understand what you can do before anyone can tell you how to do what you may want to do with it...


but chances are, you want to play with animated backgrounds, or playlists/tracks.

or are looking some help with how to get things to work.


R20es Configuration

In Roll20, click the sidetoolbar's R20Settings.PNG setting, and if VTTes/R20es is loaded properly (see Installation Guide) you will see the buttons for R20es Tools and R20es Config.


Which will bring up the following dialog window that has three distinct parts.


VTT Enhancement Suite Configuration.PNG

1️⃣ In this part are the specific features, listed by category.


2️⃣ This is the pane in which the individual settings are presented.

Note: clicking upon the checkbox will NOT initiate the update int this panel, for that you need to click upon the feature name directly in panel 1️⃣.


3️⃣ The Change Log for VTTes/R20es and the About dialog box, which lists the current version and provides links to the Discord Server, Github and Coffee



A note Each Feature's wiki page will denote which items are DM only, Requires the DM & Players to Run, or are will run for the PC (even if the DM doesn't use the script).

Icon Meaning
Dm.png
GM only feature
CharactersGroup.png
Requires Players Run the Script to make use of this feature.
EitherDMnPC.png
Either DM or PC can use this feature.
BothDMnPC.png
Requires DM to run this feature to for Players to use/have access to it.