Dice of Sending

Wondrous Item, uncommon

When a Dungeon Master insists you roll in plain sight, the Dice of Sending offer a clever loophole. These enchanted dice are linked by invisible arcane currents (or Bluetooth, depending on your realm’s tech level), allowing a roll in both the physical and digital planes simultaneously.

Those attuned to the Dice of Sending may appear obedient while still indulging their chaotic good nature—rolling fairly, yet unpredictably.

Preface

This project is still a work in progress and is mostly there but there are still some rough edges.

Join the discussion on Discord (Check the #dice-of-sending channel).

Fairness

With the latest version, I test rolled 210 times

• 1 - 34
• 2 - 31
• 3 - 41
• 4 - 37
• 5 - 36
• 6 - 31

Quick Start

Full setup below.

1. Solder Seed Studio, battery, and accelerometer together.
2. Calibrate dice with arduino/calibration/calibration.ino
3. Add calibration values to arduino/dice_of_sending/dice_of_sending.ino.
4. Run website with cd website && npm bootstrap && npm run dev (Or visit Dice of Sending if still hosted.)
5. Open website, invite friends to a room, connect to dice, start playing board games.

const device = await navigator.bluetooth.requestDevice({
filters: [{ namePrefix: "old-name-here" }],
optionalServices: ["deadbeef-1234-5678-1234-56789abcdef0"],
});

Future Functionality

These are things I’ll maybe do in the future, or you can too!

Low power mode

When the dice aren’t being rolled, go to sleep to save power.

Setup

Tools

1. Hot glue gun
2. Soldering iron
3. Arduino IDE

Parts

1. 1× USB-C cable
2. 1× Seeed Studio XIAO nRF52840 (Or any Arduino device with Bluetooth)
3. 1× BMI160 accelerometer + gyroscope
4. 1× 3.7V 60mAh 0.22Wh battery
5. 1x 38cm x 38cm Protoboard
6. PCB wire

Code

• dice_of_sending/ — Final Code.
• bluetooth/ — Test bluetooth communication. Upload sketch then open the bluetooth.html file in the browser.
• acceleration/ — Test accelerometer. Upload sketch and open Tools → Serial Monitor with the Arduino software.
• calibration/ — Calibrate dice values. Copy output to dice_of_sending/.

Circuit

References

• Seeed Studio XIAO nRF52840
• BMI160 3 Axis Accelerometer & Gyroscope

Soldering

1. Solder the battery to the microcontroller pads before soldering the microcontroller to the protoboard.
2. Solder the following connections between the Seeed Studio XIAO nRF52840 and BMI160 using the references above.

3D Models

• STLs can be found in cad/.
• Onshape models can be found here. Use the V2 Models.

1. Print models. I opted for 60% infill.
2. Place some hot glue on each of the four corners.
3. Place circuit inside.
4. Place some more hot glue along the edges of the circuit.
5. Hot glue the two halves together.

Website

The site may or may not still be hosted here.

Run locally

1. cd website
2. Install Node and npm
3. Install dependencies — npm bootstrap
4. Start website — npm run dev

Deploy

1. Get a domain.
2. Point website/frontend/src/services/socket.ts towards your domain.
3. Build npm run build - This will give you an Express server that runs the socket connection and serves the React app.
4. Deploy somewhere.
5. Enjoy!

Known Issues

These are either bugs in the code or quirks/shortcomings.

Arduino Software can’t find device

Sometimes the device needs to be reconnected a few times before it shows up in Arduino.

Bluetooth Naming

It appears that it takes some time for the browser to recognize a name change of BLE.setLocalName("Arduino"); within the Arduino code. If the device stops showing up and you changed the name, try searching for the old name within the HTML code: