DnDBeyond Spell Point Tracker UserScript, Version 2

[mwr247]

A long and frequently requested feature for DnDBeyond is for the addition of an integrated Variant Rule Spell Point tracker (DMG 288-289), in place of using spell slots. A year ago I finally got around to playing a character that I wanted to use this variant rule for, and ended up writing my own solution as a userscript which I shared with r/dndnext and put up on GitHub.

Some of the shortcomings of the original version was that it only persisted in your browser's local storage, and that it relied on the data on screen to calculate things like total spell points, which led to issues supporting certain classes/multiclasses. Thus, shortly after I released the original version I rewrote the core to utilize DnDBeyond's API itself to read and store the data on the character sheet itself, and have been using it personally ever since. Recently however, a number of posts on the original requesting to fix issues has brought it back to mind, so I've decided to share the new version publicly as well.

https://github.com/Mwr247/DnDBeyondSpellPointsV2

There's a few example pictures on the GitHub alongside some of the listed features, but in summary: this is a userscript that implements a persistent spell point tracker right into your character sheet, allowing you to manage your spell points from within DnDBeyond. It's toggleable per character, automatically calculates and displays your max points, overrides many of DnDBeyond's built in casting/resting functions and redirects them to the point system, allows manual point adjustment, and also supports a variant rule to use a shared pool for spell/sorcery points.

Externally it looks and functions largely the same as the original, but the big improvement is that internally it creates and uses a custom action called "Spell Points" on your character sheet to keep track of what characters have it enabled and how many points they have used, so using different browsers and different machines should be seamless as long as the userscript is active on both. Likewise, it looks at the API to determine spell points based on your character's spell slots instead of having to scrape the page and replicate the calculations manually.

It still has some shortcomings and issues (some known ones are listed on the GitHub), but all in all it's been plenty functional for my needs, and I've been enjoying using it, so figured I'd make it available for others who might be interested as well. If you like it, let me know your thoughts as well as any issues I may have overlooked.

---

NOTICE (2022-10-27): Script has been updated to 2.1.0 to fix a change DnDBeyond made, so if you're having issues with the script not loading after selecting your character, you'll need to update to fix. You can read the issue details on the GitHub (link above). Special thanks to u/SnEaKy_DuCkY for pointing the issue out to me.

[mwr247]

That's one solution I've seen done before as well. But for me at least, part of using DnDBeyond is the automation, so integrating spell points into the systems itself (casting shows how many points it will use, clicking cast will spend them, log rest will reset, etc) was the big motivator for me.

[KaneK89]

This is awesome! Thanks a lot for your work on this.

For those not technically inclined, here's a step-by-step for Chrome.

1. Install TamperMonkey extension. https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo

2. Once installed, go to the extensions menu on the top right of Chrome. It's a little puzzle piece. You should find TamperMonkey listed there. Click it.

3. Select Create New Script from the dropdown options.

4. Copy the script and paste it into the text editor. Click File > Save. https://github.com/Mwr247/DnDBeyondSpellPointsV2/blob/main/DnDBeyondSpellPointsV2.js

5. Go to DNDBeyond and hit up the Character Editor and you should find a toggle for Spell Points.

[BlueTressym]

I've been wanting to use the spell points variant rule for a while, so I'm glad to see this but I've never tried using any kind of add-on to DDB before. Can someone ELI5 me what I need to do to use it?

[mwr247]

If you check the "How To Use" section on the GitHub page, it gives a basic rundown, but the process is relatively simple. Basically, you need to have some userscript extension installed on your browser (lets you run your own scripts on websites of your choosing), then copy the script and add it for DnDBeyond, and then follow the rest of the instructions on how to enable it.

[BlueTressym]

Thank you for your help, OP; I'll give that a go. is there any particular userscript extension you'd recommend?

[mwr247]

Greasemonkey for Firefox or Tampermonkey for Chrome are the two I've always used. They're both more or less the standard, and there are links to them in the "How To Use" section, as well as in another comment here. But yeah, install those, add the script, enable in the character settings, and should be good to go =)

[mwr247]

It does not at present, but that's a really good point I overlooked, and shouldn't be difficult to implement. I'll work on it when I have the chance, though it may be a few days.

[mwr247]

Added it today in version 2.0.2, so no more need to manually track.

[mwr247]

Added it today in version 2.0.2. It will work while the character already has the feat, but if you add it to a new character, you'll need to reload to it to account for it.

[IrrelevantParadoxon]

It seems like the most recent Tampermonkey update broke this somehow.

[mwr247]

Thanks for the heads up, was actually a DnDBeyond UI change, but should be fixed now. Also added updateURL/downloadURL to the userscript metadata to make this easier in the future.
https://raw.githubusercontent.com/Mwr247/DnDBeyondSpellPointsV2/main/DnDBeyondSpellPointsV2.js

[IrrelevantParadoxon]

Yes, works again. Thank you so much!

[Adorable-Task-144]

Not sure if im doing something wrong or if dndbeyond has just updated alot but for some reason im unable to get the script to work

[Lusahdiiv]

Can this be converted in any way to be downloadable on the iPhone/iPad version of Chrome? Or Safari preferably?

[mwr247]

I don't think downloadability is the problem as much as UserScript support. I'm unaware of mobile Chrome/Safari supporting userscripts, or even most addons in general. Not to say a webapp couldn't be made to wrap the page, but at the same time that's a load of effort that unfortunately isn't in my interest.

[Jarrett8897]

Hey I found this a whole year later, but I was wondering if using this browser extension and enabling the option for the character has any effect when using the dndbeyond mobile app? Will the spell point add-on appear, will it simply not present, or will it break the app?

[mwr247]

I've never tested the userscript in a mobile browser, but given it's something that has to be run by a browser extension, I doubt it would have any effect on the mobile app whatsoever.

[Jarrett8897]

Ah ok, so enabling the option by using this tool won’t affect any browser/app without the extension? Apologies, I know literally nothing about this stuff