AdvancedNPCs999

插件

· 作者 Erik9994857

一款全面的 Minecraft 插件,旨在赋予服务器管理员对非玩家角色(NPC)的高级控制能力。创建、自定义和管理智能 NPC,以增强服务器的环境和玩家互动体验。

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

最新 1.0.3 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

主要功能

? NPC 管理

  • 创建与移除:轻松在当前位置创建新 NPC,并移除现有 NPC。
  • 选择:选择最近的 NPC 以管理其属性。
  • 持久化:所有 NPC 都会自动保存和加载,确保它们在服务器重启后依然存在。
  • 基础控制:传送、克隆、生成、消失。
  • 显示名称:自定义 NPC 名称,支持颜色代码。
  • 实体类型:更改 NPC 的视觉类型(例如玩家、僵尸、村民)。
  • 所有权:为 NPC 分配所有者。
  • 重置:将 NPC 重置为默认设置(名称、皮肤、装备及所有行为),同时保留该 NPC。
  • 传送:通过名称或 ID 传送到特定 NPC。

? 外观

  • Mojang 皮肤系统:通过直接从 Mojang API 获取数据,将任何玩家的皮肤应用到 NPC 上。
    • /npc skin <player>:获取并应用某玩家的皮肤。
    • /npc skin update:刷新所选 NPC 的皮肤。
    • /npc skin clear:将 NPC 重置为默认皮肤。
    • /npc skin list:显示缓存中存储的所有皮肤。
    • /npc skin refreshall:从 Mojang 服务器刷新所有 NPC 皮肤。
  • 自定义名称:使用颜色代码设置显示名称。
  • 装备 GUI:打开图形界面,为 NPC 配备盔甲和物品。

? 行为与 AI

  • 注视玩家:切换 NPC 是否会自动转头看向附近的玩家。
  • 寻路巡逻:
    • /npc path add:将你当前的位置添加为所选 NPC 的路径点。
    • /npc path start:命令 NPC 开始巡逻其定义的路径。
    • /npc path stop:停止 NPC 当前的巡逻。
    • /npc path clear:移除 NPC 路径上的所有路径点。
  • 跟随玩家:
    • /npc follow <player>:让 NPC 跟随特定玩家。
    • /npc follow off:停止 NPC 的跟随行为。
  • 姿态控制:
    • /npc sit:让所选 NPC 坐下。
    • /npc stand:让所选 NPC 站起来。
  • 物理控制:
    • /npc gravity:为 NPC 启用重力。
    • /npc fly:禁用重力,允许 NPC 漂浮或飞行。
  • 自动重生:NPC 会在服务器启动时在世界中自动重生。

? 交互

  • 对话系统:
    • /npc text add <message>:添加 NPC 在被交互时会说的对话内容。
    • /npc text list:查看所选 NPC 的所有对话内容。
    • /npc text clear:移除所有对话内容。
    • /npc text remove <index>:通过编号移除特定的对话内容。
  • 命令执行:
    • /npc cmdadd <command>:添加当玩家与 NPC 交互时服务器将执行的命令。使用 %player% 作为交互玩家名称的占位符。
    • /npc cmdremove <index>:移除特定的命令。
    • /npc cmdclear:清除所有命令。
  • 交互触发器:
    • /npc trigger <type>:定义玩家如何激活 NPC 交互。
      • right_click:通过右键点击 NPC 进行交互。
      • left_click:通过左键点击(攻击)NPC 进行交互。
      • proximity:当玩家进入 NPC 的一定范围内时进行交互。

⚔️ 战斗(可选)

  • 玩家护卫:
    • /npc guard <player>:命令 NPC 护卫特定玩家。
    • /npc guard off:禁用护卫模式。
  • 范围设置:
    • /npc range <blocks>:设置 NPC 的跟随或攻击范围。

? 实用工具

  • 列出 NPC:
    • /npc list [page]:显示所有活跃 NPC 的分页列表,展示它们的 ID 和名称。
  • NPC 信息:
    • /npc info:显示当前所选 NPC 的详细信息。
  • 保存数据:
    • /npc save:强制插件立即保存所有 NPC 和皮肤数据。
  • 重载插件:
    • /npc reload:重载插件的配置、NPC 数据和皮肤缓存。
  • 调试模式:
    • /npc debug:切换调试消息(未来功能)。

核心系统

皮肤系统

  • 使用用户名直接从 Mojang API 获取玩家皮肤。
  • 提取皮肤数据(值值和签名)并将其应用到 NPC 的外观上。
  • 在本地 skins.yml 中缓存皮肤数据,以减少 API 请求并提高性能。
  • 所有皮肤获取操作均在异步线程中执行,以防止服务器卡顿。
  • 支持通过命令更新或清除 NPC 皮肤。

持久化

  • NPC 数据:所有 NPC 配置(UUID、名称、位置、皮肤数据、实体类型、路径点、装备、行为设置、交互详情)都持久存储在 npcs.yml 中。
  • 皮肤缓存:下载的皮肤数据缓存在 skins.yml 中。
  • 自动加载:插件启动时会自动加载并生成所有 NPC。

命令处理

  • 一个强大的命令系统,为所有 NPC 管理任务提供清晰的子命令。
  • 包含完整的 Tab 补全功能,便于使用。
  • 针对无效命令或缺少选择的全面错误处理。

