FancyNpcs NPC插件

FancyNpcs 数据包 NPC 插件

> 一款基于数据包（packets）实现的轻量、高性能 NPC 插件，专为 Paper（及 Folia）服务端设计。支持自定义生物类型、皮肤、发光、属性、装备与交互，开箱即用，功能丰富。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | FancyNpcs |
| 开发者 | Oliver（OliverOwner，FancyInnovations）|
| 最新版本 | 2.11.0+370（2026-06-23，快照版）；正式版 2.11.0（2026-06-16）|
| 许可协议 | MIT |
| 兼容版本 | Minecraft Java 1.19.3 – 26.2（含 1.19.3–1.19.4、1.20.x、1.21.x、26.1.x、26.2）|
| 运行平台 | Paper、Folia（及 Paper 分支服务端）|
| 运行环境 | Java 25 或更高；Paper 1.21.4 及以上 |
| 项目地址 | https://modrinth.com/plugin/fancynpcs |
| 官方文档 | https://docs.fancyplugins.de/（原 fancymcplugins.github.io 已迁移至此）|
简介

FancyNpcs 是一款基于数据包机制实现的 NPC 插件，全程通过发包与解包与客户端交互，无需依赖服务端实体、不修改核心逻辑，因此性能开销极低、兼容性好。玩家在客户端看来是"真实 NPC"，服务端则以轻量对象管理，适合大规模部署。

插件覆盖从创建、克隆、位移、旋转、缩放，到外观（类型、皮肤、发光、装备）、属性（姿态、可见性、变体）、交互动作（执行命令、发送消息、控制台命令）的完整管理链路，显示名支持 MiniMessage、PlaceholderAPI 与 MiniPlaceholders。提供官方开发者 API（Maven/Gradle 依赖），方便二次开发。

官方明确说明：Spigot 不受支持，仅推荐 Paper 及分支（Folia 兼容）。同时插件会收集匿名使用数据以改进产品，数据仅做聚合统计，不存储 IP、服务器名等可识别信息，且可在文档中查阅指标清单并选择退出。
核心特性
纯数据包实现
通过 packets 收发驱动 NPC，不依赖服务端实体注册，性能开销小、稳定性高，可承载大量 NPC。
丰富的外观自定义
类型：牛、猪、玩家等任意实体类型
皮肤：来自玩家名、UUID、纹理 URL、本地文件，支持 @mirror 镜像观察者皮肤、@none 清除，支持 --slim 细手臂
发光：全 16 种颜色或关闭
装备：主手物品、四件盔甲，如手持钻石剑、身穿皮革甲
缩放：1.20.5+ 支持 scale 调整体积
显示名：支持 MiniMessage 格式与 PlaceholderAPI、MiniPlaceholders 变量
属性与状态控制
姿态、可见性、变体等属性可设；可开关碰撞（collidable）、是否转向玩家（turn_to_player 及触发距离）、是否在 Tab 列表显示（仅玩家类型 NPC）。
交互动作系统
可为 NPC 绑定触发条件与动作列表，支持执行玩家命令、控制台命令、发送消息等，动作可增删插队（add、add_before、add_after），实现点击对话、传送、商店入口等玩法。
完整的管理命令
/npc 为主命令：创建、复制、删除、列表、信息查询、位移旋转居中、皮肤发光装备缩放、属性设置一应俱全；/fancynpcs 用于重载、保存、版本查询、功能开关。
多版本分模块支持
代码按 Minecraft 版本分模块实现（如 implementation_1_21_5、1_21_11、26_1_2、26_2 等），持续跟进新版本，26.2 支持已于 2.11.0 加入。
开发者 API
提供 Maven/Gradle 依赖与 Javadocs，坐标 de.oliver:FancyNpcs:[VERSION]，仓库 https://repo.fancyinnovations.com/releases，便于插件联动开发。
匿名数据统计（可关闭）
收集聚合型匿名使用数据，不记录 IP 或服务器信息，可在文档中查看完整指标清单并选择退出。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper 1.21.4 及以上（推荐最新版）；支持 Folia 与 Paper 分支 |
| Java | 25 或更高 |
| 不支持 | Spigot（官方明确不支持）|
安装方法
从 Modrinth（或 Hangar）下载 FancyNpcs-2.11.0.jar（正式版）或对应快照构建
放入服务端的 plugins/ 目录
确保服务端为 Paper 1.21.4+，使用 Java 25+ 启动
重启服务器，插件自动生成默认配置
按需编辑配置后，执行 /fancynpcs reload 热重载

> 升级提醒：快照版（如 2.11.0+370、2.10.1.xxx）仅供测试，官方不建议用于生产环境，可能含未完成的 bug；生产环境请优先选择正式版（如 2.11.0）。升级前建议备份 plugins/FancyNpcs/ 目录。如不想参与匿名数据统计，可按官方文档在配置中关闭。

使用机制说明
NPC 数据按世界存储，创建后即可被同世界玩家看见；跨世界需在对应世界创建或使用传送逻辑
皮肤来源优先级：指定玩家名/UUID > 纹理 URL > 本地 skins 目录下的图片文件（plugins/FancyNpcs/skins/）
交互动作按 trigger（如点击、距离进入）触发，动作列表有序，可通过 add_before/add_after 精确插队
显示名、消息均支持 MiniMessage 与占位符，可直接接入 PlaceholderAPI 变量
缩放、部分属性功能有版本门槛（如 scale 需 1.20.5+），低版本对应命令不可用
使用场景
主城/大厅的引导员、任务发布者、传送门守卫
商店入口、职业介绍、对话树（配合动作执行命令）
展示柜：装备展示、皮肤展示、变体/姿态演示
RPG 剧情 NPC、活动临时交互点
数据统计点位、排行榜展示载体
近期更新
2.11.0+370（2026-06-23，快照）：修复 npcconvert 命令中 NPC 的发光效果
2.11.0+369（2026-06-22，快照）：移除 player_command_as_op 动作
2.11.0（2026-06-16，正式版）：新增 26.2 服务端支持；新增 mineskin_timeout 配置项（设置从 MineSkin 获取皮肤的超时）；修复 /npc displayname 报错
2.10.1.xxx 系列（2026-06 中旬，快照）：新增通用命令执行异常处理器；修复 26.2-rc-2 属性问题；修复交互被执行两次；为 fancynpcs、fancyholograms 添加 26.2-rc-2 支持；修复 NPC 类的自定义模型属性检查
相关链接
Modrinth：https://modrinth.com/plugin/fancynpcs
Hangar：https://hangar.papermc.io/Oliver/FancyNpcs
官方文档（命令参考）：https://docs.fancyplugins.de/
数据收集说明：https://fancyinnovations.com/docs/minecraft-plugins/data-collection
GitHub 源码：https://github.com/FancyInnovations/FancyPlugins
Maven 仓库：https://repo.fancyinnovations.com/releases
Discord：官方 Discord 服务器（见 Modrinth 页）
BBSMC 镜像（含中文 changelog）：https://bbsmc.net/plugin/fancynpcs/changelog