Configuration

One config.yml runs everything. Colours use & codes and &#RRGGBB hex.

License

license:
  key: "YOUR-LICENSE-KEY"

Order rules

order:
  currency-symbol: "$"
  default-duration-hours: 72
  minimum-price: 1
  maximum-price: 1000000000000
  max-amount: 6400
  max-active-orders: 18       # default with no rank permission
  browse-page-size: 45
  select-page-size: 45

Input mode

Mode	Behaviour
`dialog`	Paper's native Dialog UI — needs Paper 1.21.7+. Falls back to sign automatically when unavailable. Default.
`sign`	In-game sign editor. Works on every 1.21.x version.

input:
  mode: dialog

◆

dialog is safe to leave on — if the running server doesn't have the Dialog API, DexOrders quietly uses the sign editor instead.

Storage

Type	Where	Setup
`yaml`	`plugins/DexOrders/data.yml`	None — default
`sqlite`	`plugins/DexOrders/data.db`	None
`mysql`	External MySQL/MariaDB	Fill in credentials

storage:
  type: yaml
  mysql:
    host: "localhost"
    database: "dexorders"
    username: "root"
    password: ""

Item-picker icons

In dialog mode the Choose Item buttons show real item sprites. These need a 1.21.9+ client; set icons: false for name-only buttons on older versions.

item-picker:
  icons: true
  item-atlas: "auto"    # auto-detects server version
  block-atlas: "auto"
  sprite-overrides: {}   # map a material to a texture, or "none"

Client version	Item atlas used
1.21.9 – 1.21.10	`minecraft:blocks` (everything)
1.21.11+	`minecraft:items` for items, `minecraft:blocks` for blocks

Config version

config-version: 1