MC173 Rust Client

Rust port of the Minecraft Beta 1.7.3 client and supporting local server/world code.

Start The Game

From this workspace, run:

cargo run -p mc173-client -- --options-file C:\Users\Administrator\Desktop\mc173-data\options.txt

That opens the title screen. Use Singleplayer to create or select a world. The title, world-selection menus, and in-game first-person view all stay in the same WGPU window, matching the original Beta client lifecycle.

This uses C:\Users\Administrator\Desktop\mc173-data for options and saves. The client automatically detects Beta assets from this checkout's root assets folder first, then falls back to an assets folder next to the selected options.txt, then the platform default Beta .minecraft folder. A root resources folder is also detected for future sound support.

If you want to use the platform default Beta .minecraft data directory for options and saves instead, this shorter command also works:

cargo run -p mc173-client

Useful Options

Use a custom player name:

cargo run -p mc173-client -- --username Player --options-file C:\Users\Administrator\Desktop\mc173-data\options.txt

Use a custom options and saves directory:

cargo run -p mc173-client -- --options-file C:\Users\Administrator\Desktop\mc173-data\options.txt

Saves are stored next to the selected options.txt in a saves folder. Assets are loaded from the first valid assets folder found in the project root, next to the selected options.txt, or in the Beta .minecraft data directory; pass --asset-root only when you need to override that discovery. Resources follow the same order and can be overridden with --resource-root.

VS Code

Open this playable checkout in VS Code, then run the default task mc173: play client (WGPU). The task uses the local options file at C:\Users\Administrator\Desktop\mc173-data\options.txt; root assets and resources are detected automatically when present.

The Run and Debug panel also has a matching Debug MC173 Client (WGPU) entry. It uses CodeLLDB for Rust debugging; the task runs through the integrated terminal with plain cargo.

Renderer Selection

The live-world renderer is WGPU-only and requires a working WGPU-compatible graphics adapter and driver.

Smoke Test

Run the main verification suite with:

cargo test -p mc173-world -p mc173-server -p mc173-client --quiet