1.1.25. NPC插件安装

NPC（非玩家角色）插件可在服务器内创建可交互的虚拟角色，广泛用于菜单入口、功能指引、剧情交互等场景，极大提升服务器可玩性和沉浸感。

1.1.25.1. 插件对比

主流NPC插件对比

插件名称

是否免费

核心功能

脚本支持

兼容性

推荐指数

备注

Citizens2

是

NPC创建、动作、命令绑定

Denizen/外部脚本

Spigot/Paper

★★★★★

最主流，生态丰富

Denizen

是

高级脚本、对话、任务

内置脚本

Spigot/Paper

★★★★

需配合Citizens2

MythicMobs

部分免费

怪物/NPC/技能

内置脚本

Spigot/Paper

★★★

偏向怪物与Boss

CommandNPC

是

NPC绑定命令

无

Spigot/Paper

★★★

轻量级，功能单一

NPCLib

是

临时NPC、动画

API开发

Spigot/Paper

★★

偏向开发者

Quests

是

任务NPC

内置脚本

Spigot/Paper

★★★

任务系统为主

1.1.25.2. 推荐选择项

  • Citizens2 + Denizen：功能最全，生态丰富，支持命令、脚本、对话、动作等，适合绝大多数服务器。

  • 轻量需求可用 CommandNPC，复杂剧情建议配合 Denizen。

1.1.25.3. 插件简介

  • Citizens2：最主流的NPC插件，支持NPC创建、动作、皮肤、命令绑定、路径巡逻等，生态丰富。

  • Denizen：Citizens2的脚本扩展，支持复杂对话、任务、剧情、条件判断等。

  • 支持与菜单、全息、任务、权限等插件联动。

  • 免费开源，长期维护。

1.1.25.4. 关键链接

1.1.25.5. 安装步骤

  1. 从 CI 下载最新 Citizens2 和 Denizen jar 包

  2. 放到所有需要NPC的分区 plugins 目录

  3. 重启服务端

wget https://ci.citizensnpcs.co/job/Citizens2/lastSuccessfulBuild/artifact/dist/Citizens-2.x.x.jar
wget https://ci.citizensnpcs.co/job/Denizen/lastSuccessfulBuild/artifact/target/Denizen-1.x.x.jar
cp Citizens-2.x.x.jar /home/mc/instances/dl1/plugins/
cp Denizen-1.x.x.jar /home/mc/instances/dl1/plugins/
# 其他分区同理

1.1.25.6. 基础用法示例

以登录分区和生存区为例：

# 登录分区创建主菜单NPC
/npc create &3熊猫乐园
/npc lookclose
/npc command add -p menu
/citizens save

# 生存区创建主菜单和随机TP NPC
/npc create &3点击主菜单
/npc lookclose
/npc command add -p menu
/npc skin mc__panda

/npc create &3点我随机tp
/npc lookclose
/npc command add -p rtp
/npc mirrorskin
/citizens save

# 其他分区同理

1.1.25.7. 进阶用法

  • 支持 NPC 路径巡逻、动作、对话、脚本等高级功能

  • 配合 Denizen 可实现复杂剧情、任务、条件判断

  • 可与菜单插件、全息插件联动，打造沉浸式体验

1.1.25.8. 权限配置

这个插件，也不需要额外授权的。 主要是管理员在使用。

1.1.25.9. 常见问题 QA

Q1:

NPC无法创建或命令无效？

A1:

检查 Citizens2 是否安装，查看服务端日志，确认权限已授权。

Q2:

NPC皮肤不显示或动作异常？

A2:

检查皮肤ID是否正确，部分功能需正版账号支持。

Q3:

NPC命令无效或无权限？

A3:

检查 LuckPerms 权限配置，确认已授权 citizens.npc.* 相关权限。

Q4:

Denizen脚本报错？

A4:

检查脚本语法，参考官方文档和示例。