minecraftconsoles-lce
minecraftconsoles-lce — an installable skill for AI agents.
By reason-machines · 1,353 installs
npx skills add reason-machines/trending-skills --skill minecraftconsoles-lce
Source repository · Upstream listing
MinecraftConsoles (Legacy Console Edition) Skill
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
What This Project Is
MinecraftConsoles is a C++ reimplementation/continuation of Minecraft Legacy Console Edition v1.6.0560.0 (TU19) , targeting modern Windows (and unofficially macOS/Linux via Wine). Goals include:
Multi platform base for modding, backports, and LCE development
Quality desktop experience with keyboard/mouse and controller support
LAN multiplayer and dedicated server software
Splitscreen multiplayer support
Repository: smartcmd/MinecraftConsoles
Primary language: C++
Build system: Visual Studio 2022 solution ( .sln ) + CMake support
Quick Start
Prerequisites
Windows (primary supported platform)
[Visual Studio 2022](https://aka.ms/vs/17/release/vs community.exe) with C++ desktop workload
Git
Clone
Build with Visual Studio
1. Open MinecraftConsoles.sln in Visual Studio 2022
2. Set Startup Project to Minecraft.Client
3. Set configuration to Debug (or Release), platform to Windows64
4. Press F5 or Ctrl+F5 to build and run
Build with CMake (Windows x64)
See COMPILE.md in the repo for additional platform specific notes.
Running the Client
Nightly Build (No Compile Needed)
Download the .zip from the [Nightly Release](https://github.com/smartcmd/MinecraftConsoles/releases/tag/nightly), extract, and run Minecraft.Client.exe .
Setting Your Username
Create username.txt in the same directory as the executable:
Or use a launch argument:
Client Launch Arguments
Argument Description
name <username Override in game username
fullscreen Launch in fullscreen mode
Keyboard & Mouse Controls
Action Key/Button
Move 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 (tabs: Q / E )
Attack / Destroy Left Click
Use / Place Right Click
Select hotbar slot 1 – 9 or Mouse Wheel
Pause Esc
Fullscreen F11
Toggle HUD F1
Toggle Debug Info F3
Debug Overlay F4
Toggle Debug Console F6
Toggle FPS/TPS view F5
Player list / Host Options Tab
Accept tutorial hint Enter
Decline tutorial hint B
LAN Multiplayer
LAN multiplayer works automatically on the Windows build:
Hosting a world auto advertises it on the local network
Other players discover sessions via Join Game menu
TCP port: 25565 (game connections)
UDP port: 25566 (LAN discovery)
Use the Add Server button to connect to known IPs
Username changes are safe — keep uid.dat to preserve your data across renames
Splitscreen players can join LAN/multiplayer sessions
Dedicated Server
Download Nightly Server Build
[Nightly Dedicated Server](https://github.com/smartcmd/MinecraftConsoles/releases/tag/nightly dedicated server)
Run Directly (Windows)
Server CLI Arguments
Argument Description
port <1 65535 Override server port
ip <addr Override server ip (bind address)
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 debug , info , warn , error
help / help / h Print usage and exit
server.properties Configuration
Located in the same directory as Minecraft.Server.exe . Auto generated with defaults if missing.
Key property notes:
Key Values Default Notes
server port 1–65535 25565 TCP listen port
server ip string 0.0.0.0 Bind address
server name string DedicatedServer Max 16 chars
max players 1–8 8 Player slots
level seed int64 or empty empty Empty = random
world size classic\ small\ medium\ large classic New world size
log level debug\ info\ warn\ error info Verbosity
autosave interval 5–3600 60 Seconds between autosaves
white list true/false false Enable whitelist
lan advertise true/false false LAN advertisement
Dedicated Server in Docker (Linux/Wine)
Recommended: Pull from GHCR (No Local Build)
Local Build Mode (Optional)
Requires a locally compiled Minecraft.Server.exe :
Docker Persistent Volumes
Host Path Container Path Purpose
./server data/server.properties /srv/mc/server.properties Server config
./server data/GameHDD /srv/mc/Windows64/GameHDD World save data
Docker Environment Variables
Variable Default Description
XVFB DISPLAY :99 Virtual display number
XVFB SCREEN 64x64x16 Virtual screen size (tiny, Wine needs it)
Project Structure (Key Areas)
Common C++ Patterns in This Codebase
Adding a New Key Binding (Keyboard Input)
The project added keyboard/mouse support on top of the original controller only code. When extending input:
Registering a Launch Argument
Follow the existing name / fullscreen pattern:
Reading server.properties
Writing server.properties (Normalize / Auto generate)
Troubleshooting
Build Fails: Missing Windows SDK
Open Visual Studio Installer → Modify → add Windows 10/11 SDK
Make sure the platform is set to Windows64 (not x86)
CMake Can't Find Visual Studio Generator
Game Launches But No Display / Crashes Immediately
Ensure you're running from the directory containing all game assets
Check that your GPU drivers support the required DirectX version
Try Debug build for more verbose error output
Server Not Visible on LAN
Check firewall rules allow TCP 25565 and UDP 25566
Verify lan advertise=true is NOT required for dedicated servers (it's for LAN broadcast; clients discover via Join Game)
Ensure both client and server are on the same subnet
Docker Server: Wine Can't Display
The XVFB DISPLAY env var must match what Wine uses
The container uses a minimal 64x64x16 virtual framebuffer — don't change this unless you have a reason
Username Reset / UID Issues
Do not delete uid.dat — it stores your unique player ID
If you rename yourself via name or username.txt , your existing uid.dat keeps world data linked to your account
macOS / Linux (Wine)
Download the Windows nightly .zip
Run via wine Minecraft.Client.exe or CrossOver
Stability issues (frametime pacing) are known and community reported; not officially supported
Contributing
Read [ CONTRIBUTING.md ](https://github.com/smartcmd/MinecraftConsoles/blob/main/CONTRIBUTING.md) before submitting PRs. Key points:
Follow existing code style and naming conventions
Console build compatibility should not be broken without discussion
Security fixes are always welcome
Check open issues (535+) for good first tasks
Join the [Discord](https://discord.gg/jrum7HhegA) for contributor discussion
Platform Support Summary
Platform Status
Windows (VS 2022) ✅ Fully supported
macOS / Linux (Wine) ⚠️ Community reported working, unofficial
Android (Wine) ⚠️ Runs with frametime issues
iOS ❌ No support
Consoles ⚠️ Code present, not actively maintained