宝箱战利品控制

宝箱战利品控制

为Minecraft世界添加管理员命令,可清除所有箱子或用可自定义的战利品和概率填充它们。

管理

ChestLootControl - 箱子战利品控制

📖 简介 ChestLootControl 是一个轻量级的 Fabric 管理员实用模组,可通过简单命令完全控制世界中所有箱子内的物品。一次性清空所有容器,或用完全可自定义的物品(包括完整 NBT 支持)随机重新填充它们。非常适合地图制作者、服务器管理员和整合包测试。

✨ 特性 一键清空容器:使用 /clearallchests 可立即移除世界中每个已加载的箱子、陷阱箱、木桶和潜影盒中的所有物品。

基于概率的物品填充:使用 /fillchests 可按自定义概率用你选择的物品随机填充容器。

完全可自定义物品:可指定任意原版物品,并配置数量范围(例如 minecraft:diamond:1-3)。

完整 NBT 支持:支持与 /give 命令相同的 NBT 格式——可添加附魔、药水效果、自定义名称等。

立即生效,无需重载:命令立即生效;无需重载服务器或重新加载区块。

低性能影响:仅遍历当前已加载的区块,保持轻量高效。

📋 命令

命令 参数 描述
/clearallchests 无 清空所有已加载区块中每个容器的所有物品
/fillchests 按指定概率用随机物品填充容器

需要权限:管理员(等级 ≥ 2)

🎮 使用方法 清空所有箱子 text /clearallchests 执行后,所有已加载的箱子会立即被清空。聊天栏将显示已清空的容器数量。

用物品填充箱子 基本用法 – 普通物品

text /fillchests 0.8 minecraft:diamond:1-3, minecraft:iron_ingot:5-10 这表示 80% 的箱子将随机获得钻石(1–3 个)或铁锭(5–10 个)。

高级用法 – 带 NBT 的物品

text /fillchests 0.5 minecraft:diamond_sword:1 {Damage:0,Enchantments:[{id:"minecraft:sharpness",lvl:3}]}, minecraft:potion:1 {Potion:"minecraft:strong_healing"} 这表示 50% 的箱子将被填充为锋利 III 的钻石剑或瞬间治疗 II 药水。

参数详情 概率:介于 0.0 和 1.0 之间的浮点数

0.0 = 不修改任何箱子

0.5 = 大约一半的箱子

1.0 = 每个箱子都会被填充

物品列表格式:

text namespace:item_id:min-max [optional NBT] 多个物品用逗号 , 分隔

NBT 遵循与 /give 命令相同的语法

数量会在给定范围内随机抽取

🎯 使用场景 冒险地图制作 – 快速为地牢箱子填充战利品

服务器活动 – 为限时活动刷新服务器中的所有箱子

生存服务器管理 – 定期清空公共箱子以防止物品囤积

整合包测试 – 用测试物品填充容器,无需手动放置

小游戏世界 – 随机化资源分布以增加可重玩性

📦 安装 安装 Minecraft 1.20.1 和 Fabric Loader 0.14.21 或更新版本

安装 Fabric API

将模组的 .jar 文件放入你的 .minecraft/mods/ 文件夹

启动游戏,进入世界并使用命令

⚙️ 兼容性 Minecraft:1.20.1

模组加载器:Fabric 0.14.21+

必需依赖:Fabric API

专用服务器:✅ 支持

单人游戏:✅ 支持(必须启用作弊)

📝 注意事项 命令仅影响当前已加载区块中的容器。未加载区域不会被处理。

如果世界中包含大量箱子,建议在服务器活动较少时运行命令,以避免短暂卡顿。

/fillchests 会在重新填充前清空容器中已有的物品。请谨慎使用。

使用 NBT 标签时,请确保格式正确;否则物品可能无法生成。

🖼️ 截图(建议) 清空命令反馈 填充命令反馈 [截图 1:/clearallchests 结果] [截图 2:/fillchests 结果] [截图 3:清空前后的箱子] [截图 4:包含 NBT 物品的箱子] ❓ 常见问题 问:有些箱子没有被清空/填充。为什么? 答:该命令仅处理已加载的区块。请靠近箱子以加载其区块,或在服务器上使用世界预加载模组。

问:我可以只针对特定区域而不是整个世界吗? 答:当前版本是全局生效。区域特定定位计划在未来的更新中推出。

问:它支持战利品表吗? 答:目前,物品直接在命令中定义。战利品表集成已在路线图中。

🔗 链接 Fabric API:https://modrinth.com/mod/fabric-api

📄 许可证 本项目采用 MIT 许可证授权。你可以自由使用、修改和分发它,只要保留原始作者声明,并在同一许可证下发布你的修改。