RTS building: Build From Above

简体中文

适用于 Minecraft 1.21.1 / NeoForge 与 Minecraft 1.20.1 / Forge。

这个补丁集中重做了 Ctrl+Z 撤回的可靠性，并为创造模式加入 Ctrl+Y 重做，同时修复大型连续建造、挖掘和范围破坏会逐渐变慢的问题。

玩家可见变化

• Ctrl+Z 现在只保留最近 3 次完整操作；超过宽松安全上限的整次操作不会保存，并会给出提示。
• 创造模式破坏会保存完整 BlockState 和方块实体 NBT；撤回可以恢复箱子、机器等方块的完整内容。
• 创造模式建造会同时保存建造前后快照；覆盖旧方块后撤回可恢复原方块及其 NBT。
• 创造模式现在支持 Ctrl+Y，按精确位置重做最近一次成功撤回的部分；玩家后来改动过的位置会安全跳过并保留待重试状态。
• 生存模式建造撤回会移除仍与本次建造结果一致的方块，并优先把材料退回已连接储存。
• 生存模式破坏撤回只记录位置和 BlockState，不保存方块实体 NBT；恢复时会先从已连接储存、再从原操作快捷栏槽位消耗对应方块。
• 部分成功的撤回/重做不再按列表前缀猜测，而是只迁移真正成功的位置，失败位置仍可再次尝试。
• 大型连续建造、挖掘和范围破坏改为延后写入历史检查点，不再每个处理片段复制越来越大的历史记录，改善“越造越慢 / 越挖越慢”。

兼容与回退

• Ctrl+Y 当前仅对创造模式开放；生存模式仍只有 Ctrl+Z。
• 本版本以预发布补丁形式提供。如果遇到严重回归，可暂时回退到 1.1.6，并附上日志与复现步骤反馈。

验证

• NeoForge 1.21.1：完整构建、常规测试、性能债务、UI/资源/字节码门禁通过。
• Forge 1.20.1：完整构建通过，719 项常规测试、3 项性能债务门禁及 UI/资源/字节码检查全部通过。
• 内置教程的“技术信息附录”已同步更新撤回/重做责任链和排查点。

English

For Minecraft 1.21.1 / NeoForge and Minecraft 1.20.1 / Forge.

This patch rebuilds Ctrl+Z reliability, adds creative-mode Ctrl+Y redo, and fixes the progressive slowdown seen during large continuous placement, mining, and area destruction jobs.

Player-visible changes

• Ctrl+Z now keeps only the latest three complete operations. An operation that exceeds the generous safety limit is not recorded, and the player is notified.
• Creative breaking records the full BlockState and block-entity NBT, allowing chests, machines, and similar blocks to be restored with their complete contents.
• Creative placement records both before and after snapshots, so undo can restore an overwritten block and its NBT.
• Creative mode now supports Ctrl+Y. Redo moves only positions that were actually restored; positions changed afterward are safely skipped and remain retryable.
• Survival placement undo removes only blocks that still match the recorded placement result and returns materials to linked storage first.
• Survival break undo records positions and BlockState without block-entity NBT. Restoring consumes matching blocks from linked storage first, then the hotbar slot recorded by the original operation.
• Partial undo and redo now track exact successful positions instead of assuming a successful list prefix.
• Large placement, mining, and area-destruction jobs use write-behind history checkpoints instead of copying an ever-growing history on every slice, reducing the “gets slower over time” behavior.

Compatibility and rollback

• Ctrl+Y is currently creative-only; survival mode continues to provide Ctrl+Z only.
• This is published as a prerelease patch. If you encounter a serious regression, temporarily return to 1.1.6 and report it with logs and reproduction steps.

Verification

• NeoForge 1.21.1: full build, regular tests, performance-debt checks, and UI/resource/bytecode gates passed.
• Forge 1.20.1: full build passed, including 719 regular tests, 3 performance-debt checks, and all UI/resource/bytecode validations.
• The bundled tutorial Technical Information Appendix was updated with the undo/redo responsibility chain and troubleshooting checkpoints.