MyNpc

MyNpc

MyNPC是一个Forge模组，为《我的世界》添加了可自定义的向导NPC。NPC能帮助玩家找到建筑结构、提供方向提示，并给予传送卷轴。你还可以自定义它们的名字、外观、对话、交易和建筑结构设置。

冒险

MyNpc预览查看大图

MyNPC

NPC NPC NPC NPC

MyNPC 1.1 用户指南

游戏要求

  • Minecraft 1.20.1
  • Forge 47.x
  • MyNPC 1.1

安装方法

  1. 将 MyNPC 的 jar 文件放入你的游戏实例的 mods 文件夹中。
  2. 启动游戏一次。
  3. 模组会自动创建配置文件文件夹。

重要文件夹：

  • config/npc_types 存储 NPC 定义 JSON 文件。
  • config/mynpc_custom_assets/textures 存储自定义 NPC 皮肤纹理。
  • config/mynpc_custom_assets/sounds 存储自定义 NPC 声音文件。
  • config/mynpc_custom_assets/lang 可用于额外的语言条目。

默认向导 NPC

内置向导 NPC 是 village_guide。

默认情况下，向导：

  • 会在原版村庄中生成。
  • 当村庄生成检查成功时，有 100% 的生成几率。
  • 每个村庄区域最多生成一个向导。
  • 知道一组随机的结构。
  • 可以出售结构位置帮助和传送卷轴。
  • 可以攻击敌对生物，受到攻击时会反击，并避开苦力怕。
  • 会待在其家乡村庄附近，而不是自由游荡。

如果更新前已经生成了默认配置，请删除 config/npc_types/village_guide.json 并重新启动游戏，以重新生成最新的默认版本。

NPC 管理器

在游戏中按 H 键打开 NPC 管理器。

主要操作：

  • + 从默认模板创建一个新的 NPC。
  • 从左侧列表选择一个 NPC 进行编辑。
  • 使用 NPC 条目旁的小框进行多选。
  • 保存 保存当前更改。
  • 复制 复制所选 NPC。副本会保留大部分设置，但会获得一个唯一的 ID。
  • 取消 放弃当前的编辑会话。
  • 删除 在确认后删除选中的 NPC 定义。
  • 重置 将选中的 NPC 恢复为内置的默认向导设置。

选项卡：

  • 外观：皮肤、名称、实体 ID 和声音。
  • 行为：生成结构、生成几率和最小/最大生成数量。
  • 结构：已知结构和结构提示行为。
  • 交易：传送卷轴交易和自定义物品交易。
  • 聊天：随机聊天台词和与结构相关的对话。

自定义皮肤

  1. 将 PNG 皮肤文件放入 config/mynpc_custom_assets/textures。
  2. 按 H 键打开 NPC 管理器。
  3. 选择一个 NPC。
  4. 转到 外观 选项卡。
  5. 使用自定义皮肤按钮选择纹理。
  6. 保存 NPC。

皮肤应使用正常的 Minecraft 玩家皮肤布局。

自定义声音

  1. 将声音文件放入 config/mynpc_custom_assets/sounds。
  2. 按 H 键打开 NPC 管理器。
  3. 选择一个 NPC。
  4. 转到 外观 选项卡。
  5. 为互动、受伤、死亡或环境音效槽选择声音。
  6. 使用预览按钮测试声音。
  7. 保存 NPC。

结构选择

结构列表支持：

  • 按关键字搜索。
  • 单击结构名称进行单选。
  • 单击小框进行多选。
  • 当列表长于面板时滚动。

结构名称在可用时使用语言键。未知结构会回退到基于 ID 的可读名称。

交易

NPC 可以提供：

  • 针对已知结构的传送卷轴交易。
  • 结构位置提示交易。
  • 自定义物品交易。

对于每个结构交易，你可以配置：

  • 结构名称。
  • 用作货币的物品。
  • 所需物品数量。
  • 结构交易是否被禁用。

聊天与提示

NPC 可以有通用聊天台词和特定结构的提示文本。

结构提示文本可以使用：

  • {structure} 用于翻译后的结构名称。
  • {direction} 用于方向文本。

示例：

如果我没记错的话，{structure}就在 {direction} 方向的某个地方。

生成蛋

生成蛋 NPC 使用与自然生成 NPC 相同的基础初始化：

  • 可以生成默认的已知结构。
  • 生成时设置家园位置。
  • 可以分配随机装备。
  • 启用战斗行为。

故障排除

如果自定义皮肤显示为缺失纹理：

  • 检查文件是否在 config/mynpc_custom_assets/textures 内。
  • 确保它是有效的 PNG 文件。
  • 重新打开选择器并再次保存 NPC。

