Reference

Configuration

config.yml key by key — language, debug, the module switches, network groups, feedback, categories, prices and logs — and where every other file and setting lives.

Everything is generated in plugins/ExyliaMarket/ on first start, with comments. Edit the files there and run /marketadmin reload; most module settings can also be changed in game from /marketadmin, which writes the same files. The catalogues — the shop, the bazaar's products, listings, orders — live in the database, not in any file.

File	What it holds	Documented on
`config.yml`	The plugin's own settings, below.	This page
`discord.yml`	The webhooks.	Administration
`modules/auction-house/config.yml`		Auction house
`modules/auctions/config.yml`		Auctions
`modules/orders/config.yml`		Buy orders
`modules/bazaar/config.yml`		Bazaar
`modules/shop/config.yml`		Shop
`modules/sell/config.yml`		Selling and worth
`modules/worth/worth.yml`	The worth list.	Selling and worth
`modules/sell-wands/config.yml`		Sell wands
`modules/trade/config.yml`		Trade
`database.yml`	ExyliaLib's database connection.	Installation
`lang/<code>/…`	Every message and menu.	Below

config.yml

language: default
debug: false
modules:
  auction-house: true
  auctions: true
  orders: true
  bazaar: true
  shop: true
  sell: true
  worth: true
  sell-wands: true
  trade: true
network:
  group: ''
  modules:
    auction-house: default
    auctions: default
    orders: default
    bazaar: default
    shop: global
    prices: default
    deliveries: default
feedback:
  toasts:
    auction-house-sold: GOAL
    auctions-won: CHALLENGE
    auctions-sold: GOAL
    orders-filled: TASK
    orders-completed: GOAL
  sell-indicators: true
  wand-particles: HAPPY_VILLAGER|12|0.4|0.4|0.4|0
  autosell-report: ACTION_BAR
  auction-countdown-seconds: 60
  outbid-action-bar: true
  trade-countdown: BOSS_BAR
categories:
  shown: [blocks, tools, armour, food, redstone, enchanted-books, potions, misc]
  overrides:
    TOTEM_OF_UNDYING: misc
prices:
  refresh-seconds: 60
  min-sales: 3
  warn-below-percent: 50
  warn-above-percent: 200
  keep-history-days: 90
  keep-daily-days: 365
logs:
  keep-days: 30
  stats-refresh-seconds: 60

language and debug

Key	Default	What it does
`language`	`default`	Language of this plugin's menus and messages. `default` follows ExyliaLib's; `en`, `es`, `pt`, `fr`, `ru` or `tr` set this plugin alone. Each is a folder under `lang/`; `custom` holds files adopted from a server that had its own.
`debug`	`false`	Extra console detail.

modules

One switch per module, all on. A module switched off registers nothing at all — no commands, listeners, menus, placeholders or tables — and its own file is left alone. A restart applies a change; a reload only names the modules waiting for one.

sell-wands needs sell: with sell off it stays off, with a line in the console.

network

Which servers of a network share each module's data. Servers on the same database share everything unless they are put in groups here: survival-1 and survival-2 set group: survival and trade on one auction house, while a full-PvP server sets group: fullpvp and keeps its own. Restart to apply.

Key	Default	What it does
`group`	`''`	This server's group: letters, digits, `-` and `_`, up to 24. Blank shares with every server.
`modules.auction-house`	`default`	Auction house listings and watchlists.
`modules.auctions`	`default`	Auctions.
`modules.orders`	`default`	Buy orders.
`modules.bazaar`	`default`	The bazaar's products, order books and daily volume.
`modules.shop`	`global`	The shops, their stock, limits, coupons and log. Global so one shop can serve the whole network and still be offered on some servers only, which each shop sets in the editor.
`modules.prices`	`default`	The price index behind suggestions and charts.
`modules.deliveries`	`default`	What players are owed in `/collect`, so what survival owes is collected on survival.

Each module's value is default (follow group), global (share with every server on the database) or the name of a group of its own. A group keeps its rows in tables of its own, named with the group in front (survival_sc_auctions). Data written before a module changed group stays with the old group: move it yourself, or empty it first. An invalid name is warned about in the console and shares with every server until it is fixed. The market log and players' history are always shared.

feedback

Toasts, floating labels, particles, action bars and countdowns. Every key is described on Collect and notices.

Key	Default	What it does
`shown`	all eight	The categories the filter steps through, in order: `blocks`, `tools`, `armour`, `food`, `redstone`, `enchanted-books`, `potions`, `misc`. Leave one out to hide it.
`overrides`	`TOTEM_OF_UNDYING: misc`	A material filed somewhere other than its own category, as `MATERIAL: category`.

prices

The price index.

Key	Default	What it does
`refresh-seconds`	`60`	How often each server writes its trades and reads every server's back. Restart to apply.
`min-sales`	`3`	Sales in the last 7 days before a price is suggested or a deal questioned.
`warn-below-percent`	`50`	Ask before listing below this % of the 7-day average. `0` never.
`warn-above-percent`	`200`	Ask before buying above this % of it. `0` never.
`keep-history-days`	`90`	Days each player's market history is kept. `0` forever.
`keep-daily-days`	`365`	Days the daily figures behind the charts are kept. `0` forever.

logs

Key	Default	What it does
`keep-days`	`30`	Days each line of the market log is kept. `0` forever.
`stats-refresh-seconds`	`60`	How often the stats screen's figures are worked out again.

Messages and menus

All under lang/<code>/, where <code> is the language above.

File	What it holds
`messages.yml`	The prefix, errors, notices and the join summary, `/collect`, feedback, menu labels, category names, history words, price words, the settings screens and the market log.
`modules/<module>/messages.yml`	Each module's lines.
`menus/collect.yml`, `menus/currency_select.yml`, `menus/price_history.yml`	`/collect`, the currency picker, the price chart.
`menus/admin/*.yml`	The staff screens. Rewritten from the jar on every start.
`modules/<module>/menus/*.yml`	Each module's player screens.
`modules/trade/window.yml`	The trade window.

Colours use ExyliaLib palette tokens such as {primary}, {error} or {highlight}. A message may start with [sound:NAME|volume|pitch], which plays a sound and never reaches the screen. %prefix% is the prefix of the core messages.yml, used by every module's file too.

Updating menus

A release updates a player screen only while it is untouched; an edited one is kept and the new version is offered next to it. The staff screens are the plugin's and are replaced on every start.

Something missing on this page? Tell us on Discord