Introduction
What ExyliaMarket is, its nine modules, what it needs to run and how this documentation is organised.
ExyliaMarket is everything players buy and sell on an Exylia server, in one plugin: between each other
through the auction house, auctions, buy orders, the bazaar and face-to-face trades, and with the server
through its shop, /sell, the worth list, sell wands and autosell. Each is a module with its own switch,
its own file and its own commands.
It is a premium plugin, sold on BuiltByBit and the Exylia store, and installed through a licence loader.
The modules
Fixed-price listings with a review of fee and tax, a suggested price, boxes you can look inside, sorts, categories, search and a watchlist.
AuctionsTimed auctions in any currency, bids held until beaten, auto-bids up to a ceiling, buy-it-now and anti-snipe.
Buy ordersPay up front for an amount of an item; anybody fills it and is paid at once.
BazaarAn order book per product: instant buys and sells, buy orders and sell offers, 227 products shipped.
TradeTwo grids, money, two accepts and a countdown: the end of "you drop yours first".
ShopShops inside shops edited in game, each with its own commands and servers, fixed, demand or random prices, stock, limits, sales, coupons, gifts and a cart, with a 402-product default shop.
Selling and worth/sell, its window, the worth list, what each item is worth drawn under it, and an audit of prices
that would print money.
Wands that empty a container into money, and autosell for what players break.
Around them: one /collect inbox for everything a player is owed, notices that
find a player on any server, a price index built from what players actually
paid, a market log and stats for staff, settings edited in game, and Discord webhooks. See
Administration.
Every module is on after a fresh install. Switch any of them off in config.yml; a module that is off
registers nothing at all.
Requirements
| Requirement | Detail |
|---|---|
| Server | Paper 1.21.1 or newer, or a fork of it. Folia 1.21.4 or newer. |
| Java | 21 |
| Required dependencies | packetevents, and ExyliaLib 1.448.1 or newer — installed for you if it is missing |
| An economy | ExyliaEconomy, or Vault with an economy plugin. Without one, nothing can be priced. |
| Optional | PlaceholderAPI, ExyliaSurvivalCore, ExyliaAnalytics |
Configuration, menus and prompts, the database, the economy facade, notices, deliveries, /settings,
boosters, placeholders and the cross-server channels all come from ExyliaLib. ExyliaMarket is written on top
of it and does not run without it, which is why the loader installs it on a server that lacks it.
A network
Every server pointed at the same database shares one market: the same listings, auctions, orders, bazaar book and shop, and a player hears about their deals wherever they are. With Redis configured, changes reach the other servers at once. Network groups choose, module by module, which servers share: two survival servers on one auction house, a full-PvP server with its own. See Installation.
How to read this documentation
Getting started
Installation, then a first listing, order and sale in a few minutes.
Between players
The auction house, auctions, buy orders, the bazaar and trades.
Selling to the server
The shop, /sell and the worth list, sell wands and autosell.
Systems
/collect and notices, the price index, administration and integrations.
Reference
Commands, permissions, placeholders, config.yml, the developer API and the questions that come up most.
Conventions
- Values marked as default are what the plugin writes the first time it starts. If the file already exists, your value is kept.
- Identifiers between
<and>are variables:/ah sell <price>means/ah sell 500. - The default currency is the server's main one: ExyliaEconomy's default, or Vault's. Thresholds written as plain numbers are amounts of it.
- Colours use ExyliaLib palette tokens (
{primary},{highlight},{letters}).
Something missing on this page? Tell us on Discord