NPCPremium

NPCPremium

NPCPremium 是一个可配置的 Minecraft NPC 模组。它添加了持久化的类玩家 NPC,支持自定义皮肤、带格式的名称/副名称、右键操作、占位符、消息、声音、完整的游戏内编辑器 GUI 以及真实的 EMOTES。作者:zJuqni

装饰

NPCPremium

NPCPremium 是一个适用于 Minecraft Fabric 服务器和客户端的可配置 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 调校:home、检测范围、速度、半径、停止距离和传送范围。
  • 为巡逻和展示设置保存路径点路线。
  • AI 预设:host、guard、pet、shy、mirror、showcase、patrol。
  • 情境问候消息、问候表情、问候冷却,以及可配置间隔的环境表情。
  • 使用自定义轻量级移动系统,而非原版生物 AI/寻路。

编辑器 GUI

  • /npcpremium gui <npcName> 打开分页编辑器,包含 General、Position、AI Brain、Click、Feedback 和 Emotes 标签页。
  • 让你无需记住完整命令语法即可在游戏内管理大多数 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 会自动以 1、2、3 等数字 id 注册召唤的 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。

----- SPANISH -----

NPCPremium

NPCPremium es un mod de NPCs configurables para Minecraft Fabric en servidor y cliente. Añade NPCs tipo jugador persistentes con skins personalizadas, name/subname con formato, acciones por click derecho, placeholders, mensajes, sonidos, una GUI completa de edición, emotes reales de Emotecraft reproducidos por el propio NPC y un sistema configurable de IA ligera. Creador por zJuqni

Compatible con:

  • Minecraft 1.21.1-1.20-1
  • Fabric Loader 0.18.2+
  • Fabric API
  • Java 21
  • Opcional: Emotecraft 2.4.12+ (playeranimator también puede ser necesario según la instalación)

Qué hace

  • Crea entidades NPC persistentes guardadas en el NBT del mundo.
  • Soporta name y subname personalizados, formato legacy con & y §, y escape de ampersands con \&.
  • Resuelve skins a partir del nick de un jugador, con fallback a Steve/Alex si no se pueden obtener las texturas.
  • Soporta interacción por click derecho con comandos como player o console, mensajes al click en chat o actionbar, sonidos, emotes al click, cooldowns por NPC, radio de proximidad, emotes por cercanía y restricciones opcionales de interacción.

IA y comportamiento

  • Modos de IA: static, wander, patrol, follow, guard, orbit, greet, flee, mirror, showcase.
  • Ajustes de IA: home, rango de detección, velocidad, radio, stop distance y teleport range.
  • Rutas guardadas por waypoints para patrullas y setups de showcase.
  • Presets de IA: host, guard, pet, shy, mirror, showcase, patrol.
  • Mensajes de saludo contextuales, emotes de saludo, cooldown de saludo y emotes ambientales con intervalo configurable.
  • Usa un sistema propio de movimiento ligero en lugar de la IA/pathfinding vanilla.

GUI de editor

  • /npcpremium gui <npcName> abre un editor por pestañas con General, Position, AI Brain, Click, Feedback y Emotes.
  • Permite configurar casi todo el NPC dentro del juego sin memorizar toda la sintaxis de comandos.

Otras funciones

  • Placeholders integrados para comandos y mensajes: %player%, %player_uuid%, %player_x%, %player_y%, %player_z%, %player_world%, %npc%, %npc_uuid%, %npc_x%, %npc_y%, %npc_z%, %npc_world%, %world%.
  • Compatibilidad opcional con PB4 Placeholder API por reflexión si está presente.
  • /summon npcpremium:npc auto-registra NPCs invocados con ids numéricos como 1, 2, 3, y les asigna un nombre visible por defecto como NPC #1 cuando hace falta.
  • Incluye controles avanzados como look static|nearest, rango de mirada configurable, mover al bloque que estás mirando, presets de rotación, toggle de daño por NPC y clonado de NPCs.

Comandos

  • Gestión principal: create, delete, list, tp, info, gui, name, subname, skin, move, rotate, look, clone, damage.
  • Interacción y feedback: onclick, message, sound, emote, near radius, cooldown, interact onlyplayers, interact requirepermission.
  • Gestión de IA: ai status, mode, home, range, speed, radius, stopdistance, teleportrange, ambientemote, ambientinterval, preset, waypoint add/list/remove/clear, greeting message/clear/cooldown/emote.

Permisos

  • npcpremium.admin da acceso administrativo a /npcpremium.
  • Si no hay un provider de permisos compatible, usa como fallback el nivel OP configurado.
  • interact requirepermission <node> puede usar nodos reales cuando existe un provider compatible.

Límites importantes

  • La interacción principal es con click derecho.
  • Los NPCs son estáticos por defecto y no usan IA vanilla ni pathfinding vanilla.
  • El movimiento de IA es ligero y basado en comportamiento, no navegación autónoma completa.
  • Los emotes son opcionales y requieren soporte de Emotecraft en el entorno que los renderiza.
  • La skin puede caer en Steve/Alex si no se pueden resolver las texturas del perfil.
  • Para la experiencia completa, instala el mod en servidor y cliente. Instala Emotecraft en el lado que deba renderizar los emotes del NPC.