活塞ProPlus

PistonProPlus

让活塞再次伟大。


这是一个适用于 Minecraft 的服务器端 Fabric 模组，通过可配置的推动限制、高级方块推动控制以及 NBT 数据保留功能来增强活塞的行为。

功能特性

• 可配置推动限制 -- 突破原版 12 个方块的上限，可设置在 1 到 4096 之间的任意限制。
• 无限推动模式 -- 将限制设置为负数即可启用几乎无限制的推动。
• 基于类型的方块控制 -- 可单独切换命令方块和所有其他方块是否可以被推动。
• NBT 数据保留 -- 方块实体数据（例如命令方块的命令）在活塞推动后得以保留。
• 热重载 -- 使用 /pistonproplus reload 即可即时更改配置，无需重启服务器。
• 完整国际化 (i18n) -- 内置英文和中文；易于扩展。

命令

推动限制

命令	权限	描述
/pistonproplus pushlimit set <limit>	OP（4级）	设置活塞推动限制（1-4096）。使用 -1 启用无限模式。
/pistonproplus pushlimit get	无	显示当前的推动限制和模式。

类型限制

命令	权限	描述
/pistonproplus typelimit commandblock [true/false]	OP（4级）	切换或查询命令方块的推动。
/pistonproplus typelimit all [true/false]	OP（4级）	切换或查询所有方块（除移动中的活塞和命令方块外）的推动。

省略布尔参数将显示当前状态（开/关）。

实用工具

命令	权限	描述
/pistonproplus help	无	显示帮助菜单。
/pistonproplus reload	OP（2级）	从磁盘热重载配置。

配置

设置存储在 config/pistonproplus.json 文件中，可以直接编辑或通过命令修改。

{
  "maxPushLimit": 12,
  "allowInfinitePush": false,
  "allowPushCommandBlock": false,
  "allowPushAllBlocks": false
}

键名	类型	默认值	描述
maxPushLimit	int	12	活塞最多可推动的方块数（1-4096）
allowInfinitePush	boolean	false	为 true 时，推动限制变为 4096
allowPushCommandBlock	boolean	false	允许活塞推动命令方块（保留 NBT）
allowPushAllBlocks	boolean	false	允许活塞推动几乎所有方块（除移动中的活塞外）

警告

• 移动中的活塞（方块ID 36）永远不能被推动。 这是一个硬性安全限制。
• 命令方块在极端情况下可能丢失 NBT 数据；该模组通过捕获/恢复来保留 NBT，但复杂的设置应进行测试。
• 推动所有方块可能会导致意外行为。 粘液块上附着的方块（如红石粉、火把等）在大型推动过程中可能会出现异常行为。
• 极高的推动限制可能会导致服务器卡顿。 在部署到生产服务器之前，请逐步进行测试。

许可证

本项目基于 GNU General Public License v3.0 许可。

链接

• GitHub

---

本模组与 Mojang Studios 无关联或未经其认可。Minecraft 是 Mojang Studios 的商标。