docs

OmegaBot Docs

This folder collects the main OmegaBot reference docs, setup guides, and project notes.

Getting Started

• Environment setup - Configure required and optional .env values
• Discord setup - Create the bot app, invite it, and configure permissions
• Notion setup - Connect a Notion database for /wiki and /notion
• Runbook - Practical operating notes for running and maintaining the bot
• Troubleshooting - Common problems and how to diagnose them

Features

• Commands - Slash command coverage and behavior
• Discord setup - Permissions and setup notes for /roles
• FAQ - Curated FAQ system overview
• FAQ Admins - Admin workflows for FAQ maintenance
• Chat and LLM - AI/chat behavior and related configuration
• Analytics - Tracking, observability, and reporting notes
• Progression - XP, levels, and progression-related behavior

Development

• Development Notes - Conventions, structure, and implementation guidance
• Project Structure - High-level codebase layout
• File Structure - Expanded folder and file tree
• Games Development - Patterns for building and extending games
• Web Platform - Shared backend and website/API notes
• Grafana - Metrics and dashboard setup
• i18n - Internationalization notes and future direction

Ideas And Planning

• Recommendations - Feature and command recommendations
• Improvements - Reliability, ops, and quality ideas
• Gameplay Improvements - Gameplay tuning ideas
• Games and UX Ideas - User experience and feature brainstorms
• Transcripts - Captured notes and discussion artifacts

Full Index

• analytics
• chat-and-llm
• commands
• dev-notes
• faq
• faq-admins
• file-structure
• games-and-ux-ideas
• games-development
• gameplay-improvements
• grafana
• i18n
• improvements
• progression
• project-structure
• recommendations
• runbook
• setup-discord
• setup-env
• setup-notion
• transcripts
• troubleshooting
• web-platform