Skip to content

jasonbrandt42/discord-dice-ui

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Discord Dice Ui

Discord Dice UI

🎲 The app is intended to use as a graphical interface dice roller for Discord. You can connect it with your Discord chat and use to roll some dice without typing!

The app offers special support for following games:

  • Call of Cthulhu 7e
  • Warhammer (Dark Heresy II, WFRP 2e/4e)
    • Warhammer Money Converter
  • Conan 2d20
  • Narrative Dice (EotE SW)
  • Legend of the Five Rings 1e (Roll and Keep)
  • Legend of the Five Rings 5e
  • and Fate dice

App interface

Fate dice

Sample results inside Discord's Chat

Sample Chat Results

Sample results inside the App

Sample App Results


Call of Cthulhu 7e Mode

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.

Call of Cthulhu 7e Mode 2


Warhammer Mode

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

WFRP Mode - app

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

Warhammer Money Converter Info

Warhammer Money Converter


Conan 2d20 Mode

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

Conan 2d20 Mode general interface

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

Conan 2d20 Mode modal

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

Conan 2d20 Mode Combat Dice roll results


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

Roll and Keep Results:
Roll and Keep Results Modal



Legend of the Five Rings 5e

Allows to roll Skill and Ring Dice and to modify the results:
L5R Pool Builder

Roll Results:
L5r Results Modal


Narrative Dice

Allows to build a custom dice pull from popular space opera RPG series:
Narrative Dice Pool Builder

Roll Results:
Narrative Dice Pool Builder


Setup

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. how-to-1

  2. Select Server Settings from the context menu. how-to-2

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

  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. how-to-4 🛑 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:

    how-to-5

    1. 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. how-to-5
  6. Saving the Webhook in the app will connect the app with the Discord server.


Developers' info

Production build

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

Development build

  1. npm run dev.

About

Discord Dice UI Webhook Bot Connector

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 90.1%
  • CSS 9.3%
  • HTML 0.6%