DUXPLIMA Documentation

Player market

Players sell their own builds as designs, and other players buy them and have them built.

A player marks a build of theirs with the market wand and runs /builders market sell. The plugin copies it into a fixed design, the player names it and sets a price, and the listing is on sale at once. Other players find it in /builders market, buy a blueprint, and their builder crew builds it the way it builds a package. The settings are in market.yml.

PageCovers
Selling a buildThe wand, the capture and what it leaves out, the listing, the fee and commission, managing listings, earnings
Buying a designBrowsing, searching, previewing, buying, the blueprint, My designs, cancelling a market build
Market moderationReports and auto-hide, removing and revoking, restoring, bans, refunds and payouts by hand

From a build to a sale

flowchart LR
    A[Wand selection] -->|/builders market sell| B[Capture]
    B --> C[Listing form]
    C -->|publish, pay the fee| D[For sale]
    D -->|a player buys| E[Blueprint]
    E -->|right-click| F[Build]
    D -->|sale| G[Seller's earnings]
    G -->|payout| H[Seller's balance]

The design is stored when it is listed. What the seller does to the build afterwards, demolishing it included, changes nothing for buyers: every copy builds the stored design.

Where the money goes

StepMoney
ListingThe seller pays economy.listingFee; holders of uxmbuilders.market.fee.exempt pay nothing. It is not returned when the listing ends
SaleThe buyer pays the price. The market keeps the commission, at the rate fixed when the design was listed; the rest, the net, is owed to the seller
Fee and commissionCredited to economy.commissionAccount, a player, or destroyed when it is empty
PayoutThe seller is paid at once or when they join, as economy.payout says; see Earnings

Prices and fees need an economy plugin through Vault. Without one, browsing still works, while listing and buying are refused: every listing has a price nobody could pay. A seller hears it as soon as they run /builders market sell, before anything is captured, fee exempt or not.

Listing statuses

StatusShown asMeaning
ACTIVEFor saleIn the market; the only status that sells
PAUSEDPausedTaken off sale by its seller for now
SOLD_OUTSold outEvery limited copy is sold; copies never come back
HIDDENUnder reviewHidden by reports or a seller ban until a moderator decides; only its seller still sees it
REMOVEDRemovedTaken down by a moderator
DELETEDWithdrawnWithdrawn by its seller for good

Every listing has a six-character code such as 7KQ2MX, used by every market command. Codes ignore case and dashes, and read I and L as 1 and O as 0, so a code copied by hand still works. Buyers keep what they bought whatever happens to the listing, unless a moderator revokes it.

Turning it off

enabled: false in market.yml closes the market: nothing can be captured, listed or bought, and the menus say so. Designs already bought stay buildable, /builders market designs keeps working, and sellers are still paid what they are owed.

Several servers

On a shared database every server sells from the same market.

SharedHow
ListingsEach server reads the others' changes every cache.syncSeconds
The last copyDecided by the database: two buyers on two servers cannot both get it; the one who loses is refunded and told it sold out
Sales, decisionsA seller playing on another server hears of a sale within 30 seconds; one who is offline hears of it on joining any server
EarningsPaid on whichever server the seller is on, never twice

Notes

  • The market's menus are menu/market-*.yml; see Messages and menus. Bedrock players get six of them as lists of buttons, worded by menu/bedrock/market-*.yml; see Bedrock forms.
  • A player's listings, sales, earnings and designs are placeholders for scoreboards.
  • Category names in market.yml follow the language like the rest of the texts.
  • The market writes listings, sales, payouts and refunds to the audit table when logging.audit is on.

Related: Commands, Permissions, market.yml