Skip to main content

Havenly Bot 2.0 & Havenly Helper

Two bots, one codebase: the main bot runs the day-to-day, and the Helper runs setup and background jobs — both sharing one Postgres database.

Start readingHow the two bots split the work

🤍 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.