A multipurpose Discord bot for communities of all sizes — moderation, engagement, and automation with a full web dashboard.
Helix helps you run a Discord server: moderate it, welcome new members, verify them, give out self-assignable roles, track activity with detailed audit logs, and keep members engaged with a deep economy system and fun commands. Everything is configurable from Discord commands or the web dashboard — no hosting or code required for server admins.
- Moderation — bans, kicks, timeouts, mutes, purges, warnings with escalation (warn → timeout/kick/ban), and live moderation actions from the dashboard.
- Audit logging — 31 event types across moderation, members, messages, voice, server changes, and AutoMod, with per-event channels and ignore lists.
- Verification — button-based gate with a customizable embed; grants a role on verify.
- Reaction roles — self-assignable role menus with labels, emoji, per-menu limits, and pause/resume.
- Welcoming — welcome/farewell messages with placeholders, auto-role on join, and image cards.
- Economy — wallet & bank, shop, inventory & equipment, item effects, auctions, leaderboards, and RPG-style stats.
- AutoMod — Discord native AutoMod rule management plus custom keyword blocklists.
- Social feeds — automatic Reddit feeds per channel (Twitch/YouTube/TikTok/X/Instagram/RSS planned).
- Fun & utility — emotion roleplay commands, canvas image effects, pet pics, polls placeholders, 8-ball, memes, and more.
- Dashboard — per-server web panel for every setting above, with live Discord-style previews.
- AI (beta) — Ollama-powered
askcommand with a family-friendly assistant persona.
All modules can be toggled per server from /configmodule or the dashboard. Default state in brackets.
| Module | What it covers | Default |
|---|---|---|
| General | Info commands, help, ping, profiles | ✅ on |
| Moderation | Ban/kick/timeout/mute/purge/warn, AutoMod | ✅ on |
| Administration | Prefix, staff roles, log channels, toggles | ✅ on |
| Verification | Verify gate + setup | ✅ on |
| Welcoming | Welcome/farewell, auto-role, cards | ✅ on |
| Reaction Roles | Role menus | ✅ on |
| Economy | Wallet/bank/shop/inventory/auctions | ✅ on |
| Fun | 8-ball, memes, games, emotion, image, pets | ✅ on |
| Utility | Misc helpers (password, uuid, color…) | ✅ on |
| Developer | Owner-only diagnostics & data tools | ✅ on |
| Music | Voice playback | ✅ on (not yet implemented) |
| Leveling | XP, ranks, role rewards | ❌ off (in development) |
| Symbol | Meaning |
|---|---|
| 🟢 | Active |
| Very active (current focus) | |
| 🔵 | Beta |
| ⚪ | Alpha |
| 🟡 | Inactive |
| 🔴 | Discontinued |
| 🟣 | Unofficial / private |
| 🛟 | Life support (security fixes only) |
| ✅ / 🤖 / ❌ | Full / partial / no AI |
| ⚗️ | In progress |
| Core | Version(s) | Codename | Status | Engine | AI | Notes |
|---|---|---|---|---|---|---|
| — | v1.0.0 → 1.1.8 | Rootspawn | 🔴 | D.js 12.2.0 | ❌ | |
| — | v2.0.0 → 2.6.0 | Loopback | 🔴 | D.js 12.4.1 | ❌ | |
| — | v3.0.0 → 3.5.0 | EchoRun | 🛟 | D.js 12.5.2 | ❌ | |
| — | v4.0.0 → 4.1.2 | Neatline | 🔴 | D.js 12.5.3 | ❌ | |
| — | v5.0.0 | Ghostping | 🟡 | D.js 13.6.0 | ❌ | |
| — | v5.1.0 | Signalband | 🟢 | D.js 13.11.0 | ❌ | |
| — | v6.0.0 | Dataloom | 🔴 | D.js 13.14.0 | ❌ | |
| — | v6.1.0 | Protothype | 🔵 | D.js 14.9.0 | ✅ | |
| — | v7.0.0 | Cleancut | 🔴 | D.js 14.11.0 | ⚗️ | |
| Hex_1 | v9.0.0 → 9.0.6 | Stackflow | 🔴 | D.js 14.6.0 | ⚗️ | Deprecated in favor of Carbonkernel |
| Hex_2 | v10.0.1 | Carbonkernel | D.js 14.26 | ⚗️ | Current. Sapphire framework + Svelte dashboard + REST API | |
| Cranberry | x | Cranberry | 🟣 | D.js 14.14.1 | 🤖 | Private moderation bot for the Helix support server |
v9.0+ runs on Paperplane, a custom fork of Sapphire.
- 🌐 Website
- ➕ Add Helix to your server
- 💬 Support server — help, suggestions, and status updates
- 📖 In-bot help —
/helplists every command; the dashboard documents each settings page inline
Requires Bun ≥ 1.3.14 and a MongoDB database.
bun install # install bot dependencies
cp src/example.env .env # then fill in DISCORD_TOKEN, MONGO_URI, ...
bun run build # typecheck + compile to dist/
bun run start # run the botLive-reload bot:
bun run devbun run dev:allBoots the bot first, waits for its API, then boots the dashboard. Bot logs pass through untouched; dashboard lines are re-tagged TIMESTAMP - DASH - … (magenta). Ctrl+C stops everything.
To delete both dist/ folders, rebuild the bot and dashboard from clean, then launch both (so a broken compile fails before anything starts):
bun run dev:freshThe web dashboard lives in dashboard/ — a Svelte SPA served by a Bun server that handles Discord login and proxies the bot API.
bun run dashboard:install # install dashboard deps
bun run dashboard:dev # dev: Vite (5173) + Bun server (3000)
bun run dashboard:build # production frontend build
bun run dashboard:start # serve production buildConfigure via DASHBOARD_WEB_PORT, DASHBOARD_WEB_URL (e.g. https://dash.domain.tld), BOT_API_URL, plus DISCORD_CLIENT_ID / DISCORD_CLIENT_SECRET / SESSION_SECRET. Register {DASHBOARD_WEB_URL}/api/auth/callback as an OAuth2 redirect in the Discord developer portal. See dashboard/README.md.
Other useful scripts: bun run validate (pre-commit checks), bun run test, bun run create-module / delete-module (scaffold toggleable modules).
- Sapphire framework — bot architecture, MIT
- Paperplane — Helix's Sapphire fork
- discord.js — Discord API library
- Svelte — dashboard UI
GPL-3.0 — see LICENSE.