Administration

The panel

/marketadmin (also /exyliamarket) opens one panel for everything staff manage. It opens for anybody holding any of the plugin's staff nodes; each card then asks for its own. From the console it prints the usage.

Each card shows whether its module is on, and live counts: listings, auctions, orders, offers, shops, priced items and today's deals.

Settings in game

Each module's card opens its settings in themed pages — Fees & tax, Limits, Rules, Broadcasts, Bidding, Durations and so on. Click a value to change it: numbers, money, percentages, hours and seconds are typed with their range shown, switches flip, the blocked materials open a list. Values that bound each other are checked against each other (a minimum never above its maximum).

A change is written to the module's own file, under the same key as by hand, and that module reloads at once. Nothing is stored anywhere else. The shop's config.yml (celebrations included), discord.yml, the module switches and the network groups are only edited in the files. The shop's catalogue, coupons and sales are edited from its own editor.

Moderation lists

Every removal asks first, tells the owner, and is written to the market log as market-remove, auction-remove, order-remove or bazaar-remove. See each module's page for the commands that do the same by id.

The market log

/marketadmin log [player] opens the log of the whole network, or of one player as the one who acted or the one it happened to. It needs exyliamarket.admin.logs.

Each line is who did what, with which item, for how much, to whom, on which server and when. Click a name to open that player's log. Filter by module and by action, left-click forward and right-click back.

Lines are kept logs.keep-days (30 by default, 0 forever). The same records also go to the ExyliaLib staff log every Exylia plugin shares, browsed with /exylialib logs.

The stats screen

/marketadmin stats shows today and the last seven days: volume and deals per module and currency, the taxes taken, the items that moved most, and the players who sold and bought most (ranked in the default currency). The figures are worked out from the log every logs.stats-refresh-seconds (60 by default) and the screen says how long ago.

Demo data

/marketadmin demo seed fills the market with believable activity from eight fake players, so every screen can be photographed on a test server: auction house listings, auctions, buy orders, bazaar offers, a week of price history and, run by a player, a few entries in their own /collect. Rows go through the same storage as real ones, so they survive a restart, but no money is withdrawn or deposited. /marketadmin demo clear deletes everything the fake players own, refunding nobody; an auction a real player has bid on is left to end normally. Both need exyliamarket.admin.demo and run from the console too.

Wiping and resetting

ExyliaMarket has no wipe or reset command of its own. Every table declares what it holds, so ExyliaLib's /exylialib wipe ExyliaMarket <table|*> and /exylialib resetplayer <player> [ExyliaMarket|all] cover the market: listings, auctions, orders and bazaar offers are world data, the shop and bazaar catalogues and coupons are setup, limits and daily volume are progress, who used which coupon is account data, and logs, history and the price index are history. After a player reset, the market reads its listings, auctions, orders and offers again. See ExyliaLib commands.

Reloading

/marketadmin reload (or the panel's button) re-reads config.yml, discord.yml, every module's files, the worth list and every menu. Turning a module on or off still needs a restart; the reload names the modules waiting for one. /exylialib reload also re-reads this plugin's menus.

Discord

discord.yml posts the market's big moments to a channel: an auction house sale, an auction won, a buy order completed, a bazaar trade, a large shop purchase and a removal by staff. It is off until enabled is true and a webhook URL is set.

enabled: true
webhook: https://discord.com/api/webhooks/<id>/<token>
auction-house-sale:
  enabled: true
  above: 10000
  webhook: ''
  template:
    title: AUCTION HOUSE SALE
    description: '**%player%** bought **%amount%x %item%** from **%counterparty%**.'

above is in the default currency; 0 posts every deal, and a deal in another currency only posts when it is 0. Each event may name its own webhook. Templates are ExyliaLib's webhook cards — title, description, fields, colour, buttons, footer — with %player%, %player_head%, %counterparty%, %item%, %amount%, %price%, %tax%, %currency%, %module%, %action% and %server%. What players typed is escaped, so it never pings.