NPCShowcase

NPCShowcase 是面向 Folia 1.21.11 的 Citizens NPC 展示柜插件。

管理员蹲下右键 Citizens NPC 打开六行箱子编辑器，可以直接拖动编辑主手、副手、头盔、胸甲、护腿和靴子，并通过 Citizens Trait API 管理 LookClose、SkinTrait 和 RotationTrait。

运行要求

• Java 21
• Folia 1.21.11
• Citizens 2.0.43 或兼容版本
• LuckPerms 可选，仅用于管理标准 Bukkit 权限节点

权限

所有 npcshowcase.* 权限默认仅 OP，可使用 LuckPerms 授予权限组。

新手使用

• 使用 Citizens 选中 NPC 后，蹲下右键即可打开编辑器。
• 新建 NPC 默认没有名字。/npcshow rename <名称> 可改名，/npcshow rename * 清空名称，支持 & 和 § 颜色代码。
• GUI 可切换潜行、Look 和持续旋转；持续旋转在关闭菜单后仍继续。
• 皮肤输入期间输入 T 或 t 取消，输入内容不会显示到公屏。
• 本地皮肤放到 plugins/NPCShowcase/skins/，每个皮肤使用一个 .yml 文件：

name: Demo
texture: base64-texture-value
signature: base64-signature-value

重要说明

插件通过 Citizens 公开 API 工作，不复制或打包 Citizens 源码。静态检查、单元测试和 Maven 构建成功，不等于真实 Folia 1.21.11 服务端运行测试。