🌌 Lost Dimension Bot

An all-in-one moderation, security, and utility bot for Discord

---

About

Lost Dimension Bot is a full-featured moderation and security bot built for the Lost Dimension Discord community. It combines standard moderation tools with advanced features like a jail system, interactive setup wizards, ticket support, self-roles, giveaways, and persistent warning/note logs backed by MongoDB.

Features

Moderation

• Ban, kick, softban, mass-ban (by ID list)
• Timeout / remove timeout
• Server mute, deafen, and their reverses
• Warning system with add/remove/list/clear and persistent history
• Moderator notes on members
• Message purge (bulk delete)
• Channel lock / unlock and slowmode control
• Jail system — strips roles and confines a member to a jail channel, with release/restore

Security & Logging

• Full audit-log event tracking (guildAuditLogEntryCreate)
• Message edit/delete logging with snipe command to view the last deleted message
• Member join/leave, ban add/remove, avatar and nickname change tracking
• Voice state update logging
• Automatic nickname enforcement via configurable listener channel

Community Tools

• Ticket system with panel setup and handler
• Self-role panel management
• Giveaway management
• Interactive setup wizard for configuring channels
• Server / user / role / channel info commands

Infrastructure

• Slash-command based (Discord.js v14)
• MongoDB persistence layer for warnings, notes, and configuration
• Built-in Express web server (for uptime monitoring / hosting platforms that require an open port)
• Docker-ready

Commands

Category	Commands
Moderation	/ban /kick /softban /massban /mute /unmute /deafen /undeafen /timeout /removetimeout /jail /unjail /warn /warnings /warnlist /removewarn /clearwarns /note /purge /lock /unlock /slowmode
Info	/userinfo /serverinfo /roleinfo /channelinfo /botinfo /av /snipe
Community	/ticket-setup /selfrole /giveaway /nick /role
Setup	/setup /nickname-setup
Utility	/ping /help

Run /help in Discord for an interactive breakdown of every command.

Setup

Prerequisites

• Node.js v18 or higher
• A MongoDB database (Atlas free tier works fine)
• A Discord Application/Bot with the Server Members and Message Content privileged intents enabled

Installation

git clone https://github.com/your-username/lost-dimension-bot.git
cd lost-dimension-bot
npm install

Copy the example environment file and fill in your credentials:

cp .env.example .env

TOKEN=your_discord_bot_token_here
MONGODB_URI=your_mongodb_connection_string_here

Run

node index.js

Docker (optional)

docker build -t lost-dimension-bot .
docker run -d --env-file .env -p 7860:7860 lost-dimension-bot

Project Structure

lost-dimension-bot/
├── commands/       # All slash commands
├── events/         # Discord event listeners (audit log, member updates, tickets, etc.)
├── utils/          # Database connection & logging utilities
├── index.js        # Bot entry point + command/event loader
├── Dockerfile
└── .env.example

Contributing

Issues and pull requests are welcome. If you're proposing a larger change, please open an issue first to discuss what you'd like to change.

📄 License

Distributed under the MIT License. See LICENSE for details.

---

Built by DieBack Theatre~~~Faysal