Skip to main content
The Shop Definition configures the inventory, pricing model, and stock rules for a shop.

​
General Settings

​
title
String
default:"Shop"
GUI Title.
​
rows
Int
default:"6"
GUI Size.
​
currency
Enum
default:"VAULT"
Economy provider: VAULT, PLACEHOLDER, POINTS, etc.
​
taxes
Double
default:"0.0"
Tax rate added to purchase price (e.g. 0.1 = 10% tax).
​
resetPolicy
Enum
default:"NONE"
When to restock: NONE, DAILY, WEEKLY, INTERVAL.
​
artifact
Ref<Artifact>
Storage artifact to save dynamic state.

​
Items Configuration

​
items
List<ShopItem>
The products sold in this shop.

​
Shop Item Structure

​
item
Item
required
The item to trade.
​
limitPerPlayer
Int
default:"0"
Max purchases per player per reset interval (0 = unlimited).
​
strategy
PriceStrategy
Pricing logic.

​
Price Strategy

​
price
Double
required
Base Buy Price (at 100% stock).
​
sellPrice
Double
required
Base Sell Price (at 100% stock).
​
stockMax
Int
default:"0"
Maximum stock level.
  • 0: Infinite stock (Static Price).
  • >0: Dynamic stock (Dynamic Price).
​
step
Double
default:"0.1"
Price elasticity. How much price changes per missing stock unit.
​
min
Double
Minimum possible price cap.
​
max
Double
Maximum possible price cap.