SinceDungeon-NBTChest
一个为 SinceDungeon 插件编写的附加组件,添加了两个强大的自定义地牢动作:
NBT_LOOT_CHEST— 掉落箱,可保留完整的物品 NBT 数据(附魔、属性、自定义模型数据、持久化数据),并支持随机预设池。PARALLEL— 同时运行任意数量的地牢子动作,仅在所有子动作完成后才算完成。
这两个动作都通过 SinceDungeon 的公共 API 进行注册,因此它们会出现在地牢编辑器中,与内置动作并列显示。
功能
- 完整 NBT 掉落箱 — 物品使用 Paper 的
ItemStack#serializeAsBytes()进行序列化,确保不会丢失任何数据。 - 随机预设池 — 可以列出多个预设,系统会随机选择其中一个。
- 玩家独立或共享模式 — 每个玩家可以抽取各自的随机掉落,或者所有人共享同一个箱子。
- 可选钥匙需求 — 将箱子限制在需要特定地牢钥匙 ID 的情况下才能开启。
- ⏱️ 时间限制与惩罚 — 支持针对每个动作设置时间限制和超时惩罚。
- 并行动作 (
PARALLEL) — 将SPAWN_WAVE、NBT_LOOT_CHEST和其他已注册的动作组合成一个单一的并行目标。 - 游戏内编辑器 — 提供用于编辑掉落预设和并行预设的可视化 GUI,无需编辑 YAML 文件。
要求
| 要求 | 版本 |
|---|---|
| 服务端 | Paper 1.21+ |
| Java | 21 |
| SinceDungeon | 已安装并在本附加组件之前加载 |
安装
- 下载最新的
SinceDungeon-NBTChest-x.x.x.jar。 - 确保 SinceDungeon 已经安装在你的
plugins/文件夹中。 - 将此附加组件的 JAR 文件放入
plugins/目录。 - 重启服务器。
启动时你应该看到以下输出:
[SinceDungeon-NBTChest] SinceDungeon-NBTChest enabled. Actions: NBT_LOOT_CHEST, PARALLEL
命令
| 命令 | 描述 |
|---|---|
/sdnbt create <name> |
创建一个新的掉落预设(打开编辑器 GUI) |
/sdnbt edit <name> |
编辑现有的掉落预设 |
/sdnbt list |
列出所有掉落预设 |
/sdnbt delete <name> |
删除一个掉落预设 |
/sdnbt info <name> |
显示预设的详细信息 |
/sdnbt reload |
重载 presets.yml |
/lapparallel |
打开并行预设编辑器 |
/lapparallel reload |
重载 parallel_presets.yml |
权限
| 节点 | 默认值 | 授予 |
|---|---|---|
sincedungeon.nbtchest.admin |
op |
访问所有 /sdnbt 和 /lapparallel 命令的权限 |
创建掉落预设
- 运行
/sdnbt create epic_chest。 - 打开一个 54 格的编辑器 —— 自由放置你希望包含的任何物品(保留完整 NBT 数据)。
- 关闭物品栏以保存。空的编辑器不会被保存。
预设存储在以下位置:
plugins/SinceDungeon-NBTChest/presets.yml
在地牢中使用 NBT_LOOT_CHEST
像其他动作一样将其添加到你的地牢 YAML 文件中。
单个预设(向后兼容):
type: "NBT_LOOT_CHEST"
preset: "epic_chest"
location: "0,64,0"
随机预设池:
type: "NBT_LOOT_CHEST"
presets: "epic_chest,rare_chest,common_chest"
location: "0,64,0"
per_player: true # 每个玩家独立抽取
required_key: "NONE" # 或者指定钥匙 ID
NBT_LOOT_CHEST 参数
| 键 | 默认值 | 描述 |
|---|---|---|
location |
0,64,0 |
箱子位置,格式为 x,y,z(相对于地牢坐标) |
presets |
[my_preset] |
每行一个预设名称;系统将随机选择一个 |
preset |
— | 单个预设名称(作为 presets 的替代选项) |
per_player |
true |
true: 每个玩家独立抽取 · false: 共享箱子 |
required_key |
NONE |
开启所需的钥匙 ID,或设为 NONE |
time_limit |
-1 |
触发时间惩罚前的秒数(-1 = 无限制) |
time_penalty |
1 |
每超时一秒扣除的分数 |
注意: 玩家必须拿走箱子里的所有物品,该箱子才会被视为已完成。
使用 PARALLEL 动作
PARALLEL 动作会同时运行并行预设中的每个子动作,并在所有子动作完成后结束。
1. 构建并行预设
/lapparallel
- 创建一个预设,然后添加子动作(例如
SPAWN_WAVE、NBT_LOOT_CHEST)。 - 可以在 GUI 中编辑每个子动作的字段。
PARALLEL本身不能嵌套(阻止递归)。
预设存储在以下位置:
plugins/SinceDungeon-NBTChest/parallel_presets.yml
2. 在地牢中引用它
challenge:
type: "PARALLEL"
preset: "wave_and_loot"
start_message: "<red>Survive the wave AND loot the chest!"
PARALLEL 参数
| 键 | 默认值 | 描述 |
|---|---|---|
preset |
"" |
要运行的并行预设的名称 |
time_limit |
-1 |
触发时间惩罚前的秒数(-1 = 无限制) |
time_penalty |
1 |
每超时一秒扣除的分数 |
许可证
APACHE-2.0-license.
作者
- LAPDK66
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
评论 0
登录后参与评分
还没有评论,来抢沙发吧