codebymitch /TitanBot

A powerful, all-in-one Discord assistant built for every server.

★ 9,613⑂ 15,252👁 14⑃ 211● 29▤ 5
JavaScriptMITCreated 2026-01-30discord.gg/QnWNz2dKCE
Download: v3.0.0v3.0.0 ↓3.0.02026-07-13
+24
Daily
9,613
stars
15,252
forks
14
watchers
211
prs
29
issues
5
releases

README

TitanBot - Ultimate Discord Bot

TitanBot is a powerful, feature-rich Discord bot designed to enhance your server experience with comprehensive moderation tools, engaging economy systems, utility features, and much more. Built with modern Discord.js v14 and PostgreSQL for optimal performance and data persistence.



!PostgreSQL

 Table of Contents

- Features Overview
- Quick Setup
- Manual Installation Steps
- Support Server
- Required Bot Intents
- Contributing


 Features Overview

TitanBot offers a complete suite of tools for Discord server management and community engagement:





 Moderation & Administration
- Mass Actions - Bulk ban/kick capabilities
- User Notes - Keep detailed moderation records
- Case Management - View and track all mod actions

 Economy System
- Shop & Inventory - Buy and manage items
- Gambling - Risk it for rewards
- Pay System - Transfer money between users

 Fun & Entertainment
- Random Facts - Learn something new
- Wanted Poster - Create fun wanted images
- Text Reversal - Reverse any text

 Advanced Ticket System
- Claim & Priority - Staff ticket management
- Ticket Limits - Prevent spam
- Transcript System - Save ticket history

 Server Stats
- Member Counter - Live member count channels
- Voice Counters - Track voice stats
- Dynamic Updates - Real-time channel updates

 Reaction Roles
- Role Assignment - Self-assignable roles
- Emoji Selection - Reaction-based system
- Multi-role Support - Multiple role options




 Leveling & XP System
- XP Tracking - Automatic message-based XP
- Level Roles - Auto-assign roles by level
- Custom Configuration - Personalize leveling

 Giveaways & Events
- Multiple Winners - Support multi-winner giveaways
- Auto Picking - Automatic winner selection
- Reroll System - Pick new winners if needed

 Birthday System
- Birthday Tracking - Never miss a birthday
- Auto Announcements - Celebrate automatically
- Timezone Support - Accurate worldwide tracking

 Utility Tools
- Report System - Report issues to staff
- Todo Lists - Personal task management
- First Message - Jump to channel's first message

 Welcome System
- Welcome Messages - Greet new members
- Auto Roles - Assign roles on join
- Custom Embeds - Personalized messages
  
 Music
- 24/7 Mode - Play music 24/7
- Interative Button System - Manage music through buttons
- Supports EVERY platform - Supports spotify, deezer, youtube, apple music
  





 Quick Setup (Recommended for non-coders)

 Video Tutorial
For a detailed step-by-step setup guide, watch our comprehensive video tutorial:
TitanBot Setup Tutorial

 Docker Deployment (Recommended)

TitanBot is fully containerized for easy deployment.

1. Clone the repository:
   bash
   git clone https://github.com/codebymitch/TitanBot.git
   cd TitanBot
   

2. Configure environment variables:
   bash
   cp .env.example .env
   
   Set at minimum DISCORD_TOKEN, CLIENT_ID, and GUILD_ID. Docker Compose also reads POSTGRES_USER, POSTGRES_PASSWORD, and POSTGRES_DB from .env (defaults: t

Top issues

Discussions

Latest release

v3.0.0 v3.0.0 2026-07-13
This release is a major stability and architecture update: a full codebase restructure, Lavalink music playback, stronger dashboard and ticket systems, database key migration, and several command and logging fixes.

 What's New

 Music Playback
- Lavalink v4 integration via Riffy for Spotify, YouTube, Deezer, Apple Music, and more
- New commands:
  - /play
  - /join
  - /queue
  - /nowplaying
  - /music with playback controls (pause, resume, skip, shuffle, loop, volume, seek, 24/7 mode)
- Interactive music player buttons for queue and playback management
- Prefix shortcuts for com

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON