In the updated content of the manual 在手册更新内容

[TBPig]

No description provided.

[Copilot]

🟡 Changes recommended

A few documented navigation/formatting and correctness issues were found (missing tool category in guide book pages, Moon title encoding, and X/Y vs X/Z coordinate wording).

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the in-game manual content (Chinese and English) to reflect recent gameplay/mechanics changes, improve cross-references, and add missing documentation for the Moon feature.

Changes:

• Refreshed Guide Book acquisition/usage docs and linked monolith-related entries via items frontmatter.
• Expanded/updated container (crate/shulker container/storage station) and other block/material documentation details.
• Added new “Moon” feature pages in both zh_cn and en_us.

Verification:

• Not run (documentation-only changes).

File summaries

File	Description
src/main/resources/assets/anvilcraft/ageratum/zh_cn/005_tool/000_guide_book.md	Updates Guide Book page content and frontmatter items.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/402_mega_structure.md	Tweaks Dyson Sphere amplification description.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/401_celestial_forging_anvil.md	Clarifies gravity behavior (sneaking exception).
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/331_hyperdimension_storage_station.md	Clarifies crafting prerequisite (requires 4 upgrades).
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/215_large_crate.md	Adds tips and updates storage/terminal behavior descriptions.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/003_crate.md	Adds classification and crafting-window sections.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/002_jewelcrafting_table.md	Refines replication description and recipe layout text.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/004_block/001_redstone.md	Improves GUI description wording.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/002_material/210_liquid_enchantment.md	Re-formats table and adds curse-related recipes.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/002_material/140_void_matter.md	Adds crate-adjacent behavior note.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/001_feature/301_moon.md	Adds new Moon feature page.
src/main/resources/assets/anvilcraft/ageratum/zh_cn/000_process/007.md	Reorders/clarifies tips about cursed-gold production sources.
src/main/resources/assets/anvilcraft/ageratum/en_us/005_tool/000_guide_book.md	Updates Guide Book page content and frontmatter items.
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/402_mega_structure.md	Tweaks Dyson Sphere amplification description.
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/401_celestial_forging_anvil.md	Clarifies gravity behavior (sneaking exception).
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/331_hyperdimension_storage_station.md	Clarifies crafting prerequisite (requires 4 upgrades).
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/215_large_crate.md	Adds tips and updates storage/terminal behavior descriptions.
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/003_crate.md	Adds classification and crafting-window sections.
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/002_jewelcrafting_table.md	Refines replication description and recipe layout text.
src/main/resources/assets/anvilcraft/ageratum/en_us/004_block/001_redstone.md	Improves GUI description wording.
src/main/resources/assets/anvilcraft/ageratum/en_us/002_material/210_liquid_enchantment.md	Adds curse-related recipes to liquid enchantment table.
src/main/resources/assets/anvilcraft/ageratum/en_us/002_material/140_void_matter.md	Adds crate-adjacent behavior note.
src/main/resources/assets/anvilcraft/ageratum/en_us/001_feature/301_moon.md	Adds new Moon feature page.
src/main/resources/assets/anvilcraft/ageratum/en_us/000_process/007.md	Clarifies tip about which replicated items carry vanishing curse.

Review details

Suppressed comments (1)

src/main/resources/assets/anvilcraft/ageratum/en_us/001_feature/301_moon.md:24

• Minecraft uses X/Z for horizontal coordinates; using “X and Y coordinates” would imply a vertical (Y) check, which doesn’t match the concept of near/far side biomes. This should likely be X/Z instead of X/Y.

Biomes where the X and Y coordinates are both less than 1024 and greater than -1024 are on the near side of the Moon; all other areas are on the far side

• Files reviewed: 24/24 changed files
• Comments generated: 4
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && echo "=== 文件列表对称性 ==="; diff <(grep "^diff --git" pr4776.diff | grep en_us | sed 's|.* en_us/||') <(grep "^diff --git" pr4776.diff | grep zh_cn | sed 's|.* zh_cn/||') && echo "✅ 完全对称"; echo...

Reason: Security scan — [MEDIUM] Variation selector characters detected: Content contains Unicode variation selectors (VS1-256). These are commonly used in emoji sequences but may indicate steganographic encoding or obfuscation

Reply /approve to execute, /approve session to approve this pattern for the session, /approve always to approve permanently, or /deny to cancel.

[Gugle2308]

代码审查摘要 — PR #4776

操作: review_requested
范围: 24 个文件（0 Java；纯 ageratum 手册 md，en_us 12 + zh_cn 12）/ 548 行 diff / 新增 2 页（001_feature/301_moon.md 中英各一）
分支: pig/1.21/1.6 → dev/1.21/1.6（merge-base 即目标分支尖端 c9026b2018，无冲突；301_moon.md 在目标分支不存在，新增不冲突）

---

🟢 已逐条对照源码交叉验证通过

手册声称	代码依据	结论
潜影容器约 1024 种物品、每种容量 1024 组	ShulkerContainerStorage.DEFAULT_TYPE_LIMIT=1024，TypeLimitItemStacksResourceHandler(1024, 65536)（65536 物品 = 1024 组）	✅ 修正了旧的「6.5 万种/6.5 万个」
压入空间压缩器使种类与容量翻倍，最多四次	UpgradeShulkerContainerBehavior：MAX_UPGRADES=4、MAX_TYPE_LIMIT=16384、MAX_SPACE_SIZE=1048576（=65536×16）	✅
超维存储站需砸入升级过四次的潜影容器	Upgrade2HyperdimensionStationBehavior：spaceSize < MAX_SPACE_SIZE 直接 return false	✅ 补全了前置条件
大板条箱 1024 组、板条箱 32 组	LargeCrateStorage → SpaceSizeItemStacksResourceHandler(65536)	✅
虚空物质放在板条箱旁、装满时销毁输入	CrateBlock.hasAdjacentVoidMatter/dispose（仅普通 VoidMatterBlock 触发）	✅
手持大板条箱 Shift 右击替换 3×3×3 板条箱	CrateBlock.useItemOn：isShiftKeyDown() && is(LARGE_CRATE) → mergeIntoLargeCrate，findLargeCrateOrigin 要求整块 3×3×3	✅
液态魔咒：9 诅咒金块+虚空物质→消失诅咒 1mB；9 诅咒金块+锁链→绑定诅咒 1mB	SolidLiquidRecipeLoader 的 vanishing_curse / binding_curse，consume(1)、curseFluid(...) = 1mB	✅ 数值完全一致
珠宝加工台「部分仿制品附带消失诅咒」，点名图腾+护符	JewelCraftingRecipe.hasVanishingCurse（默认 true；trial key/不祥之瓶/旗帜图案/唱片/陶片/盔甲纹饰为 false；图腾、鞘翅、重核、各护符为 true）	✅
合成窗口需仓库内有工作台+切石机；Shift 合成 1 组、空格 8 组	StorageServerStub.craftingAvailable（两个 tag 都要）；StorageScreen：space ? 8 : 1	✅
分类左击标绿、只显示同时满足所有标绿条件的物品	StorageServerStub.createOrder：任一非 UNLIMITED 条目不通过即 return false（AND）	✅
悬浮指南书按 A 打开「集成」	ModKeyMappings.THOUGHT 默认 GLFW_KEY_A（KeyConflictContext.GUI）+ GuideBookItem implements Thinkable#onThought	✅ W→A 修正正确
浮窗：Shift 按行滚动、Ctrl 按页	TerminalRemoteOverlay.mouseScrolled：hasControlDown → pageSize，else if hasShiftDown → gridSize	✅

另外确认无副作用项：3×3×3 板条箱全并成一行（页面中最多 11 个 recipe 的先例）、categories: - tools 的移除无影响（ageratum 0.0.1+build.111 的 MDDocument 只读 navigation/guide/items/item/item_id/title，不解析 categories）、被删章节的锚点无任何页面引用（无断链）。

---

🔴 关键

1. 新增「月面」段落的判据与代码不符（中英两侧同错）

• en_us/001_feature/301_moon.md（末段）：Biomes where the X and Y coordinates are both less than 1024 and greater than -1024 are on the near side of the Moon
• zh_cn/001_feature/301_moon.md：x和y坐标小于1024，大于-1024的群系为月球正面
• 代码实际：MunSkyMath.isFarSide(double x, double z) → Math.max(Math.abs(x), Math.abs(z)) > NEAR_SIDE_HALF_SIZE，而 NEAR_SIDE_HALF_SIZE = 2048.0。三个问题：

1. 轴错：判定用的是水平 x/z，不是 x/y；
2. 阈值错：常量是 2048，不是 1024（全仓库无月球相关 1024 常量）；
3. 「群系」不成立：data/anvilcraft/dimension/mun.json 的 biome_source 是 minecraft:fixed → 整个月球只有 anvilcraft:mun 一个群系，不存在按坐标划分的群系；正/背面只影响天空与日照几何（skyRotation/sunlight 取相机 x/z），而且 isFarSide 目前在源码中没有任何调用者。

• 建议改为「天空/光照的正背面」表述并写 z、2048（如 1024 有其它依据请说明来源）。

---

⚠️ 警告

2. 月球返程说明不完整且有一处不准（中英两侧）
新页面只写「触摸可以回到主世界的出生点」，但 TheMonolithEventListener.onRightClickBlock 的实际行为是：

• 需要第二次右击确认（首次只发 message.anvilcraft.monolith.return_confirmation）；
• 目标是玩家当前重生点（findRespawnPositionAndUseSpawnBlock），不一定是主世界出生点——被删掉的旧文案「按末地出口的规则返回当前重生点」本来更准确；
• 只对非核心方块生效（事件只处理 MONOLITH/MONOLITH_LINE/GIANT_MONOLITH_LINE，核心被排除），旧文案明确写了「非核心部分」。
• 另外，末影珍珠返程仍在代码中有效（MunTravelEventListener：月球原点 128 格内、Y>512、速度 ≥32、不需要午夜、落地 1 点伤害），但指南书的「月球返程」整节被删除后，手册里已完全不提这条路径。建议在 301_moon.md 中补回。

3. 指南书获取方式被收窄为只接受原版铁砧
MonolithCoreBlockEntity.acceptsOffering(stack,false) 实际接受：minecraft:anvil / chipped_anvil / damaged_anvil 以及本体的 spectral / neoforge / royal / frost / ember / transcendence 铁砧。旧文案「原版铁砧和铁砧工艺本体的特殊铁砧均可献祭」被删，新文案只写 <ref item="minecraft:anvil"/>，会让玩家以为本体铁砧不能用。同时被删但仍然正确的信息：每核心 5 秒一次献祭（OFFERING_TICKS=100）、指南书无法合成（datagen 中确实没有 guide_book 配方，只有成就掉落）。建议保留这些要点或至少改回「（含本体特殊铁砧）」。

4. 402_mega_structure.md 删除的句子目前仍然成立
褐矮星→红矮星后：transformToRedDwarf → normalizeRedDwarfState() 会 clearAuxiliaryMegastructures() + clearMegastructure()（既有戴森球确实被销毁）、setAmplify(true)（需增幅器才能显示/运行）、且只能重建小型戴森球——ModMegastructures.DYSON_SPHERE_SMALL 恰好需要 16 个戴森球组件（DYSON_SPHERE_BROWN_DWARF 为 8、LARGE 为 32）。删除后玩家会失去「建好的戴森球会被拆掉」这一关键警告。若只想删掉「切换为恒星的大型束星环」这一句（可能已过时），建议保留销毁与重建成本部分。

---

💡 建议

