From 5c571df94767378377bb42f509351d8521d8750b Mon Sep 17 00:00:00 2001 From: p2r3 <41925384+p2r3@users.noreply.github.com> Date: Tue, 9 Sep 2025 19:33:52 +0300 Subject: [PATCH] clarify details in readme --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cc00d81..63bd3c0 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ The goal of this project is to enable hosting Minecraft servers on very weak dev - Protocol version: `772` ## Quick start -For PC x86_64 platforms, grab the [latest build binary](https://github.com/p2r3/bareiron/releases/download/latest/bareiron.exe) and run it. The file is a [Cosmopolitan polyglot](https://github.com/jart/cosmopolitan), which means it'll run on Windows, Linux, and possibly Mac, despite the file extension. +For PC x86_64 platforms, grab the [latest build binary](https://github.com/p2r3/bareiron/releases/download/latest/bareiron.exe) and run it. The file is a [Cosmopolitan polyglot](https://github.com/jart/cosmopolitan), which means it'll run on Windows, Linux, and possibly Mac, despite the file extension. Note that the server's default settings cannot be reconfigured without compiling from source. For microcontrollers, see the section on **compilation** below. @@ -15,11 +15,13 @@ For microcontrollers, see the section on **compilation** below. Before compiling, you'll need to dump registry data from a vanilla Minecraft server. Create a folder called `notchian` here, and put a Minecraft server JAR in it. Then, follow [this guide](https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/Data_Generators) to dump all of the registries. Finally, run `build_registries.js` with `node`, `bun`, or `deno`. - To target Linux, install `gcc` and run `build.sh` -- To target an ESP variant, set up a PlatformIO project and clone this repository on top of it. +- To target an ESP variant, set up a PlatformIO project and clone this repository on top of it. Set your WiFi credentials in `include/globals.h`. - There's currently no streamlined build process for Windows. Contributions in this area are welcome! ## Configuration -Most user-friendly configuration options are available in `include/globals.h`, including WiFi credentials for embedded setups. Of course, many more things can be configured by editing the source code. +Configuring the server requires compiling it from its source code (see section above). + +Most user-friendly configuration options are available in `include/globals.h`, including WiFi credentials for embedded setups. Some other details, like the MOTD or starting time of day, can be found in `src/globals.c`. For everything else, you'll have to dig through the code. ## Non-volatile storage (optional) This section applies to those who target ESP variants and wish to persist world data after a shutdown. *This is not necessary on PC platforms*, as world and player data is written to `world.bin` by default.