A high-performance Minecraft Java Edition server rewritten in Rust. Targets Minecraft 26.1 (protocol
775).
| Goal | Detail |
|---|---|
| Correctness | Implemented against the decompiled 26.1 server source (4 789 Java files) |
| Performance | Async-first with Tokio; ECS-based entity system; no blocking I/O on the game thread |
| Maintainability | Clean Rust idioms, comprehensive tests, strict Clippy lints |
| Compatibility | Wire-protocol compatible with the vanilla 26.1 client |
| Modern design | Not a 1:1 Java port β uses data-oriented architecture, parallel tick phases, and Rust-native patterns |
π§ Pre-alpha β infrastructure and planning complete, implementation starting.
Oxidized/
βββ crates/
β βββ oxidized-nbt/ # NBT read/write, SNBT, GZIP/zlib
β βββ oxidized-macros/ # Proc-macro: #[derive(McPacket, McRead, McWrite)]
β βββ oxidized-protocol/ # Network: TCP, packet codec, typestate connections
β βββ oxidized-world/ # World, chunks (Anvil), blocks, items, lighting
β βββ oxidized-game/ # ECS (bevy_ecs): entities, AI, combat, commands
β βββ oxidized-server/ # Binary β startup, tick loop, network layer
βββ mc-server-ref/ # Decompiled vanilla server (gitignored)
βββ deny.toml # cargo-deny licence + advisory config
βββ rustfmt.toml # Formatting rules
βββ rust-toolchain.toml # Pinned to stable (CI enforces MSRV 1.85)
- Rust stable 1.85+ (see
rust-toolchain.tomlfor pinned version) - A vanilla Minecraft 26.1 client
cargo build --release ./target/release/oxidized
cargo run # debug build cargo test --workspace # all tests cargo fmt --check # formatting cargo clippy --workspace --all-targets -- -D warnings # lints
| Document | Description |
|---|---|
| Contributing | How to contribute to the project |
The decompiled vanilla server is at mc-server-ref/decompiled/ (gitignored).
The implementation uses the Java source as reference but rewrites everything
idiomatically in Rust β no line-by-line transliteration.
See CONTRIBUTING.md. All contributions are welcome β bugs, docs, phases, performance.
Licensed under the MIT License.
Note: This project is not affiliated with or endorsed by Mojang or Microsoft. Minecraft is a trademark of Mojang AB. This server reimplementation is developed for educational and compatibility purposes only.