纯 C++23 实现的 Minecraft Java Edition 1.12.2（协议 340）服务端。
详细文档见
docs/：架构、兼容契约、里程碑、协议、参考日志。 原版对齐进度：vanilla/2185 文件燃尽清单，已核销 228（10.4%），tools/vanilla_progress.py输出。
cmake -S . -B build -G "Unix Makefiles" -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build -j
./build/cyane单元测试（184 项）：cmake --build build -j4 && ./build/cyane_tests
| 项 | 指标 |
|---|---|
| 协议 | Java Edition 1.12.2，protocol 340 |
| 存档 | 读写原生 Anvil (.mca) |
| 性能 | 单 tick 内 1000 并发玩家 |
| 部署 | 单可执行文件 + plugins/ + world/ |
- 可以：反编译阅读原版/Spigot，理解语义；把 jar 当测试基准与行为预言机。
- 不可以：复制其代码进本项目；链接其 class/jar；随包分发其产物。
cyane/
├── include/cyane/ # 内核头文件
├── src/
│ ├── core/ # 日志、配置、线程池、错误、时间
│ ├── net/ # reactor、连接、加密、压缩、限流
│ ├── proto/ # 340 包定义、读写器、NBT
│ ├── world/ # 注册表、chunk、光照、anvil、voxelshape
│ ├── item/ # 物品、附魔、容器、合成、熔炉
│ ├── game/ # tick、调度、命令、权限、事件总线
│ └── plugin/ # JVM 宿主、JNI 桥、插件加载
├── config/ # server.toml / recipes.toml
├── data/ # 数据驱动内容（registry 等）
├── world/ # 运行时存档（level.dat / region / playerdata）
├── vanilla/ # 原版 1.12.2 燃尽占位文件（2185，逐份实现后 git rm）
├── java/ # bukkit-api / nms-shim / craft-shim
├── jars/ # 参考 jar（不入库）
├── tools/ # 探针、签名提取、燃尽统计、基准
├── tests/ # 单元测试
└── docs/ # 架构、兼容、里程碑、协议、参考日志
C++23（clang）· CMake 3.25+ · lld · zlib-ng · OpenSSL · liburing · 内嵌 JVM（8/11/17/21）
| 阶段 | 内容 | 状态 |
|---|---|---|
| M0 | 工程骨架 | ✅ |
| M1 | 协议与连接（握手/状态/登录/加密） | ✅ |
| M2 | 世界与移动（区块/移动同步/多人可见/聊天） | ✅ |
| M3 | 玩法基础（方块/物品栏/容器/合成/熔炉/命令/生物） | ✅ |
| M4 | 存档与世界兼容（玩家 .dat 互通 / Anvil 编辑区块 / 完整区块模型） | ✅ |
| M5 | 世界生成（噪声地形/生物群系/洞穴/矿脉/植被装饰/结构） | ✅ 核心 |
| M6 | 玩法进阶（敌对生物 AI/寻路/战斗/经验/掉落） | ✅ 核心 |
| M7 | 插件基座（JVM/类加载器/事件/调度） | ⬜ |
| M8 | Bukkit API 覆盖扩展 | ⬜ |
| M9 | NMS shim | ⬜ |
| M10 | 性能与加固 | ⬜ |
- 协议与连接：握手/状态/登录/加密/压缩完整流程，与原版逐字节一致。
- 世界与移动：自然噪声地形区块、动态加载/卸载、多人可见、聊天、KeepAlive。
- Anvil 存档：完整区块存储，可加载原版世界（真实地形 +
level.dat出生点），保存为无损打补丁（光照/群系/实体透传）；方块修改与箱子/熔炉内容跨重启保留；停机保存 + 自动保存 + 控制台save。 - 自然地形生成（M5 核心）：逐行转写原版
ChunkGeneratorOverworld——- 5×5×33 噪声高度图（depth/main/minLimit/maxLimit 四组八度 Perlin + 群系 5×5 权重卷积）→ 三线性插值填石头/水；
- 30 种原版生物群系（大陆度宏观分带 + 温湿度气候区，陆海间沙滩缓冲，冷/温带/热区不交错）；
- 洞穴雕刻（
MapGenCaves）、8 类矿脉（煤/铁/金/红石/钻石/青金石/绿宝石 + 花岗岩/闪长岩/安山岩）、地表替换与基岩； - 装饰植被：橡树/白桦/云杉/金合欢/沼泽树/深色橡树、高草、花朵、甘蔗、仙人掌、野生南瓜、睡莲、枯灌木、双层植物、水底黏土与沙盘；
- 湖与熔岩湖（原版空腔密封校验，不撕裂海岸）、岩壁水/熔岩泉眼、沙漠水井、地下地牢（苔石室 + 刷怪笼 + 宝箱）、寒带自然覆雪结冰。
- 种子系统：
config/server.toml的seed（空=随机、数字=直取、文本=JavaString.hashCode），持久化到level.dat的RandomSeed，/seed动态读取。 - 旁观者模式与动作同步：
PlayerInfo动作序号对齐原版枚举（更新游戏模式=action 1，含广播给自己）；旁观者无敌/禁交互，切换时对他人销毁/重建自身实体；潜行/疾跑经EntityMetadata（index 0，serializer 1）广播；破坏方块发射WorldEvent 2001粒子，挖掘裂纹动画按原版计时广播BlockBreakAnimation。 - 方块交互：破坏/放置/碰撞检测/回滚，创造/生存模式。
- 容器：箱子、工作台、熔炉（含持久化存储与 shift-click 转移）。
- 物品栏：46 槽背包、点击事务、创造物品修改。
- 玩家持久化：按 UUID 落盘位置/朝向/游戏模式/血量/46 格背包（
world/playerdata/<uuid>.dat，原版 gzip NBT 格式，与原版服务器双向互通），登录恢复、断开保存。 - 命令：
/gamemode /tp /kill /say /op /deop /seed /tps /help，OP 权限，Tab 补全。 - 合成：数据驱动配方（shaped/shapeless），结果槽实时刷新。
- 生物（M6 核心）：僵尸近战、苦力怕引信自爆、骷髅举弓走位射箭、动物繁殖/剪毛/挤奶；原版 A* 寻路（
WalkNodeProcessor）、无敌窗与护甲减伤、经验球与升级公式、死亡掉落。
vanilla/ 下按原版 1.12.2 源码目录保存 2185 个零字节占位文件，每个机制先实现 C++ 等价物、加单元测试，再 git rm 核销对应占位文件。当前进度 228/2185（10.4%）：
python3 tools/vanilla_progress.py按包分布剩余大头：client 643 / entity 236 / block 205 / world 187，详见输出。
| 文档 | 内容 |
|---|---|
docs/architecture.md |
进程/线程、分层、各子系统设计 |
docs/compat.md |
Spigot 兼容契约、NMS 分层、第三方类路径 |
docs/roadmap.md |
里程碑交付清单、当前状态、性能目标、风险 |
docs/protocol.md |
协议 340 事实与验证状态 |
docs/reference-log.md |
参考源审计日志 |