Skip to content

emjaytee404/ddb-screen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ddb-screen

Another D&D Beyond DM Screen

Now Live! 🚀

Check it out @ ddb-screen.pages.dev

screenshot Default View

screenshot-expanded Abilitiy Scores & Proficiencies/Expertise expanded

About

A function-focused DM Screen for D&D Beyond. Inspired by swichers/dndbeyond-screen (except that seems to be unmaintained right now).

I wanted something that would have the stats I'm most likely to use during my game sessions: Name, Level, Armor Class and Hit Points. I've since expanded it to include Dexterity to determine tiebreakers on Initative rolls, a full Ability Scores table, and Skill Proficiencies & Expertise because I like to call on characters with relevant skills when adjudicating situations.

All of the stats calculation logic was written by DjikstraTheDragon (python code), and credit goes fully to them. I simply (poorly) rewrote it to JavaScript and fixed a couple issues. Many thanks!

How to Use

Copy the character's DDB URL, and paste it into the input field. Click the Add Character button to add them to the listing.

Click on the character's name to change it if you'd like to shorten it/add a nickname. Custom names are remembered for the next time that character is loaded.

Character cards are draggable. You can manually sort them by name, initiative order, whatever.

You can toggle showing the ability scores table by clicking the Show/Hide Ability Scores button.

You can do the same for skill proficiencies (and expertise, which is designated with a ★ symbol) with the Show/Hide Skill Proficiencies button.

To save the current character listing, click the Save button. You'll be prompted to name the campaign. This way you can keep several groups saved at the same time.

In the campaigns listing, click the Load button to load those characters. They will be added to the current listing.

To remove a character, click on its Remove button. If you want to wipe the entire listing, click the Remove All button.

The Reload button starts updating all of the character's stats once per minute. Useful for when combat begins.

To increase the size of the page, click the Zoom button. You can then enter a value, press the up/down arrow keys, or use the mouse scroll wheel to zoom in and out.

All settings are stored in the browser.

Card Fields

[ Name ] [ Level ] [ DDB Link ]
  Passive Senses [ Perception | Investigation | Insight ] [DEX]
---------------------------------------------------------------
                       [STR] [CON] [DEX]
                       [INT] [WIS] [CHA]
---------------------------------------------------------------
                 [ Proficiencies | Expertise ]

Buttons

  • remove Remove Character

  • add Add Character

  • toggle abilities Toggle Showing/Hiding Ability Scores

  • toggle proficiencies Toggle Showing/Hiding Skill Proficiencies

  • zoom Open/Close Zoom Control

  • save Save Current Character List as a Campaign

  • reload Start Reload

  • remove all Remove All Characters

  • In the Campaigns List

    • load Load Campaign
    • delete Delete Campaign
    • cofirm Confirm Save
    • cancel Cancel Save
  • 🤍 Hit Points Colors

    • 🟩 Healthy (current = max)
    • 🟨 Injured (current < max)
    • 🟧 Bloodied (current < ½ max)
    • 🟥 Unconscious (current = 0)

Installation Instructions

Generic Web Host

  1. Upload the contents of the public directory to your favorite web host. I'm a huge fan of Nearly Free Speech.
  2. There is no step 2.

Alternative Installation: Deploy to Cloudflare Pages

You can deploy to Cloudflare Pages. Follow the Git integration guide with the following settings:

  • Build command: sed -i 's|api\.php?id=|api/character/|' public/ui.js.
  • Build output directory: public.

Credits

  • Again, many thanks to DjikstraTheDragon on the DDB forums, for sharing their work.
  • All icons by the awesome folks at Freepik on Flaticon.
  • Color palette: uchū by NetOperator Wibby. Thank you!

If you've got any ideas or feedback, you can email me: [my github username]@proton.me

About

Another D&D Beyond DM Screen

Topics

Resources

Stars

Watchers

Forks