Overworld-Like Reset and Orbital Celestial Phenomena 类主世界重置与轨道天象，以及特殊天体配方扩展

[WhereisFff]

• 为特殊天体配方和持久化数据新增 can_be_shattered 字段，并兼容旧存档与旧数据包的类主世界坍缩判定
• 允许特殊天体自定义大气层颜色
• 允许行星开采器在接收伽马激光时触发类主世界坍缩，限制其在放大模式下建造和工作
• 持久化类主世界代次、种子、轨道时间和玩家撤离状态，在下次服务器启动时安全清理维度存储并使用新种子重新生成
• 在坍缩期间关闭入口传送门、阻止新玩家进入，并将滞留或重新登录的玩家强制转移至主世界安全位置
• 新增 planetary_collapse 不可抵抗伤害类型、死亡消息及绕过护甲、护盾、无敌和效果等伤害标签
• 同步类主世界的代次、轨道和坍缩阶段至客户端，渲染可配置的共享轨道环、日食天空与雾效，并显示坍缩白闪
• 改进特殊天体传送门与回程门的安全落点、紧急平台、附近门复用和双端水淹状态同步
• 更新特殊天体配方、语言文件和生成的数据资源，并将 AnvilLib 升级至 2.0.0+snapshot.513

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && echo "=== hunk 统计（每文件）===" && grep -n "^diff --git" /tmp/pr4502.diff > /tmp/headers.txt && for f in $(grep "^diff --git" /tmp/pr4502.diff | sed 's|.* b/||'); do START=$(grep -n "^diff --git...

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]

⚠️ Dangerous command requires approval:

cd /tmp && javap -p -classpath minecraft-client-1.21.1.jar net.minecraft.util.ColorRGBA 2>/dev/null || unzip -o -q minecraft-client-1.21.1.jar "net/minecraft/util/ColorRGBA*" -d /tmp/crgba && javap -p...

Reason: Security scan — [MEDIUM] Archive extraction to sensitive path: Archive command 'unzip' extracts to a potentially sensitive location

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

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && unzip -o -q minecraft-server-1.21.1.jar "net/minecraft/util/ColorRGBA.class" -d /tmp/mc-classes 2>/dev/null; javap -p -c /tmp/mc-classes/net/minecraft/util/ColorRGBA.class 2>/dev/null | hea...

Reason: Security scan — [MEDIUM] Archive extraction to sensitive path: Archive command 'unzip' extracts to a potentially sensitive location

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

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && python3 -c "
import zipfile
z = zipfile.ZipFile('minecraft-server-1.21.1.jar')
names = [n for n in z.namelist() if 'ColorRGBA' in n]
print(names)
if names:
    data = z.read(names[0])
    i...

