[重置][实用]RsNPC —— 支持4D皮肤的命令NPC插件[全版本] - Nukkit插件专区

lt_name

本帖最后由 lt_name 于 2023-3-1 21:14 编辑

RsNPC

GitHub开源: https://github.com/MemoriesOfTime/RsNPC

一个多用途的NPC插件

支持4D皮肤
支持自定义实体(需配合材质包在客户端添加实体)
支持自定义手持物品/护甲
支持看向玩家
支持表情动作
支持自定义点击命令(玩家权限,op权限,控制台权限)和消息
支持设置路径（NPC会根据设置的路径点自动移动）
支持对话框（可用于介绍信息/RPG对话等功能）
支持原地旋转功能（例如展示皮肤/模型）
支持在游戏内使用GUI配置90%的功能

命令
/rsnpc 打开GUI
/rsnpc create <NPC名称> 在当前位置创建NPC
/rsnpc delete <NPC名称> 移除NPC
/rsnpc addroute <NPC名称> 将当前位置添加到NPC路径
/rsnpc reload 重载NPC

NPC配置文件：
您可以直接在游戏内使用/rsnpc打开GUI界面配置NPC
但部分高级功能可能需要修改配置文件

# RsNPC - NPC配置文件
# 警告！编辑此文件前请确认您已掌握YAML语法！
# 您可以从这里学习YAML
# https://www.runoob.com/w3cnote/yaml-intro.html
# NPC的显示名称（头顶名称）
name: test2
# NPC的坐标
坐标:
x: -44.29899978637695
y: 72.00000274181366
z: -95.20189666748047
yaw: 180.0
level: world
# 手持物品id 例如267:0 为空则不显示
手持: '267:0'
# 头部护甲的物品id 例如298:0 为空则不显示
头部: 0:0
# 胸部护甲的物品id 例如299:0 为空则不显示
胸部: 0:0
# 腿部护甲的物品id 例如300:0 为空则不显示
腿部: 0:0
# 脚步护甲的物品id 例如301:0 为空则不显示
脚部: 0:0
# 使用的皮肤名称
皮肤: 默认
# 实体大小
实体大小: 1.0
# 是否看向玩家
看向玩家: true
表情动作:
# NPC是否播放表情
启用: false
# 已知的表情ID：https://github.com/lt-name/GetEmoteID/blob/master/README.md
# 请注意！此配置为List类型！
# 格式：
# - "ID1"
# - "ID2"
表情ID:
- 4c8ae710-df2e-47cd-814d-cc7bf21a3d67
# NPC播放表情的间隔单位：秒
间隔: 10
# 是否允许抛射物触发例如箭雪球等
允许抛射物触发: true
# 点击NPC执行的指令
# 请注意！此配置为List类型！
# 格式：
# - "命令1&权限"
# - "命令2&权限"
# &前为命令，&后为权限权限不写默认玩家权限
# &con 使用控制台权限执行命令
# &op 使用op权限执行命令
# 例如:
# - "give @p 260 1&con"
# - "say @p 你好&con"
点击执行指令:
- give @p 260 1&con
# 点击NPC发送的消息
# 请注意！此配置为List类型！
# 格式：
# - "消息1"
# - "消息2"
# 例如：
# - "%npcName%： @p 您好"
# - "送您一个苹果！"
发送消息:
- '%npcName%： @p 您好'
- 送您一个苹果！
# npc移动的速度
基础移动速度: 1.0
# 路径列表请使用命令添加！
route:
- -44.293701171875:72.00000274181366:-95.4177017211914
- -44.38859939575195:72.00000274181366:-91.53340148925781
- -40.95069885253906:72.00000274181366:-101.39520263671875
# 辅助寻路功能
# 启用后NPC自动绕过障碍物向目标点移动（地形会变情况下推荐使用）
# 不启用NPC忽视障碍物直接向目标点移动（地形不变情况下省性能使用）
启用辅助寻路: true
# NPC的旋转角度设置为负数可以反向旋转
# 可用于旋转展示皮肤
# 开启此项会自动关闭NPC移动
旋转: 0.0
对话框:
# 是否启用对话框
启用: false
# 对话框配置文件名称
页面: demo
# 发包显示给玩家时所用的实体NetworkId
# 实体ID介绍请参考：https://minecraft.fandom.com/zh/wiki/%E5%9F%BA%E5%B2%A9%E7%89%88%E6%95%B0%E6%8D%AE%E5%80%BC/%E5%AE%9E%E4%BD%93ID
# 无特殊需求请设置为 -1 使用假玩家实体
实体NetworkId: -1
# 自定义实体相关配置
# 注意！此功能需要配合材质包使用！
# 注意！自定义实体注册后，玩家需要重新进入服务器才能显示，建议在关闭服务器后修改此项配置！
CustomEntity:
# 是否启用自定义实体
enable: false
# 自定义实体标识符（资源包内设置的identifier）
identifier: RsNPC:Demo
# 实体皮肤（变种）id 一般默认为0
skinId: 0
# NPC的显示名称(头顶名称)是否一直可见
# true - 一直可见
# false - 仅玩家指向NPC时可见
nameTagAlwaysVisible: true
# -
# -
# 配置文件的版本号
# 警告！除非您明确知道您在干什么，否则不要尝试改动此项配置！
ConfigVersion: 2.2.3
# 你已经到达配置文件的底部啦

