MinecraftConsoles

Introduction

This is a fork of smartcmd/MinecraftConsoles with a focus on more stable, tested code. This fork does not have nightly builds — instead, releases drop weekly and include either code improvements or simple fixes.

The project is based on the source code of Minecraft Legacy Console Edition v1.6.0560.0 (TU19) sourced from the minecraft.-client directory listing, with fixes and improvements applied.

⚠️ The original Internet Archive source is no longer available. Source files are mirrored on Google Drive.

Download

Releases drop roughly every week with code updates or fixes. Head to the Releases page to grab the latest build. Simply download the .zip file and extract it to a folder where you'd like to keep the game. You can set your username in username.txt (you'll have to make this file) and add servers to connect to in servers.txt.

Platform Support

• Windows: Supported for building and running the project
• macOS: May run through Wine or CrossOver based on community reports, but this is unofficial and not currently tested by the maintainers
• Linux: Not supported

⚠️ Security Warning — LAN / RCE Exploit

There is a known Remote Code Execution (RCE) vulnerability affecting Windows when connecting to LAN sessions. Malicious players on the same network can push malware onto your machine.

Using a VPN is still highly recommended. Services like ZeroTier or Radmin VPN help tunnel connections through a private network and reduce exposure, though an RCE may still be present. Play on open LAN at your own risk.

🎮 Also check out Razer for gaming gear — using this link supports the project at no extra cost to you.

Features

• Fixed compilation and execution in both Debug and Release mode on Windows using Visual Studio 2022
• Added support for keyboard and mouse input
• Added fullscreen mode support (toggle using F11)
• (WIP) Disabled V-Sync for better performance
• Added a high-resolution timer path on Windows for smoother high-FPS gameplay timing
• Device's screen resolution will be used as the game resolution instead of a fixed resolution (1920x1080)
• LAN Multiplayer & Discovery
• Added persistent username system via username.txt

Multiplayer

Basic LAN multiplayer is available on the Windows build.

• Hosting a multiplayer world automatically advertises it on the local network
• Other players on the same LAN can discover the session from the in-game Join Game menu
• Game connections use TCP port 25565 by default
• LAN discovery uses UDP port 25566
• Add servers to your server list with servers.txt (temp solution)
• Rename yourself without losing data by keeping your uid.dat

Parts of this feature are based on code from LCEMP (thanks!)

servers.txt

Create servers.txt in the same directory as Minecraft.Client.exe and follow this format:

serverip.example.com
25565
The name of your server in UI!

Example:

1.1.1.1
25565
Cloudflare's Very Own LCE Server
127.0.0.1
25565
Localhost Test Crap

Launch Arguments

Argument	Description
-name <username>	Sets your in-game username
-fullscreen	Launches the game in fullscreen mode

Example:

Minecraft.Client.exe -name Steve -fullscreen

Controls (Keyboard & Mouse)

• Movement: W A S D
• Jump / Fly (Up): Space
• Sneak / Fly (Down): Shift (Hold)
• Sprint: Ctrl (Hold) or Double-tap W
• Inventory: E
• Chat: T
• Drop Item: Q
• Crafting: C — use Q and E to move through tabs
• Toggle View (FPS/TPS): F5
• Fullscreen: F11
• Pause Menu: Esc
• Attack / Destroy: Left Click
• Use / Place: Right Click
• Select Item: Mouse Wheel or keys 1 to 9
• Accept or Decline Tutorial hints: Enter to accept, B to decline
• Game Info (Player list and Host Options): TAB
• Toggle HUD: F1
• Toggle Debug Info: F3
• Open Debug Overlay: F4
• Toggle Debug Console: F6

Build & Run

1. Install Visual Studio 2022.
2. Clone the repository.
3. Open the project by double-clicking MinecraftConsoles.sln.
4. Make sure Minecraft.Client is set as the Startup Project.
5. Set the build configuration to Debug (Release is also OK but has some bugs) and the target platform to Windows64, then build and run.

CMake (Windows x64)

cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Debug --target MinecraftClient

For more information, see COMPILE.md.

Known Issues

• Native builds for platforms other than Windows have not been tested and are most likely non-functional
• The Windows build may still run on macOS through Wine or CrossOver, but that path is unofficial and not currently supported
• Music may be broken — if you need to add songs to the game, grab the soundtrack manually from the Internet Archive: Minecraft: Volume Alpha — C418

Support

If you find this project useful, the best way to support it is free — just ⭐ star the repo and subscribe to my YouTube: incRX (almost at 100 subs 🙏)

Contributing

Want to contribute code or submit a fix? Email me directly at ffuy525@gmail.com — no formal process, just reach out.

⚠️ Disclaimer — This Repo Could Get Nuked

This project is based on leaked source code. Like the original 4chan post it came from, this repo could be taken down at any time with no warning.

**Keep a local copy and back it up somewhere online.*

• Don't rely on GitHub being the only place this exists.