体素清理器

体素清理器

一个轻量级的 Fabric 模组,用于挖空区域并生成房间,支持撤销/重做。

游戏机制

VoxelCleaner

VoxelCleaner 是一个 Minecraft 模组,旨在通过游戏内命令提供强大的基于体素的编辑功能。凭借房间生成、区域挖空、历史记录跟踪(撤销/重做)、战利品管理和方块保护等特性,它是创作者、地图制作者和服务器管理员的必备工具。


目录


特性

  • 🧱 房间生成:使用单条命令生成指定宽度、高度和深度的房间。
  • 🕳️ 区域挖空:清空体积内容,同时保留外壳方块。
  • ♻️ 撤销/重做:通过历史记录跟踪还原或重新应用世界更改。
  • 🎁 战利品管理:破坏方块、生成箱子并自动分配战利品。
  • 🔒 方块保护:防止修改受保护的方块,如刷怪笼和带有实体的方块。
  • 🧰 命令工具:用于辅助命令中玩家和方块定位的实用方法。

安装

  1. 为 Minecraft 安装 Fabric Loader。
  2. 安装 Fabric API。
  3. 下载 VoxelCleaner 模组 JAR 并将其放入你的 mods 文件夹。
  4. 使用 Fabric 配置文件启动游戏。

用法

主要命令

/voxelcleaner

别名: /vc
清空(挖空)玩家前方的矩形区域。

/voxelcleaner <width> <height> <depth>
/voxelcleaner <width> <height> <depth> <material>
/voxelcleaner <width> <height> <depth> <material> <force>
/voxelcleaner <width> <height> <depth> <material> <force> <loot>

参数:

  • width – 区域内部宽度
  • height – 区域内部高度
  • depth – 区域内部深度
  • material (可选) – 用于外壳的方块
  • force (可选,布尔值) – 移除受保护的方块
  • loot (可选,布尔值) – 将掉落物收集到箱子中

/voxelroom

别名: /vr
创建一个带有墙壁、地板和天花板的完整房间。

/voxelroom <width> <height> <depth> <walls> <floor> <ceiling>
/voxelroom <width> <height> <depth> <walls> <floor> <ceiling> <force>
/voxelroom <width> <height> <depth> <walls> <floor> <ceiling> <force> <loot>

参数:

  • width – 房间内部宽度
  • height – 房间内部高度
  • depth – 房间内部深度
  • walls – 墙壁方块
  • floor – 地板方块
  • ceiling – 天花板方块
  • force (可选,布尔值) – 覆盖受保护的方块
  • loot (可选,布尔值) – 将移除的方块收集到箱子中

历史命令

/voxelundo

别名: /vcu
撤销上一次体素操作。

/voxelundo
/voxelundo <count>

/voxelredo

别名: /vcr
重做之前撤销的体素操作。

/voxelredo
/voxelredo <count>

/voxelhistory

别名: /vch
显示当前玩家的命令历史记录。

/voxelhistory
/voxelhistory <count>

注意事项

  • 所有命令均为仅限玩家(无法从控制台执行)。
  • 撤销/重做按每名玩家和每个维度独立工作。
  • 如果未指定,force 和 loot 默认为 false。
  • 受保护的方块(方块实体、刷怪笼)除非 force = true,否则会被保留。

配置

所有常量都集中在 VoxelConfig.java 中。值得注意的配置选项:

public static final int MAX_W = 64;
public static final int MAX_H = 64;
public static final int MAX_D = 64;
public static final int MAX_ACTIONS_PER_PLAYER = 10;
public static final int MAX_HISTORY_LINES = 20;
public static final String TIMEZONE = "America/New_York";

调整这些值以微调玩家限制、历史深度和尺寸约束。


示例

# 使用默认材料挖空一个 10x5x10 的区域
/voxelcleaner 10 5 10

# 使用石头外壳挖空一个 10x5x10 的区域并收集战利品
/voxelcleaner 10 5 10 minecraft:stone true true

# 使用不同的方块作为墙壁、地板和天花板创建一个 7x4x7 的房间
/voxelroom 7 4 7 minecraft:oak_planks minecraft:birch_planks minecraft:glass

# 创建一个 7x4x7 的房间并覆盖受保护的方块
/voxelroom 7 4 7 minecraft:oak_planks minecraft:birch_planks minecraft:glass true

# 撤销最近 2 次体素操作
/voxelundo 2

# 重做最近一次撤销的体素操作
/voxelredo 1

# 查看当前玩家最近的 5 次体素操作
/voxelhistory 5

故障排除

  • ❗ 命令无法识别? 确保模组已加载并且你使用的是 Fabric 配置文件。
  • ❗ 方块编辑不生效? 确保你没有选中受保护的方块(例如刷怪笼、带有实体的方块)。
  • ❗ 撤销栈不工作? 检查 VoxelConfig.MAX_ACTIONS_PER_PLAYER 以确保为玩家启用了历史记录。

依赖项

  • Minecraft (Fabric)
  • Fabric API
  • Brigadier(Minecraft 的命令解析器)
  • Minecraft 服务器类(用于方块、实体、世界管理)

贡献者

  • Jason Oltzen – 作者和核心开发者

许可证

本作品在 Creative Commons CC0 1.0 Universal (CC0 1.0) 公共领域贡献 下发布。