如果自定义声音不播放：

  • 检查文件是否在 config/mynpc_custom_assets/sounds 内。
  • 使用 外观 选项卡中的声音预览按钮。
  • 如果资源包是首次创建的，请重新启动游戏。

如果默认向导设置看起来是旧的：

  • 删除 config/npc_types/village_guide.json。
  • 重新启动游戏。
  • 模组会重新生成最新的默认配置。

——————————————————————————

MyNPC 1.2 更新指南

本指南涵盖了 MyNPC 1.2 中新增或更改的主要新工作流程。

打开 NPC 管理器

  • 按 H 键打开自定义 NPC 管理器。
  • 使用左侧的 NPC 列表选择一个 NPC。
  • 使用 NPC 列表下方的搜索框过滤 NPC。
  • 使用搜索框旁边的 + 按钮创建新的 NPC。
  • 所选的 NPC 现在会在列表中显示为按下状态，与所选的页面选项卡匹配。

NPC ID 与默认设置

  • 内置向导 NPC 仍然使用显示名称 village_guide。
  • 其内部 ID 现在是 npc。
  • 新的自定义 NPC 使用类似 npc1、npc2 和 npc3 的 ID。
  • 重置会恢复共享的默认向导设置，同时为被编辑的 NPC 保留一个安全的唯一 ID。

生成蛋

  • MyNPC 生成蛋现在放在它们自己的创造模式标签页中。
  • 使用 /mynpc egg <npc_id> 为特定 NPC 创建生成蛋。
  • 该命令支持建议，因此你可以输入部分 NPC ID，并从命令列表中选择。

命令

/mynpc egg <npc_id>

给玩家一个所选 NPC 定义的生成蛋。

示例：

/mynpc egg npc

给予默认向导 NPC 的生成蛋。

/mynpc egg npc1

给予 ID 为 npc1 的自定义 NPC 的生成蛋。

该命令支持 Minecraft 风格的建议。输入部分 NPC ID，然后使用命令建议列表选择正确的 NPC，无需输入完整 ID。

当整合包包含许多自定义 NPC 时，这很有用，因为你不想让每个生成蛋都混入正常的创造模式物品栏工作流程中。

外观页面

  • 设置 NPC 的显示名称和实体 ID。
  • 从自定义资源文件夹中选择自定义皮肤。
  • 在需要时将皮肤重置为史蒂夫。
  • 配置互动、受伤、死亡和环境声音。

行为页面

  • 使用 生成结构 编辑 NPC 可以自然生成的位置。
  • 每个生成规则包含：
    • 结构 ID
    • 最小生成数量
    • 最大生成数量
    • 生成几率
  • 使用生成规则界面中的搜索字段和 + 按钮添加结构。

结构页面

结构页面现已简化。

  • 查看已知 打开已知结构规则列表。
  • 随机已知最大值 控制自然生成的 NPC 所选择的已知结构最大数量。
  • 随机已知最小值 控制自然生成的 NPC 所选择的已知结构最小数量。

已知结构规则可用于控制 NPC 可以知道哪些结构，以及每个结构被选中的可能性有多大。

交易页面

  • 使用自定义交易列表添加和管理普通物品交易。
  • 自定义交易在右键点击的交易界面中显示在卷轴交易之前。
  • 使用传送卷轴价格列表配置结构卷轴交易。
  • 物品 ID 字段可以手动输入，也可以使用物品图标按钮选择。
  • 可以自定义交易前和交易后的交易文本消息。

聊天页面

  • 旧的独立 添加文本 按钮已移除。
  • 使用 查看文本 管理聊天台词。
  • 在文本列表编辑器中，可以在一处添加、编辑或删除聊天台词。
  • 使用结构文本工具配置与结构相关的对话。

结构指南

  • 按 G 键打开结构指南。
  • 当玩家到达一个已追踪的结构时，指南条目会标记为已访问。
  • 指南可以使用配置选项显示已追踪结构的名称和距离。

自定义资源

自定义皮肤和声音从 MyNPC 配置区域下的自定义资源文件夹中加载。

  • 将纹理放入纹理文件夹。
  • 将声音放入声音文件夹。
  • 重新打开相关的选择器界面以刷新并选择资源。

整合包作者注意事项

  • 现有的 NPC JSON 文件不会被自动删除。
  • 新安装使用 npc.json 作为默认向导定义。
  • 旧的 village_guide.json 文件仍然兼容。
  • 对于大型 NPC 整合包，使用 /mynpc egg 命令和专用的 MyNPC 生成蛋创造模式标签页，以避免杂乱。