Reference

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.

SettingDefaultWhat it does
displayrequiredThe menu icon: material, name, lore, glow, and optionally custom-model-data or skull-owner.
display_salesame as displayA different look while the item is on sale.
price.buy0The price. A price of 0 makes the item free.
price.currencyeconomy.default-currencyCurrency id, or vault / playerpoints.
slotautomaticMenu slot. Leave out to fill the menu by itself.
pageautomaticMenu page, or a comma-separated list.
itemnoneWhat 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.
confirmshop.confirm-purchasesSet false to skip the confirm screen for this item.
max-quantity64Most the player can buy at once.
giftabletrueWhether the item can be bought as a gift.
sale.enabled / sale.discountfalse / 0A fixed percentage discount on this item.
stock.enabledfalseTurn on limited stock.
stock.max100Maximum stock.
stock.regeneratefalseRestock automatically.
stock.regen-amount10Stock added each regen-interval.
stock.regen-interval0Time between regen-amount top-ups. 0 for none.
stock.regen-time0Time after selling out before a full restock.
stock.regen-datenoneA date when a sold-out item is fully restocked.
limit.enabledfalseTurn on per-player purchase limits.
limit.max-purchases-per-player0Most a player can buy.
limit.reset-every0Time after which the player's count resets. 0 for never.
cooldown0Time before the same player can buy this item again.
subscription.enabledfalseMake the item a subscription.
subscription.intervalnoneTime between charges, for example 30d.
subscription.renew-commands[]Console commands run on each renewal.
decline-subscription-commands[]Console commands run when the subscription ends.
permissionnonePermission node required to buy.
permission-modepurchasepurchase 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.enabledfalseTurn on demand-based pricing.
dynamic-pricing.multiplier0.1How strongly demand raises the price.
dynamic-pricing.decay0.05How much of the base price the price falls by each decay-interval.
dynamic-pricing.decay-interval1hHow often the price falls.
dynamic-pricing.min-price / max-price0.5 / 2.0Lowest and highest price as multiples of the base price.
previewing.enabled / publish-datefalse / noneShow the item but block buying until the date (yyyy-MM-dd HH:mm:ss).