• en_us|zh_cn/002_material/210_liquid_enchantment.md：新增两行数量写法不统一（en 写 9 <ref .../>，zh 写 9x <ref .../>），而同行其它行的既有风格是 12mB/纯数字，建议两侧统一（推荐 9x）。
• 215_large_crate.md 终端浮窗：TerminalRemoteOverlay.take 中普通左击即可取出（左键一整组/右键单个，取到指针），Shift+左击才是「直接移入背包」。en 改为 Shift-left-click to withdraw it 会让读者以为必须按 Shift（zh 的「(shift)左击取出」较接近）；建议写成「左击取出（按住 Shift 直接放进背包）」。同段的 Use Alt to zoom in 也不准确：Alt（LALT/RALT）是在三种面板尺寸间循环切换（remote_4/5/6），建议写「按 Alt 切换面板尺寸」。
• zh_cn/004_block/003_crate.md：文末仍缺换行（No newline at end of file）；本次改动重写了末行但未补上（en 侧正常）。
• PR 标题：在手册更新内容 过于笼统，建议改为 Update manual content: guide book, Moon page, storage blocks 更新手册内容（指南书/月球/仓储）。我已尝试用 gh pr edit 4776 --title ... 代为修改，但本环境 gh auth status 显示 token 失效（HTTP 401: Bad credentials），无法完成，需作者或维护者手动改（按规范我没有导出任何凭据）。

---

📋 变更核对表

文件（en/zh 对称）	状态	说明
000_process/007.md	✅	两 tip 已对齐；「图腾+护符」举例经 JewelCraftingRecipeLoader/JewelCraftingRecipeGeneratingCache 验证正确
001_feature/301_moon.md（新增）	⚠️	结构/锚点/物品 id 全部有效（#anvil-impact-crafting、#hidden-celestial-bodies、lunar_rock 等均已注册；zh 用中文锚点符合既有 44 处先例），但正/背面段落见 🔴1、返程见 ⚠️2
002_material/140_void_matter.md	✅	与 CrateBlock dispose 逻辑一致
002_material/210_liquid_enchantment.md	✅（💡写法）	配方数值精确匹配
004_block/001_redstone.md	✅	纯措辞修正
004_block/002_jewelcrafting_table.md	✅	「部分仿制品带诅咒」与 has_vanishing_curse 一致；合并为一行不超既有排版先例（最多 11 个/行）
004_block/003_crate.md	✅（💡EOF）	三新段均与代码一致
004_block/215_large_crate.md	✅（💡浮窗措辞）	数值/合并机制均已验证
004_block/331_hyperdimension_storage_station.md	✅	「升级过四次」为必要前置
004_block/401_celestial_forging_anvil.md	✅	「潜行不受影响」与引力系统一致
004_block/402_mega_structure.md	⚠️	删除内容仍成立，见 ⚠️4
005_tool/000_guide_book.md	⚠️	A 键/物品链接正确，但获取方式被收窄、删掉的信息仍有价值，见 ⚠️3

结论: COMMENT（建议修改后合并） — 本次更新绝大部分是把手册数值与代码对齐，方向完全正确（潜影容器容量、超维存储站前置、A 键、合成窗口、分类 AND 语义、液态魔咒新配方等均已逐条核实为真）。阻塞项只有一处：新增「月面」的坐标轴/阈值与代码冲突（且「群系」表述不成立），加上月球返程与非核心方块、二次确认、珍珠返程的说明缺失，建议一并修正后合并。无 Java 变更，无序列化/注册/兼容性风险。

由 Hermes Agent 审查

[Gugle2308]

💾 Self-improvement review: Patched SKILL.md in skill 'documentation-pr-review' (1 replacement).

[Gugle2308]

代码审查摘要 — PR #4776

操作: opened（非 closed/labeled，正常审查）
范围: 24 个文件（en_us 12 + zh_cn 12，全部为 ageratum 手册 markdown）/ +121 −44 行 / 新增 2 个文件（月球页中英各一）/ 删除 0 个
性质: 纯文档 PR，无 Java、无资源、无 en_ud（项目本就无 en_ud 目录，跳过同步检查）

---

🔴 关键

