# Alpha Discord Bot A fully-featured, production-ready Discord bot built with Node.js v20 and discord.js v14. ## Features ### 🎵 Music System - Play songs from YouTube - Queue management - Pause, resume, skip, and stop controls - Auto-disconnect when voice channel is empty - Display now playing and queue information ### 🎉 Giveaway System - Create timed giveaways with multiple winners - Persistent storage with MongoDB - Automatic winner selection - Reroll and early end options - Reaction-based entry system ### 🛡️ Moderation - Ban, kick, timeout, and unban commands - Bulk message deletion (clear command) - Basic anti-link protection - Basic anti-spam protection - Permission-based access control ### ⚙️ Utility - Dynamic help command - Ping and uptime monitoring - Detailed server information - User information with roles ### 🎫 Ticket System - Button-based ticket creation - Automatic private channel creation - Close ticket with auto-delete - Permission-based access ## Installation ### Prerequisites - Node.js v20 or higher - MongoDB database - Discord Bot Token ### Setup Steps 1. **Clone or download the project** 2. **Install dependencies** ```bash npm install ``` 3. **Configure environment variables** Create a `.env` file in the root directory: ```env DISCORD_TOKEN=your_bot_token_here CLIENT_ID=your_application_id_here MONGODB_URI=mongodb://localhost:27017/alphabot PREFIX=! OWNER_ID=your_discord_user_id ``` 4. **Get your bot token** - Go to [Discord Developer Portal](https://discord.com/developers/applications) - Create a new application - Go to the "Bot" section - Click "Reset Token" and copy it - Paste it in your `.env` file 5. **Get your Client ID** - In the Discord Developer Portal - Go to "OAuth2" → "General" - Copy the "Client ID" - Paste it in your `.env` file 6. **Setup MongoDB** - Install MongoDB locally or use MongoDB Atlas (cloud) - Update the `MONGODB_URI` in your `.env` file 7. **Invite the bot to your server** Use this URL (replace CLIENT_ID with your actual client ID): ``` https://discord.com/api/oauth2/authorize?client_id=CLIENT_ID&permissions=8&scope=bot%20applications.commands ``` Required Bot Permissions: - Administrator (or specific permissions below) - Manage Channels - Manage Messages - Ban Members - Kick Members - Moderate Members - Send Messages - Embed Links - Attach Files - Read Message History - Add Reactions - Connect to Voice - Speak in Voice Required Intents (already configured): - Guilds - GuildMessages - MessageContent - GuildMembers - GuildVoiceStates - GuildMessageReactions - GuildModeration 8. **Start the bot** ```bash npm start ``` For development with auto-reload: ```bash npm run dev ``` ## Project Structure ``` alpha-discord-bot/ ├── src/ │ ├── commands/ │ │ ├── music/ │ │ │ ├── play.js │ │ │ ├── pause.js │ │ │ ├── resume.js │ │ │ ├── skip.js │ │ │ ├── stop.js │ │ │ └── queue.js │ │ ├── giveaway/ │ │ │ ├── create.js │ │ │ ├── reroll.js │ │ │ └── end.js │ │ ├── moderation/ │ │ │ ├── ban.js │ │ │ ├── kick.js │ │ │ ├── timeout.js │ │ │ ├── unban.js │ │ │ └── clear.js │ │ ├── utility/ │ │ │ ├── help.js │ │ │ ├── ping.js │ │ │ ├── uptime.js │ │ │ ├── serverinfo.js │ │ │ └── userinfo.js │ │ └── ticket/ │ │ └── setup.js │ ├── events/ │ │ ├── ready.js │ │ ├── interactionCreate.js │ │ ├── messageCreate.js │ │ └── voiceStateUpdate.js │ ├── handlers/ │ │ ├── commandHandler.js │ │ └── eventHandler.js │ ├── models/ │ │ ├── Giveaway.js │ │ ├── Ticket.js │ │ └── Settings.js │ ├── utils/ │ │ ├── musicPlayer.js │ │ ├── giveawayManager.js │ │ ├── ticketManager.js │ │ ├── embedBuilder.js │ │ └── logger.js │ ├── config.js │ └── index.js ├── .env ├── .env.example ├── .gitignore ├── package.json └── README.md ``` ## Commands List ### Music Commands - `/play ` - Play a song from YouTube - `/pause` - Pause the current song - `/resume` - Resume the paused song - `/skip` - Skip the current song - `/stop` - Stop music and clear queue - `/queue` - View the music queue ### Giveaway Commands (Requires Manage Server) - `/giveaway ` - Create a giveaway - `/greroll ` - Reroll a giveaway - `/gend ` - End a giveaway early ### Moderation Commands - `/ban [reason]` - Ban a member - `/kick [reason]` - Kick a member - `/timeout [reason]` - Timeout a member - `/unban [reason]` - Unban a user - `/clear [user]` - Delete messages ### Utility Commands - `/help` - Show all commands - `/ping` - Check bot latency - `/uptime` - Check bot uptime - `/serverinfo` - Get server information - `/userinfo [user]` - Get user information ### Ticket Commands (Requires Administrator) - `/ticket-setup ` - Setup ticket system ## Hosting ### Recommended Hosting Options 1. **VPS (Virtual Private Server)** - DigitalOcean - Linode - Vultr 2. **Pterodactyl Panel** - Optimized for game servers and Discord bots - Easy management interface 3. **Free Options (Limited)** - Railway.app - Render.com - Replit (not recommended for production) ### Deployment Tips - Use PM2 for process management - Set up automatic restarts - Configure proper logging - Use environment variables for sensitive data - Keep dependencies updated ## Support & Troubleshooting ### Common Issues **Bot not responding to commands:** - Check if bot has proper permissions - Verify token is correct - Ensure all intents are enabled in Discord Developer Portal - Check MongoDB connection **Music not playing:** - Verify bot has Connect and Speak permissions - Check if voice channel is not full - Ensure FFmpeg is installed (installed with dependencies) **Giveaways not ending:** - Check MongoDB connection - Verify bot is running continuously - Check bot's system time is correct **Commands not showing up:** - Wait a few minutes (global commands take time) - Check CLIENT_ID is correct - Verify bot has applications.commands scope ## License MIT License - Feel free to use and modify ## Credits Built with: - discord.js v14 - Node.js v20 - MongoDB (Mongoose) - @discordjs/voice - play-dl - And other amazing packages