Minecraft旧版主机版C++重制项目 - 支持模组开发、局域网联机和专用服务器

minecraftconsoles-lce by aradotso/trending-skills

293 周安装量

10 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/aradotso/trending-skills --skill minecraftconsoles-lce

开源项目游戏 C++

🇨🇳中文介绍

MinecraftConsoles（旧版主机版）技能

技能由 ara.so 提供 — Daily 2026 技能集合。

项目简介

MinecraftConsoles 是 Minecraft 旧版主机版 v1.6.0560.0 (TU19) 的 C++ 重新实现/延续项目，目标平台为现代 Windows（以及通过 Wine 非官方支持的 macOS/Linux）。目标包括：

为模组开发、向后移植和 LCE 开发提供多平台基础
提供支持键盘/鼠标和手柄的高质量桌面体验
支持局域网多人游戏和专用服务器软件
支持分屏多人游戏

代码仓库： smartcmd/MinecraftConsoles 主要语言： C++ 构建系统： Visual Studio 2022 解决方案 (.sln) + CMake 支持

快速开始

先决条件

Windows（主要支持平台）
安装包含 C++ 桌面工作负载的 Visual Studio 2022
Git

克隆仓库

git clone https://github.com/smartcmd/MinecraftConsoles.git
cd MinecraftConsoles

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

使用 Visual Studio 构建

在 Visual Studio 2022 中打开 MinecraftConsoles.sln
将启动项目设置为 Minecraft.Client
将配置设置为 Debug（或 Release），平台设置为 Windows64
按 F5 或 Ctrl+F5 进行构建并运行

使用 CMake 构建（Windows x64）

# 配置
cmake -S . -B build -G "Visual Studio 17 2022" -A x64

# 构建客户端
cmake --build build --config Debug --target MinecraftClient

# 构建专用服务器
cmake --build build --config Debug --target MinecraftServer

更多特定平台的说明请参阅仓库中的 COMPILE.md。

夜间构建版（无需编译）

从 Nightly Release 下载 .zip 文件，解压后运行 Minecraft.Client.exe。

在与可执行文件相同的目录下创建 username.txt 文件：

或者使用启动参数：

Minecraft.Client.exe -name Steve
Minecraft.Client.exe -name Steve -fullscreen

客户端启动参数

参数	描述
`-name <用户名>`	覆盖游戏内用户名
`-fullscreen`	以全屏模式启动

键盘与鼠标控制

操作	按键/按钮
移动	`W` `A` `S` `D`
跳跃 / 向上飞	`空格键`
潜行 / 向下飞	`Shift`（按住）
疾跑	`Ctrl`（按住）或双击 `W`
物品栏	`E`
聊天	`T`
丢弃物品	`Q`
合成	`C`（标签页切换：`Q` / `E`）
攻击 / 破坏	鼠标左键
使用 / 放置	鼠标右键
选择快捷栏槽位	`1`–`9` 或鼠标滚轮
暂停	`Esc`
全屏切换	`F11`
切换 HUD	`F1`
切换调试信息	`F3`
调试叠加层	`F4`
切换调试控制台	`F6`
切换 FPS/TPS 显示	`F5`
玩家列表 / 主机选项	`Tab`
接受教程提示	`Enter`
拒绝教程提示	`B`

局域网多人游戏

Windows 版本上的局域网多人游戏会自动运行：

托管世界会在本地网络上自动广播
其他玩家通过加入游戏菜单发现会话
TCP 端口：25565（游戏连接）
UDP 端口：25566（局域网发现）
使用添加服务器按钮连接到已知 IP
更改用户名是安全的 — 保留 uid.dat 可在重命名后保持你的数据
分屏玩家可以加入局域网/多人游戏会话

下载夜间服务器构建版

直接运行（Windows）

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

服务器命令行参数

参数	描述
`-port <1-65535>`	覆盖 `server-port`
`-ip <地址>`	覆盖 `server-ip`（绑定地址）
`-bind <地址>`	`-ip` 的别名
`-name <名称>`	覆盖 `server-name`（最多 16 个字符）
`-maxplayers <1-8>`	覆盖 `max-players`
`-seed <int64>`	覆盖 `level-seed`
`-loglevel <级别>`	`debug`、`info`、`warn`、`error`
`-help` / `--help` / `-h`	打印用法并退出

`server.properties` 配置

位于 Minecraft.Server.exe 所在目录。如果缺失，会自动生成默认配置。

server-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

关键属性说明：

键	值	默认值	说明
`server-port`	`1–65535`	`25565`	TCP 监听端口
`server-ip`	字符串	`0.0.0.0`	绑定地址
`server-name`	字符串	`DedicatedServer`	最多 16 个字符
`max-players`	`1–8`	`8`	玩家槽位
`level-seed`	int64 或空	空	空 = 随机
`world-size`	`classic	small	medium
`log-level`	`debug	info	warn
`autosave-interval`	`5–3600`	`60`	自动保存间隔秒数
`white-list`	`true/false`	`false`	启用白名单
`lan-advertise`	`true/false`	`false`	局域网广播

