https://github.com/mcdreforged/mcdreforged

A rewritten version of MCDaemon, a python tool to control your Minecraft server
https://github.com/mcdreforged/mcdreforged

mcdreforged minecraft python

Last synced: 6 months ago
JSON representation

A rewritten version of MCDaemon, a python tool to control your Minecraft server

• Host: GitHub
• URL: https://github.com/mcdreforged/mcdreforged
• Owner: MCDReforged
• License: lgpl-3.0
• Created: 2020-03-31T09:42:49.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2026-01-12T18:29:07.000Z (6 months ago)
• Last Synced: 2026-01-12T22:54:08.684Z (6 months ago)
• Topics: mcdreforged, minecraft, python
• Language: Python
• Homepage: https://mcdreforged.com
• Size: 6.01 MB
• Stars: 1,056
• Watchers: 15
• Forks: 86
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
MCDReforged

--------

[![Python Versions](https://img.shields.io/pypi/pyversions/mcdreforged.svg)](https://pypi.org/project/mcdreforged)

[![PyPI Version](https://img.shields.io/pypi/v/mcdreforged.svg)](https://pypi.org/project/mcdreforged)

[![Docker](https://img.shields.io/docker/v/mcdreforged/mcdreforged/latest?label=docker)](https://hub.docker.com/r/mcdreforged/mcdreforged)

[![License](https://img.shields.io/github/license/MCDReforged/MCDReforged.svg)](https://github.com/MCDReforged/MCDReforged/blob/master/LICENSE)

[![Documentation Status](https://readthedocs.org/projects/mcdreforged/badge/)](https://docs.mcdreforged.com/)

![MCDR-banner](https://raw.githubusercontent.com/MCDReforged/MCDReforged/master/logo/images/logo_long.png)

**English** | [简中](https://github.com/MCDReforged/MCDReforged/blob/master/README_zh_cn.md) | [繁中](https://github.com/MCDReforged/MCDReforged/blob/master/README_zh_tw.md)

> This is a python based Minecraft server control tool

MCDReforged (abbreviated as MCDR) is a tool which provides the management ability of the Minecraft server using custom plugin system. It doesn't need to modify or mod the original Minecraft server at all

From in-game calculator, player high-light, to manipulate scoreboard, manage structure file and backup / load backup, you can implement these by using MCDR and related plugins

Greatly thanks to chino_desu and his [MCDaemon 1.0](https://github.com/kafuuchino-desu/MCDaemon) for the idea of such a cool Minecraft control tool

Contact me on discord: `Fallen_Breath#1215`

## Advantage

- It's running above the server. It doesn't need to modify the server at all which keep everything vanilla

- Hot-reloadable plugin system. You don't need to shut down the server to update the plugins

- Multi-platform / server compatibility. Supports vanilla, paper, bungeecord etc. on Linux / Windows

## How it works?

MCDR uses [Popen](https://docs.python.org/3/library/subprocess.html#subprocess.Popen) to start the server as a sub-process, 

then it has the ability to control the standard input / out stream of the server

Since the console output of a Minecraft server has a stable format and contains a large amount of useful information about the server, 

e.g. player chat messages, MCDR is able to parse and analyze the server output, abstract them into different events and dispatch them towards plugins for responding

With the help of Minecraft command system, MCDR can send Minecraft commands via the standard input stream to affect the actual Minecraft server

That's it, you can even think of MCDR as a robot that stares at the server console and can quickly respond to server output and input related commands if you like 

## Plugin

[Here](https://github.com/MCDReforged/PluginCatalogue) is a MCDR plugin collection repository

## Document

Check https://docs.mcdreforged.com/ for more details of MCDR