复制代码

皮肤存放路径：plugins\RsNPC\Skins
在Skins文件夹内新建文件夹，名称使用你想设置的皮肤名称
将皮肤图片文件重命名为skin.png放入其中（纤细手臂的重命名为skin_slim.png）
将4D皮肤文件重命名为skin.json放入其中（没有此文件将作为普通皮肤加载）

此外也可以直接将png文件和json文件后缀前命名一致后放入Skins文件夹，但不推荐此种方式

插件演示：

下载:
前置插件：https://www.mcbbs.net/thread-1220674-1-1.html

master 分支（适用于 Nukkit/Nukkit-PM1E/PowerNukkit）：

RsNPC-2.3.1.jar (199.52 KB, 下载次数: 0)
历史版本：

PNX 分支（适用于 PowerNukkitX）:

RsNPC-2.3.1-PNX.jar (200.68 KB, 下载次数: 1)
历史版本：

PM1E 分支（适用于 Nukkit PetteriM1 Edition）：

RsNPC-2.3.1-PM1E.jar (199.53 KB, 下载次数: 0)
历史版本：

更新日记：

注意：更新日记是master（主）分支的
v2.3.1：
允许自定义实体碰撞大小
指定语言文件不存在时切换为中文
修复自定义实体无法移动
捕获GUI配置异常
对话框操作延迟执行命令(修复无法使用对话框打开GUI问题)
修复世界加载状态检测

v2.3.0：
对话页面配置不存在时输出警告信息
允许自定义实体NetworkId
完善的自定义实体支持
添加nameTagAlwaysVisible配置，允许自定义NPC显示名称是否可见
添加移除(取消注册)变量的方法

v2.2.4：
修复npc头部转动问题
更详细的配置文件错误提示

v2.2.3：
添加NPC配置文件表情部分介绍
支持普通纤细手臂（Alex）的皮肤

v2.2.2：
修复玩家离线后权限检查报错问题
修复1.19.40对话框导致名称不显示问题
添加对话框配置文件和NPC配置文件的介绍

v2.2.1：
实现依赖自动下载/更新
对话框支持变量

v2.2.0：
修复皮肤模型错误导致RsNPC不能加载的问题
允许把皮肤png文件直接放到Skins文件夹内
GUI支持配置NPC开启/选择对话框配置

v2.1.1：
修复对话框功能可能的刷创造问题

v2.1.0：
使用MemoriesOfTime-GameCore前置，减少插件体积
增加1.12格式皮肤模型支持
修复右键(触屏长按)无法打开NPC对话框问题
修复GUI配置NPC没有皮肤可选时报错问题

