> For the complete documentation index, see [llms.txt](https://docs.xandtech.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xandtech.fr/home/xstash/chests-module/customization-and-search.md). # Customization & Search ## Renaming & re-icon-ing a chest Every unlocked chest can be renamed and re-iconed by the player themselves, right from the selector menu. `chests/config.yml`: ```yaml customization: enabled: true # master switch - false disables the whole feature regardless of anything below icon-change: enabled: true click: RIGHT permission: "" # extra permission on top of xstash.customize rename: enabled: true click: SHIFT_RIGHT permission: "" reset: enabled: true click: MIDDLE permission: "" # resets both name and icon back to default ``` Every action needs the base `xstash.customize` permission, plus its own extra `permission` if one is configured. Renaming closes the menu and prompts the player to type the new name in chat (or `cancel` to abort). Changing the icon opens a paginated picker built from `chests/icons.yml` — the icon catalog. ### Icon catalog `chests/icons.yml` lists every selectable icon (material or custom head texture, name, lore). Each icon can have its own permission node, gating specific icons to specific ranks independently of the base `icon-change` permission. An icon a player picked while they had permission for it, but later lost, silently falls back to the default icon instead of erroring. ## Search ```yaml search: enabled: true ``` The search button (configurable slot in the selector, see `chests/menus.yml`) prompts the player to type an item name in chat, then searches every chest they've currently unlocked. Matching is case-insensitive and partial, against both the vanilla material name and any custom display name. Results are printed in chat as `Chest #n: x ` — nothing opens automatically, it's purely informational. ## Blocked items `chests/blocked-items.yml` — materials that can never be placed into a virtual chest at all (regardless of customization settings), each with its own optional bypass permission stacked on top of the global `xstash.bypass_blocked_items`. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.xandtech.fr/home/xstash/chests-module/customization-and-search.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.