• en_us/001_feature/301_moon.md:3 — 导航标题 title: "?5Moon"，§ 被写成了字面问号
  od -c 实测该行字节为 ? 5 M o o n（0x3F），而全库其它全部 en_us 页面均使用 §（同目录 401_celestial_type.md = §5Celestial Types、215_large_electromagnet.md = §6Large Electromagnet），zh_cn 侧本 PR 新增页写的是正确的 §5月球。
  结果：英文侧导航项会原样显示为「?5Moon」且丢失颜色码。应改为 "§5Moon"。

⚠️ 警告

• 301_moon.md「Lunar Surface / 月面」的坐标与阈值描述缺乏依据
  原文：x和y坐标小于1024，大于-1024的群系为月球正面。三点问题：

  1. Minecraft 水平坐标是 X/Z，Y 是高度；源码判定也是 MunSkyMath.isFarSide(double x, double z) → max(|x|,|z|)。
  2. 全库唯一的正/背面常量是 MunSkyMath.NEAR_SIDE_HALF_SIZE = 2048.0（不是 1024），且它同时用于 skyRotation() 的距离缩放。
  3. 月球只有一个群系（data/anvilcraft/worldgen/biome/mun.json），正/背面是天空与日照几何（sunlight/skyRotation）概念，不是群系划分，写成"群系"容易被误解。
     → 建议改为「当 |X| 与 |Z| 均不超过 2048 时为月球正面」并去掉"群系"措辞（或说明 1024 的出处）。

• 301_moon.md「月球巨石碑」第 1 条丢失了返程机制的关键细节
  新写「触摸可以回到主世界的出生点」，但源码是：

  • TheMonolithEventListener.onRightClickBlock：只在月球维度、且方块为 MONOLITH / MONOLITH_LINE / GIANT_MONOLITH_LINE（非核心部件）时触发；核心右击不会返程（核心是献祭巨砧的位置）。
  • 需要点两次：首次仅发送 message.anvilcraft.monolith.return_confirmation 提示，第二次才传送（RETURN_TOUCHES）。
  • 目的地是 player.findRespawnPositionAndUseSpawnBlock(...)，即玩家当前重生点（床/重生锚，可跨维度），无重生点才退回世界出生点。所以"Overworld spawn"对有床的玩家不准确。
    同时，本 PR 把旧版 005_tool/000_guide_book.md 里那段精确描述（"右击石碑的非核心部分，看到提示后再次右击，按末地出口的规则返回当前重生点"）整段删除，细节就此丢失。→ 建议在新月球页补回"非核心部件 + 二次点击确认 + 返回重生点"。

• 同一 PR 中删除的旧信息未全部迁移（信息净损失，非阻塞但建议确认是否有意）：石碑核心献祭冷却（每核心 5 秒一次）、铁砧嵌入并化为雾气的表现、本体特殊铁砧也可献祭、超平坦主世界不生成石碑；以及整段 # Other:（指南信息可能滞后、欢迎贡献/反馈）。中英两侧都删了，若是有意精简请忽略。

💡 建议

• zh_cn/004_block/003_crate.md 仍缺文件末尾换行（diff 新旧两侧都是 \ No newline at end of file，en_us 侧有换行）。这行本次被改写，正好顺手补上。
• 005_tool/000_guide_book.md 移除了 categories: - tools（中英一致），但页面仍在 005_tool/ 目录，且同目录其它页面保留该字段。若导航按 categories 分组，指南将不再出现在 Tools 分类下——若非有意，建议保留。
• 小一致性：液态魔咒新行 en 写 9 <ref …cursed_gold_block/>，zh 写 9x <ref …/>；建议两侧统一（要么都带倍数、要么都不带）。

🟢 看起来不错（均已对目标分支源码交叉验证）

