⚙️ Settings

On this page, you will find the server-wide settings of player shops.

These options are in the player-shops section of config.yml. Only Enabled has an editor option, the rest are set in the file.

player-shops:
  enabled: false
  creation-cost: 0
  max-per-player: 5
  refund-on-remove: true
  max-amount: 3456
  blocked-items: []
  blocked-worlds: []
  display-items: true
  tax-percent: 0
  allow-sell-above-buy: false
  price-limits: {}
  partial-trades: true
  purge:
    inactive-days: 0
  claims:
    require-claim: false
  map-markers:
    enabled: true

#Enabled

Turns player shops on or off for the whole server. They are off until you turn them on. While off, nobody can trade on a player shop, the owner included, and no new one can be put up: [shop] signs are left alone so another shop plugin can use them. Existing shops stay where they are and work again once it is back on.

On Premium it is also the Status toggle in the Player Shops editor and in Editor > Settings > Sign Shops.

#Creation Cost

What a player pays once, when the sign goes up. It is charged in the Vault currency, and a player who cannot afford it is left with a blank sign. Set it to 0 to make shops free.

With a cost above 0 and no Vault economy installed, nobody can create a player shop.

#Max Per Player

How many shop signs one player can own at a time. Removing a shop frees a place. Set it to 0 for no limit.

A permission overrides it per player. phoenixshop.sign.limit.<number> sets that player's limit, and the highest one they hold counts. phoenixshop.sign.limit.unlimited removes the limit.

#Refund On Remove

Gives the owner back what they paid for the sign when the shop is removed, whether they take it down from its menu or break the sign or container. The refund is what was paid at the time, even when the Creation Cost has changed since.

#Max Amount

The highest Amount an owner can set on a shop, per click. On Premium it is also the most a customer can choose to trade at once.

#Blocked Items

Materials that cannot be traded in player shops, such as BEDROCK or SPAWNER. An owner cannot put one on a shop, and a shop that already trades one refuses every trade.

#Blocked Worlds

Worlds where no player shop can be created. A player with phoenixshop.sign.bypass can still put one up there. Shops that already exist in such a world keep working.

#Display Items

Premium. Lets owners show their item on the container, see Display. Turning it off removes every shown item at once.

#Tax Percent

Premium. The share of every money purchase that the owner does not receive. A buyer pays the full price, and the owner gets the price minus the tax, so 10 means owners keep 90%. Shops paid in items and admin shops are never taxed.

#Allow Sell Above Buy

Premium. While off, an owner cannot set a Both shop to pay sellers more than it charges buyers.

#Price Limits

Premium. The lowest and highest price per single item an owner can set, by material, with default covering every material not listed. A max of 0 means no upper limit. Shops paid in items are not checked.

price-limits:
  default:
    min: 0.1
    max: 0
  DIAMOND:
    min: 50
    max: 500

#Partial Trades

Premium. Lets a trade that cannot go through in full trade the part that can, at its share of the price, see Partial Trades. While off, such a trade is refused as a whole.

#Purge Inactive Days

Premium. Removes the shops of owners who have not played for this many days, checked shortly after startup and once a day. See Inactive Owners. Set it to 0 to keep every shop.

#Require Claim

Premium. Lets a player put up a [shop] sign only inside a claim or region where they can build. WorldGuard, GriefPrevention, Lands and Towny are checked, whichever are installed. A spot that one of them protects against the player is refused even when another allows it. With none of them installed, nothing is checked. A player with phoenixshop.sign.bypass skips the check, and admin shops are never checked. Existing shops stay when a claim is removed.

#Map Markers

Premium. Shows every player shop with an item as a marker on BlueMap, dynmap and squaremap, whichever are installed, in a layer called Player Shops. A marker shows the shop's name if it has one, the item, the amount, the owner and the prices, and follows the shop as it is created, edited or removed. Nothing is shown while player shops are turned off. The marker text comes from the player-shops.map section of the translations file.

Last updated about 2 hours ago