Discord Module Installation

This guide will walk you through setting up the Discord Module for Zenith-Mod, from creating a Discord application to configuring the bot.

📋 Prerequisites

Zenith-Mod plugin installed and configured
Discord server with appropriate permissions
Access to Discord Developer Portal
Basic understanding of Discord bot setup

🔧 Step 1: Create Discord Application

1.1 Access Discord Developer Portal

Go to Discord Developer Portal
Log in with your Discord account
Click “New Application”

1.2 Configure Application

Application Name: Enter a name for your bot (e.g., “Zenith-Mod Bot”)
Description: Optional description
Click “Create”

1.3 Create Bot

Navigate to the “Bot” section in the left sidebar
Click “Add Bot”
Confirm by clicking “Yes, do it!”

🔑 Step 2: Configure Bot Settings

2.1 Bot Token

In the “Bot” section, find “Token”
Click “Copy” to copy the bot token
⚠️ Keep this token secret! Never share it publicly

2.2 Bot Permissions

Scroll down to “Privileged Gateway Intents”
Enable the following intents:
- ✅ Server Members Intent (Required for role checking)
- ✅ Message Content Intent (Required for slash commands)
- ✅ Guild Members Intent (Required for member information)

2.3 Required Intents

⚠️ Important: These intents are REQUIRED for the Discord Module to function properly:

Intent	Required	Purpose
Server Members Intent	✅ Yes	Check user roles and permissions
Message Content Intent	✅ Yes	Process slash commands
Guild Members Intent	✅ Yes	Access member information

How to enable:

Go to “Bot” section in Discord Developer Portal
Scroll down to “Privileged Gateway Intents”
Toggle ON all three intents listed above
Click “Save Changes”

2.3 Bot Appearance (Optional)

Username: Set a custom bot username
Avatar: Upload a custom bot avatar
Description: Add a bot description

🎫 Step 3: Generate Invite URL

3.1 OAuth2 URL Generator

Navigate to “OAuth2” → “URL Generator”
Select “bot” in the “Scopes” section
Select the following “Bot Permissions”:
- ✅ Adminstrator

3.2 Generate and Use URL

Copy the generated URL at the bottom
Open the URL in your browser
Select your Discord server
Click “Authorize”
Complete any CAPTCHA if prompted

⚙️ Step 4: Configure Zenith-Mod

4.1 Enable Discord Module

enabled: true

4.2 Set Bot Token

bot:
  token: "YOUR_BOT_TOKEN_HERE"

4.3 Configure Bot Status

bot:
  status: "online" # online, idle, dnd, invisible
  activity:
    enabled: true
    type: "WATCHING" # PLAYING, STREAMING, LISTENING, WATCHING
    text: "Zenith-Mod Server"

4.4 Set Up Log Channels

enabled: true

channels:
  kick_log: "CHANNEL_ID"
  ban_log: "CHANNEL_ID"
  unban_log: "CHANNEL_ID"
  mute_log: "CHANNEL_ID"
  unmute_log: "CHANNEL_ID"
  warn_log: "CHANNEL_ID"

🚀 Step 5: Start the Bot

5.1 Start Discord Bot

Restart your Minecraft server
Or use the in-game command: /dcbot start

5.2 Register Slash Commands

Run: /dcbot register
Wait for confirmation message
Commands should appear in Discord within a few minutes

5.3 Verify Installation

Check Discord for the bot’s online status
Try using a slash command (e.g., /getinfo)
Check server console for any error messages

🔐 Step 6: Configure Permissions

6.1 Set Up Role Permissions

Permissions:
  GetInfo: ["ROLE_ID_1", "ROLE_ID_2"]
  Notes:
    List: ["ROLE_ID_1", "ROLE_ID_2"]
    Add: ["ROLE_ID_1"]
    Remove: ["ROLE_ID_1"]
    Clear: ["ROLE_ID_1"]
    Search: ["ROLE_ID_1", "ROLE_ID_2"]
  # ... more permissions

6.2 Get Role IDs

Enable Developer Mode in Discord:
- User Settings → Advanced → Developer Mode
Right-click on a role → “Copy ID”
Use these IDs in the configuration

✅ Verification Checklist

🛠️ Troubleshooting

Bot Not Appearing Online

Check if bot token is correct
Verify bot has proper permissions
Check server console for errors

Commands Not Working

Run /dcbot register to register commands
Wait a few minutes for Discord to update
Check role permissions

Permission Denied Errors

Verify role IDs are correct
Check if user has required roles
Ensure role IDs are not role names

Next Steps: Learn about Discord Commands to start using the bot!