YetiBot 🤖

My personal Discord bot. Written in TypeScript and constantly evolving based on whatever cool ideas I have.

Features

• 📿 Amulet Game - Pass the cursed amulet around, track holding times
• 🏆 Leaderboards - See who has held the amulet the longest
• 📊 User Stats - Track amulet holds and time statistics
• 🌐 Web Dashboard - View servers, users, and stats in a web UI

Commands

Command	Description
/give	Give the amulet to a user
/who	Shows who currently has the amulet
/leaderboard	Shows ranking by time held
/reset	Force reset the amulet (moderator)
/ping	Pong!
/user	User info

Quick Start

Development

# Install dependencies
npm install

# Run bot with hot-reload
mise run dev

# Run web dashboard (requires API server)
mise run dev:api
mise run dev:web

# Lint
mise run lint

Deploying Slash Commands

# Deploy commands to test server (guild in config.json)
mise run deploy-dev-commands

Commands are automatically registered when the bot starts.

Tech Stack

Bot

• ⚡ Node.js v22 (runtime)
• 🦸 TypeScript
• 💬 Discord.js v14
• 🔊 @discordjs/voice v0.18 (audio playback)
• 💾 LowDB v7 (JSON database)
• 🛡️ Zod (validation)

Web Dashboard

• ⚡ Node.js v22 (runtime)
• ⚛️ React v19
• 🎨 Bootstrap v5
• 🛠️ Vite v7
• 📡 React Router v7

Dev Tools

• 🔧 Biome (linting/formatting)
• 📦 tsx (TypeScript execution)
• 🛠️ mise (task runner)