主要功能
? 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"。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