Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
74 lines (43 sloc) 4.52 KB

Beyond20: D&D Beyond & Roll20/Foundry VTT Integration

Beyond20 is a browser extension that integrates the Character Sheet from D&D Beyond into Roll20 & Foundry VTT.

Install and Use

Install

Chrome

To install Beyond 20 on Chrome, simply head over to the Chrome Web Store and click "Add to Chrome" to get it installed.

Firefox

To install Beyond 20 on Firefox, simply head over to Firefox Extensions and click "Add to Firefox" to get it installed.

Use

Open Roll20 or Foundry VTT in a tab of Chrome or Firefox then your character sheet in D&D Beyond in another tab. If you are using Chrome with Foundry VTT, then you need to click on the Beyond20 icon in the Chrome window's toolbar to activate Beyond20 for your FVTT installation.

Click on the item you want to roll, whether it's initiative, a skill, ability or saving throw check, a weapon or spell attack, a class/racial feat or trait or hit dice, death saving throw, etc... When the D&D Beyond character sheet shows the information about the item you selected in its side panel, there should be a Beyond20 button or B20 icon that appear in the side panel to make the roll. It will automatically pick up on what was selected, and send the roll to all Roll20 or Foundry VTT tabs open.

If a spell/item/action/feat description contains a dice formula (2d10 + 3 for example) or a modifier formula (+ 3 for example), that text will be underlined and a B20 dice icon will appear next to it. Click on the formula or the dice to make the roll in the Roll20 tab.

If you click on the Beyond20 button in the toolbar, it will pop open the quick settings menu. Note that the quick settings menu will be different whether you are on the VTT tab or D&D Beyond tab, and it will contain the per-character configuration.

Build

This extension is written in 'python', more precisely in RapydScript and you will need RapydScript-NG installed to compile the .pyj source files into .js I don't know if it's totally compatible with rapydscript itself as I've used rapydscript-ng myself.

To install : sudo npm install rapydscript-ng -g

Install RapidScript-NG then type 'make' to compile the *.pyj into *.js

Note: The .js files are already included in the source repository... I don't usually include built files in a repo, but I guess .js files are still source code and that makes it easier for people to just try the extension without having to first install rapydscript.

Developer Mode Installation

All you need is to load the extension from the source :

  1. If you already have Beyond20 installed from the Chrome or Firefox stores, disable it.
  2. Download the extension from github
  3. Extract the zip file in a directory of your choice

Chrome

  1. Go to Chrome Extensions page (Menu->More Tools->Extensions)
  2. Enable Developer Mode (Top-right corner)
  3. Click on the 'Load Unpacked' button
  4. Select the Directory where you extracted this extension

Firefox

  1. Rename the file manifest_ff.json into manifest.json from the extension's directory
  2. Open "about:debugging" in Firefox
  3. Click "Load Temporary Add-on"
  4. Select the manifest.json file from the extension's directory

License

This extension is released under the GPL v3 license. Read the LICENSE file for more details.

The icon image is based on a public domain image from openclipart. I downloaded it from wikimedia and subsequently modified it.

The donation icon is a public domain contribution by Fission Strategy, US, downloaded from thenounproject

The 'up' arrow (docs/images/up-arrow.png) used in the screenshots page is a public domain image shared by OCAL on clker.com

The options page was copied in part from the D&D Beyond Toolbox extension available here. The html and css files are licensed under the MIT license which is provided in the LICENSE.MIT file

The condition icons (FVTT-module/beyond20/conditions) are for the most part taken from https://game-icons.net/ and licensed under a Creative Common CC-BY 3.0 License. You can find each icon's source and respective license in the FVTT-module/beyond20/conditions/LICENSE file

You can’t perform that action at this time.