MinecraftConsoles (Legacy Console Revelations Edition)

If you have any questions regarding this fork, this is my Fluxer server (similar to a Discord server):

This project is based on source code of Minecraft Legacy Console Edition v1.6.0560.0 (TU19) with some fixes and improvements applied.

Latest:

Uncapped FPS (VSync Off)

• FPS is no longer locked to the monitor's refresh rate when VSync is disabled. The precompiled 4J render library hardcodes SyncInterval=1 in its Present call, which forced VBlank synchronization regardless of the VSync setting. The main loop now bypasses the library's Present and calls the DXGI swap chain directly with SyncInterval=0 and DXGI_PRESENT_ALLOW_TEARING when VSync is off
• Pressing F11 to toggle fullscreen now correctly syncs the Fullscreen checkbox in the graphics settings menu

Graphics Settings Fixes

• The graphics menu layout has been fixed: the render distance slider is now no longer occluded by the gamma slider. Also, resolved spacing error for the checkbox options due to an incomplete removal of the Bedrock Fog toggle option (the setting has been reinstated).

Hardcore Hearts

• Worlds in hardcore mode now display the hardcore heart textures, matching Java Edition
• Supports all heart states: normal, poison, wither, and flash/blink animations
• Works across all contexts: offline worlds, online hosted worlds, and dedicated servers
• Game mode is locked to Survival when hardcore is enabled in the world creation and load screens

Dedicated Server Security Hardening

The dedicated server now includes a comprehensive security system to protect against packet-sniffing attacks, XUID harvesting, privilege escalation, and bot flooding. All features are configurable in server.properties. Compatible with playit.gg -- enable proxy-protocol=true in your server.properties and enable PROXY Protocol v1 in your playit.gg tunnel settings to get per-player IP tracking, IP bans, and per-player rate limiting.

What's protected:

• Player identities (XUIDs) are hidden from unauthenticated connections
• All game traffic is encrypted between secured clients and the server
• When require-secure-client and enable-stream-cipher are both enabled, old/unpatched clients are blocked before receiving any game data
• Server commands and privileges require persistent ops.json authorization
• Connection flooding is rate-limited per IP
• When require-challenge-token is enabled, returning players are verified with a persistent identity token

New server.properties keys:

Key	Default	Description
enable-stream-cipher	true	Encrypt all game traffic with AES-128-CTR
require-secure-client	true	Kick clients that don't complete the cipher handshake (blocks old clients)
require-challenge-token	false	Require identity token verification to prevent XUID impersonation
proxy-protocol	false	Parse PROXY protocol v1 headers for real client IPs behind a tunnel
hide-player-list-prelogin	true	Strip player XUIDs from the pre-login response
rate-limit-connections-per-window	5	Max TCP connections per IP within the rate limit window
rate-limit-window-seconds	30	Sliding window duration for rate limiting
max-pending-connections	10	Max simultaneous pre-login connections

Recommended setup (especially for playit.gg):

enable-stream-cipher=true
require-secure-client=true
require-challenge-token=true
proxy-protocol=true

New server commands:

Command	Description
whitelist add <name>	Whitelist a player by name (they must attempt to connect once first)
revoketoken <name>	Revoke a player's identity token (use if a player lost their token)

Server logging:

• A server.log file is now written alongside the server executable
• Security events appear in the CLI with [security] tags
• Each join shows a security summary: cipher status, token status, XUID, and real IP

Important: When require-secure-client=true and enable-stream-cipher=true, only the secured client (LCREWindows64.zip) can connect. Old/upstream clients will be blocked before receiving any game data. Set both to false if you want to allow all clients.

Player List Map Icon Color Fix

• The colored map icon shown next to each player in the tab player list and teleport menu now matches their actual map marker color. Previously the icon was determined by a broken small-ID lookup that produced incorrect colors. The icon is now computed client-side using the same hash the map renderer uses, keyed by player name for reliable lookup

End Dimension Fixes for Dedicated Servers

• Fixed the Ender Dragon being immune to melee damage on dedicated servers. The server's entity ID allocator (smallId pool) assigned non-sequential IDs to the dragon's body parts, but the client assumed sequential offsets. Melee attacks targeted IDs the server didn't recognize, so hits were silently dropped. The server now reassigns sub-entity IDs to be sequential from the parent when an entity with parts is added to the level
• Fixed entering the End exit portal after defeating the dragon crashing the game. The player entity was never added to the Overworld level during the dimension transition, leaving the player as a ghost entity that caused a crash on the next interaction
• Fixed the End Poem crashing the client on dedicated servers due to an out-of-bounds player index lookup in the WIN_GAME event handler

