Skip to main content
This guide will help you get McDis-RCON up and running quickly with your first Minecraft server.

​
Prerequisites

Before starting, ensure you have:
  • Python 3.8 or higher installed
  • A Discord bot token (create one here)
  • A Discord channel for the McDis panel
  • A Minecraft server ready to manage
It is strongly recommended to grant administrator permissions to your Discord bot to avoid issues with panel generation and thread management.

​
Step-by-Step Setup

1

Install McDis-RCON

Install the package using pip:
pip install mcdis-rcon
On some systems, you may need to use pip3 instead of pip.
2

Navigate to Your Server Directory

Move to the directory where you want to store your server files:
cd /path/to/your/servers
This directory will become your “McDis” folder—the root where all managed servers will be stored.
3

Initialize Configuration

Generate the configuration file:
mcdis init
This creates a md_config.yml file in your current directory.
4

Configure Your Bot Token and Panel

Open md_config.yml and add your Discord bot token and panel channel ID:
Bot Token: YOUR_BOT_TOKEN_HERE
Panel ID: YOUR_CHANNEL_ID_HERE
Language: en
Backups: 3
To get a channel ID, enable Developer Mode in Discord (User Settings → Advanced → Developer Mode), then right-click a channel and select “Copy ID”.
5

Configure Your First Server

In the same md_config.yml file, configure your Minecraft server:
Processes:
  Servers:
    my_server:
      start_cmd: java -Xms2G -Xmx4G -jar server.jar nogui
      stop_cmd: stop
      blacklist:
        - 'Debug'
        - 'Can\'t keep up'
  Networks:
Replace:
  • my_server with your desired server name
  • start_cmd with your server’s start command
  • stop_cmd with your server’s stop command (usually stop or end)
6

Prepare Your Server Files

Before running McDis-RCON, create a folder matching your server name and place your server files inside:
mkdir my_server
cd my_server
# Copy your server.jar and other necessary files here
cd ..
Your directory structure should look like:
/path/to/your/servers/
├── md_config.yml
└── my_server/
    ├── server.jar
    ├── server.properties
    └── ...
7

Start McDis-RCON

Launch McDis-RCON:
mcdis run
You should see output like:
Initializing McDis RCON v0.4.30a...
Your configuration has been loaded successfully.
[INFO] discord.client: logging in using static token
[INFO] discord.gateway: Shard ID None has connected to Gateway
Logged in as Your Bot#1234!
   • Creating objects
     -> my_server
   • Loaded Discord events
   • Loaded server panel
Loading Complete

Commands: start, stop, restart, kill, mdreload, adreload, status, exit
>>
8

Check Discord

Go to your Discord panel channel. You should see:
  • A control panel message with buttons
  • Console threads for your server(s)
  • Error Reports thread
  • Console Flask thread
McDis Panel
9

Start Your Server

You can start your server in three ways:From Discord Panel:
!!start my_server
From Discord Console Thread: Navigate to the “Console my_server” thread and type:
start
From McDis Console: In your terminal where McDis is running:
start my_server
Or click the Processes button in the Discord panel and use the button interface.

​
Testing Your Setup

Once your server starts, you should see console output streaming to the Discord thread in real-time.

​
Try These Commands

!!restart my_server  # Restart the server
!!stop my_server     # Stop the server
!!start-all          # Start all configured servers

​
Next Steps

Explore Features

Learn about all the features McDis-RCON offers

Advanced Configuration

Customize your setup further

File Manager

Manage server files through Discord

Backup System

Set up automated backups

​
Troubleshooting

  • Verify your bot token is correct in md_config.yml
  • Ensure the bot is invited to your Discord server
  • Check that you have internet connectivity
  • Verify the Panel ID is correct
  • Ensure the bot has access to the channel
  • Make sure you copied the channel ID, not the server ID
  • Check that your start_cmd is correct
  • Verify server files exist in the server folder
  • Check console output for Java or server errors
If you encounter issues with the ruamel.yaml module, try:
# On Linux
python3 -m pip install --force ruamel.yaml

# On Windows
python -m pip install --force ruamel.yaml
Need help? Join the Discord community or contact kassiulo on Discord.

Build docs developers (and LLMs) love

Get started for freeTalk to us