Discord Bot to Manage Minecraft Servers

Overview

This project allows you to manage a Minecraft Java Edition server via a Discord bot.
It includes:

• server_manager.py – API to start, manage, and stop the Minecraft server.
• main.py – Discord bot to execute commands from your Discord server.

Tested on Windows 10 & 11
Requires Python 3.9+ and Java (for Minecraft server).

---

Features

• Start and stop the Minecraft server remotely.
• View who is online.
• Automatic server shutdown when inactive.
• Optional PC shutdown feature.
• Role-based command restrictions.

---

Quick Start

# Clone the repository
git clone https://github.com/V1ad8/DiscordBot.git
cd DiscordBot

# Install dependencies
pip install -r requirements.txt

# Configure .env with your Discord bot token
echo "DISCORD_TOKEN=your-bot-token" > .env

# Start the Discord bot
python main.py

Setup Instructions

Set up the Minecraft Server

Follow Mojang's official guide.

Then, place these scripts in the same directory as your Minecraft server files.

Configure server_manager.py

Variable	Description
rejoin_timer	Seconds to wait before stopping the server after last player leaves
first_join_timer	Seconds to wait for first player to join before auto-stopping
sending_timer	Delay between sending commands to the server
process_exit_steps	Steps before forcefully killing process on failure
waiting_step	Time between checking server output
server_jar	Name of the Minecraft .jar file
server_directory	Path to the server directory
ram	Amount of RAM for the server (e.g., "2G")
gui	Enable/disable GUI (usually false)

The Server Manager can be run via:

python run_server.py

Set up the Discord Bot

1. Install dependencies:

pip install -r requirements.txt

2. Get a discoed token. Here, it starts at 5:39.

3. Set the token in .env

4. Start the bot:

python main.py

Auto-Start with Windows Task Scheduler

You can configure the bot (and optionally the Minecraft server) to run automatically when your PC starts using Windows Task Scheduler.

Steps

1. Press Win + R, type taskschd.msc, and press Enter to open Task Scheduler.
2. In the Actions panel, click Create Task....
3. Under the General tab:
   • Give the task a name (e.g., Minecraft Discord Bot).
   • Select Run whether user is logged on or not.
   • Check Run with highest privileges.
4. Go to the Triggers tab:
   • Click New....
   • Set Begin the task to At startup.
   • Click OK.
5. Go to the Actions tab:
   • Click New....
   • For Action, select Start a program.
   • In Program/script, enter:

     python
     

   • In Add arguments (optional), enter:

     "C:\path\to\main.py"
     

   • In Start in (optional), enter the directory where your script is located (e.g., C:\path\to\project).
   • Click OK.
6. Click OK, enter your Windows credentials when prompted.

---

Tips

• Ensure Python is added to your system PATH.
• To test the task, right-click it in Task Scheduler and select Run.

Discord Bot Behavior

If a role named Server-Manager exists, only members with this role or admins can use commands.

If a channel named bot-commands exists, the bot only responds there and deletes commands elsewhere.

Commands

Command	Action
!start	Start the Minecraft server
!stop	Stop the Minecraft server
!online	Show server status and players
!shutdown	Shut down the PC (⚠ use carefully)
!cancel	Cancel PC shutdown

Notes

Ensure Java is installed and available in your system PATH.

The shutdown feature will turn off the PC, so use it with caution.

The bot and Minecraft server should ideally run on a dedicated machine.