Configuration

Complete reference for plugins/SellGuiAddon/config.yml.

Missing keys are safe

If a key is missing from your file (for example after updating to a newer version), the addon uses its built-in default for that key, so an older config.yml never breaks.

Feature Switch (`enabled`)

Key	Type	Default	Description
`enabled`	`boolean`	`true`	When `false`, `/sell` only replies with the `plugin-disabled` message. `/sellgui reload` still works.

Command Aliases (`command-aliases`)

Key	Type	Default	Description
`command-aliases`	`list`	`[]`	Extra aliases for `/sellgui`, on top of the built-in `/sell`. Newly added aliases are picked up by `/sellgui reload`; removing an alias needs a full restart.

command-aliases:
  - sellall
  - bulksell

Match Strategy (`match-strategy`)

Decides which order gets filled first when more than one active order would accept a deposited item.

Value	Behavior
`BEST_PRICE`	Default. Fill the highest price-per-item order first — maximizes the player's payout.
`FIFO`	Fill the order that was created first, regardless of price.
`ANY`	No particular order — the first eligible match in the order list is used.

Values are case-insensitive. An empty or unrecognized value falls back to BEST_PRICE.

match-strategy: BEST_PRICE

Messages (`messages`)

All user-facing text is configurable. Color codes use & format. Placeholders are in {braces}. An empty message sends nothing.

Prefix & Chat

Key	Default	Description
`messages.prefix`	`&6✦ &eSell &8\| &7`	Prepended to all chat messages that use `{prefix}`
`messages.no-permission`	`{prefix}&c✘ &7Insufficient permissions`	Sent when a player lacks `sellgui.use`, `sigmaorders.fulfill`, or `sellgui.admin`
`messages.only-players`	`{prefix}&c✘ &7This command can only be used by players`	Sent when the console runs `/sellgui`
`messages.plugin-disabled`	`{prefix}&c✘ &7The sell GUI is currently disabled`	Sent when `enabled: false`
`messages.reload-success`	`{prefix}&a✔ &7Configuration reloaded`	Sent after `/sellgui reload`

GUI

Key	Default	Description
`messages.gui-title`	`&8Sell to Orders`	Chest GUI title
`messages.sell-button-name`	`&a&lSELL`	Name of the emerald SELL button
`messages.sell-button-lore`	3 lines	Lore of the SELL button (list)
`messages.cancel-button-name`	`&c&lRETURN ALL`	Name of the red RETURN ALL button
`messages.cancel-button-lore`	2 lines	Lore of the RETURN ALL button (list)

Sale Results

Key	Default	Placeholders	Description
`messages.already-processing`	`{prefix}&c✘ &7Still processing your last sale, please wait`	—	Sent if a button is clicked while a sale is still being processed
`messages.nothing-to-sell`	`{prefix}&c✘ &7You haven't deposited any items`	—	Sent when SELL is pressed with an empty deposit area
`messages.sold-summary`	`{prefix}&a✔ &7Sold &e{sold}x &7item(s) across &e{orders} &7order(s)`	`{sold}`, `{orders}`	Sent after a sale where everything found a buyer
`messages.sold-summary-with-leftover`	`{prefix}&a✔ &7Sold &e{sold}x &7item(s) across &e{orders} &7order(s)&7. &c{returned}x &7had no matching order and were returned`	`{sold}`, `{orders}`, `{returned}`	Sent when some items were returned unsold
`messages.sold-earnings`	`{prefix}&a✔ &7You earned &e{earned}`	`{earned}`	Sent after a sale that sold at least one item. `{earned}` lists one formatted amount per currency, e.g. `$1.2K, 300 Gems`
`messages.returned-all`	`{prefix}&a✔ &7Returned all deposited items`	—	Sent after RETURN ALL

Full Default File

enabled: true
command-aliases: []
match-strategy: BEST_PRICE

messages:
  prefix: "&6✦ &eSell &8| &7"

  no-permission: "{prefix}&c✘ &7Insufficient permissions"
  only-players: "{prefix}&c✘ &7This command can only be used by players"
  plugin-disabled: "{prefix}&c✘ &7The sell GUI is currently disabled"
  reload-success: "{prefix}&a✔ &7Configuration reloaded"

  gui-title: "&8Sell to Orders"
  sell-button-name: "&a&lSELL"
  sell-button-lore:
    - "&7Deposit items above, then"
    - "&7click to sell everything to"
    - "&7the best matching active order"
  cancel-button-name: "&c&lRETURN ALL"
  cancel-button-lore:
    - "&7Click to take back everything"
    - "&7you've deposited, unsold"

  already-processing: "{prefix}&c✘ &7Still processing your last sale, please wait"
  nothing-to-sell: "{prefix}&c✘ &7You haven't deposited any items"
  sold-summary: "{prefix}&a✔ &7Sold &e{sold}x &7item(s) across &e{orders} &7order(s)"
  sold-summary-with-leftover: "{prefix}&a✔ &7Sold &e{sold}x &7item(s) across &e{orders} &7order(s)&7. &c{returned}x &7had no matching order and were returned"
  sold-earnings: "{prefix}&a✔ &7You earned &e{earned}"
  returned-all: "{prefix}&a✔ &7Returned all deposited items"

Feature Switch (enabled)​

Command Aliases (command-aliases)​

Match Strategy (match-strategy)​

Messages (messages)​

Prefix & Chat​

GUI​

Sale Results​

Full Default File​

See Also​