🎵MonsterDex 2.0
Back to Wiki

Discord Setup Guide

Complete guide to setting up MonsterDex in your Discord server

Quick Start (2 Minutes)

  1. 1Invite the bot using the button on our website
  2. 2Run /monstersetup #channel to set the spawn channel
  3. 3Done! Monsters will start spawning based on chat activity

Detailed Setup

Step 1

Invite the Bot

Add MonsterDex to your Discord server using the invite link.

  • Click the 'Add to Discord' button on our website or use the invite link
  • Select the server you want to add MonsterDex to
  • Make sure you have 'Manage Server' permissions
  • Authorize the bot with the requested permissions
Step 2

Set Up Spawn Channel

Configure where monsters will spawn in your server.

  • Choose a channel where you want monsters to appear
  • Run the setup command in any channel
  • The bot needs 'Send Messages' and 'Embed Links' permissions in that channel
  • Monsters will spawn based on server activity in configured channels
Command:
/monstersetup #monster-spawns
Step 3

Add More Spawn Channels (Optional)

Add additional channels for more spawn locations.

  • You can add multiple channels where monsters can spawn
  • This spreads activity across your server
  • Each channel counts toward spawn calculations
Command:
/monsteraddchannel #general
Step 4

Set Up Highlights Channel (Recommended)

Create a channel for rare catches and achievements.

  • Choose or create a channel for bot announcements
  • Epic, Legendary, and Mythical catches are posted here
  • Achievement unlocks are celebrated
  • Collection milestones are announced
  • Great for building community excitement!
Command:
/monsterhighlights #mdex-highlights
Step 5

Verify Configuration

Check that everything is set up correctly.

  • Use the config command to see all your settings
  • Verify spawn channels are correct
  • Check that the bot is enabled
  • Make sure highlights channel is set
Command:
/monsterconfig

Bot Permissions

MonsterDex needs certain permissions to function properly. Here's what each permission is used for:

Required
Send Messages
Required to send monster spawns and respond to commands
Required
Embed Links
Required for monster cards and rich embeds
Required
Attach Files
Used for monster images in some contexts
Required
Read Message History
Helps track spawn activity
Optional
Use External Emojis
For rarity indicators and reactions
Optional
Add Reactions
For interactive elements

Recommended Channel Structure

#monster-spawns

Primary spawn channel. Can be a general chat or dedicated channel. Monsters appear here when there's activity.

#mdex-highlights

For rare catch announcements, achievement unlocks, and milestones. Great for celebrating member accomplishments!

#mdex-trading

Optional dedicated channel for trading. Keeps trade offers organized and easy to find.

#mdex-commands

Optional channel for bot commands to keep main chat clean. All commands work in any channel.

Troubleshooting

Monsters aren't spawning

  • Make sure you've run /monstersetup with a spawn channel
  • Check that spawning is enabled with /monsterconfig
  • Verify the bot has permissions in the spawn channel
  • Ensure there's chat activity - spawns require messages
  • Wait a few minutes - spawns aren't instant

Bot doesn't respond to commands

  • Check if the bot is online in your member list
  • Ensure the bot has permission to read and send in the channel
  • Try using the command in a different channel
  • Re-invite the bot if permissions seem broken

Highlights not posting

  • Verify you've set a highlights channel with /monsterhighlights
  • Check bot permissions in the highlights channel
  • Make sure players haven't disabled their highlight announcements

Can't use admin commands

  • You need Administrator permission in the server
  • Server owners always have access
  • Check your Discord role permissions

Need More Help?

Join our support server for assistance from the community and developers.

Join Support Server