Reason: script execution via -e/-c flag

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

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && for j in neoforge-userdev.jar neoforge-21.1.226-universal.jar; do echo "=== $j ==="; python3 -c "
import zipfile
z = zipfile.ZipFile('$j')
names = [n for n in z.namelist() if 'ColorRGBA' in...

Reason: script execution via -e/-c flag

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

[Gugle2308]

验证完毕。已完整读完 3387 行 diff 并对目标分支做了交叉引用（传送门 WATERLOGGED 属性、findSafeLandingPos、OVERWORLD_LIKE_* 常量均确认存在），轨道环渲染矩阵与日食采样数学逐项核对一致。以下是审查意见：

---

代码审查摘要 — PR #4502

操作: review_requested
范围: 57 个文件（50 Java, 7 生成资源）/ 3387 行 diff
分支: CFA4 → dev/1.21/1.6

📋 声称验证表

声称	状态	对应实现
can_be_shattered 字段 + 旧存档/旧数据包兼容	✅	SpecialCelestialBodyRecipe(RenderingFields + legacyCanBeShattered)、SpecialCelestialBodyData(toTag/fromTag + 旧构造器)
自定义大气层颜色	✅	has_atmosphere→atmosphere(ColorRGBA)、LEGACY_HAS_ATMOSPHERE_CODEC 弃用 lifecycle、渲染/屏幕/数据生成全链路
开采器伽马激光触发坍缩 + 放大模式限制	✅	ExcavatorHandler.tryShatterPlanet+beginCollapse、ModMegastructures 前置 !amplified、serverTick 放大早退
持久化代次/种子/轨道/撤离状态 + 启动清理重生成	✅	OverworldLikeResetManifest + OverworldLikeGenerationBootstrap.prepare/deleteDimensionStorage + OverworldLikeWorldState
坍缩期间关闭入口门/阻止进入/强制撤离	✅	tickLandingPortal 关 OPEN、tryLand+isEntryAllowed、tick/登录/重生/换维四路 forceReturn
planetary_collapse 伤害 + 死亡消息 + 全套标签	✅	ModDamageTypes + 8 个生成 tag + LivingIncomingDamageEvent LOWEST 兜底
客户端同步代次/轨道/阶段 + 轨道环/日食/雾效/白闪	✅	SkyStatePacket+CollapsePacket、OverworldLikeClientState、OverworldLikeOrbitalSkyRenderer、3 个 mixin、collapse overlay
安全落点/紧急平台/附近门复用/双端水淹同步	✅	CelestialTravelManager(landing.above、平台+1、GATE_REUSE_RADIUS 复用)、CelestialBackGateBlock(+BE) 水淹状态机
配方/语言/生成资源更新	✅	5 个 recipe json + lang + damage_type/tags
AnvilLib 升级至 2.0.0+snapshot.513	⚠️	本次 diff 中无任何 gradle 文件变更，若该版本此前已合入目标分支则无问题，需确认

⚠️ 警告

• OverworldLikeClientState.java / OverworldLikeResetManager.java — 客户端与服务器日食"暗度"方向相反。 客户端 modifySkyDarken 把 getSkyDarken(float) 乘以 (1 - eclipse×0.72)（暗度变小、天空变亮），而服务器端 Level.getSkyDarken() 是加 +eclipseDarken(0..6)（变暗）。服务器侧暗度会影响生物生成判定与亮度相关逻辑，客户端却把渲染暗度调亮、只靠 sky/fog/cloud 颜色乘性变暗。语义矛盾，建议统一为同一方向（至少注释说明这是刻意设计）。
• OverworldLikeGenerationBootstrap.java — manifest 损坏会阻断服务器启动。 OverworldLikeResetManifest.read 对缺键/截断文件抛 IOException → prepare 转成 IllegalStateException 直接启动失败。建议解析失败时回退 initial() 并记 warn（状态文件损坏不该让整个存档无法启动）。
• OverworldLikeWorldState.java — pendingForcedRespawns/knownOverworldLikePlayers 对"永不回服的离线玩家"永久累积 UUID，多次坍缩后 SavedData 无限增长。建议在 generation 推进时只保留仍存在的玩家档案或加数量上限。
• 生成配方中的 8 位 hex 颜色 alpha 字节为 0。 new ColorRGBA(0x99CCFF) 序列化为 "#0099CCFF"——MC 的 ColorRGBA.parseHex 将 8 位 hex 按原始 int（AARRGGBB）解析，alpha() 为 0。当前 getAtmosphereColor(ColorRGBA) 只取 RGB 所以视觉正常，但任何未来读取 alpha() 的路径都会得到全透明。建议 new ColorRGBA(0xFF99CCFF) 或让数据生成写 6 位 hex（parseHex 自动补 0xFF000000）。
• CelestialBackGateBlockEntity.java — syncWaterloggedState 每个 gate 每 tick 执行（跨维度 getLevel + hasChunkAt + 双方 getBlockState）。门数量多时是持续常数开销，建议节流（每 20 tick 或仅在方块更新时）。
• ExcavatorHandler.java — tryShatterPlanet 位于 isAmplify 早退之前，放大模式下（若已存在开采器结构）仍可触发粉碎/坍缩。与描述"限制建造和工作"一致，但若预期放大模式完全禁用开采器行为，需把早退提前——请确认这是故意为之。
• OverworldLikeCollapseOverlay.java — 未检查 options.hideGui（F1 隐藏 GUI 时白闪仍显示），与同文件其他 registerAboveAll layer 的行为不一致。

💡 建议

• LevelMixin 注入的是 Level.getSkyDarken()（int），若 ClientLevel 覆写了 int 版（委托给 float 版），客户端实际生效的是 float 路径——确认两条路径的注入意图，避免"服务端暗、客户端亮"的隐性不一致。
• 轨道环在 RESET_PENDING 时整体隐藏，但日食雾效/天空颜色在 RESET_PENDING 期间仍按 eclipseFactor 作用（eclipseFactor 只挡了 RESET_PENDING，COLLAPSING 阶段照常）——若坍缩后期想表现"天空已死"效果这没问题，否则可统一。
• OverworldLikeResetManager.tick 在 collapseDamageIssued 后每 tick 向全服广播 state（虽然受重置阶段早退限制在 1–2 tick 内），可加"仅相位变化时广播"守卫。
• forceReturn 使用 getSharedSpawnPos+findSafeLandingPos 双保险很好，建议对 findSafeLandingPos 返回 null 时也记录一条 warn 日志（当前静默回退 spawn）。

🟢 看起来不错

• 轨道数学与渲染完全对齐：我逐项核对了 OverworldLikeOrbitMath.transformRingPoint 与 OverworldLikeOrbitalSkyRenderer 的旋转合成顺序（Ry(-outer)·Rx(14.5108)·Ry(-3.8411)·Rz(14.5109)·[ring 特有]），四个 ring 的矩阵链完全一致——渲染出的环与日食判定采样的天空位置严格重合。
• 三条旧兼容链双向完整：recipe codec（has_atmosphere 弃用 lifecycle + can_be_shattered optional + landing 推导）↔ NBT（atmosphereColor/canBeShattered 新键 + 旧键回退）↔ 旧构造器（legacyAtmosphereColor/legacyCanBeShattered），老存档/老数据包的坍缩判定（landing==overworld_like → 可粉碎）语义一致。
• 重置时序安全：manifest 在 createLevels HEAD（维度未加载）执行删除 + startsWith(worldRoot) 越界防护 + 临时文件原子写 + ATOMIC_MOVE 回退；resetPending 在坍缩开始即持久化，崩溃/干净停机后下次启动都会正确执行清理与玩家撤离——崩溃一致性设计严谨。
• 水淹同步状态机正确：init 分支 OR 合并双端、单端变化单向拷贝、双端同变取 OR，且 connectionChanged 重置 init 标志；NBT 持久化 lastWaterlogged/lastReturnPortalWaterlogged/waterloggedStateInitialized 完整。
• 伤害标签覆盖齐全（含 cooldown/effects/enchantments）且有 LivingIncomingDamageEvent LOWEST receiveCanceled 兜底，创意模式/无敌效果也无法抵抗坍缩，符合"不可抵抗"设计。
• 客户端状态通过两个 packet 同步 + 登录/换维重发 + elapsedTicks 白闪恢复，断线重连也能续上坍缩表现。

结论: COMMENT — 功能实现完整、兼容链与崩溃一致性设计扎实，未发现必须阻塞合并的问题；主要请确认 AnvilLib 升级项（不在本 diff）、客户端/服务端日食暗度方向的一致性，以及上述建议级改进。

---

由 Hermes Agent 审查（webhook 自动发布）

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && node -e "
const fs = require('fs');
const zlib = require('zlib');
function listZip(buf){
  // 简单解析 zip central directory（EOCD）
  const eocd = buf.lastIndexOf(Buffer.from([0x50,0x4b,0x05,0x0...

Reason: script execution via -e/-c flag

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

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && file minecraft-client-1.21.1.jar; python3 -c "
import zipfile
z = zipfile.ZipFile('/tmp/minecraft-client-1.21.1.jar')
names = z.namelist()
print('total:', len(names))
for n in names[:10]: p...

Reason: script execution via -e/-c flag

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

[Gugle2308]

确认：PR #4502 当前 state 为 closed（2026-08-22T06:41:57Z 合并）。

按 webhook 审查规则（步骤 1：closed / labeled → stop here，不发布评论），跳过本次审查，不输出审查意见。

[Gugle2308]

💾 Self-improvement review: Patched references/webhook-session-tooling.md in skill 'minecraft-mod-pr-review' (1 replacement). · Patched SKILL.md in skill 'minecraft-mod-pr-review' (1 replacement).

[Gugle2308]

⚠️ Processing completed but no response was generated. This may be a transient error — try sending your message again.

[Gugle2308]

⚠️ Dangerous command requires approval:

cd /tmp && curl -sL --max-time 60 "https://maven.neoforged.net/releases/net/neoforged/neoform/" 2>&1 | grep -oE 'href="[^"]*1\.21\.1[^"]*"' | head -10; echo "=== linkie api ==="; curl -sL --max-time 6...

Reason: Security scan — [MEDIUM] Lookalike TLD detected: Domain uses '.dev' TLD which can be confused with file extensions

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

[Gugle2308]

⚠️ Processing completed but no response was generated. This may be a transient error — try sending your message again.

[Gugle2308]

⚠️ Dangerous command requires approval:

unzip -o -q /opt/data/workspace/nf-src.jar -d /tmp/nf-src 2>&1 | head -2; find /tmp/nf-src -name "ColorRGBA*" 2>/dev/null | head -3; ls /tmp/nf-src 2>/dev/null | head -5

Reason: Security scan — [MEDIUM] Archive extraction to sensitive path: Archive command 'unzip' extracts to a potentially sensitive location

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

[Gugle2308]

⚠️ Dangerous command requires approval:

curl -sL --max-time 30 "https://linkie.shedaniel.dev/api/1.21.1/mojang/names" -o /tmp/linkie.json 2>&1; echo "exit=$? size=$(wc -c < /tmp/linkie.json 2>/dev/null)"; head -c 200 /tmp/linkie.json 2>/dev...

Reason: Security scan — [MEDIUM] Lookalike TLD detected: Domain uses '.dev' TLD which can be confused with file extensions

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

[Gugle2308]

⚠️ Processing completed but no response was generated. This may be a transient error — try sending your message again.