v2.0.1：
修复刷op的问题（nk本身异步问题，还是建议装个op检查插件）
修复创造模式无法使用对话框的问题

v2.0.0：
添加NPC对话框功能
皮肤不存在时使用默认(史蒂夫)皮肤
不再内置4D皮肤
加载皮肤时检查图片尺寸

v1.8.8：
自动去除命令前的/
修复GUI设置皮肤无法保存问题

v1.8.7：
修复：
  新格式的皮肤读取问题

v1.8.6：
修复：
  在Nukkit-PM1E报错的问题

v1.8.5：
修复：
  op权限执行命令实际是控制台权限执行的问题

v1.8.4：
修复：
  NPC首次创建时显示异常
  皮肤设置错误时的问题

v1.8.3：
添加：
  BaseVariableV2 更安全的变量接口
  配置文件可以开关辅助寻路（关闭后npc可以在天上移动）

v1.8.2：
更改：
  删除调试信息
修复：
  设置不看向玩家的npc，点击后会看向玩家

v1.8.1：
修复：
  用GUI修改显示名称问题
  修复在pn报错问题

v1.8.0：
添加：
  GUI界面
  命令枚举
  旋转功能
更改：
  变量接口（兼容之前的）
  设置路径的npc会在玩家点击时停止移动3秒

v1.7.1：
修复：
  基础移动速度小数部分无效

v1.7.0：
更改：
  现在NPC移动更流畅
  现在NPC在流体中移动速度会下降
添加：
  现在可以在配置文件设置NPC实体大小
  现在可以在配置文件设置NPC移动基础速度(需要先添加路径点)
  现在长按（Win10右键）NPC也会触发
修复：
  在控制台使用addroute命令会报错
  NPC会被载具带走

v1.6.2：
调整线程池任务丢弃策略

v1.6.1:
小优化

已知bug：

来自群组: Memories Of Time

暑假作业何其多

太棒了太棒了**！！！！！！！！！！！！！！！！！！！！！！！！！！！

1938534062

生成了但是没有模型，kill就卡服

lt_name

1938534062 发表于 2021-7-8 11:34
生成了但是没有模型，kill就卡服

可以在配置文件里设置皮肤

超级拉普达

什么时候支持修改NPC比例就好了

lt_name

本帖最后由 lt_name 于 2021-8-24 18:10 编辑

BanZang 发表于 2021-7-16 10:56
什么时候支持修改NPC比例就好了

~~在写了在写了~~
已经支持了

魔小炎

皮肤是写路径嘛

lt_name

魔小炎发表于 2021-8-2 00:14
皮肤是写路径嘛

直接写名称 (以skin文件夹里的皮肤名称为准)

魔小炎

lt_name 发表于 2021-8-2 07:17
直接写名称 (以skin文件夹里的皮肤名称为准)

好，超级支持

九幽天阙

1938534062 发表于 2021-7-8 11:34
生成了但是没有模型，kill就卡服

没有模型重载一下就好了

九幽天阙

魔小炎发表于 2021-8-2 00:14
皮肤是写路径嘛

是不是可以自己加4D皮肤

找不到路的晓北_

支持支持，作者大大厉害

lt_name

本帖最后由 lt_name 于 2021-9-20 18:10 编辑

九幽天阙发表于 2021-8-24 22:02
是不是可以自己加4D皮肤

可以，放到Skins文件夹就行

1741466575

4d皮肤？666啊

超级鸽子精云烟

好耶！很好用的插件

QEmerald

作者厉害！
刚开始生成出来不显示
用指令刷新一下就好了

小安~

本帖最后由小安~ 于 2022-2-19 18:41 编辑

没有图片，那没事了。不对，这有图片啊，看不到效果图。。。

我只是叫陈翔

下载不了

coffion

动作有哪些？

coffion

动作都有哪些？不知道代码

lt_name

coffion 发表于 2022-8-18 13:48
动作都有哪些？不知道代码

https://ci.lt-name.cn/job/GetEmo ... v1.0.0-SNAPSHOT.jar
安装这个插件，服务器内使用动作表情，控制台会输出uuid