Traders Extended

Traders Extended

商人特定的买卖物品列表。商店界面包含出售列表、筛选和修理按钮。支持手柄操作。商人使用硬币结算。加价与折扣机制。

游戏玩法

Traders Extended预览查看大图

功能

  • 扩展的商店界面，包含出售物品列表
  • 可为每个商人或通用配置物品购买/出售列表
  • 配置文件修改后实时生效
  • 服务器同步配置
  • 配置文件保存为 JSON 文件
  • 配置文件可存放在 dll 旁、config 文件夹、任意子目录，甚至内嵌于 dll
  • 可配置的物品会添加到现有列表中（不会替换原版物品）
  • 双击可堆叠物品可直接输入所需数量
  • 商人可修复你的护甲或武器（默认：哈尔多修复武器，希尔迪尔修复护甲）
  • 商人可拥有有限且每日补充的金币
  • 商人可根据当前金币数量提供折扣或加价
  • 可按物品名称过滤购买和出售列表
  • 可自定义金币重量和堆叠大小
  • 支持 EpicLoot（冒险模式中彩色图标和金币花费）
  • 可回购最后出售的物品（重新登录前可用）
  • 快捷栏、快速插槽和已装备的护甲不会出现在出售列表中

发现机制 物品需被玩家发现后才会出现在商店中。 若想跳过此规则，可在配置项“未发现的出售物品列表”中设置其预制体名称。 原版物品将始终可用（除非其添加被禁用且全局键满足条件）。 若禁用了商人列表中自动添加原版物品的功能，则需手动在购买列表中添加物品，并将其预制体名称填入“未发现的出售物品列表”配置项。

修复 商人会以每个物品 2 金币的价格修复你的物品。你可在配置中设置修复费用。 在对应列表中设置商人名称或其预制体名称，即可让其修复指定类型的物品（武器或护甲）。

回购 如果你刚向商人出售了一件物品，该物品会出现在购买列表的第一位，并以高亮颜色显示。 颜色可在配置中调整。 仅最后出售的一件物品可被回购。

商人使用金币 你可启用商人使用有限金币的功能。当你出售物品时，商人会支付金币；当你购买物品时，商人会收取金币。 每天早晨（按设定的补充速率），商人会获得设定数量的金币，直到达到设定的最大金币数。 若商人拥有的金币超过最小值，则出售价格会上升，购买价格会下降；反之亦然。 若希望自定义商人使用金币，需在“自定义商人预制体名称”配置项中设置其预制体名称。区分大小写，用逗号分隔。 如果你是主机（或使用服务器开发者命令）且为管理员，可使用控制台命令：

settradercoins [商人名称] [数量]

来手动设置商人金币。

默认值：

  • 商人初始拥有 2000 金币
  • 商人每天早晨补充 1000 金币，直到达到 6000 金币上限
  • 若商人金币为 0，则购买价格加价 50%，出售价格降价 30%
  • 若商人金币为 6000，则购买价格打折 30%，出售价格上升至 +50%
  • 正常价格基于 2000 金币，并会逐渐变化

手柄支持

  • 使用左摇杆滚动购买列表
  • 使用右摇杆滚动出售列表
  • 使用方向键操作两个列表
  • 使用（X）键（Xbox）或（☐）键（PS）出售选中物品
  • 按住备用操作键并按下（A）键（Xbox）或（X）键（PS）打开物品数量对话框
  • 按下右摇杆键修复物品

配置文件命名

  • 在 Windows 上不区分大小写
  • 必须以模组 ID "shudnal.TradersExtended" 开头，扩展名为 ".json"（在 Unix 系统上区分大小写）
  • 需包含商人名称（或 "common"）及列表类型（buy/sell）
  • 可针对非标准商人名称设置

配置文件命名示例：

  • shudnal.TradersExtended.haldor.buy.json（从哈尔多购买的物品）
  • shudnal.TradersExtended.haldor.sell.json（出售给哈尔多的物品）
  • shudnal.TradersExtended.hildir.buy.json（从希尔迪尔购买的物品）
  • shudnal.TradersExtended.hildir.sell.json（出售给希尔迪尔的物品）
  • shudnal.TradersExtended.bogwitch.buy.json（出售给沼泽女巫的物品）
  • shudnal.TradersExtended.bogwitch.sell.json（从沼泽女巫购买的物品）
  • shudnal.TradersExtended.common.buy.json（从所有商人购买的通用物品）
  • shudnal.TradersExtended.common.sell.json（出售给所有商人的通用物品）

配置文件格式 配置文件为 JSON 文件，包含对象数组，购买列表和出售列表格式不同。 配置文件使用游戏对象的预制体名称。预制体名称区分大小写。当前可用的[物品列表]（https://valheim-modding.github.io/Jotunn/data/objects/item-list.html）。 例如，希尔迪尔出售的“Simple cap red”对应预制体名称为“HelmetHat5”。错误的预制体名称将被安全忽略。 配置文件可使用首领键（Boss Keys）来筛选可交易物品列表（[维基页面]（https://valheim.fandom.com/wiki/Global_Keys））。

