Skip to content

让 PyMC 更像原版 1.21.1 服务端:原版地形、Anvil 存档、安全出生 - #3

Merged
hekuo5310 merged 6 commits into
mainfrom
claude/magical-dijkstra-nro58t
Nov 15, 2026
Merged

hekuo5310 merged 6 commits into
mainfrom
claude/magical-dijkstra-nro58t

Conversation

@hekuo5310

Copy link
Copy Markdown
Member

概要

让 PyMC 的行为更接近原版 Minecraft Java 1.21.1 服务端。本 PR 包含分支上的全部提交。

原版服务端外壳与玩法(前几个提交)

  • 原版风格的控制台日志、logs/latest.log 归档、启动/关闭流程和 Done (N s)! 提示
  • 原版文件布局:server.properties、ops.json、whitelist.json、banned-*.json、usercache.json、level.dat、session.lock
  • RCON;online-mode 正版验证(加密 + 会话服务器)
  • 完整的 1.21.1 注册表、标签和命令树同步
  • 原版翻译键消息;原版核心命令
  • 登录检查、死亡/重生流程、光照引擎、物品栏槽位映射、方块交互确认、战斗反馈

原版地形(native/terrain_gen 重写)

  • 移植原版 1.21.1 主世界生成器(C++17,多线程):
    • Xoroshiro128++ / PositionalRandomFactory
    • Perlin / Normal / Blended 噪声
    • 完整密度函数图(4x8x4 插值、flat / 2D 缓存、样条)
    • 含水层、矿脉
    • 多噪声生物群系查找、surface rule
    • Climate.findSpawnPosition
  • 数据来自原版 worldgen JSON(world/data/worldgen_overworld.json,由 tools/gen_worldgen_data.py 生成)
  • 编译时使用 -ffp-contract=off,保证浮点运算与 Java 逐位一致
  • 按生物群系生成树木、花草、矿石、圆盘等地物(近似原版),可跨区块
  • 找不到当前版本的生成器时,服务端启动时会自动编译

存档 / 读档

  • 区块存为原版 Anvil .mca;旧 .linear 区域启动时自动转换,原文件保留为 .linear.bak
  • 修复方块状态属性的编号顺序(原版是最后一个属性变化最快);旧存档自动识别并迁移
  • 玩家数据存为原版 playerdata/<uuid>.dat(gzip NBT,原版槽位编号,末影箱,个人出生点),旧 .json 自动迁移

安全出生 / 重生

  • 世界出生点:原版气候选点 + 11x11 区块螺旋搜索
  • 新玩家:在 spawnRadius 范围内随机挑选安全地面(原版 fudgeSpawnLocation),不会落在水里、岩浆、树顶或方块里
  • 老玩家:回到上次下线的位置,只有被埋住时才挪到附近安全处
  • 重生:在后台线程中查找位置;先发送位置和血量,再推送区块

性能与细节

  • 缓存已编码的区块和区块数据包,入服和重生时不再重复编码未修改的区块。重生从 3 秒多降到约 0.1 秒
  • 点击草、蕨、单层雪等可替换方块时,新方块直接替换它(原版行为)

测试

  • pytest:173 个测试全部通过。新增 tests/test_world_persistence.py,覆盖 Anvil 读写、Linear→Anvil 迁移、playerdata NBT、方块状态顺序和缓存失效;原生地形测试也做了扩展
  • 地形验证:
    • 噪声路由的计算值与参考实现 deepslate 一致(只在它已知与原版不同的几处有差别)
    • 生物群系查找在 20 万个点上与暴力搜索结果一致
  • 出生点:在 40 个种子上测试,全部安全
  • 端到端测试:用 mineflayer 1.21.1 客户端测试多人、聊天/私聊、击杀与重生、挖掘、放置、箱子、生物和持久化。正常关服和 kill -9 后,数据都能保留

已知限制

  • 还没有结构(村庄等)和 carver(峡谷)
  • 地物位置与原版不同
  • 旧版 PyMC 已生成的区块保持不变,与新区块的交界处会有断层
  • 已发布的旧生成器二进制会被忽略,运行环境需要 C++ 编译器(或使用 CI 新构建的二进制)