Dedicated Server Player List Fix

• The Tab player list now correctly shows all connected players on dedicated servers. Previously only the local player was visible because remote players were never registered in the client's network player tracking when their AddPlayerPacket arrived
• The dedicated server's phantom host entry (slot 0, empty name) is now filtered from the list
• Players are properly removed from the list when they disconnect, using gamertag matching since dedicated server XUIDs are not available on the client

SRV Record Support and Async Join Refactor

• Added DNS SRV record resolution (_minecraft._tcp.<hostname>), matching Java Edition behavior. Players can connect using just a domain name (e.g. play.example.com) and the client will automatically look up the correct server address and port from DNS
• Refactored the async server joining system: replaced boolean flags with a clean eJoinState enum state machine, moved connection progress handling into a dedicated UIScene_ConnectingProgress class with attempt counter and cancel support, and added a FinalizeJoin() separation so the recv thread only starts after the UI confirms success

Piston Fix for Dedicated Servers

• Fixed a bug where pistons would permanently break server-wide on dedicated servers when a redstone clock ran long enough. The piston update lock (ignoreUpdate) was set at the start of triggerEvent but never cleared on three early-return paths, permanently blocking all piston neighbor updates for the rest of the session. A fast clock would eventually hit one of these paths (e.g. signal state changing between event queuing and processing), locking out every piston in the world

Chunk Unloading and Connection Stability Fixes

• Fixed a regression where chunks outside the player's immediate vicinity would fail to load on dedicated servers, leaving giant missing areas. The server's chunk drop function was immediately removing chunks from the cache instead of queuing them for the existing save/unload pipeline, which meant chunks were never saved, never moved to the recovery cache, and their entities (item frames, paintings, etc.) were never removed from the level before being reloaded, causing entity duplication
• Fixed the server's dropAll() and autosave chunk cleanup iterating the loaded chunk list while simultaneously modifying it (undefined behavior that could corrupt chunk tracking or stall the server)
• Removed an overly aggressive dropAll() call that wiped the entire chunk cache whenever render distance decreased, instead of only removing the out-of-range chunks
• Fixed a client-side connection bug where a 5-second socket recv timeout (used during the initial server handshake) was never cleared after connecting. This meant any brief server pause longer than 5 seconds (e.g. autosave, chunk I/O) would cause the client to interpret the silence as a lost connection and disconnect

Dedicated Server Biome Diversity Fix

• The dedicated server previously used a completely random seed with no biome diversity checks, unlike the client which validates seeds to guarantee varied biomes. This could result in server worlds with large regions dominated by only one or two biome types (e.g. all taiga/snowy)
• On top of that, the client's seed validation was hardcoded to only check a 54-chunk (Classic) area, so even validated seeds had no diversity guarantee beyond that. This made the problem especially noticeable on Large worlds or worlds expanded from Classic to Large
• New server worlds now validate seeds for biome diversity, and the validation scales to the full target world size
• Added override-seed in server.properties to fix existing worlds without deleting them. Set it to any seed number and newly generated chunks will use it instead of the original

Server List and Connection Improvements

• Server edits and deletions now apply immediately without needing to restart the game
• Connecting to an offline/unreachable server no longer freezes the game indefinitely
• Connection attempts use non-blocking sockets with a 5-second timeout (3 retries max) instead of the OS TCP timeout
• Connection runs on a background thread so the UI stays responsive, with a cancel option (press B or Escape) to back out at any time
• Failed connections now always show a "Connection Failed" dialog instead of silently navigating back

Upstream Merge

• Fixed font rendering for color and formatting codes, splash text like "Colormatic!" now renders with proper per-character colors
• Fixed Sign editing UI, SignEntryMenu720 restored to correct version
• Stained glass and stained glass panes are now craftable in survival mode with full crafting UI support
• Clicking outside a container inventory while holding an item now drops it, matching Java Edition behavior
• Item lore text now displays on hover for items with NBT lore data
• Increased entity limits: boats 40->60, minecarts 40->60, fireballs 200->300, projectiles 300->400
• Fixed missing trapped chest textures in Natural Texture Pack
• Debug packet handling now properly gated behind debug builds

