🤍 Havenly Bot 2.0 — the main bot
The face of the pair. It runs the in-the-moment commands: moderation, user info, levels, games, QOTD, and everything members and mods use day to day. 54 top-level commands.
⭐ Havenly Helper — the worker bot
The behind-the-scenes bot. It runs setup and config, batch jobs (scans, backfills, backups), and the timeout board. 11 top-level commands — and no command is on both bots.
🔧 Core Features
What the two bots do, and where each system lives.
Moderation
Timeouts, bans, kicks, mod cases, and the GitHub ban log — with a mini mod panel on every user card.
Levels & XP
Message XP, rank cards, daily streaks, role rewards, and XP events — off by default, per guild.
Eat It or Yeet It
The party game: vote on foods, earn points, run it back. Live meals from TheMealDB plus a community pool.
Logger
Server-wide event logging to dedicated channels — messages, members, voice, server, and moderation.
Watch List
Put users on a per-server watch list and mirror their messages to a mod log channel.
Custom permissions
Grant a set of commands to a role or a user — a per-command allow list that replaces the Discord check.
📚 Docs
The how-it-works companion to the README — architecture, patterns, and copy-paste examples.
Two bots
How Havenly Bot 2.0 and Havenly Helper split the work — same codebase, shared Postgres, one bridge hub.
Fundamentals
Project map, boot sequence, cogs, commands, views & buttons, permissions, and config helpers.
Data layer
Postgres storage helpers and tables — which to use and when, plus adding tables and columns.
Systems
How the level system, Eat It or Yeet It, Watch List, Logger, and bot settings work internally.
Guides
Copy-paste recipes, testing, and the new-feature checklist.