Using it

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: []
  • expires in the file is a time in milliseconds (0 is never). The command and the editor work this out for you.
  • max-uses is total uses for everyone. max-per-player is per player. 0 means no limit.
  • min-spend is the smallest purchase it works on.
  • items empty means everything. Use category ids, item ids or category.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>.