🤖 Logiq - Open Source Discord Bot

The Open-Source Alternative to MEE6

A feature-rich, fully open-source Discord bot with all the premium features you need - completely free! Built by Programmify and the open-source community.

🌟 Star this repo if you find it useful!

🚀 Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Setup Environment

Create .env file:

DISCORD_BOT_TOKEN=your_discord_bot_token
MONGODB_URI=mongodb://localhost:27017
ENVIRONMENT=development

3. Run Bot

python main.py

✨ Complete Feature List (MEE6 Alternative)

🔐 Verification System

Welcome channel messages - Public welcome for all new members
DM or Channel verification - Flexible verification methods
Verify channel support - Dedicated verification channel
Silent role assignment - No spam in chat
Custom welcome messages - Personalized greetings
Button or CAPTCHA - Multiple verification types

🎮 Interactive Games

Dice Roll - Roll dice with buttons
Coinflip - Heads or tails betting
Trivia - 15+ questions with rewards
8-Ball - Magic 8-ball predictions
Earn currency - Win coins from games
Admin Setup - Deploy game panel with one command

🎫 Advanced Ticket System

Persistent buttons - Always-available ticket creation
User-specific - Private channels for each user
Permission-based - Only owner/staff can close
Ticket logging - Dedicated log channel
Active tickets view - See all open tickets
Auto-deletion - Channels deleted after closing

🎭 Role Management (FORM-BASED!)

Easy form setup - Create role menus with a Discord form
Auto emoji & name - Uses role's actual emoji and name
Custom title & description - Fully customizable embed
Exclusive roles (LOCKED) - Pick one role, cannot change unless leave/rejoin
Auto channel access - Selecting role grants access to role's channels
Multi-select - Choose multiple roles
Beautiful dropdowns - User-friendly interface

💰 Economy System

Virtual currency - Server-specific economy
Daily rewards - Claim daily coins
Transfers - Give coins to other users
Balance tracking - View balances
Admin management - Add/remove currency
Shop system - Create custom shop items

📊 Leveling System

XP on messages - Earn XP by chatting
Level up rewards - Automatic level announcements
Rank cards - Beautiful rank displays
Leaderboards - Server-wide rankings
Admin controls - Set levels manually
Cooldown system - Prevent spam

🛡️ Advanced Moderation

Warn system - Track user warnings
Timeout - Temporary mutes
Kick & Ban - Standard moderation
Auto-moderation - Spam detection
Message clearing - Bulk delete messages
Slowmode - Set channel slowmode
Lock/Unlock - Lock channels
Nickname management - Change nicknames
Infraction tracking - View all warnings

🎁 Giveaway System

Button-based entry - Easy participation
Multiple winners - Support for multiple winners
Auto-selection - Random winner picking
Reroll support - Reroll winners
End early - Manual giveaway ending
Participant tracking - Track all entries

🎵 Music Player

Join/Leave - Voice channel control ✅
Queue system - Music queue management ✅
Pause/Resume - Playback controls ✅
Skip - Skip current track ✅
Volume control - Adjust volume ✅
Play music - Ready for yt-dlp integration (requires: pip install yt-dlp PyNaCl + FFmpeg)

📢 Social Alerts

Alert management - Add/remove/list alerts ✅
Test alerts - Preview notifications ✅
Custom channels - Choose notification channels ✅
Multi-platform - Support for Twitch/YouTube/Twitter ✅
Live checking - Automatic monitoring (requires API keys in .env):
- Twitch: TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET
- YouTube: YOUTUBE_API_KEY
- Twitter: TWITTER_BEARER_TOKEN

🔊 Temporary Voice Channels

Auto-creation - Join to create channel
Auto-deletion - Delete when empty
Owner controls - Lock, unlock, rename
User limits - Set max users
Claim ownership - Take over abandoned channels
Category-based - Organized structure

🔧 Utility Commands

Polls - Interactive voting with buttons
Reminders - Set timed reminders
Server stats - Detailed server information
User info - View user details
Avatar - Get user avatars
Embeds - Create custom embeds

📈 Analytics

Message tracking - Track message activity
Join/leave analytics - Monitor member changes
Activity monitoring - Server engagement metrics
Event logging - Comprehensive event logs

🗄️ Database Setup

MongoDB Atlas (Recommended)

