# BoneMC Discord Bot - Complete Setup Guide ## Prerequisites - Node.js 16.9.0 or higher - A Discord Bot account - Access to your Minecraft server (for RCON) ## Step 1: Install Dependencies ```bash npm install ``` ## Step 2: Create Discord Bot 1. Go to [Discord Developer Portal](https://discord.com/developers/applications) 2. Click "New Application" and give it a name 3. Go to "Bot" section and click "Add Bot" 4. Under "Privileged Gateway Intents", enable: - Presence Intent - Server Members Intent - Message Content Intent 5. Copy your bot token (keep it secret!) 6. Go to "OAuth2" > "URL Generator" 7. Select scopes: `bot` and `applications.commands` 8. Select permissions: - Administrator (or select specific permissions) 9. Copy the generated URL and invite bot to your server ## Step 3: Configure Environment Variables 1. Copy `.env.example` to `.env`: ```bash cp .env.example .env ``` 2. Edit `.env` with your values: ```env DISCORD_TOKEN=your_bot_token_here CLIENT_ID=your_bot_application_id GUILD_ID=your_discord_server_id MINECRAFT_SERVER_IP=play.bonemc.net MINECRAFT_SERVER_PORT=25565 RCON_HOST=localhost RCON_PORT=25575 RCON_PASSWORD=your_rcon_password DATABASE_TYPE=json ADMIN_ROLE_ID=123456789 MODERATOR_ROLE_ID=987654321 LOG_CHANNEL_ID=123456789 CHAT_BRIDGE_CHANNEL_ID=123456789 ANNOUNCEMENTS_CHANNEL_ID=123456789 VOTE_WEBHOOK_SECRET=random_secret_string ``` ### How to Get IDs: **Discord Developer Mode:** 1. Discord Settings > Advanced > Enable Developer Mode 2. Right-click on servers/channels/roles > Copy ID **Bot Token & Client ID:** - Token: Developer Portal > Your App > Bot > Token - Client ID: Developer Portal > Your App > General Information > Application ID **Guild ID:** - Right-click your server icon > Copy ID ## Step 4: Configure Bot Settings Edit `config.json` to customize: ```json { "botName": "BoneMC Bot", "serverName": "BoneMC", "primaryColor": "#00BFFF", "rewards": { "daily": { "money": 1000, "cooldown": 86400000 } }, "rankSync": { "VIP": "role_id", "VIP+": "role_id", "MVP": "role_id" } } ``` Replace role IDs with your actual Discord role IDs. ## Step 5: Deploy Slash Commands ```bash node deploy-commands.js ``` You should see: `✅ Successfully reloaded X application (/) commands.` ## Step 6: Start the Bot ```bash npm start ``` For development (auto-restart on changes): ```bash npm run dev ``` ## Step 7: Enable RCON on Minecraft Server Edit `server.properties`: ```properties enable-rcon=true rcon.port=25575 rcon.password=your_secure_password ``` Restart your Minecraft server. ## Step 8: Verify Everything Works Test these commands in Discord: - `/ping` - Check bot is responding - `/status` - Check Minecraft server connection - `/help` - View all commands - `/link ` - Test account linking ## Common Issues & Solutions ### Bot doesn't respond to commands: - Make sure slash commands are deployed (`node deploy-commands.js`) - Check bot has proper permissions in Discord - Verify bot token is correct in `.env` ### Can't connect to Minecraft server: - Verify server IP and port are correct - Check firewall isn't blocking the port - Make sure server is actually online ### RCON doesn't work: - Enable RCON in `server.properties` - Check RCON password matches - Verify RCON port is correct (default 25575) ### Bot crashes on startup: - Check Node.js version (must be 16.9.0+) - Run `npm install` again - Check `.env` file exists and has correct format ## Commands List ### General Commands - `/status` - Check Minecraft server status - `/ping` - Check bot latency - `/help` - Display all commands - `/serverinfo` - Discord server information ### Account & Rewards - `/link ` - Link Minecraft account - `/daily` - Claim daily rewards (24h cooldown) - `/vote` - Get voting links and information ### Leaderboards - `/leaderboard money` - Top money holders - `/leaderboard kills` - Top PvP players - `/leaderboard playtime` - Most active players ### Moderation (Admin/Mod Only) - `/kick [reason]` - Kick a member - `/mute [reason]` - Timeout a member - `/warn ` - Warn a member - `/warnings view ` - View user warnings - `/warnings clear ` - Clear user warnings ### Events & Giveaways (Admin Only) - `/giveaway [channel]` - Start a giveaway ## Advanced Configuration ### Connecting to MySQL Database 1. Install MySQL package: ```bash npm install mysql2 ``` 2. Update `DATABASE_TYPE=mysql` in `.env` 3. Add MySQL credentials to `.env`: ```env DB_HOST=localhost DB_USER=root DB_PASSWORD=password DB_NAME=bonemc ``` 4. Import database schema (create your own based on JSON structure) ### Setting Up Chat Bridge The bot includes basic chat bridge functionality. For full integration: 1. Install DiscordSRV plugin on your Minecraft server 2. Configure DiscordSRV to use the same channel as `CHAT_BRIDGE_CHANNEL_ID` 3. Bot will automatically relay messages ### Custom Rank Sync Edit `config.json` rank sync section: ```json "rankSync": { "VIP": "discord_role_id", "VIP+": "discord_role_id", "CUSTOM_RANK": "discord_role_id" } ``` Sync happens automatically when players link accounts. ## Performance Optimization For large servers (100+ players): 1. **Use PM2 for process management:** ```bash npm install -g pm2 pm2 start bot.js --name bonemc-bot pm2 save pm2 startup ``` 2. **Enable caching** in config.json 3. **Use Redis** for cooldowns (optional): ```bash npm install redis ``` ## Hosting Recommendations **Free Options:** - Replit (with uptime monitoring) - Railway.app (500 hours free) **Paid Options (Recommended):** - DigitalOcean ($5/month) - Linode ($5/month) - AWS EC2 (t2.micro free tier) - Oracle Cloud (always free tier) **VPS Setup:** ```bash # Install Node.js curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # Clone your bot git clone your-repo-url cd your-bot-folder # Install dependencies npm install # Install PM2 sudo npm install -g pm2 # Start bot pm2 start bot.js --name bonemc-bot pm2 save pm2 startup ``` ## Security Best Practices 1. **Never share your bot token** 2. **Use environment variables** (.env file) 3. **Add .env to .gitignore** 4. **Use strong RCON password** 5. **Limit bot permissions** to only what's needed 6. **Keep dependencies updated**: `npm update` ## Updating the Bot ```bash git pull npm install node deploy-commands.js pm2 restart bonemc-bot ``` ## Support & Customization This bot is designed to be easily customizable: - **Add new commands:** Create files in `/commands/` folder - **Modify embeds:** Edit `/utils/embedBuilder.js` - **Change colors:** Update `config.json` - **Add features:** Create new utility files in `/utils/` ## Backup Your Data Regularly backup the `/database/` folder: ```bash tar -czf backup-$(date +%Y%m%d).tar.gz database/ ``` --- **Need help?** Check the code comments or create an issue in the repository. **Enjoy your BoneMC Discord Bot! 🎮**