SinceDungeon-NBTChest

插件

· 作者 LAPDK66

SinceDungeon 插件的附加组件。

0 本站下载 0 关注 更新于 5 个月前

需要前置:SinceDungeon

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

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 已安装并在本附加组件之前加载

安装

  1. 下载最新的 SinceDungeon-NBTChest-x.x.x.jar。
  2. 确保 SinceDungeon 已经安装在你的 plugins/ 文件夹中。
  3. 将此附加组件的 JAR 文件放入 plugins/ 目录。
  4. 重启服务器。

启动时你应该看到以下输出:

[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 命令的权限

创建掉落预设

  1. 运行 /sdnbt create epic_chest。
  2. 打开一个 54 格的编辑器 —— 自由放置你希望包含的任何物品(保留完整 NBT 数据)。
  3. 关闭物品栏以保存。空的编辑器不会被保存。

预设存储在以下位置:

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源