NPC高级权限

NPCPremium

NPCPremium 是一个适用于 Minecraft Fabric、Forge 服务器和客户端的可配置 NPC 模组。它添加了持久化的类玩家 NPC，支持自定义皮肤、带格式的名称/副名称、右键交互、占位符、消息、音效、完整的游戏内编辑器 GUI、由 NPC 自身播放的真实 Emotecraft 表情，以及一个可配置的轻量级 AI 行为系统。由 zJuqni 创作。

兼容性：

• Minecraft 1.21.1-1.20.1
• Fabric Loader 0.18.2+
• Fabric API
• Java 21
• 可选：Emotecraft 2.4.12+（根据安装配置，可能还需要 playeranimator）

功能特性

• 创建保存在世界 NBT 中的持久化 NPC 实体。
• 支持自定义名称和副名称，支持使用 & 和 § 的旧版格式代码，以及使用 \& 转义与符号。
• 可从玩家昵称解析皮肤，若无法解析纹理则回退至 Steve/Alex 皮肤。
• 支持右键交互，可执行以玩家或控制台身份运行的命令、在聊天栏或行动栏显示点击消息、播放点击音效、触发点击表情、设置每个 NPC 的冷却时间、邻近半径、接近触发表情，以及可选的交互限制。

AI 与行为

• AI 模式：static、wander、patrol、follow、guard、orbit、greet、flee、mirror、showcase。
• AI 调节：出生点、侦测范围、速度、半径、停止距离和传送范围。
• 为巡逻和展示设置保存路径点路线。
• AI 预设：host、guard、pet、shy、mirror、showcase、patrol。
• 情境化问候消息、问候表情、问候冷却时间，以及可配置间隔的环境表情。
• 使用自定义的轻量级移动系统，而非原版生物 AI/寻路。

编辑器 GUI

• /npcpremium gui <npcName> 打开一个带有常规、位置、AI 大脑、点击、反馈和表情标签页的编辑器。
• 允许你在游戏中管理大多数 NPC 设置，无需记住完整的命令语法。

其他功能

• 内置命令和消息占位符：%player%、%player_uuid%、%player_x%、%player_y%、%player_z%、%player_world%、%npc%、%npc_uuid%、%npc_x%、%npc_y%、%npc_z%、%npc_world%、%world%。
• 如果存在，可通过反射提供可选的 PB4 Placeholder API 支持。
• /summon npcpremium:npc 自动注册带有数字 ID（如 1、2、3）的召唤 NPC，并在需要时分配默认可见名称（如 NPC #1）。
• 高级控制包括 look static|nearest、可配置的视线范围、移动到注视的方块、旋转预设、每个 NPC 的伤害开关，以及 NPC 克隆。

命令

• 核心管理：create、delete、list、tp、info、gui、name、subname、skin、move、rotate、look、clone、damage。
• 交互与反馈：onclick、message、sound、emote、near radius、cooldown、interact onlyplayers、interact requirepermission。
• AI 管理：ai status、mode、home、range、speed、radius、stopdistance、teleportrange、ambientemote、ambientinterval、preset、waypoint add/list/remove/clear、greeting message/clear/cooldown/emote。

权限

• npcpremium.admin 授予对 /npcpremium 的管理员访问权限。
• 如果没有可用的兼容权限提供器，则回退到配置的 OP 等级。
• 每个 NPC 的 interact requirepermission <node> 可以在存在兼容提供器时使用真实的权限节点。

重要限制

• 主要交互触发方式是右键。
• NPC 默认是静态的，不使用原版 AI 或原版寻路。
• AI 移动是轻量级且由行为驱动的，并非完全自主导航。
• 表情是可选的，需要渲染环境支持 Emotecraft。
• 如果无法解析配置文件纹理，皮肤可能回退至 Steve/Alex。
• 为获得完整体验，请在服务器和客户端均安装此模组。在需要渲染 NPC 表情的一端安装 Emotecraft。