商户搜索与分类 - 1Gold_Merchant 附加组件

商户搜索与分类 - 1Gold_Merchant 附加组件

为庞大的1Gold_Merchant购买目录添加实时物品搜索、七个分类和安全键盘导航。按名称搜索，使用Z/X切换分类，并保持Q/E购买-出售控制不变。

商户搜索与分类 - 1Gold_Merchant 附加组件预览查看大图

商人搜索与分类

商人搜索与分类是一款专为 1Gold_Merchant 设计的便捷生活质量附加模组。

1Gold_Merchant 将数百种物品放入单个商人购买目录中，并且每种售价仅为 1 金币。在如此庞大的列表中查找特定物品可能会非常缓慢且令人沮丧。

本附加模组通过直接在商人购买界面添加实时搜索框、分类筛选、可见物品计数和键盘友好导航来解决此问题。

重要提示

此模组是一个附加组件。

它不包含 1Gold_Merchant，也不会修改其文件。

商人搜索与分类不会更改物品价格、商人库存、玩家库存、货币价值或购买行为。

1 金币价格完全由 1Gold_Merchant 提供。

功能特色

  • 在商人购买界面内进行实时搜索
  • 按完整或部分物品名称搜索
  • 支持多词搜索
  • 七个物品分类
  • 显示物品和结果计数
  • Z 和 X 键进行分类导航
  • Q 和 E 键继续用于在购买和出售之间切换
  • 输入时 Q、E、Z 和 X 键作为普通文本输入
  • 回车键确认搜索并将控制权返回给商店
  • 分类尽可能根据 Palworld 物品元数据确定
  • 对于不支持的物品，提供基于目录和名称的回退分类
  • 可选的界面位置配置
  • F8 键无需重启游戏即可重新加载布局设置
  • 无价格修改
  • 无库存修改
  • 无存档数据修改
  • 不编辑 1Gold_Merchant 的 PAK 文件
  • 无原生 DLL
  • 无外部可执行文件
  • 无需网络连接

分类

提供以下分类：

  • 全部
  • 精灵球
  • 武器
  • 护甲
  • 工具
  • 消耗品
  • 材料

选中的分类会显示在分类栏的方括号之间。

示例：

Z < 全部 精灵球 [武器] 护甲 工具 消耗品 材料 > X

搜索

点击“搜索物品”框，然后输入物品显示名称的任何部分。

搜索不区分大小写。

可以输入多个词语。每个输入的词语都必须出现在物品名称中的某个位置。

示例：

  • 传说精灵球
  • 耐热护甲
  • 古代部件

物品列表会在您输入时实时更新。

状态指示器会显示以下任一信息：

  • 所选分类中的物品总数
  • 匹配结果数量与分类总数的对比

控制

Z

当搜索框未处于编辑状态时，切换到上一个分类。

切换分类也会清除当前搜索。

X

当搜索框未处于编辑状态时，切换到下一个分类。

切换分类也会清除当前搜索。

Q / E

保留 Palworld 原有的购买和出售导航功能（在搜索框未处于编辑状态时）。

输入时的 Q、E、Z 和 X

当搜索框获得键盘焦点时，Q、E、Z 和 X 键将作为普通文本字符输入。

输入时它们不会激活分类或购买-出售快捷键。

回车键

确认当前搜索并将键盘焦点返回到商人界面。

F8

从以下路径重新加载界面布局值：

MerchantShopSearch\Scripts\config.lua

按下 F8 时必须已打开商人界面。

控制台命令

merchant_search_focus 将键盘焦点移动到当前打开的商人界面的搜索框。

merchant_search_reload_layout 从 config.lua 重新加载当前布局。

此操作与按 F8 执行相同的布局刷新。

需求

  • Palworld（Windows 版）
  • 兼容的 Okaetsu RE-UE4SS experimental-palworld 安装
  • 1Gold_Merchant

本下载包中不包含 1Gold_Merchant 和 UE4SS。

安装

  1. 完全退出 Palworld。
  2. 安装兼容的 Okaetsu RE-UE4SS experimental-palworld 构建版本。
  3. 单独安装 1Gold_Merchant。
  4. 下载并解压“商人搜索与分类”。
  5. 将 MerchantShopSearch 文件夹复制到： Palworld\Pal\Binaries\Win64\ue4ss\Mods\
  6. 确认以下文件存在：
    • Palworld\Pal\Binaries\Win64\ue4ss\Mods\MerchantShopSearch\enabled.txt
    • Palworld\Pal\Binaries\Win64\ue4ss\Mods\MerchantShopSearch\Scripts\main.lua
    • Palworld\Pal\Binaries\Win64\ue4ss\Mods\MerchantShopSearch\Scripts\categories.lua
    • Palworld\Pal\Binaries\Win64\ue4ss\Mods\MerchantShopSearch\Scripts\config.lua
  7. 启动 Palworld。
  8. 打开商人购买界面。

正确的文件夹结构

MerchantShopSearch
├── enabled.txt
└── Scripts
    ├── main.lua
    ├── categories.lua
    └── config.lua

