DungeonInstances

插件

· 作者 fox3000foxy

一个帮助创建类似《魔兽世界》地下城的插件

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

最新 1.0.1 · 1.19.4 · Bukkit / Paper

一键开服(送7天)

DungeonInstances

一个用于 Spigot/Paper Minecraft 的插件,通过小队系统、可点击的邀请、管理员命令和游戏内记分板 HUD 来管理副本实例。


概述

DungeonInstances 允许你从模板创建副本世界,邀请玩家加入小队,并在进入实例时显示动态记分板。该插件旨在提供简单的管理功能(创建/删除/编辑模板、设置出生点)以及友好的用户体验(彩色消息、接受/拒绝邀请的可点击按钮)。

主要功能

  • 基于模板创建实例(位于 templates-dungeons/ 下的文件夹)。
  • 小队系统,支持可点击的邀请([Accept]、[Decline])。
  • 管理员命令:加载/编辑/保存/清除实例,定义出生点。
  • 在副本世界中可见的记分板(instance_<name>_<uuid>),显示:
    • 小队成员(队长标记为 ♛,你自己标记为 ★)。
    • 显示成员相对位置的 directional arrows(方向箭头)。
    • 以颜色显示当前生命值(绿色/黄色/红色)。
    • 离线成员显示为删除线。

安装

  1. 构建:
cd /path/to/DungeonsInstances
mvn clean package -DskipTests -T 1C

或者如果你使 ./build 脚本具有可执行权限,也可以使用它。

  1. 部署:将生成的 JAR 文件复制到你的 Spigot/Paper 服务器 plugins/ 文件夹中:
cp "target/Dungeon Instances-1.0.0.jar" /path/to/server/plugins/
  1. 重启服务器。

重要文件夹结构

  • templates-dungeons/ – 模板文件夹(一个文件夹 = 一个副本模板)。如果文件夹不存在,插件会自动创建它并从内部归档安装默认的 manaria 副本。
  • plugins/DungeonInstances/spawnPoints.json – 通过 /dungeon admin setspawn 设置的出生点。

命令

所有命令均以 /dungeon 开头。

  • /dungeon instance <template> [difficulty]

    • 使用以下难度级别之一从模板创建实例:Beginner(新手)、Normal(普通,默认值)、Heroic(英雄)、Mythic(史诗)。 难度会对生物的生命值、伤害和护甲应用乘数。
    • 玩家(小队队长)和成员会收到消息,并在几秒后被传送。
  • /dungeon leave

    • 离开副本并恢复正常状态。
  • /dungeon list

    • 列出可用的模板和/或活动实例。
  • /dungeon admin <sub> (需要权限:dungeon.admin)

    • edit <template> – 为模板创建/打开编辑实例。
    • save <instance> – 保存修改后的实例(用于编辑模板)。
    • purge <instance> – 删除并卸载空的实例。
    • setspawn <template> – 将你当前位置注册为该模板的出生点(保存在 spawnPoints.json 中)。
    • alias <alias> – 为你正在查看的生物分配或显示战利品池别名;使用 none 清除。
    • reloadloot – 从 lootTables.json 重新加载战利品表。
  • /dungeon party <sub>

    • create [name] – 创建新的小队。如果未提供名称,插件将使用创建者的用户名(空格替换为下划线)。名称必须唯一 —— 如果名称已存在则创建失败。
    • invite <player> – 邀请一名玩家(发送可点击的 [Accept]/[Decline] 消息)。
    • accept – 接受最后一次邀请。在加入新小队之前会自动离开任何现有小队。
    • decline – 拒绝最后一次邀请。
    • leave – 离开小队。如果玩家在副本中(instance_...),他们将被传送到之前的世界(如果已知)或主出生点。
    • kick <player> – (仅限队长)移除一名成员。如果被踢出的成员在副本中,他们将被传送到之前的世界。
    • disband – (仅限队长)解散团队 —— 通知所有成员,清除待处理的邀请,并将副本中的成员传送到之前的世界。
    • list – 列出小队/成员。
    • members – 显示小队成员(队长/你,在线/离线)。

