🎲 Arcane Dice

Roll for initiative. The dungeon master is watching.

A Baldur's Gate 3-inspired physics dice roller with real 3D collisions, cinematic themes, and an AI dungeon master that narrates your fate.

Nat 20? The Weave itself applauds. Nat 1? Even goblins expected better.

---

⚔️ What is this?

Arcane Dice is not just another dice roller. It's a full sensory experience for tabletop RPG players.

Watch real polyhedral dice tumble across a physics-simulated table with Ammo.js. Hear them clatter. See them settle. Then read what the AI dungeon master has to say about your roll — because every d20 tells a story.

Built for D&D players, Pathfinder groups, solo adventurers, and anyone who misses the sound of dice hitting a wooden table at 2am.

✨ Core Features

Feature	Description
🎲 Real Physics	Ammo.js-powered 3D dice that tumble, collide, and settle realistically
🧙 AI Narrations	Gemini-powered dungeon master reacts to every roll with wit and drama
🎨 Custom Themes	Prismatic, Wooden, Gemstone, Rust, Blue-Green Metal, and more
🖼️ Dynamic Backgrounds	Cyberpunk taverns, fantasy dungeons, cozy libraries, underdark caves
🎵 Sound Effects	Satisfying dice-on-table clack sounds for every roll
📊 Roll History	Track your session stats — are you blessed or cursed tonight?
🎯 All Dice Types	d4, d6, d8, d10, d12, d20, d100 — the full polyhedral set
⚡ Advantage/Disadvantage	Roll with advantage or disadvantage, D&D 5e style
🏆 Critical Detection	Special celebrations for nat 20s, special shame for nat 1s

🧙 The AI Dungeon Master

Every roll triggers a unique narration from the AI. It's not random flavor text — it's contextual, dramatic, and occasionally hilarious:

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  🎲 You rolled: 20                                          │
│                                                             │
│  "Reality hesitates for a heartbeat.                        │
│   Even the Dungeon Master raises an eyebrow.                │
│   The Weave itself applauds."                               │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🎲 You rolled: 1                                           │
│                                                             │
│  "The fates have abandoned you.                             │
│   Your ancestors collectively sighed.                       │
│   Even your dice seem embarrassed."                         │
│                                                             │
└─────────────────────────────────────────────────────────────┘

🎨 Available Themes & Materials

DICE MATERIALS          BACKGROUNDS              TINTS
─────────────────       ──────────────────       ─────────────
• Prismatic             • Cyberpunk Tavern       • Arcane Purple
• Wooden Oak            • Fantasy Castle         • Blood Red
• Gemstone Marble       • Underdark Caves        • Forest Green
• Dice of Rolling       • Cozy Library           • Ocean Blue
• Rust & Iron           • Starlit Sky            • Golden Dawn
• Blue-Green Metal      • Dragon's Lair          • Shadow Black

🚀 Quick Start

git clone https://github.com/MahanKenway/Arcane-Dice.git
cd Arcane-Dice
npm install

Create a .env file (see .env.example):

GEMINI_API_KEY=your_key_here

Run the dev server:

npm run dev

🛠️ Tech Stack

Layer	Technology
Framework	React 19 + TypeScript
3D Engine	@3d-dice/dice-box (Three.js + Ammo.js)
AI	Google Gemini API
Styling	Tailwind CSS 4
Animations	Framer Motion
Backend	Express.js (API proxy)
Build	Vite
Database	Firebase Firestore
Deploy	GitHub Pages

🥚 Easter Eggs

This repo contains dice roller implementations in 21 esoteric programming languages — from COBOL to Zig, APL to Forth. Check the /easter-eggs directory if you dare.

ARCANE_DICE.cob    → COBOL (because enterprise dungeons exist)
arcane_dice.apl    → APL (roll dice in one incomprehensible symbol)
arcane_dice.zig    → Zig (for when you need zero-cost abstractions in your dungeon)
arcane_dice.fth    → Forth (stack-based dice, naturally)
arcane_dice.HC     → HolyC (TempleOS approved)

📜 License

MIT — May the RNG gods be ever in your favor.

---

Forged with ⚔️ by Mahan Tavakoli

Roll well, adventurer. The dungeon waits for no one.