
WynnMarketSearch
Enhanced trade market search for Wynncraft
- Загрузки
- 3K
- Подписчики
- 2
- Обновлён
- 26 апреля 2026 г.
- Лицензия
- CC0-1.0
Опубликован 14 марта 2026 г.
WynnMarketSearch
A fast, searchable GUI for the Wynncraft marketplace — favorites, pinned slots, and search history baked in.
When the market asks Type the item name or type 'cancel' to cancel:, this mod replaces the awkward chat-typing with a real search panel. Find an item, click, done.

✨ Features
- 🔍 Live fuzzy search — start typing, results appear instantly with the proper Wynncraft icons and rarity colors.
- ⭐ Favorites — middle-click to star an item. Starred items always float to the top of the list.
- 📌 Pinned slots — right-click to pin an item to a hotbar-style strip at the bottom of the screen. Up to 18 slots, two rows. One click on a slot sends the item to chat.
- 🕘 Search history — last 20 sent queries with their icons in the side panel. Click to re-send, never re-type the same name twice.
- ↕️ Sort — A→Z or Z→A, your choice; favorites still go first.
- 💡 Built-in help — toggleable hints box in the corner explains every click.
- 🌐 No API key required — items load from a daily-refreshed backend. The Wynncraft API key is server-side, you never see it.
- 🌍 Localized — English and Russian config translations included.
🎮 Controls
| Action | Effect |
|---|---|
| LMB on item | send name to chat |
| RMB on item | pin to bottom slot |
| MMB on item | toggle favorite (★ marker) |
| LMB on slot / history row | re-send to chat |
| RMB on slot / history row | remove |
| Enter | send the typed text as-is |
| ESC | cancel |
⚙️ Commands
| Command | What |
|---|---|
/wms |
open the GUI manually |
/wms add <name> |
add a personal custom item (local) |
/wms del <name> |
remove a personal custom item |
/wms list |
list personal customs |
/wms reload |
force a fresh fetch from the backend |
📦 Requirements
- Minecraft 1.21.11 (Fabric)
- Fabric API
- Cloth Config
- Mod Menu (optional, for the settings screen)
⚙️ Settings (Mod Menu → WynnMarketSearch)
| Option | Description |
|---|---|
| Enable Market Search | open the GUI on the market chat trigger |
| Auto-focus Search Box | focus the input on open |
| Item Database API URL | override the backend (self-host friendly) |
| Show History Panel | show / hide the history list |
| Show Pinned Slots | show / hide the bottom strip |
| Show Instructions Box | show / hide the corner hints |
💾 Where data is stored
All state lives in <runDir>/wms/:
items_cache.json— daily snapshot of the item databasefavorites.json— your starred itemspinned_slots.json— your pinned hotbarhistory.json— your last 20 queriescustom_items.json— your personal custom items (/wms add)
Nothing is sent anywhere except the daily request to fetch the item database.
❓ FAQ
Does it work with vanilla Wynncraft? Yes — it's a client-side mod, no server install needed.
Will the icons of all items render correctly? Yes, including ingredient/material heads with custom Wynncraft skin textures.
Can I self-host the item database?
Yes — set Item Database API URL in the config to your own deployment. The backend is open-source: wms-site.
Why 14 results max? Just a soft cap to keep the GUI clean. Refining your search gets you what you need fast.
🐛 Bug reports & source
- Issues: https://github.com/a0gzy/WynnMarketSearch/issues
- Source: https://github.com/a0gzy/WynnMarketSearch
- Backend & landing: https://wms-site-api.vercel.app
Not affiliated with Wynncraft or Mojang.
Ченджлог
2.1.0+mc1.21.11Релиз1.21.11 · 26 апреля 2026 г.
WynnMarketSearch 2.1.0
A big quality-of-life update for the search GUI.
✨ New
- ⭐ Favorites. Middle-click any item to star it. Starred items always show first in your search results.
- 📌 Pinned slots. Right-click an item to pin it to a hotbar-style strip at the bottom of the screen — up to 18 slots, two rows. One click on a slot sends the item to chat.
- 🕘 Search history. Your last 20 sent queries appear in the right side panel with their icons. Click to re-send, never re-type the same name.
- ↕️ Sort A→Z / Z→A. Toggle in the side panel; favorites still float to the top.
- 💡 Help box in the top-left corner showing the control map.
- 🌍 Russian translation for the config screen.
⚙️ Config (Mod Menu → WynnMarketSearch)
You can now toggle off:
- the history panel
- the pinned slots strip
- the help box
🛠 Fixes
/wms reloadnow actually fetches a fresh database (it used to silently reuse today's local cache).- Items with custom Wynncraft head textures (ingredients, materials) now render their real skin texture instead of a generic Steve head.
🎮 Controls cheat-sheet
| LMB on result | send to chat |
| RMB on result | pin to a slot |
| MMB on result | favorite |
| LMB on slot / history | re-send |
| RMB on slot / history | remove |
Updating from 2.0.x? You don't need to do anything — your existing settings stay, the new files are created automatically on first run.
2.0.2+mc1.21.11Релиз1.21.11 · 25 апреля 2026 г.
WynnMarketSearch 2.0.2
This release rebuilds the way the mod talks to Wynncraft's item database and fixes a couple of long-standing visual / reliability bugs.
What's new
- Self-hosted API proxy — the client no longer hits Wynncraft's API
directly. A small backend (wms-site-api.vercel.app)
refreshes the database once a day, slims it to just
displayName,tier, andicon, and serves the result to the mod.- Cached payload is ~10× smaller, so first load is much faster.
- Self-hosters can point at their own backend via the new
apiUrlconfig option.
- Custom skin icons render correctly. Ingredients and other items whose Wynncraft icon is a player-head texture (e.g. Jewel of Sin, Crown of Jewels) now show their actual Wynncraft head texture instead of a barrier block.
Fixes
- Cache fallback when the network is down. Previously, if the API returned a non-200 response the mod silently ended up with zero items. It now falls back to the on-disk cache regardless of how the request failed, so search keeps working offline as long as you've loaded the database at least once.
- Adapted to Wynncraft's new API shape. Wynncraft restructured the item database; the mod now parses the new array layout.
Config
- New option Item Database API URL (
apiUrl) — lets you point the mod at any compatible backend. Default is the public hosted one.
Commands
/wms reload— force a fresh fetch from the backend (bypasses the daily local cache).
If something looks broken, please open an issue on
GitHub with a copy of
your latest.log.
2.0.1+mc1.21.11Релиз1.21.11 · 11 апреля 2026 г.
Changelog
v2.0.1 — Wynncraft Fruma Update Fix & New Features
Fixes
- Fixed GUI not opening on servers after Wynncraft Fruma Update — added 300ms delay to allow chat screen to close before opening SearchGuiScreen
- Added check to prevent opening duplicate GUI if already open
Features
- API Caching — Items now cached to
.minecraft/wms/items_cache.jsonwith daily refresh check. Faster loading, no repeated API calls on same day - Custom Items System — Add your own items not in the Wynncraft API via
custom_items.json - Default items included: Corkian Insulator, Corkian Amplifier I-IV, Corkian Simulator
- Custom items displayed in gold color with Barrier Icon
- New Commands:
/wms— Show help with all available commands/wms add <item>— Add a custom item/wms del <item>— Remove a custom item (with autocomplete suggestions)/wms list— List all custom items/wms reload— Force reload items from API/wms open— Open search GUI manually (without sendingcancelon close)
2.0.0Релиз1.21.11 · 14 марта 2026 г.
Realese of 1.21.11 with updated Wynncraft API
Комментарии
Загружаем…