Item options
Everything here goes under an item in coinshop/<category>.yml. Only display and price are needed. Defaults are what the plugin uses when the option is missing.
| Setting | Default | What it does |
|---|---|---|
| display | required | The menu icon: material, name, lore, glow, and optionally custom-model-data or skull-owner. |
| display_sale | same as display | A different look while the item is on sale. |
price.buy | 0 | The price. A price of 0 makes the item free. |
price.currency | economy.default-currency | Currency id, or vault / playerpoints. |
| slot | automatic | Menu slot. Leave out to fill the menu by itself. |
| page | automatic | Menu page, or a comma-separated list. |
| item | none | What the player receives: material, quantity, enchants and name, or an items list for several rewards. |
| commands | [] | Console commands run on purchase. %player% is the receiver, %buyer% is the payer. |
| confirm | shop.confirm-purchases | Set false to skip the confirm screen for this item. |
| max-quantity | 64 | Most the player can buy at once. |
| giftable | true | Whether the item can be bought as a gift. |
| sale.enabled / sale.discount | false / 0 | A fixed percentage discount on this item. |
stock.enabled | false | Turn on limited stock. |
stock.max | 100 | Maximum stock. |
stock.regenerate | false | Restock automatically. |
stock.regen-amount | 10 | Stock added each regen-interval. |
stock.regen-interval | 0 | Time between regen-amount top-ups. 0 for none. |
stock.regen-time | 0 | Time after selling out before a full restock. |
stock.regen-date | none | A date when a sold-out item is fully restocked. |
limit.enabled | false | Turn on per-player purchase limits. |
limit.max-purchases-per-player | 0 | Most a player can buy. |
limit.reset-every | 0 | Time after which the player's count resets. 0 for never. |
| cooldown | 0 | Time before the same player can buy this item again. |
subscription.enabled | false | Make the item a subscription. |
subscription.interval | none | Time between charges, for example 30d. |
subscription.renew-commands | [] | Console commands run on each renewal. |
| decline-subscription-commands | [] | Console commands run when the subscription ends. |
| permission | none | Permission node required to buy. |
| permission-mode | purchase | purchase blocks buying. view hides the item. |
requires.items | [] | Items (category.item) the player must have bought before. |
requires.conditions | [] | Comparisons such as "%player_level% >= 10". |
dynamic-pricing.enabled | false | Turn on demand-based pricing. |
dynamic-pricing.multiplier | 0.1 | How strongly demand raises the price. |
dynamic-pricing.decay | 0.05 | How much of the base price the price falls by each decay-interval. |
dynamic-pricing.decay-interval | 1h | How often the price falls. |
| dynamic-pricing.min-price / max-price | 0.5 / 2.0 | Lowest and highest price as multiples of the base price. |
| previewing.enabled / publish-date | false / none | Show the item but block buying until the date (yyyy-MM-dd HH:mm:ss). |