DiceCloud

This is the repo for DiceCloud.

DiceCloud is a free, auditable, real-time character sheet for D&D 5e.

Philosophy

Setting up your character on DiceCloud takes a little longer than just filling it in on a paper character sheet would. The goal of using an online sheet is to make actually playing the game more streamlined, and ultimately more fun. So putting a little extra effort into setting up a character now pays off over and over again once you're playing.

The idea is to track where each number comes from, and allow you to easily make changes on the fly. Let's look at a hypothetical example.

You need to swim through a sunken section of dungeon to fetch the quest's Thing. You'll need to take off your magical Plate Armor of +1 Constitution to swim without sinking, of course.

Taking it off will take away that disadvantage on stealth checks, change your armor class, your speed and your constitution, and which in turn changes your hit points and your constitution saving throw. Working out all those changes in the middle of a game will drag the game to a halt.

Fortunately you have DiceCloud, so it's a matter of dragging your Plate Armor +1 Con from your "equipment" box to your "backpack" box and you're done. Your hitpoints change correctly, your saving throws are up to date, your armor class goes back to reflecting the fact that you have natural armor from being a dragonborn. Your character sheet keeps up and you ultimately get more time to play the game. Huzzah!

---

Getting started

Running DiceCloud locally, either to host it yourself away from an internet connection, or to contribute to developing it further, is fairly straightforward and it should work on Linux, Windows, and Mac.

You'll need to have installed:

• git
• docker

Now open a terminal in the installation folder and run the following commands:

  git clone https://forgejo.spacetime.technology/arbel/DiceCloud.git dicecloud
  cd dicecloud

edit the ROOT_URL line in docker-compose.yml file to use your domain or keep it as localhost (for use on the same computer)

run:

  docker-compose up -d --force-recreate
  docker ps
  # this should show two containers running for dicecloud and dicecloud-db

---

notes:

the current version of dicecloud has an issue with library editing.

if you need library editing (not the public libraries) you can use the image tagged old-schema instead of latest

plase report any issues with the container image to @arbel_arad on discord or @arbel:matrix.spacetime.technology on matrix