https://github.com/jamster3000/cauldron20
A web browser extension made to add functionalily between dndbeyond character sheets and Cauldron VTT. Supports both chromium based web browsers and firefox
https://github.com/jamster3000/cauldron20
browser cauldron cauldron20 chrome edge extension table top virtual vtt web
Last synced: 2 months ago
JSON representation
A web browser extension made to add functionalily between dndbeyond character sheets and Cauldron VTT. Supports both chromium based web browsers and firefox
- Host: GitHub
- URL: https://github.com/jamster3000/cauldron20
- Owner: Jamster3000
- License: agpl-3.0
- Created: 2023-12-19T10:31:37.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-18T11:46:47.000Z (9 months ago)
- Last Synced: 2025-02-05T15:52:24.611Z (8 months ago)
- Topics: browser, cauldron, cauldron20, chrome, edge, extension, table, top, virtual, vtt, web
- Language: JavaScript
- Homepage:
- Size: 2.47 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# What is this? 🔮
Cauldron20, a chrome extension that provides functionalily between character sheets on [dndbeyond](https://www.dndbeyond.com/) and [Cauldron](https://www.cauldron-vtt.net). It reads data from a character sheet on dndbeyond and can use different data from it into different areas of cauldron VTT. THe **best part is** that if you don't want to, you don't even need to have your dndbeyond character sheet open for this to work - it's magic 🌟
If you already use Cauldron-vtt, you might be interested in the offical cauldron-vtt discord server: [Discord Server](https://discord.gg/wNRk4qbwXz).
# How it works
This works by clicking on the extension and entering your character sheet's number (e.g. 112012248). This will then use dndbeyond's api for character sheets. It will remember your character so this will be a one time input. If you want to use a different character just input a new number and your old character will be replaced with the new one (there are plans for mulitple characters).
# Installation 🚀
To install and try this extension
1) download all the code on this github
2) extract the code from the zip folder
3) Open Chome and navigate to extensions [chome extensions](chrome://extensions/)
4) Make sure that developer mode is enabled on top right.
5) Top left, choose "load unpacked" and choose the folder that contains the code.
6) Clicking on the extention and input the number that identifies your character (make sure that your character sheet on dndbeyond is in public so it can be accessed by the extension).
Alternatively if you are using **Firefox** as your web browser you can search up cauldron20 as it's an add-on on Firefox's store.
See [wiki](https://github.com/Jamster3000/cauldron20/wiki) for more in depth instructions on how to setup the extension and use it.
> [!NOTE]
> This project is something I develop and update in my spare time, don't expect any miricales from me 🪄
This was my first first JavaScript project which has pretty much helped me learn all the basics of JavaScript, making it much less of a headache than it used to be.
# Screenshots
Character Creation
Character Sheet
Actions
Bio
Features
Inventory
spells
Extra's
# Reporting errors
There are three main ways to report errors or problems with the extentions
- Visit the official Cauldron-vtt [Discord Server](https://discord.gg/wNRk4qbwXz) where you may also mention issues with the extention
- Use the discussions or issues tab in this GitHub (account required).
- Use the `Report Incorrect Character Data` that is presented in the Cauldron20 Extention's popup.
# Contribution
The only thing I've never gotten working for me is reading character data from PDF's. If you wish to contribute and help implement that feature, even partial, it's open to it, otherwise, I'm not looking for any help for other's to improve it.
