[]()

🎲 Discord Dice UI

Discord Dice UI is a website based app which can be integrated easily with Discord server. In short, it offers a neat interface to roll dice and provides more advanced functions and dice manipulations for the supported systems. I conceived it as a simpler alternative to more complex VTTs, and as a more advanced alternative to traditional, command driven Discord bots.

Table of content:

• The App Overview
  • Supported Systems:
  • Call of Cthulhu 7e
  • Warhammer
  • Wrath & Glory
  • Conan 2d20
  • Infinity 2d20
  • Dune 2d20
  • Legend of the Five Rings 1e
  • Legend of the Five Rings 5e
  • Narrative Dice
  • Fate
  • The One Ring 2e
• Combat Tracker
• X-Card
• Discord Configuration
• Query parameters
• Developers' Info

🎲 The App Overview

The App interface:
[]()

Sample results inside a Discord Chat:
[]()

Sample results inside the App:
[]()

Call of Cthulhu 7e

After selecting the mode in the Roll Options a dedicated modal will be shown for rolling d100 skill tests - with option to Push the roll and guidelines for optional spending luck.

[]()

Skill values can be stored in build-in character sheet:

[]()

[]()

Warhammer

The app offers special support for rolling Success Levels in Warhammer 2e, Warhammer 4e and Dark Heresy II.

[]()

The app can also help with adding and subtracting gold crowns, silver shillings and brass pennies:

[]()

[]()

Wrath & Glory

• neat, colorful, and interactive interface
• skill test with automatical Icons calculation
• various number of Wrath Dice in a roll
• ability to reroll all dice
• ability to reroll selected dice
• abillity to increase Dice Pool after rolling the dice
• d6, d3 and d66 dice available

[]()

[]()

Conan 2d20

This mode adds special modal for testing abilities, generating Hit Location and rolling Combat Dice:

[]()

In the modal one can define Focus, Target Number, Difficulty, select amount of dice rolled, focus and so on:

[]()

Damage Dice Result (with option to reroll selected dice):

[]()

Infinity 2d20

[]()

Dune 2d20

[]()

Legend of the Five Rings 1e (classical Roll and Keep)

Roll and Keep Results:
[]()

Legend of the Five Rings 5e

Allows to roll Skill and Ring Dice and to modify the results:
[]()

Roll Results:
[]()

Narrative Dice

Allows to build a custom dice pull from popular space opera RPG series:
[]()

Roll Results:
[]()

Fate

[]()

The One Ring 2e

The app now allows to roll unique TOR dice. It calculates the roll results automatically and takes into the consideration factors:

• Hero's conditions (Weary, Miserable)
• Rolling the Favoured or Ill-Favoured Roll
• Rolling as an Adversary (reverses results for the Feat Die)
• Shows the results clearly on Discord chat

Interface:
[]()

Skill Test:
[]()

Results Modal:
[]()

Results on Discord:
[]()

⚔️ Combat Tracker

The Combat Tracker lets you organize the combat and share the current state of the battlefield with other players on Discord. It supports:

• creating combat zones and moving combatants between them
• adding descriptive conditions
• adding descriptive wounds
• sorting combatants in the initiative order
• tracking HP
• tracking the advantage (Warhammer 4e support)
• creating combatants of the same type easily with one click (the Copy button)
• saving the favorite combatants for the latter encounters

[]()

[]()

X-Card

The X-Card is an optional tool created by John Stavropoulos that allows anyone in your game to edit out any content anyone is uncomfortable with as you play.

[]()

[]()

You'll find more details on the X-Card under the following link: http://tinyurl.com/x-card-rpg

🔧 Discord Configuration

In order to get started, Discord's server admin has to create a Webhook and share a special link with other users. Read below how to do it.

1. As a server's admin open your chat's context menu.

2. Select Server Settings from the context menu.

3. Select Webhooks in the left side menu and then press the button Create Webhook.

4. Name your Webhook and provide an icon (optionally). Copy a link to obtain your unique Webhook url and press Save button to close the modal. 🛑 Never share your Webhook link publicly and keep it a secret. You don't want to allow strangers to publish messages in your chat.

5. Now you can share the Webhook url with other players in two ways:

   1. Via link param.
      Provide your players a link to an app which looks like this:

   https://discord-dice-ui.herokuapp.com/?q=UNIQUE_CODE_FROM_YOUR_DICORD_WEBHOOK

   💡 HINT: You can generate the link using Copy App Link button in the Setting Modal:

   

   2. Manually.
      Alternatively, every user has to enter the provided Webhook link url in the Settings modal inside the app. Entering the username is required as well.

6. Saving the Webhook in the app will connect the app with the Discord server.

🔗 Query Parameters

Several settings can by passed directly in the URL in the following format:

discord-dice-ui.herokuapp.com/?q=foo123&username=Django&sl=fast&mode=cthulhuMode

Available parameters:

• q - Discord Webhook URL
• username - Discord UI Username
• sl - Warhammer Success Level calculation method. Available values:
  • 4e for default Warhammer 4e Success Level
  • fast for Warhammer 4e Fast Success Level
  • 2e for default Warhammer 2e Degrees of Success
  • dh for default Dark Heresy 2e Degrees of Success
• mode - Game mode. Available values:
  • none - Default game mode
  • warhammerMode - Warhammer game mode
  • cthulhuMode - Call of Cthulhu game mode
  • conanMode - Conan game mode
  • infinityMode - Infinity game mode
  • duneMode - Dune game mode
  • narrativeDice - Narrative game mode (EotE, Genesys)
  • rollAndKeepMode - L5R 1e game mode
  • l5rMode - L5R 5e game mode
  • fateMode - Fate game mode
  • wrathAndGloryMode - Wrath & Glory game mode
  • torMode - The One Ring 2e game mode

👨‍💻 Developers' Info

Production build

1. npm run build
2. npm run start (serve -s build command is required by Heroku).

For local environment development run:

To run the app:

npm run dev`

To run Prettier globally:

npm run  prettier