JianFeeeee 35534b1564 feat: get_block_info —— 方块信息查询（Java 侧回答，Python 只路由） ...

新增 cmd=blockinfo（两代后端编译通过、实测）：
  返回 block 名（含 mod 方块）、stateId、属性、isAir/isSolid、
  光照/硬度、贴图缺失的程序化判据、是否来自 mod。

★ 修掉一个真实缺陷（附录 D 的语义区分落到了实处）：
  未加载区块原先返回 void_air（known=true），实测发现两个 API 都不可用：
    - ClientLevel.hasChunk()      反编译实测**恒返回 true**
    - ChunkSource.hasChunk()      走 getChunk(...,false)，而 ClientChunkCache
      覆写后在该参数下返回 emptyChunk（占位，非 null）⇒ 也恒 true
  正解：getChunk(..., requireChunk=**false**) 判 null
    （反编译：return requireChunk ? emptyChunk : null;）
  ⇒ 现在未加载明确回 known=false + reason=chunk_not_loaded

实测（1.20.1）：
  草地 → minecraft:grass_block props={'snowy':'false'} missing=False
  原木 → minecraft:oak_log       props={'axis':'y'}
  空气 → minecraft:air
  远处 → known=false reason=chunk_not_loaded        ← 与空气区分

实测（1.21.1 + mod）：
  mts:mtsofficialpack.fancydirt_block   mod=True tex=mtsofficialpack:block/fancydirt
  createbigcannons:steel_block          mod=True tex=createbigcannons:block/steel_block
  ⇒ mod 方块同样能查到正确贴图名与 fromMod 标记

顺带修 gen_1_21 两处世代差异（ChunkStatus 换包、bridge 编译顺序）。
测试：69 项全绿（新增 test_get_block_info 6 条判据）

2026-09-26 00:24:29 +08:00

1.5 KiB

Raw History

View Raw