重要文件夹警告

请勿将模组放置在额外的嵌套文件夹中。

错误示例： ...\Mods\Merchant-Search-and-Categories-0.5.7\MerchantShopSearch\Scripts\main.lua

正确示例： ...\Mods\MerchantShopSearch\Scripts\main.lua

MerchantShopSearch 文件夹必须直接放置在 UE4SS 的 Mods 文件夹内。

可选布局配置

默认界面布局在无需编辑任何文件的情况下即可正常工作。

如果搜索栏或分类栏在您的分辨率或界面缩放比例下无法正确对齐，请编辑：

MerchantShopSearch\Scripts\config.lua

可用的布局值：

参数 说明
category_x 分类栏 X 坐标
category_y 分类栏 Y 坐标
category_width 分类栏宽度
category_height 分类栏高度
status_x 状态指示器 X 坐标
status_y 状态指示器 Y 坐标
status_width 状态指示器宽度
status_height 状态指示器高度
search_x 搜索框 X 坐标
search_y 搜索框 Y 坐标
search_width 搜索框宽度
search_height 搜索框高度

这些值是相对于 Palworld 原生物品列表标题的偏移量。

负的 X 值是从标题右边缘开始测量的。

编辑 config.lua 之后：

  • 打开商人界面并按 F8
  • 或使用 merchant_search_reload_layout

仅修改布局无需完全重启游戏。

分类检测原理

“商人搜索与分类”首先尝试读取每件商品的真实 Palworld 静态物品数据。

然后将 Palworld 物品类型映射到可用分类中。

这使得模组能够使用游戏元数据对物品进行分类，而不是仅依赖其英文显示名称。

如果无法解析静态物品元数据，模组将回退到：

  • 附带的分类目录
  • 保守的基于名称的分类规则

即使物品无法被完美分类，搜索功能仍然可用。

过滤原理

模组会读取 Palworld 商人界面已创建的物品卡片。

不符合当前搜索或分类的卡片会被临时折叠。

当它们符合搜索或分类条件时，会立即重新显示。

模组不会修改：

  • 产品定义
  • 产品价格
  • 货币价值
  • 商人库存
  • 玩家库存
  • 购买功能
  • 存档文件
  • 第三方 PAK 文件

性能

“商人搜索与分类”不使用逐帧过滤钩子。

当搜索框处于活跃编辑状态时，界面会以短间隔进行检查，以实现响应式实时搜索。

当界面空闲时，检查频率会降低。

完整的物品过滤器仅在必要时运行，例如：

  • 搜索文本发生变化时
  • 所选分类发生变化时
  • 商人产品列表发生变化时
  • 商店界面被重建时

当没有支持的商人界面打开时，模组将保持非活动状态。

兼容性

  • 专为 1Gold_Merchant 设计
  • 可能与其他大型商人目录模组兼容
  • 客户端用户界面模组
  • 无需在专用服务器上安装
  • 适用于 Windows 版 Palworld
  • 需要兼容的 UE4SS 构建版本
  • 不修改或重新分发 1Gold_Merchant
  • 无需更改 PAK 加载顺序

大量替换 Palworld 商人购买界面的模组可能会产生冲突。

故障排除

搜索界面未出现

  • 确认 UE4SS 是否正常加载。
  • 确认 enabled.txt 中包含 1。
  • 确认文件夹结构正确。
  • 确保您已打开商人购买界面。
  • 检查 UE4SS.log 中是否有 MerchantShopSearch 相关消息。

搜索框出现但无法输入

打开 UE4SS 控制台并输入： merchant_search_focus

Z 或 X 无法切换分类

  • 确保搜索框未处于编辑状态。
  • 输入时，Z 和 X 会被有意作为普通文本输入。
  • 切换分类前先按回车键或点击搜索框外部。

Q 或 E 无法切换购买和出售

  • 确保搜索框未处于编辑状态。
  • 搜索时 Q 和 E 会被有意作为文本处理。
  • 按回车键将控制权返回给商人界面。

界面未对齐

  • 编辑 Scripts\config.lua。
  • 打开商人界面。
  • 按 F8 重新加载布局。
  • 根据需要调整位置和大小数值。

物品出现在错误分类中

物品的元数据可能不可用，或者无法干净地映射到当前分类。

请报告：

  • 确切的物品显示名称
  • 它当前出现的分类
  • 它应该出现的分类

无论分类准确度如何，实时名称搜索仍将继续正常工作。

卸载

  1. 完全退出 Palworld。
  2. 删除： Palworld\Pal\Binaries\Win64\ue4ss\Mods\MerchantShopSearch

模组不会创建任何存档数据。

致谢

商人搜索与分类由 byluckysm 创作。

作为 1Gold_Merchant 的搜索和分类附加组件而创建。

1Gold_Merchant 由 technogamer43 创作，本下载包中不包含该模组。

本项目与 Pocketpair、Palworld、Nexus Mods、1Gold_Merchant 或 UE4SS 开发者无任何关联，也未获得其认可。