Build a server

This guide will allow you to build a Minecraft server using HomuraMC.

system requirement

Supported Versions

We plan to support all versions in stages.

Supported OS

*1 It can be run by using WSL. So it only works on Windows 10 / Windows 11.
*2 Not confirmed to work.

Required Specs

Recommended Specs

Building the server

Installing Python

For Windows, from here,
For Mac, go to here,
For Ubuntu, go to here,
For other Linux platforms, download Python from here
Download and install Python from here for Ubuntu and here for other Linux.
If you are able to install it, proceed to the next step.

Installing Git

Download and install Git from here.
If you are able to install it, go to the next step.

Building and constructing HomuraMC environment

First, run this command in a folder of your choice.

git clone https://github.com/HomuraMC/Homura.git

Next, create a Python virtual environment. (Recommended)

python3 -m venv homura

Once you have created the virtual environment, access Python in the virtual environment using the following command.

cd . /homura/scripts/Activate

Next, use pip to install the libraries required by Homura.

python3 -m pip install -r requirements.txt

After installation, you can start the server by running the following command.

python3 main.py

Congratulations, you have successfully built HomuraMC! If you have made it this far without any errors, you have successfully built HomuraMC!