注意:

  • 邀请使用 TextComponent API 来提供客户端上的可点击按钮。
  • 没有权限的玩家看不到管理员命令。

记分板 (HUD)

  • 当玩家处于名称以 instance_ 开头的世界中时,记分板会自动激活。
  • 它在侧边栏显示:
    • 副本名称(从世界名称 instance_<name>_<uuid> 中提取)。
    • 带有生命值状态、相对方向、队长/星星标记的小队成员。
    • 统一的分隔符(页眉/页脚)采用一致的颜色。

出生点

  • 使用以下命令为每个模板设置出生点:
/dungeon admin setspawn <template>
  • 出生点持久化存储在 plugins/DungeonInstances/spawnPoints.json 中。

模板与实例

  • 将你的副本模板放置在 templates-dungeons/<template_name>/ 中。
  • 实例通过复制创建,并加载为 instance_<template_name>_<uuid>。
  • 空的实例会自动卸载并删除。

权限

  • dungeon.admin – 访问管理员命令(/dungeon admin ...)。

其他命令默认没有特定权限(如果需要可以添加检查)。

故障排除

  • 如果实例加载失败,请检查世界容器文件夹(模板文件夹副本)的写入权限。
  • 如果记分板不出现:确保你在 instance_... 世界中并且属于一个小队。
  • 如果离线玩家名称显示不正确,插件会使用 Bukkit.getOfflinePlayer(UUID).getName() 作为后备方案。

自定义战利品表

DungeonInstances 包含每个副本/难度的战利品表系统。每个生物都可以标记一个 pool alias(战利品池别名),该别名决定当生物在副本中死亡时使用的战利品表。别名存储在 NBT(PersistentDataContainer)中,并在保存/加载之间保持持久。

配置

配置文件位于 plugins/DungeonInstances/lootTables.json。首次加载时,会创建一个空的 {},以便管理员手动填充。预期结构:

{
  "<模板名称>": {
    "<难度>": {
      "<别名>": {
        "iterations": <掷骰次数>,
        "loots": [
          {
            "item": "minecraft:diamond_sword",
            "nbt": { "item_name": "Legendary Sword" },
            "count": 1,
            "chance": 0.1
          },
          {
            "item": "minecraft:iron_nugget",

```json
{
  "nbt": { "item_name": "盾牌" },
  "count": 1,
  "chance": 0.4
}

模板 manaria 配合别名 default 在全部四种难度下的完整示例:

在此示例中,随着难度提升,iterations(迭代次数)和掉落几率都会相应增加;请根据你的需求调整这些数值。

战利品表字段

  • iterations – 池子被访问的次数;每次迭代会从 loots 中随机选取一项。
  • loots – 可能的条目数组。对于每个条目,将 chance 与一个随机值(0.0–1.0)进行比较;如果判定成功,则该物品会被加入掉落物中。
  • item – Bukkit/Spigot 材质 ID(如 DIAMOND_SWORD、IRON_NUGGET 等)。
  • nbt – 用于设置物品名称(item_name)、描述 lore 等的自由映射。目前仅支持简单的键(参见源代码)。
  • count – 当该条目被选中时生成的物品数量。

分配别名

在编辑模板时,看向一只怪物并运行:

/dungeon admin alias <alias>

如果不提供参数,插件会显示当前的别名。要清除别名,请使用 none:

/dungeon admin alias none

别名会与怪物一起保存,并在副本实例中自动恢复。

重载配置

在磁盘上编辑完 lootTables.json 后,在游戏中使用以下命令重载更改:

/dungeon admin reloadloot

游戏内行为

当带有别名的怪物在副本实例中死亡时,原版掉落物会被移除,并替换为根据匹配的池子(模板 + 难度 + 别名)计算出的物品。如果未找到对应的表,则保持原版行为不变。

自定义与建议

  • 你可以在代码中修改记分板更新频率(DungeonScoreboardManager)和消息格式。
  • 可能的改进方向:多语言支持、通过 config.yml 进行配置、隐藏某些 HUD 元素的选项等。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源