Skip to content

README.md

Latest commit

 

History

History
113 lines (85 loc) · 4.92 KB

README.md

File metadata and controls

113 lines (85 loc) · 4.92 KB

123DiceDnD for Flipper Zero

Version: 1.0.2

123DiceDnD is a Flipper Zero D&D dice roller app for tabletop RPG sessions. It turns Flipper Zero into a fast pocket dice roller with support for all standard polyhedral dice, animated rolls, and multi-die totals.

If you are looking for a Flipper Zero dice app, Flipper Zero tabletop RPG tool, or a Dungeons & Dragons dice roller for Momentum firmware, this repository is built for that exact use case.

Features

  • 6 dice types: d4, d6, d8, d10, d12, d20
  • Roll 1 to 6 dice at once
  • 3D rotating polyhedron animation with deceleration
  • Vibration on result
  • Sum display when rolling multiple dice

Why Use 123DiceDnD

  • Built specifically as a Flipper Zero dice roller for D&D and other tabletop RPGs
  • Covers the full standard polyhedral set used in Dungeons & Dragons
  • Works well as a quick RPG utility when you do not want to carry physical dice
  • Designed for Momentum firmware and native Flipper Zero app workflows

Screenshots

┌────────────────────────────┐   ┌────────────────────────────┐
│ < d20 >        -  Qty: 1  +│   │ < d20 >        -  Qty: 1  +│
│ ────────────────────────────│   │ ────────────────────────────│
│                             │   │                             │
│                             │   │                             │
│      Press OK to roll!      │   │             17              │
│                             │   │                             │
│                             │   │                             │
│                             │   │        [OK] Reroll          │
└────────────────────────────┘   └────────────────────────────┘
        Main Screen                   Result (single die)

┌────────────────────────────┐   ┌────────────────────────────┐
│ < d6 >         -  Qty: 4  +│   │ < d6 >         -  Qty: 4  +│
│ ────────────────────────────│   │ ────────────────────────────│
│                             │   │                             │
│     ┌──────┐  ┌──────┐     │   │   ╭──────╮ ╭──────╮        │
│     │  ◇   │  │  ◇   │     │   │   │   3  │ │   5  │        │
│     └──────┘  └──────┘     │   │   ╰──────╯ ╰──────╯        │
│     ┌──────┐  ┌──────┐     │   │   ╭──────╮ ╭──────╮        │
│     │  ◇   │  │  ◇   │     │   │   │   1  │ │   6  │        │
│     └──────┘  └──────┘     │   │   ╰──────╯ ╰──────╯        │
└────────────────────────────┘   │          Sum: 15             │
     Rolling (multiple)          └────────────────────────────┘
                                      Result (multiple dice)

Controls

Button Action
Left/Right Dice type
Up/Down Quantity (1-6)
OK Roll
Back Exit

Build And Install

Requires ufbt and a Flipper Zero with Momentum firmware.

cd dice_roller

# First time: install Momentum SDK
ufbt update --index-url=https://up.momentum-fw.dev/firmware/directory.json

# Build
ufbt

# Build and run on Flipper via USB
ufbt launch

Structure

dice_roller/
├── application.fam       # App manifest
├── dice_roller.c         # App logic
├── dice_sprites.h        # 3D sprites (auto-generated)
├── images/
│   └── dice_10px.png     # Menu icon 10×10
└── tools/
    └── gen_sprites.py    # Sprite generation (Python)
docs/
└── plans/                # Design docs and plans

Sprite Generation

Sprites are generated by a Python script from 3D polyhedron models:

cd dice_roller
pip3 install numpy Pillow
python3 tools/gen_sprites.py

6 types × 8 frames = 48 sprites at 24×24px in XBM format.

SEO Keywords

Flipper Zero dice roller, Flipper Zero D&D app, Flipper Zero tabletop RPG tool, D&D dice roller, Dungeons & Dragons dice app, polyhedral dice roller, Momentum firmware app.

Authors

Co-authored by Claude & 123fzero