MiguelEconomy X EasyNPC

MiguelEconomy X EasyNPC

这个模组是一个附加组件,连接了两个热门模组:EasyNPC(允许你放置和自定义NPC角色)和MiguelEconomy

经济

MiguelEconomy X EasyNPC

将你的 EasyNPC 角色变成真正的商店店主——由 MiguelEconomy 提供支持。

本模组是一个附加组件,用于连接两个热门模组:EasyNPC(允许你放置和自定义 NPC 角色)和 MiguelEconomy(添加游戏内货币系统)。两者结合后,玩家可以走到 NPC 面前,打开商店,并使用硬币购买或出售物品——无需命令方块,也无需复杂设置。


本模组的功能

  • NPC 商店——为任意 EasyNPC 角色分配商店。玩家可以右键点击 NPC 打开它。
  • 购买与出售——商店中的每个物品都可以设置为允许购买、出售或两者皆可,并分别设置价格。
  • 进度系统——玩家在游玩过程中获得等级(基于赚取的钱和职业等级)。更高等级可解锁更好的商店和专属物品。
  • 商店构建器——服务器管理员可以通过可视化菜单直接在游戏内构建和编辑商店,无需接触任何文件。
  • JSON 配置——所有商店和 NPC 分配都存储在服务器配置文件夹中易于阅读的 JSON 文件里,因此高级用户如果愿意,可以直接编辑它们。

需求

模组 是否必需?
Minecraft Forge 1.20.1 是
MiguelEconomy 是(处理货币)
EasyNPC 是(提供 NPC)

使用方法

面向玩家

  1. 走到已分配商店的 NPC 面前,然后右键点击它。
  2. 商店窗口打开。浏览列出的物品。
  3. 点击购买来购买物品(硬币将从你的余额中扣除),或点击出售将你物品栏中的物品转换为硬币。
  4. 部分物品或商店被锁定在等级之后。打开进度界面(可从商店界面进入)查看你当前的等级以及达到下一等级所需的条件。

面向服务器管理员——设置商店

方式 A:游戏内商店构建器

  1. 使用 /shop create 命令(需要管理员权限)。
  2. 商店构建器菜单打开。添加物品、设置买入/卖出价格并保存。
  3. 保存后,打开 NPC 绑定配置文件,将商店 ID 链接到 NPC 的名称或 UUID。

方式 B:JSON 文件

  1. 启动一次服务器——它将在以下位置创建配置文件夹:
    config/migueleconomy_easynpc/npc_shops/
    
  2. 该文件夹中的每个 .json 文件代表一个 NPC 的商店。你可以复制并编辑 example_npc.json 作为起点。
  3. 重启服务器,或运行 /shop reload,以应用更改。

示例 NPC 商店文件:

{
  "shops": [
    {
      "id": "basic_goods",
      "title": "Basic Goods",
      "description": "Everyday supplies.",
      "requiredTier": "survivor",
      "entries": [
        {
          "id": "bread",
          "item": { "itemId": "minecraft:bread", "count": 1 },
          "buyEnabled": true,
          "sellEnabled": false,
          "buyPrice": 10,
          "sellPrice": 0,
          "description": "A loaf of bread."
        }
      ]
    }
  ],
  "npcBindings": [
    {
      "npcName": "Merchant",
      "shopIds": ["basic_goods"]
    }
  ]
}

提示: 你可以通过名称(npcName)或精确的 UUID(npcUuid)来匹配 NPC。如果多个 NPC 共享同一名称,使用 UUID 更可靠。

进度等级

玩家从 Survivor 等级开始。随着他们通过 MiguelEconomy 赚钱并提升职业等级,他们会自动晋升等级。每个等级可以解锁:

  • 整个商店的访问权限
  • 商店内的单个物品

等级列表和要求在以下位置配置:

config/migueleconomy_easynpc/progression.json

命令

命令 权限 作用
/level 玩家 打开你的进度界面,以便查看当前等级和解锁路径
/shop create 管理员 打开游戏内商店构建器,并为新商店创建空白草稿
/shop builder 管理员 打开游戏内商店构建器
/shop builder open 管理员 与 /shop builder 相同;保留为更易读的别名
/shop reload 管理员 重新加载商店、NPC 绑定、进度和经济配置,无需重启
/shop debug 管理员 显示商店/调试计数、检测到的 EasyNPC 实体、已映射的 NPC 以及经济适配器状态
/he shopbuilder 管理员 打开商店构建器的旧别名
/he reloadshops 管理员 /shop reload 的旧别名
/he debugshop 管理员 /shop debug 的旧别名
/he settier <players> <tier> 管理员 手动将一个或多个玩家设置为某个进度等级

/shop create、/shop builder、/shop reload、/shop debug 以及 /he 管理命令需要管理员权限等级 2。


配置文件夹结构

config/
└── migueleconomy_easynpc/
    ├── progression.json       ← 等级定义和解锁要求
    └── npc_shops/
        ├── example_npc.json   ← 自动生成的示例,可安全删除
        └── your_npc.json      ← 每个 NPC(或一组 NPC)一个文件