PookyEvent

PookyEvent is a Discord event management system designed for ESO PvP runs with pre-defined group setups. It replaces chaotic manual signup lists with clean interactive embeds.

Features

• 🎮 Interactive Signup Embeds — Role-based buttons on rich Discord embeds. Click to sign up, click again to cancel.
• ⭐ Multi-Role Signups — Users can pick a preferred role (⭐) and alternative roles (✔️). The system prioritizes preferred roles when finalizing.
• 🛡️ Custom Role System — Up to 12 custom roles with auto-emoji prefixes (👑 Lead, ⚡ Speed, ⚔️ Damage, 💣 Bomber, 💉 Heal, 🧪 Support, 🛡️ Tank, etc.)
• 🚫 Special Signup States — Absent, Bench, Maybe, Whatever, Late, Early — each with unique behavior and visual indicators.
• 🔄 Auto-Benching — Excess signups are automatically moved to the Bench when the event is full.
• 🔒 Event Finalization — "Close Event" assigns waiting players, locks signups, and assigns final roles.
• 📅 Event Repeating — Duplicate previous events with one command; perfect for weekly runs.
• 🌐 Web Admin Dashboard — Full-featured admin UI (Streamlit + NiceGUI) for managing events, users, guilds, and roles without Discord.
• 🔐 Secure API — HMAC-authenticated REST API for inter-component communication.
• 📊 Status Tracking — Real-time overview of open slots, missing roles, mandatory role requirements, and event readiness.

Slash Commands

Architecture

• Discord Bot — discord.py, slash commands + interactive button embeds
• FastAPI REST API — Backend services for all CRUD operations
• Streamlit UI + NiceGUI UI — Two admin dashboard options
• SQLite Database — Shared across all components
• Docker — Easy deployment with docker-compose

Use Cases

• Weekly PvP trial/raid signups with fixed role compositions
• Community events requiring role-based attendance tracking
• Guilds that need a structured, searchable event history