WynnMarketSearch

WynnMarketSearch

为Wynncraft增强的贸易市场搜索

工具

WynnMarketSearch预览查看大图

WynnMarketSearch

为 Wynncraft 市场打造的快速、可搜索 GUI——内置收藏、固定槽位和搜索历史。

当市场提示 Type the item name or type 'cancel' to cancel: 时，本模组用一个真正的搜索面板取代了笨拙的聊天输入。找到物品，点击，完成。

GUI

✨ 功能

  • 🔍 实时模糊搜索——开始输入，结果立即显示，并带有正确的 Wynncraft 图标和稀有度颜色。
  • ⭐ 收藏——中键点击可为物品加星标。加星标的物品始终浮动到列表顶部。
  • 📌 固定槽位——右键点击可将物品固定到屏幕底部的快捷栏式条带中。最多 18 个槽位，两行。点击槽位一次即可将物品发送到聊天。
  • 🕘 搜索历史——侧边栏中显示最近 20 条发送的查询及其图标。点击即可重新发送，永远不用再次输入同一个名称。
  • ↕️ 排序——A→Z 或 Z→A，由你选择；收藏仍然优先。
  • 💡 内置帮助——角落可切换的提示框解释每一次点击。
  • 🌐 无需 API 密钥——物品从每日刷新的后端加载。Wynncraft API 密钥位于服务端，你永远不会看到它。
  • 🌍 已本地化——包含英文和俄文配置翻译。

🎮 操作

操作 效果
在物品上 左键 将名称发送到聊天
在物品上 右键 固定到底部槽位
在物品上 中键 切换收藏（★ 标记）
在槽位 / 历史行上 左键 重新发送到聊天
在槽位 / 历史行上 右键 移除
Enter 按原样发送输入的文本
ESC 取消

⚙️ 命令

命令 作用
/wms 手动打开 GUI
/wms add <name> 添加个人自定义物品（本地）
/wms del <name> 移除个人自定义物品
/wms list 列出个人自定义物品
/wms reload 强制从后端重新获取

📦 需求

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

⚙️ 设置（Mod Menu → WynnMarketSearch）

选项 描述
Enable Market Search 在市场聊天触发时打开 GUI
Auto-focus Search Box 打开时聚焦输入框
Item Database API URL 覆盖后端（便于自托管）
Show History Panel 显示 / 隐藏历史列表
Show Pinned Slots 显示 / 隐藏底部条带
Show Instructions Box 显示 / 隐藏角落提示

💾 数据存储位置

所有状态都保存在 <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 个结果？ 只是一个软上限，以保持 GUI 简洁。细化搜索即可快速找到所需内容。

🐛 错误报告与源代码

与 Wynncraft 或 Mojang 无关联。