🤖 Advanced Discord Bot

A feature-rich Discord bot with advanced leveling, RPG mechanics, music playback, and moderation tools. Built with TypeScript and Discord.js v14.

💬 Need help? Join our Discord community!
🔗 https://discord.gg/a3tGyAwVRc

✨ Features

🎵 Music System - Discord Music Bot

YouTube Integration: Play from URLs or search queries
Spotify Support: Direct Spotify track and playlist playback
Queue Management: Advanced queue with shuffle and loop
Voice Controls: Skip, pause, resume, and volume control
High-Quality Audio: FFmpeg integration for optimal sound

🏆 Leveling System - Discord XP Bot

Message XP: Earn XP for every message sent
Voice XP: Bonus XP for time spent in voice channels
Level Progression: 100 XP per level with exponential scaling
Anti-Spam Protection: Prevents XP farming
Leaderboards: Server-wide and global rankings
Profile Cards: Beautiful level display with avatars

🎭 RPG System - Discord RPG Bot

4 Character Classes: Warrior, Mage, Archer, Priest
6 Core Stats: Strength, Dexterity, Intelligence, Vitality, Wisdom, Charisma
Adventure System: Explore dungeons and battle enemies
Equipment System: Weapons, armor, and accessories
Training System: Improve specific stats
Daily Rewards: Claim daily bonuses and rest periods

🛡️ Moderation Tools - Discord Mod Bot

Auto-Moderation: Anti-spam and raid protection
User Management: Ban, kick, mute, and warn commands
Logging System: Comprehensive action logging
Verification System: Role-based verification
Anti-Raid: Automatic raid detection and response

🎮 Fun & Games - Discord Game Bot

Wordle: Classic word guessing game
Hangman: Interactive hangman with custom words
Tic-Tac-Toe: Multiplayer tic-tac-toe
Trivia: Quiz system with multiple categories
Would You Rather: Interactive polls
Ship Calculator: Relationship compatibility

🛠️ Utility Commands - Discord Bot Utilities

Translation: Multi-language translation support
Weather: Real-time weather information
Calculator: Advanced mathematical operations
Reminder System: Set and manage reminders
Webhook Management: Create and manage webhooks
Server Analytics: Detailed server statistics

📊 Information Commands - Discord Bot Info

User Profiles: Detailed user information and statistics
Server Info: Comprehensive server analytics
Bot Statistics: Performance and usage metrics
Avatar Display: High-quality avatar viewing

🚀 Quick Start - Discord Bot Setup

Prerequisites

Node.js 18.0.0 or higher
npm or yarn package manager
Discord Bot Token

🪟 Windows Installation

Download and extract the Discord bot files
Double-click start-bot-manager.bat
Follow the prompts to configure your Discord bot
Start your bot with npm start

🐧 Linux/Mac Installation

Download and extract the Discord bot files
Open terminal in the bot directory
Make setup script executable: chmod +x setup.sh
Run the setup script: ./setup.sh
Edit the .env file with your Discord bot token
Start your bot with npm start

Troubleshooting:

If you get permission errors, try: chmod +x setup.sh
If npm install fails, try: sudo apt update && sudo apt install build-essential
For voice features, you may need: sudo apt install ffmpeg

Manual Setup

Clone the repository

git clone https://github.com/M1tsumi/DiscordDemo.git
cd DiscordDemo

Install dependencies
```
npm install
```
Set up environment variables
```
cp env.template .env
```
Edit .env with your configuration (see Configuration section below)
Build the project
```
npm run build
```
Start the Discord bot
```
npm start
```

Development Mode

For development with auto-restart:

npm run dev

⚙️ Configuration - Discord Bot Settings

Environment Variables (.env)

# Required: Discord Bot Token
DISCORD_TOKEN=your_discord_bot_token_here

# Optional: Spotify API (for enhanced music features)
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret

# Optional: YouTube API (for enhanced video features)
YOUTUBE_API_KEY=your_youtube_api_key

Bot Permissions

Your Discord bot needs the following permissions:

Send Messages
Manage Messages
Embed Links
Attach Files
Use External Emojis
Add Reactions
Connect (for voice features)
Speak (for voice features)
Use Voice Activity
Ban Members (for moderation)
Kick Members (for moderation)
Manage Roles (for moderation)

🔧 CRITICAL: Discord Bot Intents Configuration

To fix the "disallowed intents" error, you MUST enable these intents in your Discord application:

Go to https://discord.com/developers/applications
Select your bot application
Go to "Bot" section in the left sidebar
Scroll down to "Privileged Gateway Intents"
Enable ALL THREE intents:
- ✅ PRESENCE INTENT
- ✅ SERVER MEMBERS INTENT
- ✅ MESSAGE CONTENT INTENT
Click "Save Changes"

🛠️ Troubleshooting - Common Discord Bot Issues

❌ "Disallowed Intents" Error

Error Message: used disallowed intents at websocketshard connection.onclose

Solution:

Go to https://discord.com/developers/applications
Select your bot application
Go to "Bot" section
Enable all three Privileged Gateway Intents:
- ✅ PRESENCE INTENT
- ✅ SERVER MEMBERS INTENT
- ✅ MESSAGE CONTENT INTENT
Click "Save Changes"
Restart your bot

❌ "Invalid Token" Error

Error Message: Invalid token

Solution:

