Search

Search

With hundreds of cosmetics spread across nine categories, scrolling to find one gets slow. Search filters every cosmetic on the server from a single menu.

Using it

/cosmetics search <query>        Open the results menu directly
/cosmetics search                Prompt for the term in chat, then open the results

• With a query on the command line, the results menu opens immediately. The query can contain spaces (/cosmetics search dragon tag).
• With no query, the plugin asks you to type the term in chat (type cancel to abort) — the same flow the Auction House uses for entering a sell price.

What it matches

The search scans every cosmetic category — tags, rebirth, name/rank/chat colors, emojis, glows, join messages, chat emojis, and sets — and returns any cosmetic whose display name or id contains your term.

• Case-insensitive and matches anywhere in the text (a substring, not just a prefix).
• Color codes are ignored, so you search the readable name — searching gold finds &#fcd700Gold without needing the hex.
• Results are paginated when there are many matches.

From the results menu you interact with each cosmetic exactly as you would in its normal category menu (equip it, preview it, etc.), subject to the same ownership and permission rules — see Vault & Trading.

Customizing the menu

The search menu's title and empty-state text are configurable under search-menu (title supports {query}):

# config.yml
search-menu:
  title: "&8Search: &f{query}"
  empty:
    name: "&7No matches for &f{query}"

Layout, icons, and slots follow the same rules as every other menu — see GUI Customization.

---

Next: Auction House