Easy NPC - Easy NPC（简易NPC）

🗣 Easy NPC（Bundle）

[][issues]

[][wiki]

[][ko-fi]

Easy NPC 提供了一个简化的系统，用于创建带有对话、交易和交互功能的自定义 NPC，

适用于地图制作者、RPG、冒险服务器、整合包以及其他模组。

本项目是 Easy NPC Bundle，这是一个方便启动器使用的打包版本，可自动安装

所需的 Easy NPC 模块。

此 Bundle 本身并不包含 Easy NPC 模块文件。

📦 安装概览

Easy NPC 被拆分为多个模块。

此 Bundle 的存在是为了简化那些支持自动依赖解析的启动器中的安装流程。

选项 A：通过启动器安装（推荐）

• 安装 Easy NPC Bundle
• 你的启动器会自动安装所需模块：
• Easy NPC Core
• Easy NPC Config UI（配置工具和所需网络功能）

选项 B：手动安装或复制整合包

如果你是手动安装模组，或在不同实例之间复制整合包，请确保以下必需模块已存在：

• Easy NPC Core
• Easy NPC Config UI

提示：在分享或复制整合包时，请复制完整的 mods/ 文件夹，以确保包含所有必需的 jar 文件。

Introduction & Overview Video (English)

✨ 功能特性

• 轻松创建带有对话、交易和交互功能的 NPC
• 适用于地图制作者、服务器和 RPG 环境的简易配置
• 可配置动作，并带有调试选项
• 支持可配置的交易内容和条件
• 支持使用玩家名称和 URL 进行皮肤配置
• 同时适用于服务端和客户端环境
• 为其他模组提供 API 支持与集成能力

📦 模组集成

[Armourer's Workshop][armourers_workshop]

为 Armourer's Workshop 提供基础集成，可使用其库中的皮肤。

[Epic Fight Mod][epicfightmod]

自 Easy NPC 6.4.x 起，已内置对 Epic Fight 的支持。

无需额外的集成模组。

[Immersive Melodies][immersive-melodies]

为 Immersive Melodies 提供基础集成，可使用音乐乐器。

用法

使用对应的刷怪蛋或通过 summon 命令生成一个 NPC。

使用预定义的 /easy_npc 命令或 NPC 配置魔杖来打开图形用户界面。

该 GUI 允许你直接在游戏内配置对话、交易选项、皮肤、动作以及其他与 NPC 相关的

设置。

大多数交互和调整都可以直接在游戏内完成，无需编辑文件或重启服务器。

⬆️ 升级

在升级/更新到新版本之前，请务必先查看[升级指南][upgrade_guide]。

ℹ️ 为什么不再提供 jar-in-jar bundle

旧版本曾使用 jar-in-jar 方案，将多个 Easy NPC 模块打包到单个文件中。

这种方式会导致一些技术问题：

• 当模块被单独安装时会出现重复的 mod ID
• 类加载冲突以及模组来源不明确
• 当仅需要 Easy NPC Core 作为依赖时会出现兼容性问题
• 增加维护和支持复杂度

现代启动器已经提供了依赖解析功能。

使用这种机制可以带来更干净、更可预测的安装方式，并允许 Easy NPC 各模块独立更新。

ℹ️ 更多信息

请查看 [wiki][wiki] 了解更多信息。

🐛 反馈问题、Bug、崩溃或功能请求

请通过 [issues link][issues] 提交问题和功能请求。我很乐意帮助你。

🫶 支持我

如果你喜欢我的作品，可以考虑支持我的开发！☕️

通过 [Ko-fi][ko-fi] 进行捐助将给予我极大帮助，

但这并非必须（我的模组是免费且开源的！）。

每一份支持都能帮助我在空闲时间继续制作模组，承担软件、服务、硬件成本，

以及多买一块披萨或多喝一瓶 Spezi。

⚖️ 许可证

[MIT LICENSE](LICENSE.md) 仅适用于此仓库中的代码。

图片、模型和其他资源被明确排除在外。

[ko-fi]: https://ko-fi.com/Kaworru

[wiki]: https://github.com/MarkusBordihn/BOs-Easy-NPC/wiki

[upgrade_guide]: https://github.com/MarkusBordihn/BOs-Easy-NPC/wiki/Upgrading

[armourers_workshop]: https://www.curseforge.com/minecraft/mc-mods/armourers-workshop

[epicfightmod]: https://www.curseforge.com/minecraft/mc-mods/epic-fight-mod

[issues]: https://github.com/MarkusBordihn/BOs-Easy-NPC/issues