生物群系查找表来自 cubiomes(MIT),worldgen JSON 来自 misode/mcmeta。


Generated by Claude Code

- 修正 1.21.1 serverbound 数据包 ID 表, 文本组件改用 NBT
- 配置阶段同步完整原版注册表/标签, 主世界 min_y 修正为 -64
- 原版格式日志、启动/关闭流程、level.dat、ops/whitelist/ban JSON
- RCON、online-mode 加密、命令树 (declare_commands)

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MqNsCYYKLCUPjt3r1MFKgu
协议
- 修正 1.21.1 serverbound 数据包 ID 表 (聊天、移动、挖掘、放置等此前全部错位)
- 文本组件按协议使用 NBT/JSON; 断开连接发送带原因的 Disconnect 包
- 配置阶段同步全部原版注册表、标签与 Feature Flags; 主世界 min_y=-64
- 完整 1.21.1 物品 ID 表; 修正物品栏窗口槽位、容器类型与 Set Slot 编码
- 命令树 (declare_commands)、Tab 补全、Acknowledge Block Change

服务端外壳
- 原版格式日志与 logs/latest.log 归档; 原版启动/关闭流程与提示
- server.properties 原版键名与格式; ops/whitelist/banned-*/usercache JSON
- level.dat + session.lock 持久化出生点、时间、天气、游戏规则和种子
- RCON; online-mode 加密与 Mojang 会话验证
- 原版核心命令与翻译键反馈, OP 通知, 原版未知命令错误

玩法
- 原版登录检查、加入/离开/死亡消息、死亡掉落与重生
- 受伤动画、击退、PvP、潜行/疾跑/装备同步; 天空光与方块光
- 区块解码缓存与线程池组包, 消除每刻数百毫秒的卡顿

测试: 新增协议数据、配置、权限文件、level.dat、命令树、光照、RCON、
加密及端到端 TCP 登录测试 (162 通过)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MqNsCYYKLCUPjt3r1MFKgu
Terrain: rewrite native/terrain_gen as a port of the vanilla 1.21.1
overworld generator driven by the vanilla worldgen JSON (noise router
and density functions, Xoroshiro/legacy random, Perlin/Normal/Blended
noise, aquifers, ore veins, multi-noise biome lookup, surface rules,
Climate.findSpawnPosition), plus biome-aware feature decoration
(trees, plants, ores, disks) that spans chunk borders. The server
auto-builds the generator when no current binary is found.

Saving: store regions as vanilla Anvil .mca (Linear worlds are
converted on startup), write vanilla playerdata/<uuid>.dat NBT, and
fix the block state property order (legacy chunks are detected and
migrated).

Spawning: vanilla world spawn search and spawnRadius fudging so new
and respawning players land on safe ground, never in water, lava,
tree tops or inside blocks. Respawn resolves off the event loop and
sends position/health before streaming chunks.

Also: cache encoded chunks and packets so joins/respawns don't
re-encode unchanged chunks, and let block placement replace clicked
replaceable blocks (grass, ferns, single snow layers) like vanilla.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MqNsCYYKLCUPjt3r1MFKgu
windows.h defined min/max macros that broke every std::min/std::max in
the worldgen headers; define NOMINMAX (and WIN32_LEAN_AND_MEAN) before
it and pass /DNOMINMAX from CMake, build.bat and the auto-builder.
Drop /fp:contract-, which MSVC does not know: /fp:precise already
keeps a*b+c unfused, so terrain stays bit-identical to Java.

Pushing a v* tag now builds and tests all three platforms and publishes
a release (PyMC-linux / PyMC-macos / PyMC-windows.exe plus the native
helpers) with notes taken from the new CHANGELOG.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MqNsCYYKLCUPjt3r1MFKgu
@hekuo5310
hekuo5310 merged commit 8e39315 into main Nov 15, 2026
5 checks passed
@hekuo5310
hekuo5310 deleted the claude/magical-dijkstra-nro58t branch November 15, 2026 07:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants