Configuration
Complete reference for plugins/QuickBuyAddon/config.yml.
Shop Size (shop-size)
| Key | Type | Default | Description |
|---|---|---|---|
shop-size | int | 54 | Total slots in the shop chest GUI. Must be a multiple of 9, between 9 and 54. |
Command Aliases (command-aliases)
| Key | Type | Default | Description |
|---|---|---|---|
command-aliases | list | [qb] | Extra aliases for /quickbuy, registered at startup. Changes take effect after a full restart — no rebuild needed. The built-in /qb is included here by default and will be active even if you remove it (it is also declared in plugin.yml). |
command-aliases:
- qb
- shop
- qs
Slot Permissions (slot-permissions)
Controls how many shop slots each player can use, based on their permissions.
| Key | Type | Default | Description |
|---|---|---|---|
slot-permissions.default-slots | int | 9 | Slots available to players without any matching override permission. |
slot-permissions.overrides | list | [] | List of {permission, limit} pairs. If a player matches more than one, the highest limit wins. |
slot-permissions:
default-slots: 9
overrides:
- permission: "quickbuy.slots.18"
limit: 18
- permission: "quickbuy.slots.27"
limit: 27
- permission: "quickbuy.slots.54"
limit: 54
Messages (messages)
All user-facing text is configurable. Color codes use & format. Placeholders are in {braces}.
Prefix & Chat
| Key | Default | Description |
|---|---|---|
messages.prefix | &6✦ &eQuickBuy &8| &7 | Prepended to all chat messages that use {prefix} |
messages.no-permission | {prefix}&c✘ &7Insufficient permissions | Sent when a player lacks a required permission |
messages.only-players | {prefix}&c✘ &7This command can only be used by players | Sent when a non-player runs /quickbuy |
Slot Lifecycle
| Key | Default | Placeholders | Description |
|---|---|---|---|
messages.slot-configured | {prefix}&a✔ &7Slot &e#{slot} &7configured: &e{item} &7(max &e{cap}&7/item) | {slot}, {item}, {cap} | Sent after a slot is successfully configured |
messages.slot-cleared | {prefix}&a✔ &7Slot &e#{slot} &7cleared | {slot} | Sent after a slot's configuration is deleted |
messages.search-no-results | &c✘ &7No items matched &e{query} | {query} | Shown in chat when a search returns no materials |
messages.price-invalid | {prefix}&c✘ &7Please enter a valid positive number, or leave it empty for no limit | — | Sent when invalid price text is submitted |
messages.price-no-limit-label | &aNo Limit | — | Text shown in slot lore when no price cap is set |
Shop GUI
| Key | Default | Description |
|---|---|---|
messages.shop-title | &8Quick Buy | Chest GUI title for the personal shop |
messages.slot-name | &6{item} | Display name for a configured slot item |
messages.empty-slot-name | &a&lConfigure Slot | Display name for an unconfigured slot |
messages.locked-slot-name | &c&lLocked Slot | Display name for a locked slot (beyond permission allotment) |
Slot Lore
| Key | Placeholders | Description |
|---|---|---|
messages.slot-lore-available | {cap}, {amount}, {per_unit}, {total} | Lore lines when a qualifying listing exists |
messages.slot-lore-unavailable | {cap} | Lore lines when no listing qualifies |
messages.empty-slot-lore | — | Lore lines for unconfigured slots |
messages.locked-slot-lore | — | Lore lines for locked slots |
messages.slot-lore-enchant-header | — | Header line shown above required enchantments |
messages.slot-lore-enchant-line | {enchant}, {level} | One line per required enchantment |
Dialog Picker (1.21.6+ Java clients)
| Key | Default | Description |
|---|---|---|
messages.search-results-title-all | &6Choose an Item | Dialog title when no search is active |
messages.search-results-title | &6Search Results &8» &7"{query}" | Dialog title when a search query is active |
messages.search-input-label | &7Search | Label for the embedded search text box |
messages.search-button-label | &aSearch | Label for the Search submit button |
messages.search-delete-button | &c🗑 Delete Slot | Label for the Delete Slot button (shown only when editing an existing slot) |
messages.enchant-prompt-title | &6Required Enchantments | Dialog title for enchantment selection |
messages.enchant-prompt-body | &7Set a minimum level for any enchantment... | Body text for the enchantment dialog |
messages.enchant-level-none | &7None | Label for the "no requirement" option in enchantment dropdowns |
messages.enchant-confirm-button | &aConfirm | Label for the enchantment confirm button |
messages.price-prompt-title | &6Set Price Cap | Dialog title for price input |
messages.price-prompt-body | &7Enter the most you're willing to pay... | Body text for the price dialog |
messages.price-input-label | &7Max Price | Label for the price text input |
messages.price-confirm-button | &aConfirm | Label for the price confirm button |
messages.delete-confirm-title | &cDelete this slot? | Dialog title for delete confirmation |
messages.delete-confirm-body | &7This will clear the item, price cap... | Body text for delete confirmation |
messages.delete-confirm-button | &cDelete | Label for the confirm delete button |
messages.cancel-button-label | &cCancel | Label for all Cancel buttons |
Fallback Picker (Bedrock / old Java clients)
| Key | Default | Description |
|---|---|---|
messages.fallback-material-title | &8Choose an Item | Chest GUI title for the fallback material picker |
messages.fallback-enchant-title | &8Set Enchantments | Chest GUI title for the fallback enchantment picker |
messages.fallback-prev-page | &a« Previous Page | Navigation button label (previous page available) |
messages.fallback-no-prev-page | &7« Previous Page | Navigation button label (no previous page) |
messages.fallback-next-page | &a» Next Page | Navigation button label (next page available) |
messages.fallback-no-next-page | &7» Next Page | Navigation button label (no next page) |
messages.fallback-search-button | &bSearch | Label for the search button in the fallback picker |
messages.fallback-search-prompt | {prefix}&7Type an item name... | Chat prompt for fallback material search |
messages.fallback-price-prompt | {prefix}&7Type the most you're willing to pay... | Chat prompt for fallback price input |
messages.fallback-price-title | &6Enter Price | Title overlay shown during fallback chat price input |
messages.fallback-price-subtitle | &7Max price you wish to buy &e{item} &7for | Subtitle overlay during fallback chat price input |
messages.fallback-delete-lore | ["&7Shift-click to confirm deletion"] | Lore shown on the delete button in the fallback picker |
messages.fallback-delete-needs-shift | {prefix}&e⇧ &7Shift-click... | Sent when player clicks delete without shift |
messages.fallback-enchant-selected-name | &a{enchant} &8» &e{level} | Display name for a selected enchantment icon |
messages.fallback-enchant-unselected-name | &7{enchant} | Display name for an unselected enchantment icon |
messages.fallback-enchant-lore | (list) | Lore shown on each enchantment icon |