你可以使用控制台命令：

tradersextended save

该命令会在模组 dll 旁生成 ObjectDB.list.json 文件，其中包含游戏中当前所有物品。

Google Sheets JSON 辅助工具 为方便格式化配置文件，可使用[Google Sheets JSON 辅助工具]（https://docs.google.com/spreadsheets/d/1VgGlERaRb2rDB6ULdoWM39Sh0L_X1sR4dJE1CgRDsYI）。该工具专为此模组创建，用于辅助编辑配置文件。 更多信息请参见电子表格本身。

特别感谢 [@MeowingInsanely]（https://www.nexusmods.com/valheim/users/57883796）的创意、首次实现、测试和文档！

可交易物品模型

{
  "prefab": "PrefabName",
  "stack": 1,
  "price": 100,
  "requiredGlobalKey": "",
  "notRequiredGlobalKey": "",
  "requiredPlayerKey": "",
  "notRequiredPlayerKey": "",
}
  • prefab - 字符串 - 物品的预制体名称。对应物品列表中的 Item 列。
  • stack - 整数 - 堆叠中的物品数量。若设为 0 则忽略该物品。
  • price - 整数 - 堆叠的价格。若设为 0 则忽略该物品。
  • quality - 整数 - 物品品质。若为 0，则购买列表使用默认品质，出售列表不检查品质。
  • requiredGlobalKey - 字符串，逗号分隔 - 若设置，则需列表中所有全局键均已解锁，物品才会出现。换言之，若任一全局键未解锁，则物品不可用。
  • notRequiredGlobalKey - 字符串，逗号分隔 - 若设置，则列表中所有全局键均不能解锁，物品才会出现。换言之，若任一全局键已解锁，则物品不可用。
  • requiredPlayerKey - 字符串，逗号分隔 - 若设置，则需列表中所有玩家唯一键均已设置，物品才会出现。换言之，若任一玩家唯一键未设置，则物品不可用。
  • notRequiredPlayerKey - 字符串，逗号分隔 - 若设置，则列表中所有玩家唯一键均不能设置，物品才会出现。换言之，若任一玩家唯一键已设置，则物品不可用。

购买列表示例 我想在击杀莫德后，能以 500 金币购买龙蛋。 我想以 10 金币购买野猪肉。 我想在击杀长老前，能以 1000 金币购买远古种子。 我想在击杀长老后，能以 500 金币购买最大品质的耕耘者。

[
  {
    "prefab": "DragonEgg",
    "stack": 1,
    "price": 500,
    "requiredGlobalKey": "defeated_dragon"
  },
  {
    "prefab": "RawMeat",
    "stack": 1,
    "price": 10
  },
  {
    "prefab": "AncientSeed",
    "stack": 1,
    "price": 1000,
    "notRequiredGlobalKey": "defeated_gdking"
  },
  {
    "prefab": "Cultivator",
    "stack": 1,
    "price": 500,
    "requiredGlobalKey": "defeated_gdking",
    "quality": 4
  }
]

出售列表示例 我想以 200 金币出售钓鱼竿。 我想在击杀长老后，以 25 金币出售 50 个木头。 我想以每个 50 金币出售河鲈，同时也出售品质 4 的 x5 河鲈，价格更高。

[
  {
    "prefab": "FishingRod",
    "stack": 1,
    "price": 200
  },
  {
    "prefab": "Wood",
    "stack": 50,
    "price": 25,
    "requiredGlobalKey": "defeated_gdking"
  },
  {
    "prefab": "Fish1",
    "stack": 1,
    "price": 50
  },
  {
    "prefab": "Fish1",
    "stack": 5,
    "price": 500,
    "quality": 4
  }
]

安装（手动） 将 TradersExtended 文件夹复制到 BepInEx/Plugins/ 文件夹中。 在 dll 旁创建新的配置文件以添加物品。

兼容性

  • 本模组应与任何修改物品价格以使其可出售、及扩展可交易物品列表的模组兼容。
  • 与任何修改原版商店界面的模组不兼容（与 AUGA 直接不兼容）。
  • 本模组应与添加更多独特商人名称的模组兼容（只要它们使用原版商店界面）。
  • 本模组应与向商店添加更多物品的模组兼容（只要其补丁不具侵入性）。

配置管理 游戏内管理配置的最佳方式是使用[配置管理器]（https://thunderstore.io/c/valheim/p/shudnal/ConfigurationManager/），或[官方 BepInEx 配置管理器]（https://thunderstore.io/c/valheim/p/Azumatt/Official_BepInEx_ConfigurationManager/）。

对于 JSON 原始编辑，可使用 [https://jsoneditoronline.org/]（https://jsoneditoronline.org/）。

专为此模组制作的工具：[Traders Extended - JSON Helper]（https://docs.google.com/spreadsheets/d/1VgGlERaRb2rDB6ULdoWM39Sh0L_X1sR4dJE1CgRDsYI）。

捐赠 [给我买杯咖啡]（https://buymeacoffee.com/shudnal）

Discord [加入服务器]（https://discord.gg/e3UtQB8GFK）