Easy NPC

🗣 Easy NPC（整合包）


 [](https://github.com/MarkusBordihn/BOs-Easy-NPC/issues?q=is:open !label:enhancement)

Easy NPC 为地图制作者、RPG、冒险服务器、整合包和其他模组提供了一个简化的系统，用于创建带有对话、交易和交互的自定义 NPC。

该项目是 Easy NPC 整合包，一个启动器便利包，可自动安装所需的 Easy NPC 模块。

此整合包本身不包含 Easy NPC 模块。

📦 安装概览

Easy NPC 被拆分为多个模块。此整合包的存在是为了简化通过支持自动依赖解析的启动器进行的安装。

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

• 安装 Easy NPC 整合包
• 您的启动器将自动安装所需的模块：
  • Easy NPC 核心
  • Easy NPC 配置界面（配置工具和所需的网络功能）

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

如果您手动安装模组或在实例之间复制整合包，请确保所需的模块存在：

• Easy NPC 核心
• Easy NPC 配置界面

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

介绍与概览视频（英文）

✨ 功能

• 带有对话、交易和交互的简易 NPC
• 为地图制作者、服务器和 RPG 环境提供简单设置
• 可配置的操作与调试选项
• 支持交易，提供可配置的交易内容和条件
• 皮肤配置，支持玩家名称和 URL
• 为服务器和客户端环境而设计
• 为其他模组提供 API 支持和集成

📦 模组集成

Armourer's Workshop

与 Armourer's Workshop 的基本集成，可使用其库中的皮肤。

Epic Fight Mod

自 Easy NPC 6.4.x 版本起，内置了对 Epic Fight 的支持。无需额外的集成模组。

Immersive Melodies

与 Immersive Melodies 的基本集成，可使用乐器。

用法

使用对应的生成蛋或通过召唤命令生成一个 NPC。

使用预定义的 /easy_npc 命令或 NPC 配置魔杖来打开图形用户界面。此界面允许您直接在游戏中配置对话、交易选项、皮肤、操作和其他与 NPC 相关的设置。

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

⬆️ 升级

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

ℹ️ 为什么不再有 jar-in-jar 整合包了

旧版本使用 jar-in-jar 的设置将多个 Easy NPC 模块打包到一个文件中。

这种方法导致了一些技术问题：

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

现代的启动器已经提供了依赖解析功能。使用此机制可以带来更清晰、更可预测的设置，并允许 Easy NPC 模块独立更新。

ℹ️ 更多信息

请查看Wiki以获取更多信息。

🐛 报告问题、错误、崩溃或功能请求

请通过问题链接报告问题和功能请求。我很乐意帮助您。

🫶 支持我

如果您喜欢使用我的创作，请考虑支持我的开发！☕️ 通过 Ko-fi 捐款非常有帮助，但不是必须的（我的模组是免费且开源的！）。每一份帮助都能让我继续在业余时间创作模组，支付软件、服务、硬件费用，以及多买一块披萨或额外的 Spezi。

⚖️ 许可

MIT 许可证仅适用于此仓库中的代码。图像、模型和其他资产被明确排除在外。