Loading...
Loading...
Expert skill for building, running, and extending MinecraftConsoles (Minecraft Legacy Console Edition) — a C++ multi-platform reimplementation with dedicated server, LAN multiplayer, and modding support.
npx skill4agent add aradotso/trending-skills minecraftconsoles-lceSkill by ara.so — Daily 2026 Skills collection.
smartcmd/MinecraftConsoles.slngit clone https://github.com/smartcmd/MinecraftConsoles.git
cd MinecraftConsolesMinecraftConsoles.slnMinecraft.Client# Configure
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
# Build the client
cmake --build build --config Debug --target MinecraftClient
# Build the dedicated server
cmake --build build --config Debug --target MinecraftServerCOMPILE.mdusername.txtSteveMinecraft.Client.exe -name Steve
Minecraft.Client.exe -name Steve -fullscreen| Argument | Description |
|---|---|
| Override in-game username |
| Launch in fullscreen mode |
| Action | Key/Button |
|---|---|
| Move | |
| Jump / Fly Up | |
| Sneak / Fly Down | |
| Sprint | |
| Inventory | |
| Chat | |
| Drop Item | |
| Crafting | |
| Attack / Destroy | Left Click |
| Use / Place | Right Click |
| Select hotbar slot | |
| Pause | |
| Fullscreen | |
| Toggle HUD | |
| Toggle Debug Info | |
| Debug Overlay | |
| Toggle Debug Console | |
| Toggle FPS/TPS view | |
| Player list / Host Options | |
| Accept tutorial hint | |
| Decline tutorial hint | |
uid.datMinecraft.Server.exe -name MyServer -port 25565 -ip 0.0.0.0 -maxplayers 8 -loglevel info
Minecraft.Server.exe -seed 123456789| Argument | Description |
|---|---|
| Override |
| Override |
| Alias of |
| Override |
| Override |
| Override |
| |
| Print usage and exit |
server.propertiesMinecraft.Server.exeserver-name=DedicatedServer
server-port=25565
server-ip=0.0.0.0
max-players=8
level-name=world
level-id=world
level-seed=
world-size=classic
log-level=info
white-list=false
lan-advertise=false
autosave-interval=60| Key | Values | Default | Notes |
|---|---|---|---|
| | | TCP listen port |
| string | | Bind address |
| string | | Max 16 chars |
| | | Player slots |
| int64 or empty | empty | Empty = random |
| | | New world size |
| | | Verbosity |
| | | Seconds between autosaves |
| | | Enable whitelist |
| | | LAN advertisement |
# Start (pulls latest image automatically)
./start-dedicated-server.sh
# Start without pulling
./start-dedicated-server.sh --no-pull
# Equivalent manual command
docker compose -f docker-compose.dedicated-server.ghcr.yml up -dMinecraft.Server.exedocker compose -f docker-compose.dedicated-server.yml up -d --build| Host Path | Container Path | Purpose |
|---|---|---|
| | Server config |
| | World save data |
| Variable | Default | Description |
|---|---|---|
| | Virtual display number |
| | Virtual screen size (tiny, Wine needs it) |
MinecraftConsoles/
├── MinecraftConsoles.sln # Visual Studio solution
├── CMakeLists.txt # CMake build definition
├── COMPILE.md # Detailed compile instructions
├── CONTRIBUTING.md # Contributor guide and project goals
├── docker-compose.dedicated-server.ghcr.yml # Docker (GHCR image)
├── docker-compose.dedicated-server.yml # Docker (local build)
├── start-dedicated-server.sh # Quick-start script
├── server-data/
│ ├── server.properties # Server config (auto-generated)
│ └── GameHDD/ # World save data
└── .github/
└── banner.png// Typical pattern for checking key state in the input handler
// Find the keyboard input processing file and add your key check:
bool isKeyPressed(int virtualKey) {
return (GetAsyncKeyState(virtualKey) & 0x8000) != 0;
}
// Example: adding a new toggle key
if (isKeyPressed(VK_F7)) {
// toggle your feature
myFeatureEnabled = !myFeatureEnabled;
}-name-fullscreen// In the argument parsing section (typically in main or init):
for (int i = 1; i < argc; i++) {
std::string arg = argv[i];
if (arg == "-name" && i + 1 < argc) {
username = argv[++i];
}
else if (arg == "-fullscreen") {
launchFullscreen = true;
}
// Add your argument:
else if (arg == "-myoption" && i + 1 < argc) {
myOption = argv[++i];
}
}server.properties#include <fstream>
#include <sstream>
#include <map>
#include <string>
std::map<std::string, std::string> loadServerProperties(const std::string& path) {
std::map<std::string, std::string> props;
std::ifstream file(path);
std::string line;
while (std::getline(file, line)) {
if (line.empty() || line[0] == '#') continue;
auto eq = line.find('=');
if (eq == std::string::npos) continue;
std::string key = line.substr(0, eq);
std::string val = line.substr(eq + 1);
props[key] = val;
}
return props;
}
// Usage:
auto props = loadServerProperties("server.properties");
int port = std::stoi(props.count("server-port") ? props["server-port"] : "25565");
std::string serverName = props.count("server-name") ? props["server-name"] : "DedicatedServer";server.propertiesvoid writeServerProperties(const std::string& path,
const std::map<std::string, std::string>& props) {
std::ofstream file(path);
for (auto& [key, val] : props) {
file << key << "=" << val << "\n";
}
}
// Normalize level-id from level-name
std::string normalizeLevelId(const std::string& levelName) {
std::string id = levelName;
// Remove unsafe characters, lowercase, replace spaces with underscores
for (char& c : id) {
if (!std::isalnum(c) && c != '_' && c != '-') c = '_';
}
return id;
}# Confirm VS 2022 is installed, then:
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
# "17 2022" is the generator name for VS 2022lan-advertise=trueXVFB_DISPLAY64x64x16uid.dat-nameusername.txtuid.dat.zipwine Minecraft.Client.exeCONTRIBUTING.md| 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 |