Docker 中的专用服务器（Linux/Wine）

推荐：从 GHCR 拉取（无需本地构建）

# 启动（自动拉取最新镜像）
./start-dedicated-server.sh

# 启动但不拉取
./start-dedicated-server.sh --no-pull

# 等效的手动命令
docker compose -f docker-compose.dedicated-server.ghcr.yml up -d

本地构建模式（可选）

需要本地编译的 Minecraft.Server.exe：

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

主机路径	容器路径	用途
`./server-data/server.properties`	`/srv/mc/server.properties`	服务器配置
`./server-data/GameHDD`	`/srv/mc/Windows64/GameHDD`	世界保存数据

变量	默认值	描述
`XVFB_DISPLAY`	`:99`	虚拟显示器编号
`XVFB_SCREEN`	`64x64x16`	虚拟屏幕尺寸（很小，Wine 需要）

项目结构（关键区域）

MinecraftConsoles/
├── MinecraftConsoles.sln       # Visual Studio 解决方案
├── CMakeLists.txt              # CMake 构建定义
├── COMPILE.md                  # 详细的编译说明
├── CONTRIBUTING.md             # 贡献者指南和项目目标
├── docker-compose.dedicated-server.ghcr.yml  # Docker（GHCR 镜像）
├── docker-compose.dedicated-server.yml       # Docker（本地构建）
├── start-dedicated-server.sh   # 快速启动脚本
├── server-data/
│   ├── server.properties       # 服务器配置（自动生成）
│   └── GameHDD/                # 世界保存数据
└── .github/
    └── banner.png

此代码库中常见的 C++ 模式

添加新的按键绑定（键盘输入）

该项目在原始仅支持手柄的代码基础上添加了键盘/鼠标支持。扩展输入时：

// 在输入处理器中检查按键状态的典型模式
// 找到键盘输入处理文件并添加你的按键检查：

bool isKeyPressed(int virtualKey) {
    return (GetAsyncKeyState(virtualKey) & 0x8000) != 0;
}

// 示例：添加一个新的切换键
if (isKeyPressed(VK_F7)) {
    // 切换你的功能
    myFeatureEnabled = !myFeatureEnabled;
}

遵循现有的 -name / -fullscreen 模式：

// 在参数解析部分（通常在 main 或 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;
    }
    // 添加你的参数：
    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;
}

// 用法：
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.properties`（规范化 / 自动生成）

void 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";
    }
}

// 从 level-name 规范化 level-id
std::string normalizeLevelId(const std::string& levelName) {
    std::string id = levelName;
    // 移除不安全字符，转为小写，将空格替换为下划线
    for (char& c : id) {
        if (!std::isalnum(c) && c != '_' && c != '-') c = '_';
    }
    return id;
}

构建失败：缺少 Windows SDK

打开 Visual Studio Installer → 修改 → 添加 Windows 10/11 SDK
确保平台设置为 Windows64（不是 x86）

CMake 找不到 Visual Studio 生成器

# 确认已安装 VS 2022，然后：
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
# "17 2022" 是 VS 2022 的生成器名称

游戏启动但无显示 / 立即崩溃

确保从包含所有游戏资源的目录运行
检查你的 GPU 驱动程序是否支持所需的 DirectX 版本
尝试 Debug 构建以获得更详细的错误输出

服务器在局域网上不可见

检查防火墙规则是否允许 TCP 25565 和 UDP 25566
验证 lan-advertise=true 对于专用服务器不是必需的（它用于局域网广播；客户端通过加入游戏菜单发现）
确保客户端和服务器在同一子网

Docker 服务器：Wine 无法显示

XVFB_DISPLAY 环境变量必须与 Wine 使用的匹配
容器使用最小的 64x64x16 虚拟帧缓冲区 — 除非有理由，否则不要更改

用户名重置 / UID 问题

不要删除 uid.dat — 它存储你唯一的玩家 ID
如果你通过 -name 或 username.txt 重命名自己，你现有的 uid.dat 会保持世界数据与你的账户关联

macOS / Linux (Wine)

下载 Windows 夜间构建版 .zip
通过 wine Minecraft.Client.exe 或 CrossOver 运行
已知存在稳定性问题（帧时间同步），社区已有报告；非官方支持

提交 PR 前请阅读 CONTRIBUTING.md。要点：

遵循现有的代码风格和命名约定
未经讨论不应破坏主机版本的构建兼容性
安全修复总是受欢迎的
查看开放议题（535+）以寻找适合新手的任务
加入 Discord 参与贡献者讨论

平台	状态
Windows (VS 2022)	✅ 完全支持
macOS / Linux (Wine)	⚠️ 社区报告可用，非官方
Android (Wine)	⚠️ 可运行，存在帧时间问题
iOS	❌ 不支持
游戏主机	⚠️ 代码存在，未积极维护

🇺🇸English

MinecraftConsoles (Legacy Console Edition) Skill

Skill by 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 with C++ desktop workload
Git

Clone

git clone https://github.com/smartcmd/MinecraftConsoles.git
cd MinecraftConsoles

Build with Visual Studio

Open MinecraftConsoles.sln in Visual Studio 2022
Set Startup Project to Minecraft.Client
Set configuration to Debug (or Release), platform to Windows64
Press F5 or Ctrl+F5 to build and run

Build with CMake (Windows x64)

# 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 MinecraftServer

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, extract, and run Minecraft.Client.exe.

Setting Your Username

Create username.txt in the same directory as the executable:

Steve

Or use a launch argument:

Minecraft.Client.exe -name Steve
Minecraft.Client.exe -name Steve -fullscreen

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`

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