Sign up at https://www.mongodb.com/cloud/atlas
Create free cluster
Get connection string
Update .env:

MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/logiq

🚂 Deploy to Railway

1. Push to GitHub

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourusername/logiq.git
git push -u origin main

2. Deploy to Railway

Go to https://railway.app
Login with GitHub
Click "New Project" → "Deploy from GitHub repo"
Select your repository
Add MongoDB plugin: Click "New" → "Database" → "MongoDB"
Add environment variables:

DISCORD_BOT_TOKEN=your_token
MONGODB_URI=${{MongoDB.MONGO_URL}}
ENVIRONMENT=production

Deploy!

🎮 Commands

👥 PUBLIC COMMANDS (Users can use)

/rank [user] - View rank card
/balance [user] - Check balance
/leaderboard - View server leaderboard

🔧 ADMIN COMMANDS (Administrators only)

Verification

/setup-verification <role> <welcome_channel> <method> [verify_channel] [type] - Setup verification system
- method: Choose 'dm' or 'channel' (REQUIRED)
- verify_channel: Required if method is 'channel'
- Example DM: /setup-verification @Verified #welcome dm button
- Example Channel: /setup-verification @Verified #welcome channel #verify button
/set-welcome-message <message> - Custom welcome message
/send-verification - Send verification button

Tickets

/ticket-setup <category> <log_channel> [role] - Setup ticket system with logging
/ticket-panel - Deploy ticket creation button
/tickets - View all active tickets
/close-ticket [reason] - Close ticket

Games

/setup-game-panel - Deploy all game buttons

Roles (FORM-BASED!)

/create-role-menu [channel] - Opens a form to create role menu!
- Fill in title, description, and mention roles with @
- Discord auto-completes role names when you type @
- Choose exclusive (pick one) or multi-select
- Automatically creates beautiful dropdown menu for users
/addrole <user> <role> - Add role to user
/removerole <user> <role> - Remove role from user

Economy

/addbalance <user> <amount> - Add balance
/daily - Claim daily reward
/give <user> <amount> - Transfer currency
/shop - View shop

Leveling

/setlevel <user> <level> - Set user level
/resetlevels - Reset all levels

Giveaways

/giveaway <prize> <duration> [winners] - Start a giveaway
/gend <message_id> - End giveaway early
/greroll <message_id> - Reroll giveaway winners

Music

/play <query> - Play music from YouTube
/join - Join voice channel
/leave - Leave voice channel
/pause - Pause music
/resume - Resume music
/skip - Skip current track
/queue - View music queue
/nowplaying - Show current track
/volume <level> - Set volume (0-100)

Social Alerts

/alert-add <platform> <username> <channel> - Add social alert
/alert-remove <platform> <username> - Remove alert
/alert-list - List all alerts
/alert-test <platform> <username> - Test alert

Temporary Voice

/setup-tempvoice <category> [creator_name] - Setup temp voice channels
/voice-lock - Lock your temp channel
/voice-unlock - Unlock your temp channel
/voice-limit <limit> - Set user limit
/voice-rename <name> - Rename your temp channel
/voice-claim - Claim ownership of temp channel

Utility

/poll <question> <options> - Create poll
/remind <duration> <message> - Set reminder
/serverstats - Server statistics
/userinfo [user] - User information
/avatar [user] - Get avatar

Analytics

/analytics [days] - View analytics
/activity - Recent activity

Admin

/botinfo - Bot information
/config - View configuration
/modules - Module status
/reload <cog> - Reload cog
/sync - Sync commands
/setlogchannel <channel> - Set log channel

🛡️ MODERATOR COMMANDS

/warn <user> <reason> - Warn user
/warnings <user> - View warnings
/timeout <user> <duration> [reason] - Timeout user
/kick <user> [reason] - Kick user
/ban <user> [reason] [delete_messages] - Ban user
/unban <user_id> - Unban user
/clear <amount> [user] - Clear messages
/slowmode <seconds> - Set slowmode
/lock [channel] - Lock channel
/unlock [channel] - Unlock channel
/nickname <user> [nickname] - Change nickname

🎭 How to Create Role Menus (SUPER EASY!)

Step 1: Run the command

/create-role-menu

Step 2: Fill in the form

A Disc

Logiq

Install / Use

README