交互触发器

  • 支持多种玩家与 NPC 交互的方式:右键点击、左键点击和 proximity(距离)检测。
  • 触发时,NPC 可以显示对话并执行服务器命令。

寻路与移动

  • NPC 可以配置为由多个路径点组成的巡逻路径。
  • 可以命令 NPC 跟随特定玩家。

装备管理

  • 专用的图形用户界面 (GUI) 允许服务器管理员直观地为 NPC 配备盔甲和物品。

命令

所有命令均以 /npc 或 /advnpcs 开头。

  • /npc create <name>:在当前所在位置创建一个名为 <name> 的 NPC。
  • /npc remove:移除当前选中的 NPC。
  • /npc select:选择距离你最近的 NPC。
  • /npc skin <player_name>:将选中 NPC 的皮肤设置为 <player_name> 的皮肤。
  • /npc skin update:从缓存的用户名刷新选中 NPC 的皮肤。
  • /npc skin clear:将选中 NPC 重置为默认皮肤。
  • /npc skin list:显示缓存中存储的所有皮肤。
  • /npc skin refreshall:从 Mojang 服务器刷新所有 NPC 的皮肤。
  • /npc name <new_name>:更改选中 NPC 的显示名称。支持颜色代码。
  • /npc equip:打开物品栏 GUI 以装备选中 NPC。
  • /npc reset:将选中 NPC 重置为默认设置(名称、皮肤、装备和所有行为),同时保留该 NPC。
  • /npc teleport <npc_name>:传送至指定的 NPC。
  • /npc tp <npc_name>:teleport 命令的别名。
  • /npc look:切换选中 NPC 是否注视附近玩家。
  • /npc path add:将你当前位置作为路点添加到选中 NPC 的巡逻路径中。
  • /npc path start:开始让选中 NPC 沿着其路径巡逻。
  • /npc path stop:停止选中 NPC 的巡逻。
  • /npc path clear:清除选中 NPC 路径中的所有路点。
  • /npc follow <player_name>:使选中 NPC 跟随 <player_name>。
  • /npc follow off:停止选中 NPC 的跟随行为。
  • /npc sit:使选中 NPC 坐下。
  • /npc stand:使选中 NPC 站立。
  • /npc gravity:为选中 NPC 启用重力。
  • /npc fly:禁用选中 NPC 的重力,使其能够漂浮。
  • /npc text add <message>:向选中 NPC 添加一行对话。
  • /npc text list:列出选中 NPC 的所有对话行。
  • /npc text clear:清除选中 NPC 的所有对话行。
  • /npc text remove <index>:移除指定 <index> 处的对话行。
  • /npc cmdadd <command>:添加一个在交互选中 NPC 时执行的服务器命令。使用 %player% 作为交互玩家名称的占位符。
  • /npc cmdremove <index>:移除指定 <index> 处的命令。
  • /npc cmdclear:清除选中 NPC 的所有命令。
  • /npc trigger <type>:设置选中 NPC 的交互触发方式(right_click、left_click、proximity)。
  • /npc guard <player_name>:使选中 NPC 守卫 <player_name>。
  • /npc guard off:停止选中 NPC 的守卫行为。
  • /npc range <blocks>:设置选中 NPC 的跟随/攻击范围(单位:方块)。
  • /npc list [page]:分页显示所有已创建的 NPC 列表。
  • /npc info:显示当前选中 NPC 的详细信息。
  • /npc save:强制将所有 NPC 和皮肤数据保存到磁盘。
  • /npc reload:重新加载插件的配置、NPC 数据和皮肤缓存。
  • /npc debug:切换调试消息(目前尚未实现)。

权限

所有权限均以 advnpcs. 开头。

  • advnpcs.admin:授予访问所有 AdvNPCs 命令的权限(默认:op)。
  • advnpcs.create:允许玩家创建新的 NPC(默认:op)。
  • advnpcs.remove:允许玩家移除 NPC(默认:op)。
  • advnpcs.skin:允许玩家管理 NPC 皮肤(默认:op)。
  • advnpcs.behavior:允许玩家管理 NPC 行为(默认:op)。
  • advnpcs.dialogue:允许玩家管理 NPC 对话和命令(默认:op)。
  • advnpcs.teleport:允许玩家传送到 NPC(默认:op)。

数据存储

  • plugins/AdvNPCs/npcs.yml:存储所有持久化的 NPC 数据,包括 UUID、名称、位置、皮肤数据、实体类型、路径点、装备以及行为和交互设置。
  • plugins/AdvNPCs/skins.yml:存储缓存的 Mojang 皮肤数据(用户名、UUID、值、签名),以减少 API 调用。

用法示例

  • /npc create Steve:在当前所在位置创建一个名为 "Steve" 的 NPC。
  • /npc select:选择最近的 NPC。
  • /npc skin Notch:将选中 NPC 的皮肤设置为 Notch 的皮肤。
  • /npc text add Hello, traveler!:向选中 NPC 添加一行对话。
  • /npc path add:将你当前位置添加到选中 NPC 的路径中。
  • /npc path start:使选中 NPC 开始沿其路径巡逻。
  • /npc follow Player123:使选中 NPC 跟随玩家 "Player123"。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源