GitHub - mdmrk/rosebed

A from-scratch reimplementation of Minecraft Beta 1.7.3 in Zig, using SDL3 and OpenGL 3.3. Client and dedicated server, both speaking the b1.7.3 protocol (version 14).

Index

• Not in b1.7.3
• Play
• Build
  • Web
  • Android
  • iOS
• License

Not in b1.7.3

The short list of things b1.7.3 does not have. Everything else is meant to match it, and anything that doesn't is a bug.

• Chat and commands in single player - /help, /freecam, /give, /kill, /spawn, ...
• Chat input editing - History recall, ctrl+backspace, paste.
• Fullscreen in Video Settings - Vanilla has F11 and no setting.
• On-screen touch controls - Only on Android and iOS, where there is no keyboard or mouse to bind.
• Auto-jump - Android and iOS only, on by default, toggled in Options.

Play

Play browser build online. Worlds are saved in browser storage. Multiplayer connects over WebSocket. Needs WebGL2.

Platform	Stable	Nightly
x86_64-linux	tar.gz	tar.gz
x86_64-windows	zip	zip
aarch64-macos	tar.gz	tar.gz
wasm32-emscripten	tar.gz	tar.gz
aarch64-linux-android	apk	apk
aarch64-ios	ipa	ipa

# Client
./rosebed

# Server
./rosebed-server [--port 25565] [--world world] [--seed <n>] [--ticks <n>]

Build

Requires Zig 0.16.0.

# Build
zig build fetch-assets            # once, before anything else
zig build -Doptimize=ReleaseFast  # binaries into zig-out/bin

# Other useful commands
zig build                         # debug build may be too slow to play
zig build run                     # build and run the client
zig build run-server              # build and run the dedicated server
zig build test                    # run the unit tests

Assets aren't in the repo, so fetch-assets has to run first. It downloads the official b1.7.3 client jar, checks its SHA-1 and unpacks it into src/assets/ to be embedded into the binary.

Anything after -- is passed to the program: zig build run-server -- --port 25566 --world test.

Web

Needs emscripten on PATH and a patched copy of the Zig stdlib:

lib_dir=$(zig env | sed -n 's/^ *\.lib_dir = "\(.*\)",$/\1/p')
cp -r "$lib_dir" ziglib
chmod -R u+w ziglib
patch -p1 -d ziglib < .github/zig-emscripten.patch

zig build -Dtarget=wasm32-emscripten -Doptimize=ReleaseFast \
  --sysroot "$(em-config CACHE)/sysroot" --zig-lib-dir ziglib

Output is a static site in zig-out/www. You can serve it with python -m http.server.

Android

Needs the Android NDK and an Android SDK with build-tools and a platform installed, plus zip and keytool on PATH. SDL3 itself is the official prebuilt Android build, not compiled from source:

zig build fetch-android-sdl       # once, unpacks SDL3 and its Java glue into android/sdl

zig build -Dtarget=aarch64-linux-android -Doptimize=ReleaseFast \
  -Dandroid-ndk="$ANDROID_NDK_HOME" -Dandroid-sdk="$ANDROID_HOME"

The NDK and SDK paths also come from ANDROID_NDK_HOME/ANDROID_NDK_ROOT and ANDROID_HOME/ANDROID_SDK_ROOT when the options are left out. -Dandroid-api (default 21), -Dandroid-build-tools (default 35.0.0) and -Dandroid-platform (default android-35) pick the levels to build against.

Output is a signed debug APK in zig-out/rosebed.apk. zig build run with the same options installs it on a connected device over adb and starts it.

iOS

Needs macOS with Xcode installed, plus zip on PATH. SDL3 itself is the official prebuilt SDL3.framework, taken from the ios-arm64 slice of the disk image Apple-side releases ship, not compiled from source:

zig build fetch-ios-sdl           # once, unpacks SDL3.framework into ios/sdl

zig build -Dtarget=aarch64-ios -Doptimize=ReleaseFast

The iPhoneOS SDK comes from xcrun --sdk iphoneos --show-sdk-path unless -Dios-sdk names one.

Output is an unsigned IPA in zig-out/rosebed.ipa. Signing it with a provisioning profile is left to you; the CI artifact will not install on a stock device as-is.

License

GPLv3. See LICENSE. Not affiliated with or endorsed by Mojang or Microsoft.