HomuraMC

English | 日本語

HomuraMC is Open Source Minecraft Server Software written in Python.

Join Our Discord

How To (Server Admins)

[!WARNING]
Homura is a pre-alpha version with most features not yet implemented! We recommend that you do not use it in a production environment.

Require

• Python3
• Java16 (Homura uses vanilla jar for chunk sending)
• Git (If you don't get it from the release)

  procedure

  (If you want to clone the repository and get it)

First, run the following command to clone this repository.

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

Once obtained, create a Python virtual environment (recommended)

# Windows
python -m venv homura

# Other
python3 -m venv homura

If you have created a virtual environment, access Python in the virtual environment with the following command.

# Windows
./homura/scripts/Activate

# Other
source homura/bin/activate

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

# Windows
pip install -r requirements.txt
# Other
python3 -m pip install -r requirements.txt

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

python3 main.py

Trouble Shooting

how to fix "[WinError 2] The system cannot find the file specified"

Java (JDK) is required to use the Vanilla jar for world generation. Install Java(JDK) from here. ( https://www.oracle.com/java/technologies/downloads/ )

My friend can't connect server

Check that the IP address (leave 0.0.0.0) and port (default is 25565) in the Homura.ini file match and that the port is open. If you absolutely cannot get the port open, you can use playit( https://playit.gg ).

I need help with something not mentioned here

Issues or Discord.

Screen Shots

Special Thanks

• https://qiita.com/YuzuRyo61/items/da7a6e55616254eb63d7
• https://github.com/barneygale/quarry/issues/135#issuecomment-1088143509
• https://github.com/TMShader/QuarryMinecraftServerTests/