Music Context Fixes

• Menu music (menu1-4) now plays only on the title screen
• Creative music (creative1-6) only plays in creative mode
• Survival mode plays only calm/hal/nuance/piano tracks

Performance Optimizations

• Renderer: column-level frustum culling and compact visible-chunk lists skip thousands of empty iterations per frame; lightweight second-pass render path avoids redundant checks
• Sound engine: filesystem probe results are now cached, eliminating repeated file-existence checks every time a sound plays; sounds are pre-decoded for smoother playback
• Entity movement: reduced shared_from_this() overhead by caching the shared pointer; dynamic_pointer_cast replaced with a raw pointer cast guarded by instanceof
• Chunk updates: early-out for non-dirty chunks in the update loop; scaled recheck period at high render distances
• Threading: entity query locking consolidated at the Level layer on all platforms for consistent thread safety
• Block breaking: server now skips redundant tile-update packets when a block is successfully destroyed

CMake Build System Migration

• Project now builds with CMake instead of Visual Studio project files
• Use cmake --preset windows64 or open the repo folder directly in Visual Studio (it detects CMakeLists.txt automatically)
• Old .vcxproj/.sln files are preserved on the vs-build branch if needed

Multi-Language Font Rendering and Unicode Text Input

• Type and read text/characters in Japanese, Chinese, Korean, Thai, Arabic, Hindi, and many more languages
• Works in: chat, signs, world names, seeds, server address/port fields
• Two rendering systems: Iggy UI uses a new unicode bitmap fallback font; legacy C++ renderer uses Java Minecraft's glyph page system
• Arabic text shaping: proper contextual letter forms and right-to-left visual reordering in chat and UI
• Security: blocked Unicode bidirectional override characters to prevent chat spoofing
• Fixed a pre-existing memory leak in sign loading

Copy+Paste Support

• Added copy+paste support for IP/Port, world names, world seeds, server names, signs, etc.
• Just use Ctrl+V to paste from your clipboard

Dedicated Server Hardcore Mode

• Dedicated server is fully compatible with smartcmd/MinecraftConsoles clients, even with hardcore mode
• Client (LCREWindows64.zip): download from the Nightly release on GitHub
• Dedicated Server (LCREServerWindows64.zip): download from the Nightly-Dedicated-Server release on GitHub
• Docker: pull ghcr.io/itsrevela/minecraft-lce-dedicated-server:nightly for server container

Screenshot Functionality

• Pressing F2 will save a screenshot to a screenshots folder in your root game directory
• Works in any context: main menu, pause menu, settings, inventory, crafting, and during gameplay
• A local-only chat message is shown to the player when in-game

Proper implementation of Hardcore Mode in LCRE!

• difficulty slider included in create world menu
• difficulty slider forces "Difficulty: Hardcore" on world load
• singleplayer: host death, force no respawn, on exit deletes world
• multiplayer: host death = world delete upon exit --- joiner death = only exit available, persists upon rejoin (no respawn option)
• multiplayer fixes: added fix to prevent host from using exit-without-saving loophole for nonhost players that died
• to-do: hardcore hearts texture

The current goal of MinecraftConsoles is to be a multi-platform base for further development, such as modding, backports, and anything else LCE. On top of that, we're working to make this a quality experience on Desktop with or without a controller while (long-term) retaining console support.

See our our Contributor's Guide for more information on the goals of this project.

Download

Client

Windows users can download our Nightly 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)

Server

If you're looking for Dedicated Server software (with hardcore-mode functionality), download its Nightly Build here. Similar instructions to the client more or less, though see further down in this README for more info on that.

Platform Support

• Windows: Supported for building and running the project
• macOS / Linux: The Windows nightly build will run through Wine or CrossOver based on community reports, but this is unofficial and not currently tested by the maintainers when pushing updates
• Android: VIA x86 EMULATORS (like GameNative) ONLY! The Windows nightly build does run but has stability / frametime pacing issues frequently reported
• iOS: No current support
• All Consoles: Console support remains in the code, but maintainers are not currently verifying console functionality / porting UI Changes to the console builds at this time.

Features

