授权转载 - Allay - AllayNPC - NPC插件 | MineBBS 我的世界中文论坛

版权类型: 授权转载

版权链接: https://github.com/smartcmd/AllayNPC

语言支持: 多语言

前置组件: Allay
PlaceHolder

适配版本（基岩）

全版本

AllayNPC

一个为 AllayMC 开发的强大 NPC 插件。

项目信息：

适配版本: AllayMC 0.23.0+
运行环境: Java 21
许可证: MIT

功能特性

自定义皮肤 - 支持普通玩家皮肤及 4D 皮肤
注视玩家 - NPC 会自动看向附近的玩家（每个玩家看到的角度独立）
动作表情 - 支持设置 NPC 定期播放表情动作（Emote）
装备系统 - 完整支持盔甲及手持物品
对话系统 - 创建带按钮的交互式对话框（内置游戏内编辑器！）
点击动作 - 点击时执行命令、发送消息或打开对话框
多语言支持 - 内置国际化支持（中文与英文）
游戏内编辑器 - 使用直观的表单界面创建和编辑 NPC
热重载 - 无需重启服务器即可重载配置
PlaceholderAPI - 消息中支持完整的变量解析

常用命令
（别名：/npc）

/anpc create <名称> - 创建新 NPC
/anpc edit <名称> - 编辑现有 NPC
/anpc delete <名称> - 删除 NPC
/anpc list - 列出所有 NPC
/anpc dialog - 管理对话框（游戏内 UI 界面）
/anpc reload - 重载配置
/anpc help - 查看帮助

权限节点： allaynpc.command (访问所有 NPC 命令)

目录结构说明

skins/ - 存放自定义皮肤 (.png 或 4D 文件夹)
capes/ - 存放披风文件
npcs/ - NPC 配置文件 (.yml)
dialogs/ - 对话框配置文件 (.yml)

皮肤设置方法
方式 1：单个 PNG 文件
将皮肤放入 skins/ 目录。如果是细手臂皮肤，请在文件名后添加 _slim（如 alex_slim.png）。
方式 2：皮肤文件夹（用于 4D 皮肤）
在 skins/ 下创建以皮肤命名的文件夹，放入 skin.png 和 skin.json（模型数据）。

对话系统配置示例
你可以在游戏内使用 /anpc dialog 编辑，也可以手动编辑 dialogs/welcome.yml：

YAML：

title: "&6🏪 商店"
body: "你好 {player_name}!\n欢迎光临，你想买点什么？"
buttons:
  - text: "🗡️ 钻石剑 - $100"
    commands:
      - "eco take {player_name} 100"
      - "give {player_name} diamond_sword 1"
    message: "&a感谢购买！"
    as_player: false
  - text: "❌ 关闭"