Run Directly (Windows)

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

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)

`server.properties` Configuration

Located in the same directory as Minecraft.Server.exe. Auto-generated with defaults if missing.

server-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 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`

Dedicated Server in Docker (Linux/Wine)

Recommended: Pull from GHCR (No Local Build)

# 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 -d

Local Build Mode (Optional)

Requires a locally compiled Minecraft.Server.exe:

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

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)

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

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:

// 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;
}

Registering a Launch Argument

Follow the existing -name / -fullscreen pattern:

// 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];
    }
}

Reading `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";

Writing `server.properties` (Normalize / Auto-generate)

void 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;
}

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

# 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 2022

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 deleteuid.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 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 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

Weekly Installs

293

Repository

aradotso/trending-skills

GitHub Stars

First Seen

7 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli292

github-copilot292

codex292

amp292

cline292

kimi-cli292

freeCodeCamp 开源课程平台开发指南 - React/TypeScript 前端与 Node.js/Fastify 后端架构

501 周安装

Minecraft旧版主机版C++重制项目 - 支持模组开发、局域网联机和专用服务器

🇨🇳中文介绍

MinecraftConsoles（旧版主机版）技能

项目简介

快速开始

先决条件

克隆仓库

相关 Skills

使用 Visual Studio 构建

使用 CMake 构建（Windows x64）

运行客户端

夜间构建版（无需编译）

设置用户名

客户端启动参数

键盘与鼠标控制

局域网多人游戏

专用服务器

下载夜间服务器构建版

直接运行（Windows）

服务器命令行参数

server.properties 配置

Docker 中的专用服务器（Linux/Wine）

推荐：从 GHCR 拉取（无需本地构建）

本地构建模式（可选）

Docker 持久化卷

Docker 环境变量

项目结构（关键区域）

此代码库中常见的 C++ 模式

添加新的按键绑定（键盘输入）

注册启动参数

读取 server.properties

写入 server.properties（规范化 / 自动生成）

故障排除

构建失败：缺少 Windows SDK

CMake 找不到 Visual Studio 生成器

游戏启动但无显示 / 立即崩溃

服务器在局域网上不可见

Docker 服务器：Wine 无法显示

用户名重置 / UID 问题

macOS / Linux (Wine)

贡献

平台支持摘要

🇺🇸English

MinecraftConsoles (Legacy Console Edition) Skill

What This Project Is

Quick Start

Prerequisites

Clone

Build with Visual Studio

Build with CMake (Windows x64)

Running the Client

Nightly Build (No Compile Needed)

Setting Your Username

Client Launch Arguments

Keyboard & Mouse Controls

LAN Multiplayer

Dedicated Server

Download Nightly Server Build

Run Directly (Windows)

Server CLI Arguments

server.properties Configuration

Dedicated Server in Docker (Linux/Wine)

Recommended: Pull from GHCR (No Local Build)

Local Build Mode (Optional)

Docker Persistent Volumes

Docker Environment Variables

Project Structure (Key Areas)

Common C++ Patterns in This Codebase

Adding a New Key Binding (Keyboard Input)

Registering a Launch Argument

Reading server.properties

Writing server.properties (Normalize / Auto-generate)

Troubleshooting

Build Fails: Missing Windows SDK

CMake Can't Find Visual Studio Generator

Game Launches But No Display / Crashes Immediately

Server Not Visible on LAN

Docker Server: Wine Can't Display

Username Reset / UID Issues

macOS / Linux (Wine)

`server.properties` 配置

读取 `server.properties`

写入 `server.properties`（规范化 / 自动生成）

`server.properties` Configuration

Reading `server.properties`

Writing `server.properties` (Normalize / Auto-generate)