• Dedicated Server Software (Minecraft.Server.exe)
• 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 using a fixed resolution (1920x1080)
• LAN Multiplayer & Discovery
• Added persistent username system via username.txt
• Decoupled usernames and UIDs to allow username changes
• Fixed various security issues present in the original codebase
• Splitscreen Multiplayer support (connect to dedicated servers, etc)
• In-game server management (Add Server button, etc)

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 (cycles Left/Right)
• 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 and 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

Contributors

Would you like to contribute to this project? Please read our Contributor's Guide before doing so! This document includes our current goals, standards for inclusions, rules, and more.

Client Launch Arguments

Argument	Description
-name <username>	Overrides your in-game username.
-fullscreen	Launches the game in Fullscreen mode

Example:

Minecraft.Client.exe -name Steve -fullscreen

LAN Multiplayer

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 the in-game Add Server button (temp)
• Rename yourself without losing data by keeping your uid.dat
• Split-screen players can join in, even in Multiplayer

Dedicated Server Software

About server.properties

Minecraft.Server reads server.properties from the executable working directory (Docker image: /srv/mc/server.properties). If the file is missing or contains invalid values, defaults are auto-generated/normalized on startup.

Important keys:

Key	Values / Range	Default	Notes
server-port	1-65535	25565	Listen TCP port
server-ip	string	0.0.0.0	Bind address
server-name	string (max 16 chars)	DedicatedServer	Host display name
max-players	1-8	8	Public player slots
level-name	string	world	Display world name
level-id	safe ID string	derived from level-name	Save folder ID; normalized automatically
level-seed	int64 or empty	empty	Empty = random seed
world-size	classic|small|medium|large	classic	World size preset for new worlds and expansion target for existing worlds
log-level	debug|info|warn|error	info	Server log verbosity
autosave-interval	5-3600	60	Seconds between autosaves
white-list	true/false	false	Enable access list checks
lan-advertise	true/false	false	LAN session advertisement

Minimal example:

server-name=DedicatedServer
server-port=25565
max-players=8
level-name=world
level-seed=
world-size=classic
log-level=info
white-list=false
lan-advertise=false
autosave-interval=60

Dedicated Server launch arguments

The server loads base settings from server.properties, then CLI arguments override those values.

Argument	Description
-port <1-65535>	Override server-port
-ip <addr>	Override server-ip
-bind <addr>	Alias of -ip
-name <name>	Override server-name (max 16 chars)
-maxplayers <1-8>	Override max-players
-seed <int64>	Override level-seed
-loglevel <level>	Override log-level (debug, info, warn, error)
-help / --help / -h	Print usage and exit

Examples:

Minecraft.Server.exe -name MyServer -port 25565 -ip 0.0.0.0 -maxplayers 8 -loglevel info
Minecraft.Server.exe -seed 123456789

Dedicated Server in Docker (Wine)

This repository includes a lightweight Docker setup for running the Windows dedicated server under Wine.

Quick Start (No Build, Recommended)

No local build is required. The container image is pulled from GHCR.

./start-dedicated-server.sh

start-dedicated-server.sh does the following:

• uses docker-compose.dedicated-server.ghcr.yml
• pulls latest image, then starts the container

If you want to skip pulling and just start:

./start-dedicated-server.sh --no-pull

Equivalent manual command:

docker compose -f docker-compose.dedicated-server.ghcr.yml up -d

Local Build Mode (Optional)

Use this only when you want to run your own locally built Minecraft.Server binary in Docker. A local build of Minecraft.Server is required for this mode.

docker compose -f docker-compose.dedicated-server.yml up -d --build

Useful environment variables:

• XVFB_DISPLAY (default: :99)
• XVFB_SCREEN (default: 64x64x16, tiny virtual display used by Wine)

Fixed server runtime behavior in container:

• executable path: /srv/mc/Minecraft.Server.exe
• bind IP: 0.0.0.0
• server port: 25565

Persistent files are bind-mounted to host:

• ./server-data/server.properties -> /srv/mc/server.properties
• ./server-data/GameHDD -> /srv/mc/Windows64/GameHDD

Build & Run

1. Install Visual Studio 2022 or newer.
2. Clone the repository.
3. Open the project folder from Visual Studio.
4. Set the build configuration to Windows64 - Debug (Release is also ok but missing some debug features), then build and run.

CMake (Windows x64)

cmake --preset windows64
cmake --build --preset windows64-debug --target Minecraft.Client

For more information, see COMPILE.md.

Star History