BungeeNPCs - CommandNPCs - BungeeNPCs - 跨服NPC传送插件

ServerNPC 是一款功能强大的插件，允许你在服务器中创建可交互的 NPC。这些 NPC 可以显示自定义皮肤和全息文本，并执行命令将玩家传送到指定子服务器或执行其他操作。配置简单，权限系统完善，并支持 PlaceholderAPI。

💡核心特性

• 高度可配置：通过配置文件轻松调整所有设置。
• 自定义皮肤：为每个 NPC 设置独特的皮肤。
• 权限控制：为每个 NPC 设置独立的交互权限，并可自定义所有管理命令的权限。
• 易于使用：直观的命令让创建和管理 NPC 变得非常简单。
• 扩展支持：支持 PlaceholderAPI，可在全息文本中使用丰富的变量。

🎮命令与权限

管理命令

• /servernpc create (serverName) (NPCskin) (NPCname)

创建一个新的 NPC。

• /servernpc delete (NPCid)

删除指定 ID 的 NPC。

• /servernpc list

查看所有已创建的 NPC 及其 ID。

• /servernpc addcommand (NPCid) (Executor (player/console)) (command)

为指定 NPC 添加点击后执行的命令。

• /servernpc reload

重新加载插件的配置文件。

权限节点

• servernpc.admin - 拥有所有管理权限（allTheAbove）。
• servernpc.create - 允许使用创建命令。
• servernpc.delete - 允许使用删除命令。
• servernpc.list - 允许使用列表命令。
• servernpc.reload - 允许使用重载命令。
• servernpc.(服务器名) - 例如 servernpc.test，允许玩家与特定 NPC 交互。

🔧配置说明

主要配置文件 config.yml 结构如下：

# 是否接收更新通知
update-notification: true

# 全息显示设置
Hologram:
  # 全息文本相对于 NPC 的 Y 轴偏移
  YAxisAdd: 2.5
  # 全息文本行内容，支持颜色代码和 PlaceholderAPI 变量
  Lines:
  - '&b%NPCName%'
  - '&e{online: %server%} players'

# 消息文本
Messages:
  rightClick: '&aSending you to the &7%server% &aserver.'
  cmdNoPerm: '&c&lERROR: &7You don''t have permission to use this command.'
  npcNoPerm: '&c&lERROR: &7You don''t have permission to use the &e%server% &7NPC.'
  onlyPlayers: '&c&lERROR: &7This command is only available for players.'
  # 点击 NPC 的冷却时间（秒）
  cooldownTime: 5

# 命令权限节点（可在此处自定义）
Permissions:
  create: servernpc.admin
  delete: servernpc.delete
  list: servernpc.list
  reload: servernpc.reload
  allTheAbove: servernpc.admin

# 已创建的 NPC 数据将自动存储在此部分
NPCS:
  '1':
    Server: Test
    Skin: Island
    Name: Test
    Permission: servernpc.test
    Location: world, 89.74857536318889, 136.0, -198.6885826978651, 7.5154123, 183.09644
    HoloLocation: world, 89.74857536318889, 139.0, -198.6885826978651

✨依赖与要求

必需依赖

• HolographicDisplays - 用于生成 NPC 上方的全息文本。
• ProtocolLib - 用于处理 NPC 的皮肤、交互等底层网络协议。

可选依赖

• PlaceholderAPI - 如果安装，可以在全息文本的 Lines 中使用其变量。

> 开发者说明：未来更新计划实现自研的全息系统，以移除对 HolographicDisplays 的依赖。

❓使用示例

• 创建 NPC：手持物品，执行 /servernpc create Lobby Steve 大厅接待员。插件会在你的位置生成一个名为“大厅接待员”、使用“Steve”皮肤、指向 Lobby 服务器的 NPC。
• 添加命令：执行 /servernpc addcommand 1 console say %player% 点击了NPC!。这会让 ID 为 1 的 NPC 在被点击时，以控制台身份执行公告命令。
• 设置权限：在配置中为该 NPC 设置 Permission: servernpc.lobby，则只有拥有 servernpc.lobby 权限的玩家才能使用它。

---

支持开发：如果你喜欢这个插件，请考虑 Donate! 来支持作者的持续开发。