文档声明	验证来源	结论
指南书「悬浮后按 A 打开集成」（原 W）	ModKeyMappings.THOUGHT 默认 GLFW_KEY_A（GUI 上下文）+ GuideBookItem.onThought() → IntegrationUtil.openIntegrationScreen()	✅ 修正正确
消失诅咒液体魔咒 = 9 诅咒金块 + 虚空物质 + 1mB；绑定诅咒 = 9 诅咒金块 + 链 + 1mB	SolidLiquidRecipeLoader L130-158	✅
珠宝加工台「部分仿制品带消失诅咒（不死图腾、各种护符）」	JewelCraftingRecipe codec optionalFieldOf("has_vanishing_curse", true)；图腾/护符/鞘翅无该字段=默认 true，试验钥匙/旗帜图案/唱片/陶片/锻造模板为 false	✅ "部分"表述准确
储物箱分类显示「左击标绿、需同时满足所有条件」	StorageServerStub 逐条遍历 CategoryEntry，任一不匹配即返回 false（AND 语义）	✅
储物箱合成窗口「放入工作台+切石机启用；Shift 合 1 组、空格合 8 组」	StorageServerStub.craftingAvailable（PLAYER_WORKSTATIONS_CRAFTING_TABLES + …_STONECUTTERS 标签）；StorageScreen.clickCraftingResult → takeAllChunk(..., space ? 8 : 1)	✅
潜影盒容器「约 1024 种物品 × 每种 1024 组」（原 6.5万×6.5万）	ShulkerContainerStorage = TypeLimitItemStacksResourceHandler(1024, 65536)，computeCount = floorDiv(space, ceilDiv(64, maxStackSize)) → 65536 个 = 1024 组	✅ 旧值确实是错的
存储终端浮窗 Shift 按行 / Ctrl 按页 / Alt 放大 / Shift 左击取入背包	TerminalRemoteOverlay L285-296（pageSize/gridSize）、L320（ALT 切尺寸）、L744（Shift → takeToInventory）	✅
天体引力「玩家潜行时不受影响」	GravityManager L168 / L686 entity instanceof Player player && player.isShiftKeyDown()	✅
登月「午夜 + 极高速度向上发射末影珍珠」	MunTravelEventListener：MIDNIGHT=18000（±1000）、Y>512、speed ≥ 32、需向上	✅
链接锚点与物品 ID	#anvil-impact-crafting/#铁砧撞击合成、#hidden-celestial-bodies/#隐秘天体 均存在；../006_prop/100_amulet.md 双语均存在；lunar_rock/lunar_soil/monolith/monolith_core/monolith_line/giant_monolith_* 均在 ModBlocks 注册	✅
中英文对称性	12/12 文件路径一一对应；无指向被删章节的悬空引用	✅

📋 结构核对

• 2 个新增页面（001_feature/301_moon.md）中英成对 ✅；001_feature/index.md 仅为目录说明，无需登记子页 ✅
• ghost 文件：0 ✅；被删章节无外部反向引用 ✅

结论: REQUEST_CHANGES（小改即可合并） — ?5Moon 的 § 编码错误必须修；月面坐标（1024/2048 与 X/Y→X/Z）和石碑返程（非核心 + 二次点击 + 返回重生点）两处表述建议按源码修正后再合并。其余为可选润色。

🏷 PR 标题

原标题 在手册更新内容 缺英文标题、信息量不足。建议标题：

Update handbook: add Moon page and correct outdated entries 更新手册：新增月球页并修正过时内容

⚠️ 未执行 gh pr edit：gh auth status 显示 /opt/data/home/.config/gh/hosts.yml 中 token 已失效（Failed to log in to github.com account Gugle2308），本流程禁止 export GITHUB_TOKEN，故无法自动改标题，请维护者手动设置或修复 gh 登录后由我更新。

由 Hermes Agent 审查

[Gugle2308]

💾 Self-improvement review: Patched SKILL.md in skill 'documentation-pr-review' (1 replacement). · Patched SKILL.md in skill 'github-webhook-pr-review' (1 replacement).

[Gugle2308]

PR #4776 action 为 closed，按 Webhook 约束第 1 条：跳过审查，不发布评论。

说明：已关闭/已打标签的 PR 不触发审查流程，故本次无审查意见输出。若需要复审，请在 PR 重新打开（或推送新提交）后再次触发。