SimpleNPCs

插件

· 作者 Axiumyuyu

一个简单的 NPC 插件。真的非常简单。:P

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

最新 1.1.0 · 26.2 · Paper / Purpur

一键开服(送7天)
简体中文

SimpleNPC

SimpleNPC 是一款极其轻量的 Minecraft 实体 NPC 插件,它唯一的功能就是右键配置过的实体时,执行一系列命令。你几乎不需要学习任何新的内容,也不需要花费时间调节配置文件,就能立刻掌握其使用方式。

本插件不依赖外部数据库,采用纯标签驱动架构。它不负责实体的生成或物理属性的修改,而是将交互逻辑直接储存在实体的 PDC 中。任何非玩家实体均可作为 NPC,数据与原版区块同步保存与销毁。


核心特性

  • 无外部状态: 不使用 MySQL 或 SQLite。所有命令和行为数据直接存储在实体的 PDC 中。当实体被清除时,数据随之销毁,不会产生数据残留。

  • 泛用实体支持: 推荐配合 1.21.9+ 原生的玩家模型 (minecraft:mannequin) 使用,同时也支持任何非玩家实体。只需通过命令添加 PDC 标签即可将其转换为 NPC。

  • 交互防抖: 内置交互冷却机制,防止因网络延迟或连点导致的命令重复执行。

  • 指令执行: * 支持 %player_name% 等基础变量,并兼容 PlaceholderAPI。

  • 带有 player: 前缀的指令将以玩家身份执行,无前缀则默认以控制台身份执行。

  • 技术规范: 基于 Paper API 1.21.11+ 与 Kotlin 编写。使用 Brigadier 构建命令树,通过 MiniMessage 处理文本格式化。

  • 视觉附加功能 (计划中): 计划引入 PacketEvents,通过发包实现特定玩家视角的皮肤镜像与目光追随功能。


快速上手

第一步:生成实体 使用原版命令或生成蛋召唤一个实体,并配置所需的属性(如无敌、无重力等):

/summon minecraft:mannequin ~ ~ ~ {Invulnerable:1b,NoGravity:1b}

第二步:绑定命令 使用插件提供的选择器,向该实体注入需要触发的命令:

/npc add @n[type=mannequin] say 欢迎来到这里,%player_name%!
/npc add @n[type=mannequin] player:spawn

第三步:玩家交互 玩家右键点击该实体,系统将按顺序执行绑定的命令。


命令与权限

所有命令默认需要 pronpc.admin 权限。命令目标 <target> 支持 Minecraft 原版目标选择器。

命令 说明
/npc reload 重载配置文件。
/npc list <target> 列出目标实体 PDC 中绑定的所有命令。在聊天框输出,点击对应行可复制内容。
/npc add <target> <command> 向目标实体追加交互命令。若目标原先无 PDC 标签,会自动初始化。
/npc remove <target> <index> 根据列表索引移除指定命令。若列表被清空,实体的 NPC 标签将被移除。

注:目标选择器仅允许选择一个实体。


配置文件 (config.yml)

# NPC 交互全局冷却时间(单位:秒)
cooldown-seconds: 3.0


开发者参考

插件的底层数据结构如下:

  • 命名空间 (Namespace): npc
  • 核心键值: commands 对应类型 PersistentDataType.LIST.strings()
  • 视觉扩展键值 (计划中): * mirror_skin 对应类型 PersistentDataType.BYTE
  • look_at 对应类型 PersistentDataType.BYTE
English

由 AI 翻译,可能存在语法错误。

SimpleNPC

SimpleNPC 是一个极其轻量的 Minecraft 实体 NPC 插件。其唯一功能是在玩家右键点击已配置的实体时执行一系列命令。你无需学习太多新东西或花费大量时间进行配置即可掌握其用法。

本插件不依赖任何外部数据库,采用纯标签驱动架构。它不处理实体生成或修改物理属性,而是将交互逻辑直接存储在实体的 PDC 中。任何非玩家实体均可作为 NPC 使用,数据与原版区块同步保存和销毁。


核心功能

  • 无外部状态依赖: 无需 MySQL 或 SQLite。所有命令和行为数据均直接存储实体的 PDC(持久化复合数据)中。当实体被移除时,其数据随之销毁,不留任何残留数据。
  • 通用实体支持: 专为在 1.21.9+ 版本引入的原生玩家模型 minecraft:mannequin 提供最佳体验,同时也支持任何非玩家实体。只需通过命令添加 PDC 标签即可将其转换为 NPC。
  • 交互防抖: 内置交互冷却机制,防止因网络延迟或快速点击导致的重复命令执行。
  • 命令执行:
    • 支持 %player_name% 等基础变量,并与 PlaceholderAPI 兼容。
    • 以 player: 前缀开头的命令将以玩家身份执行;无前缀的命令默认以控制台身份执行。
  • 技术规格: 基于 Paper API 1.21.11+ 构建,使用 Kotlin 编写。使用 Brigadier 构建命令树,使用 MiniMessage 进行文本格式化。
  • 计划中的视觉增强: 计划引入 PacketEvents,通过数据包操作实现针对每个玩家的皮肤镜像和视线跟随功能。

快速开始

步骤 1:生成实体
使用原版命令或刷怪蛋召唤一个实体,并配置所需的属性(例如无敌、无重力):

/summon minecraft:mannequin ~ ~ ~ {Invulnerable:1b,NoGravity:1b}

步骤 2:绑定命令
使用插件的选择器将应由该实体触发的命令注入其中:

/npc add @n[type=mannequin] say Welcome, %player_name%!
/npc add @n[type=mannequin] player:spawn

步骤 3:玩家交互
当玩家右键点击该实体时,系统会按顺序执行绑定的命令。


命令与权限

所有命令默认需要 pronpc.admin 权限。命令目标 <target> 支持 Minecraft 原生的目标选择器。

命令 描述
/npc reload 重新加载配置文件。
/npc list <target> 列出目标实体 PDC 中绑定的所有命令。输出至聊天栏;点击某行可复制其内容。
/npc add <target> <command> 向目标实体追加交互命令。如果目标尚不存在 PDC 标签,系统将自动初始化。
/npc remove <target> <index> 移除给定列表索引处的命令。如果列表变为空,则移除实体的 NPC 标签。

注意:目标选择器必须精确匹配单个实体。


配置 (config.yml)

# NPC 的全局交互冷却时间(秒)
cooldown-seconds: 3.0

开发者参考

插件的底层数据结构如下:

  • 命名空间: npc
  • 核心键: commands — 类型 PersistentDataType.LIST.strings()
  • 计划中的视觉扩展键:
    • mirror_skin — 类型 PersistentDataType.BYTE
    • look_at — 类型 PersistentDataType.BYTE

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源