Citizens 是 Minecraft 服务器最主流的 NPC 管理插件，兼容 Spigot/Paper 等核心，支持 NPC 创建、外观定制、移动控制、交互绑定等全场景需求

一、基础操作：NPC 创建与管理

plaintext

# 1. NPC创建
# 基础创建（默认玩家外观，生成在脚下）
/npc create 名称
示例：/npc create 新手引导员

# 指定生物外观创建
/npc create 名称 -t 生物类型
示例：/npc create 僵尸守卫 -t zombie、/npc create 村民商人 -t villager

# 模仿玩家外观创建
/npc create 名称 -p 玩家名
示例：/npc create 管理员克隆体 -p Admin

# 2. 选中与删除
/npc select 名称/ID  # 指令选中（右键空手持物点击也可选中）
示例：/npc select 僵尸守卫、/npc select 1

/npc remove  # 删除选中NPC
/npc remove 名称 -a  # 批量删除同名NPC
示例：/npc remove 临时NPC -a

# 3. 基础查询
/npc list  # 查看所有NPC（含ID、外观）
/npc info  # 查看选中NPC详情

二、外观与基础属性配置

plaintext

# 1. 皮肤设置
/npc skin 玩家名  # 引用玩家皮肤
示例：/npc skin Steve

/npc skin -u 皮肤直链URL  # 自定义皮肤
示例：/npc skin -u https://xxx.com/custom-skin.png

/npc skin reset  # 恢复默认皮肤

# 2. 外观与姿势
/npc type 生物类型  # 切换生物外观
示例：/npc type cow、/npc type enderman

/npc pose 姿势类型  # 设置姿势
常用姿势：stand（站立）、sit（坐下）、lay（躺下）、sneak（潜行）
示例：/npc pose sit、/npc pose stand

# 3. 名称与显示
/npc rename 新名称  # 修改名称（支持颜色代码&）
示例：/npc rename &c[管理员]守卫、/npc rename &a新手引导员

/npc tag hide  # 隐藏名称标签
/npc tag show  # 显示名称标签

/npc glow on  # 开启发光
/npc glow off  # 关闭发光

# 4. 状态控制
/npc lock  # 锁定NPC（禁止攻击/推动）
/npc unlock  # 解锁

/npc god  # 开启无敌
/npc ungod  # 取消无敌

/npc invisible on  # 隐藏NPC
/npc invisible off  # 显示NPC

三、移动与朝向控制（管理员高频用）

plaintext

# 1. 移动与传送
/npc tp  # 传送NPC到自己身边
/npc move  # 让NPC自主走到自己身边

/npc tp X Y Z  # 传送NPC到指定坐标
示例：/npc tp 200 64 300

/npc follow 玩家名  # 让NPC跟随玩家
/npc follow stop  # 取消跟随
示例：/npc follow Admin

# 2. 朝向设置
/npc look  # 看向最近玩家
/npc lookat 玩家名  # 精准看向指定玩家
/npc lookat stop  # 取消定向看向
示例：/npc lookat Steve

/npc look 方向  # 固定看向指定方向
方向参数：east（东）、south（南）、west（西）、north（北）、up（上）、down（下）
示例：/npc look east

四、交互设置：对话与指令绑定

plaintext

# 1. 对话设置
/npc text add 对话内容  # 添加对话（多行重复执行）
示例：/npc text add 欢迎来到服务器！、/npc text add &a点击领礼包~

/npc text list  # 查看对话列表
/npc text clear  # 清空对话

/npc text mode once  # 单次显示对话
/npc text mode cycle  # 循环显示对话

# 2. 指令绑定
# 玩家执行指令（需玩家有对应权限）
/npc cmd add 指令
示例：/npc cmd add give @s diamond 1、/npc cmd add warp spawn

# 服务器执行指令（管理员权限）
/npc cmd add -s 指令
示例：/npc cmd add -s tp @s 0 64 0

/npc cmd list  # 查看绑定指令
/npc cmd remove 序号  # 删除指定指令
示例：/npc cmd remove 0
/npc cmd clear  # 清空所有指令

五、行为模式设置

plaintext

/npc stand  # 静止模式（不移动）
/npc wander  # 游走模式（默认10格范围）
/npc wander 范围  # 自定义游走范围
示例：/npc wander 20

# 巡逻模式
/npc path add  # 添加巡逻点（选中NPC后执行）
/npc path start  # 启动巡逻
/npc path stop  # 停止巡逻
/npc path clear  # 清空巡逻点

六、权限管理与辅助指令

plaintext

# 1. 权限控制
/npc owner 玩家名  # 设置NPC所有者
示例：/npc owner Admin
/npc owner clear  # 取消专属所有者

/npc perm add 玩家名 interact  # 允许玩家交互
/npc perm remove 玩家名 interact  # 禁止交互
/npc perm add * interact  # 开放所有玩家交互

# 2. 辅助指令
/npc copy  # 复制选中NPC
/npc refresh  # 刷新NPC状态（解决卡顿/异常）
/npc pause  # 暂停NPC行为
/npc resume  # 恢复NPC行为
/citizens reload  # 重载插件

七、常见问题解决

1. 指令无效：确认插件已放入 plugins 文件夹并重启服务器，管理员需拥有citizens.admin权限；
2. 点击无响应：解锁 NPC（/npc unlock），确认绑定对话 / 指令，关闭隐形模式；
3. 皮肤加载失败：玩家名真实存在，皮肤 URL 为 PNG 直链，执行/npc refresh；
4. 朝向 / 跟随失效：取消之前的朝向指令（/npc lookat stop），清除 NPC 周围障碍物。