🏠 Introduction
Introduction
Welcome to the official documentation of Security Bot, a multi-purpose Discord bot built with Discord.js v14 that combines moderation, music, tickets, economy, leveling, giveaways, and a full web dashboard.
This guide covers every command, every feature, and the trickier parts of the bot — including the complete music player, the ticket system, the Premium features, the web dashboard, and the owner tools.
What makes Security Bot different
- 97+ global slash commands — every feature is a native Discord slash command. No prefixes, no conflicts.
- One consolidated
/musiccommand — the 16 music commands (play, queue, filters, volume...) are deployed as a single top-level command with 16 subcommands, which keeps the bot under Discord's 100-command limit while preserving every feature. - Full web dashboard — control the bot from your browser: live music player, ticket manager, server overview, Premium management.
- Music that survives restarts — the currently playing track and the queue are persisted to a database and automatically restored when the bot restarts.
- Live search suggestions — when you type a song in
/music play, the bot shows real YouTube suggestions as you type. - SQLite database — all data (warnings, economy, leveling, tickets, giveaways, premium subscriptions, playlists, AFK statuses, reminders, and much more) is stored locally in a single robust database.
- Modular command folders — commands are organized in
base,mod,premium, andownerfolders; new commands are auto-discovered and registered on startup.
Feature highlights
| Category | Features |
|---|---|
| Moderation | Kick, ban, unban, timeout, untimeout, warn system with auto-ban threshold, bulk clear, lock/unlock, channel access control, mass role management, voice move, nickname management, mod stats, anti-raid trap channel, verification, age verification, assistance requests |
| Music | Search & play from YouTube, play next, queue management, skip, stop, pause, resume, volume (0–200%), loop modes, 7 audio filters, shuffle, autoplay, 24/7 mode, lyrics, equalizer, saved playlists, radio, live dashboard |
| Tickets | Multi-panel ticket system (up to 3 panels per server), DM-based setup wizard, claim/unclaim, transcripts, log channel |
| Economy | Wallets, daily rewards with streaks, work, rob, leaderboards |
| Leveling | XP per message, level cards, leaderboards, role rewards, XP boost events |
| Giveaways | Normal, scheduled (recurring), and reaction-goal giveaways with reroll |
| Server tools | Embed sender, polls, counters, temp-voice "join to create" channels, role panels, welcome messages with custom Canvas images, auto-roles, suggestions, partnerships, anonymous confessions, community logging |
| Fun & utility | 8-ball, hangman, wordle, tic-tac-toe, rock-paper-scissors, dice, ship compatibility, reaction GIFs, memes, facts, quotes, emojify, translate, reminders, AFK, snipe, file sharing |
| Premium | Custom commands, music 24/7, equalizer, lyrics, playlists, radio, role rainbow, server clone, slowmode, boost rewards, birthdays, autopublish, stream notifications, tags, auto-threads, welcome templates, MOTD, activity tracking, exports, emoji manager, security audit, backups |
| Dashboard | Discord OAuth login, per-server control panel, live music workspace, ticket management, premium pages |
Bot identity
- Every embed is signed with the footer
danidema.xyz • <version>. - The version is read from the
BOT_VERSIONenvironment variable (defaultv5.0). - The bot's creator is danidema.xyz (
/ownercommand). - The public website (login for the dashboard) is
securitybot.k1wi.xyz.
Technology stack
| Component | Technology |
|---|---|
| Runtime | Node.js |
| Discord library | discord.js v14 |
| Database | SQLite (better-sqlite3) |
| Music extraction | yt-dlp (kept up to date automatically) |
| Web server | Express (dashboard + API + transcripts) |
| Auth | Discord OAuth2 |
| Payments | Stripe (Premium purchases) |
Documentation map
- Getting Started — how to invite the bot, required permissions, first steps.
- Commands Reference — the full list of every command, subcommand, and option.
- Music System — the complete music player reference, including the tricky details (filters, loop modes, autoplay, persistence, 24/7).
- Ticket System — panels, the setup wizard, claiming, transcripts.
- Moderation Commands — warnings, bans, clear, lock, and every moderation tool.
- Server Tools — embed, polls, counters, temp-voice, role panels, welcome system, and more.
- Fun & Utility Commands — economy, games, file sharing, API keys, and everything fun.
- Premium Features — what Premium unlocks and how to use each feature.
- Web Dashboard — login, pages, and the live music workspace.
- Owner Tools — maintenance, blacklist, error logs, and global settings.
- FAQ & Troubleshooting — common issues and their fixes.