Check your .env file has the correct token
Get a fresh token from Discord Developer Portal
Make sure there are no extra spaces or characters
Verify the token is copied correctly

❌ "Cannot find module" Error

Error Message: Cannot find module './dist/index.js'

Solution:

Run npm run build to compile TypeScript
Make sure the dist folder exists
Check that all dependencies are installed: npm install

❌ Permission Errors (Linux)

Error Message: Permission denied

Solution:

chmod +x setup.sh
chmod +x start-linux.sh

❌ Voice Features Not Working

Error Message: FFmpeg not found

Solution:

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# CentOS/RHEL
sudo yum install ffmpeg

# macOS
brew install ffmpeg

❌ Node.js Version Issues

Error Message: SyntaxError: Unexpected token

Solution:

Update Node.js to version 18 or higher
Download from: https://nodejs.org/
Verify with: node --version

❌ Environment Variables Not Loading

Error Message: DISCORD_TOKEN is not set

Solution:

Make sure .env file exists in the root directory
Check the file format (no spaces around =)
Restart the bot after editing .env

❌ Build Errors

Error Message: TypeScript compilation errors

Solution:

Clear build cache: rm -rf dist/
Reinstall dependencies: rm -rf node_modules && npm install
Rebuild: npm run build

❌ Runtime Errors

Error Message: Various runtime errors

Solution:

Check Discord status: https://status.discord.com/
Verify bot permissions in servers
Check console for specific error messages
Try development mode: npm run dev

📋 Commands - Discord Bot Commands

🎵 Music Commands

!play <url/query> - Play music from YouTube or Spotify
!queue - Display current music queue
!skip - Skip current song
!stop - Stop playback and clear queue

🏆 Leveling Commands

!profile-level - View your leveling profile
!leaderboard-level - View server leveling rankings
!rank - View your rank and top users

🎭 RPG Commands

!create - Create your RPG character
!profile-rpg - View your RPG character profile
!adventure - Start an adventure in dungeons
!train - Train your character stats
!daily - Claim daily rewards
!rest - Restore HP, Mana, and Stamina
!leaderboard-rpg - View RPG rankings
!rank-rpg - View your RPG rank

🛡️ Moderation Commands

!ban <user> [reason] - Ban a user
!kick <user> [reason] - Kick a user
!mute <user> [duration] [reason] - Mute a user
!warn <user> [reason] - Warn a user
!purge <amount> - Delete multiple messages

🎮 Fun Commands

!wordle - Play Wordle
!hangman - Play Hangman
!tictactoe <@user> - Play Tic-Tac-Toe
!trivia - Start a trivia game
!joke - Get a random joke
!meme - Get a random meme
!quote - Get an inspirational quote

🛠️ Utility Commands

!translate <text> - Translate text
!weather <city> - Get weather information
!calculator <expression> - Calculate math expressions
!reminder <time> <message> - Set a reminder
!help - View all commands

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

Fork the repository
Install dependencies: npm install
Set up environment: cp env.template .env
Start development: npm run dev

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

💬 Need help? Join our Discord community!
🔗 https://discord.gg/a3tGyAwVRc

Discord: @quefep
Issues: GitHub Issues
Documentation: See README.md

🔄 Updates

Stay updated with the latest features and bug fixes by checking our releases regularly.

Last Updated: December 2024

Developed by quefep! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 46 Commits
.github/workflows		.github/workflows
data		data
src		src
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
env.template		env.template
fix-all-imports.ps1		fix-all-imports.ps1
fix-broken-imports.ps1		fix-broken-imports.ps1
fix-imports.ps1		fix-imports.ps1
package.json		package.json
requirements.txt		requirements.txt
setup.sh		setup.sh
start-bot-manager.bat		start-bot-manager.bat
start-linux.sh		start-linux.sh
troubleshoot.bat		troubleshoot.bat
troubleshoot.sh		troubleshoot.sh
tsconfig.json		tsconfig.json

License

M1tsumi/DiscordDemo

Folders and files

Latest commit

History

Repository files navigation

🤖 Advanced Discord Bot

✨ Features

🎵 Music System - Discord Music Bot

🏆 Leveling System - Discord XP Bot

🎭 RPG System - Discord RPG Bot

🛡️ Moderation Tools - Discord Mod Bot

🎮 Fun & Games - Discord Game Bot

🛠️ Utility Commands - Discord Bot Utilities

📊 Information Commands - Discord Bot Info

🚀 Quick Start - Discord Bot Setup

Prerequisites

🪟 Windows Installation

🐧 Linux/Mac Installation

Manual Setup

Development Mode

⚙️ Configuration - Discord Bot Settings

Environment Variables (.env)

Bot Permissions

🔧 CRITICAL: Discord Bot Intents Configuration

🛠️ Troubleshooting - Common Discord Bot Issues

❌ "Disallowed Intents" Error

❌ "Invalid Token" Error

❌ "Cannot find module" Error

❌ Permission Errors (Linux)

❌ Voice Features Not Working

❌ Node.js Version Issues

❌ Environment Variables Not Loading

❌ Build Errors

❌ Runtime Errors

📋 Commands - Discord Bot Commands

🎵 Music Commands

🏆 Leveling Commands

🎭 RPG Commands

🛡️ Moderation Commands

🎮 Fun Commands

🛠️ Utility Commands

🤝 Contributing

Development Setup

📄 License

🆘 Support

🔄 Updates

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Uh oh!

Languages