方块操纵器 - 移动、旋转和调整任何方块的大小

方块操纵器

作者：Luved · Minecraft 1.21.1 · NeoForge

使用紫水晶魔杖选择一个已放置的方块，然后通过屏幕上的手柄移动、旋转或等比缩放它。可以添加微小的偏移、调整装饰性细节的角度，或调整方块的比例，而无需用其他方块类型替换它。

原始方块及其方块实体保持在其逻辑世界坐标上。编辑器保存一个变换，改变方块的渲染、选中和碰撞方式。这种设计保留了方块数据，但也意味着这不是一个完整的物理位移系统。

直观的编辑器

• 移动：拖动坐标轴箭头或使用中心手柄进行摄像机平面移动。
• 旋转：使用交互手柄调整三个旋转轴。
• 缩放：拖动缩放手柄，进行 1/16× 到 4× 的等比缩放。
• 精确操作：输入数值或使用吸附实现可重复的调整。
• 保持控制：在本地坐标轴和世界坐标轴之间切换、撤销更改、重置数值或取消正在进行的拖动。
• 保留编辑：变换按维度持久保存，并通过服务器同步。

快速上手

1. 通过合成配方（2 根木棍、1 个紫水晶碎片，斜向摆放）、创造模式工具标签页，或 /give @s blockmanipulator:manipulator 获得“方块操纵器”。

1. 将其持于主手并右键点击一个方块，或在瞄准方块时按 M。
2. 在未输入文本时，使用 G 移动、R 旋转，或 S 缩放。

1. 拖动手柄并松开以保存。使用数值字段输入精确值。
2. 关闭编辑器并切换到其他物品，即可正常与可见方块交互。

多人游戏与恢复

编辑由服务器验证并同步给玩家。管理员可以使用 /blockmanipulator list 和 /blockmanipulator inspect X Y Z 来定位和检查编辑。审计日志记录已接受的编辑及其作者。

需要排查建筑问题？/blockmanipulator mode logical 可以在不删除已保存编辑的情况下，临时禁用当前维度的变换。/blockmanipulator mode transformed 可恢复它们。

逻辑模式（实际方块位置）：

变换模式（默认）启用：

我把所有黑曜石移到了地面以下。

了解限制及其工作原理

红石、相邻方块更新、方块支撑、流体逻辑及其他内部机制仍然使用原始网格位置。例如，一个视觉上被移动的拉杆会为其原始的逻辑相邻方块供电。

移动后，它仍然为红石供电！

旋转后的碰撞使用保守的轴对齐边界，因此斜角附近的空白区域可能仍会阻挡移动。

变换不会跟随被活塞移动或转化为 Create 机械装置的方块。多部分方块按位置编辑。不保证兼容任意模组渲染器、光影和保护系统；

安装时，请在备份世界中测试你的配置。这不是建议。

兼容性

此模组对渲染、光影和 mixin 的侵入性很强，但应该能与“Flywheel”、“Iris”及大多数光影兼容。再次强调，请测试你的配置。

组件	测试版本	支持内容
原版渲染器	Minecraft 1.21.1	变换后的方块模型、方块实体、破坏覆盖层、粒子、碰撞、选中和光照
Sodium	0.8.13 for NeoForge 1.21.1	变换后方块的区块渲染、面可见性/遮挡和光照处理
Lithium	0.15.4 for NeoForge 1.21.1	变换方块附近的移动扫描和缓存的地面支撑碰撞
Iris	1.8.14-beta.1 for NeoForge 1.21.1	在光影阴影渲染阶段重新渲染变换后的几何体
Flywheel	1.0.6	变换后的方块实体退出 Flywheel 实例化，改用其普通渲染器
Create	6.0.10	通过 Flywheel 回退机制支持静态放置的方块

安装与设置

需要 Minecraft 1.21.1、Java 21 以及 NeoForge 21.1.248 或 21.1 系列中更新的版本。客户端和服务器需安装相同版本。

世界设置存储在 serverconfig/blockmanipulator-server.toml 中，包括每区块变换上限（默认 256）、生存模式编辑和变换后的接触效果。服务器设置可能需要一个活动世界以及配置菜单中的相应访问权限。

延迟与性能

此模组已经过大量测试，问题不大，目前正用于我的 140+ 模组永久硬核世界。

然而，某些方块（具有许多复杂形状和碰撞斜面，例如某些模组方块，如 Sophisticated Backpacks 的背包放置后）在旋转时可能产生延迟。这是待完善的工作。如果你在服务器中使用此模组，我强烈建议你在 server.toml 中禁用“生存模式玩家可以使用该工具编辑方块”，并将其保留为仅限服务器管理员的工具。

配置：

免责声明与 AI 使用

此模组是在我的 Plus 订阅上使用 GPT 6 Astra 构建的，因此我将其奉献给公有领域，你可以随意处置。我估计它花了我每周配额中大约 3 美元。

我（Luved）是真人，已尽我所能进行了测试，并且正在我的 1.21.1 永久硬核世界中使用它，该世界有 140+ 个模组。

如果你是一位经验丰富的 Java 程序员，如果你在 Astra 的代码中发现任何可改进之处，欢迎反编译并留下评论。