A feature-rich Discord bot with a web dashboard for managing everything from automod to reaction roles. Built with discord.js v14, Express, and SQLite.
- 🤖 Automod — word filter, spam detection, mass-mention blocking, invite link blocking with configurable actions
- 🔒 Lockdown — lock/unlock channels instantly, bulk-lock all at once
- 🎭 Reaction Roles — users react to get roles, with unique and synced modes
- 🎫 Tickets — configurable support ticket system with panels, categories, and logging
- 📋 Commands —
/mod(kick, ban, timeout, unban),/clear(bulk delete),/lockdown,/automod,/reactionrole - 🚫 Autores — automatic keyword-triggered responses
- 🔢 Counting Game — members count together in a channel with milestone celebrations
- ⭐ Starboard — best messages get pinned to a star channel
- 🎁 Giveaways — timed giveaways with button entries and winner selection
- 📊 Surveys — button + modal surveys with response tracking
- 📌 Sticky Messages — messages that repost at configurable intervals
- 🔊 Temporary Channels — users join a trigger channel and get their own voice channel
- 📈 Live Stats — voice channels that display member, bot, online, and voice counts
- 👋 Welcome / Farewell — configurable join and leave messages
- 🎭 Auto-Roles — automatically assign roles to new members
- 📝 Logging — track member joins, leaves, kicks, bans, and message edits
- 🔔 Scheduled Announcements — timed embed messages
- 🛠️ Interactive Panel —
/panelopens a button-based management menu in chat - 🔍 Info Commands —
/ping,/avatar,/userinfo,/serverinfo,/help - 🔁 Autores — keyword-triggered automatic responses
All features are fully configurable through the web dashboard at http://127.0.0.1:3000:
- Toggle features on/off, configure channels, thresholds, and colors
- Automod: manage word lists, spam settings, case history
- Reaction roles: create messages, add/remove emoji-to-role mappings
- Lockdown: view locked channels, lock/unlock with one click
- Sticky messages: set, remove, configure intervals
- Surveys, giveaways, tickets, starboard, welcome, stats, and more
- discord.js v14 — Discord API wrapper
- Express — web dashboard server
- better-sqlite3 — SQLite database with WAL mode
- cookie-parser — dashboard session auth
src/
├── index.js # Client setup, intent config, startup
├── lib/
│ └── discord.js # discord.js re-export facade
├── commands/ # Slash commands (one file each)
│ ├── automod.js # /automod setup|toggle|word-add|...
│ ├── autoroles.js # /autoroles setup|disable
│ ├── avatar.js # /avatar
│ ├── clear.js # /clear
│ ├── counting.js # /counting setup|disable|emojis
│ ├── filter.js # /filter add|remove|list
│ ├── fun.js # /8ball, /joke
│ ├── giveaway.js # /giveaway create|end|reroll
│ ├── help.js # /help
│ ├── lockdown.js # /lockdown lock|unlock|status|list
│ ├── logging.js # /log setup|disable
│ ├── moderation.js # /mod kick|ban|unban|timeout
│ ├── panel.js # /panel (interactive management menu)
│ ├── ping.js # /ping
│ ├── reactionrole.js # /reactionrole create|add|remove|delete|list
│ ├── serverinfo.js # /serverinfo
│ ├── starboard.js # /starboard setup|disable
│ ├── stats.js # /stats setup|refresh|disable
│ ├── sticky.js # /sticky set|remove|list
│ ├── survey.js # /survey create|post|list|delete
│ ├── temp.js # /temp setup|name|limit|lock|unlock|claim|remove
│ ├── update.js # /update check
│ └── userinfo.js # /userinfo
├── events/ # Discord.js event handlers
│ ├── channelDelete.js # Clean up temp/stats data on channel delete
│ ├── clientReady.js # Bot startup: stats refresh, sticky timers, update check
│ ├── guildMemberAdd.js # Welcome messages, auto-roles
│ ├── interactionCreate.js # Routes slash commands, panel buttons, survey modals
│ ├── messageCreate.js # Counting game, autores, automod checks
│ ├── messageReactionAdd.js # Starboard, reaction role assign
│ ├── messageReactionRemove.js # Starboard, reaction role remove
│ └── voiceStateUpdate.js # Temporary channel creation + cleanup
├── panel/ # Web dashboard
│ ├── server.js # Express API + static file server
│ └── public/
│ ├── index.html # Dashboard HTML
│ ├── app.js # Dashboard frontend logic
│ └── style.css # Dashboard styles
├── utils/ # Feature modules
│ ├── announcements.js # Scheduled announcement logic
│ ├── automod.js # Word filter, spam detection, case logging
│ ├── autores.js # Keyword-triggered auto-responses
│ ├── autoroles.js # Auto-role assignment
│ ├── counting.js # Counting game state
│ ├── db.js # SQLite store (WAL, batched writes, saveKey())
│ ├── giveaways.js # Giveaway CRUD + winner selection
│ ├── handlers.js # Auto-loads commands and events
│ ├── lockdown.js # Channel lock/unlock with overwrite restore
│ ├── panel.js # Interactive panel view builders + access control
│ ├── reactionRoles.js # Reaction role CRUD + reaction handlers
│ ├── register.js # Slash command registration
│ ├── starboard.js # Starboard config + threshold logic
│ ├── stats.js # Live stats channel management
│ ├── sticky.js # Sticky message CRUD + timer management
│ ├── surveys.js # Survey CRUD + response handling
│ ├── temp.js # Temporary voice channel lifecycle
│ ├── tickets.js # Ticket system
│ ├── updater.js # Version check + log channel
│ └── welcome.js # Welcome/farewell message builder
└── data/
└── store.db # SQLite database (auto-migrates from store.json)
- Node.js 18+
- A Discord bot application with these intents enabled:
- Server Members, Message Content, Voice State, Presence, Guild Messages, Guild Message Reactions
- Invite with the
applications.commandsscope and permissions:- Manage Channels, Manage Messages, Moderate Members, Move Members, View Channel, Send Messages
-
Clone the repository
git clone https://github.com/WollyDev24/Monolith cd Monolith -
Install dependencies
npm install
-
Configure environment
cp .env.example .env
Fill in your
.env:TOKEN=your-bot-token-hits here CLIENT_ID=your-application-id-here GUILD_ID=optional-guild-id-for-quick-registration GEMINI_API_KEY=your-gemini-key OWNER_ID=your-discord-user-id PANEL_PASSWORD=admin PANEL_HOST=127.0.0.1 PANEL_PORT=3000GUILD_IDis optional — commands register instantly with it; omit it for global registration (takes up to an hour).The AI features fail silently when these are missing: without
GEMINI_API_KEYthe bot ignores AI messages entirely, and without anOWNER_IDit can read memories but every write is refused. The bot prints a warning on startup if the AI is enabled somewhere and either is unset, so check the console after deploying. See.env.examplefor the full list, including the optional Discord OAuth and panel settings.To spread requests across several keys, or to survive one being rate limited, add them with a numeric suffix:
GEMINI_API_KEY1=first-key GEMINI_API_KEY2=second-key GEMINI_API_KEY3=third-keyThere is no fixed limit. Requests rotate between the keys, and a key that is rate limited or rejected is sidelined while the others keep serving. The plain
GEMINI_API_KEYstill works on its own and is tried last. -
Run
npm start # production npm run dev # auto-reload on code changes
The bot serves a local web dashboard at http://127.0.0.1:3000 (default
password: admin).
From the panel you can:
- View live bot status (ping, uptime, guilds, members)
- Pick any server the bot is in
- Configure all features without touching code:
- Temporary channels, stats, welcome/farewell, auto-roles
- Counting game, starboard, giveaways, surveys, sticky messages
- Automod (word filter, spam, mass mention, invite blocking)
- Reaction roles, tickets, lockdown, logging, announcements
- Command toggles, panel role restriction
- Re-register slash commands instantly
Contributions are welcome! Please feel free to submit a pull request.
- Fork the repository
- Create your feature branch:
git checkout -b feature/AmazingFeature - Commit your changes:
git commit -m 'Add some AmazingFeature' - Push to the branch:
git push origin feature/AmazingFeature - Open a pull request
This project is licensed under the Apache 2.0 License — see the LICENSE file for details.
Made with ❤️ by WollyDev24