Sales, coupons and deals
Item discount#
A permanent discount on one item: sale: {enabled: true, discount: 10}. Use display_sale to give the item a different look while it is discounted.
Timed sales#
Start a sale by hand with:
/mccs sale create <time> <percent> [items|all] [players]
items is a comma-separated list of category ids, item ids or category.item (use all for everything). players is a comma-separated list of names for a sale that only they get. Example: /mccs sale create 2h 25 blocks,ranks.vip. List sales with /mccs sale list and end one with /mccs sale delete <id>. You can also create sales from /mccs then Sales.
While a sale for everyone runs, a boss bar with a countdown is shown (sale-bossbar in config.yml), and the start and end are announced.
sale-bossbar:
enabled: true
color: YELLOW
text: "<gradient:#FFD76A:#FF9F43><bold>%percentage%% OFF</bold></gradient> &7%items% &8| &7ends in &e%time%"
Scheduled sales#
sales.yml holds sales that start by themselves, such as a weekend sale or a happy hour. Both examples are off by default:
scheduled:
weekend:
enabled: false
days: [SATURDAY, SUNDAY]
time: "12:00"
duration: 6h
percentage: 20
items: []
happy-hour:
enabled: false
days: []
time: "20:00"
duration: 1h
percentage: 10
items: [blocks]
days empty means every day. time is 24-hour server time. items empty means everything.
Coupons#
Players enter a coupon code on the confirm screen. Make coupons in coupons.yml, in the Coupons editor, or with a command:
/mccs coupon create <code> <20%|500> [expires-in|never] [max-uses] [per-player] [min-spend] [items]
A value ending in % is a percentage, anything else is a fixed amount. Example: /mccs coupon create SUMMER 20% 7d 100 1 500 blocks. Remove one with /mccs coupon delete <code> and view them with /mccs coupon list.
coupons:
WELCOME10:
percent: 10
amount: 0
expires: 0
max-uses: 0
max-per-player: 1
min-spend: 0
items: []
expiresin the file is a time in milliseconds (0 is never). The command and the editor work this out for you.max-usesis total uses for everyone.max-per-playeris per player. 0 means no limit.min-spendis the smallest purchase it works on.itemsempty means everything. Use category ids, item ids orcategory.item.
Disable coupons with shop.coupons-enabled: false.
Daily deals#
Each day the shop picks random items at a random discount. Players see them with /coinshop deals or from the main menu. Settings are in deals.yml:
enabled: true
menu-title: "<gradient:#FFD76A:#FF9F43><bold>Daily Deals</bold></gradient>"
# 24-hour server time.
refresh-time: "00:00"
# How many deals to show, up to 7.
count: 4
discount:
min: 10
max: 40
# Tell players when new deals are picked.
announce: true
pool:
# Leave empty to use every category. Subscriptions are never picked.
categories: [weapons, blocks, cosmetics]
# Item ids or category.item to leave out.
exclude: []
count is how many deals (up to 7). Subscriptions are never picked. /mccs deals picks new deals right now.
Dynamic pricing#
Prices that follow demand. Each purchase adds demand, and demand falls over time. The price is base * (1 + demand * multiplier), kept between min-price and max-price (multiples of the base price). Every decay-interval, the price falls by decay of the base price.
dynamic-pricing: {enabled: true, multiplier: 0.05, decay: 0.05, decay-interval: 1h, min-price: 1.0, max-price: 2.5}
Reset an item's price with /mccs price reset <category.item>.