WynnMarketSearch

WynnMarketSearch

为 Wynncraft 市场提供快速、可搜索的图形界面——内置收藏、固定栏位和搜索历史。

市场触发Type the item name or type 'cancel' to cancel:时，这个模组会用真正的搜索面板取代别扭的聊天框输入。找到物品，点击，完成。

✨ 功能

• 🔍 实时模糊搜索 — 输入文字，结果立即显示，并带有正确的 Wynncraft 图标和稀有度颜色。
• ⭐ 收藏 — 按鼠标中键收藏物品。收藏的物品始终排在列表前面。
• 📌 固定栏位 — 右键点击，将物品固定到屏幕底部类似快捷栏的区域。最多可设 18 个栏位，分两行显示。点击栏位即可将物品发送到聊天框。
• 🕘 搜索历史 — 侧边栏会显示最近发送的 20 条查询及其图标。点击即可重新发送，不必再重复输入相同名称。
• ↕️ 排序 — 可选 A→Z 或 Z→A；收藏的物品仍会排在最前面。
• 💡 内置帮助 — 可切换显示角落里的提示框，说明每种点击操作。
• 🌐 无需 API 密钥 — 物品数据每日从后端刷新。Wynncraft API 密钥保存在服务端，你看不到它。
• 🌍 本地化 — 已提供英文和俄文配置翻译。

🎮 操作

| 操作 | 效果 |
|—|—|
| 鼠标左键点击物品 | 将名称发送到聊天框 |
| 鼠标右键点击物品 | 固定到下方栏位 |
| 鼠标中键点击物品 | 切换收藏状态（★标记） |
| 鼠标左键点击栏位 / 历史记录行 | 重新发送到聊天框 |
| 鼠标右键点击栏位 / 历史记录行 | 移除 |
| Enter | 原样发送输入的文字 |
| ESC | 取消 |

⚙️ 命令

| 命令 | 说明 |
|—|—|
| /wms | 手动打开图形界面 |
| /wms add <name> | 添加个人自定义物品（本地） |
| /wms del <name> | 移除个人自定义物品 |
| /wms list | 列出个人自定义物品 |
| /wms reload | 强制从后端重新获取数据 |

📦 前置要求

• Minecraft 1.21.11（Fabric）
• Fabric API
• Cloth Config
• Mod Menu （可选，用于设置界面）

⚙️ 设置（Mod Menu → WynnMarketSearch）

| 选项 | 说明 |
|—|—|
| 启用市场搜索 | 市场聊天触发时打开图形界面 |
| 自动聚焦搜索框 | 打开时自动聚焦输入框 |
| 物品数据库 API URL | 覆盖后端地址（方便自行托管） |
| 显示历史记录面板 | 显示 / 隐藏历史记录列表 |
| 显示固定栏位 | 显示 / 隐藏底部栏 |
| 显示操作说明框 | 显示 / 隐藏角落提示 |

💾 数据存储位置

所有状态均保存在 <runDir>/wms/：

• items_cache.json — 物品数据库的每日快照
• favorites.json — 你收藏的物品
• pinned_slots.json — 你固定的快捷栏
• history.json — 最近 20 条查询
• custom_items.json — 你的个人自定义物品（/wms add）

除每日获取物品数据库外，不会向任何地方发送数据。

❓ 常见问题

能在原版 Wynncraft 中使用吗？
可以——这是客户端模组，无需在服务器上安装。

所有物品图标都能正确显示吗？
可以，包括使用自定义 Wynncraft 皮肤纹理的材料头颅。

可以自行托管物品数据库吗？
可以——在配置中将 Item Database API URL 设置为你自己的部署地址。后端已开源：wms-site。

为什么最多显示 14 个结果？
这只是为了保持图形界面整洁而设置的软上限。缩小搜索范围，就能快速找到所需物品。

🐛 问题反馈与源代码

• 问题反馈：
• 源代码：
• 后端与主页：

与 Wynncraft 或 Mojang 无关联。