Opencraft

Opencraft 是一个用 C++20 写的类 Minecraft 体素沙盒游戏，自带手写 Vulkan 渲染器和多线程 区块生成/网格化。内容参考早期 Minecraft：草方块与矿石、橡树、海洋，以及下界和末地维度、 传送门、末影水晶等。

编译

依赖：Vulkan SDK、CMake ≥ 3.20、Ninja、MinGW GCC 12+ 或 MSVC。

cmake -G Ninja -S . -B build
cmake --build build

产物是 build/opencraft.exe；构建时会把 assets/、shaders/*.spv、version.txt 复制到它旁边。

assets/ 里的贴图从 Minecraft 官方 jar 提取，按 Mojang EULA 不随仓库分发。 请用 tools/extract_assets 从你自己的 Minecraft 安装中提取。

打包自解压安装包

用官方 7-Zip SFX 模块打包，需要仓库根目录有 7-Zip\（含 7z.exe 和 7z.sfx， 本地产物、不入库）。默认每次 cmake --build build 之后自动生成 releases/Opencraft-Installer.exe；没有 7-Zip\ 时只警告并跳过，不影响构建。 不想要自动打包就关掉：

cmake -S . -B build -DOPENCRAFT_AUTO_PACKAGE=OFF

按需/手动打包：

cmake --build build --target package_7z    # releases/Opencraft-Installer.exe
powershell -File tools\pack_7z.ps1         # 也可以直接跑脚本，参数见脚本头部

安装包不含 assets/（遵守 Mojang EULA）；玩家首次运行时用包里的 extract_assets.exe 选择自己的 jar 提取贴图（这个工具由 CMake 从 tools/extract_assets.cpp 构建，产物在 build/extract_assets.exe）。

运行

build/opencraft.exe

版本号

version.txt 的 [current] 行是版本名（可手动改），编译时自动追加编译时间戳， 完整版本号形如 0.4.0-snapshot-1-20260214-153012，显示在主菜单右下角； 用 opencraft.exe --version 也可以直接打印。

操作

按键	说明
W / A / S / D	移动
鼠标	视角
空格	跳跃（飞行时上升）；双击切换飞行
Shift	飞行时下降
E	打开/关闭物品栏
左键 / 右键	挖掘 / 放置方块
1..9 / 滚轮	切换快捷栏
T	时间快进
Esc	暂停菜单；菜单中返回上一级

目录

• src/ 源码：世界与区块、地形生成、网格化、Vulkan 渲染、菜单、存档
• shaders/ GLSL 着色器，构建时由 glslc 编译
• tools/ 资源提取工具与自解压安装包脚本
• docs/ 项目说明

开发约定

• 注释一律用简短的中文，一两句话说清即可，不要长篇大论。
• 不要写英文或其他语言的注释。
• 其它约定见 AGENTS.md。