St3ix Docs

Shop

Sell items for shards from config.yml and place them on pages in gui.yml.

/afk shop and /shards shop open the same inventory. The buyer needs afkplus.shop and enough shards. If the item does not fit, nothing is taken.

Offers

Each offer under Shop in config.yml needs a name made of letters, numbers, and underscores. The sample offers are Apple, Bread, and Diamond.

KeyMeaning
MaterialBukkit item.
AmountHow many items the buyer receives.
PriceShards removed.
NameItem name. Color codes allowed.
LoreLines. {price}, {amount}, {item}, {currency} are filled in.
GlintEnchantment glint.
Confirmtrue opens a confirm screen. false buys immediately.
EnchantmentsOptional map, such as sharpness: 5.

An offer with a bad material or a price below 1 is skipped and a warning is printed.

Pages

gui.yml sets the title, row count (3 to 6), filler, previous and next buttons, and the pages. A page maps a slot number to an offer name:

Pages:
  First:
    10: Apple
    12: Bread
  Second:
    10: Diamond

The previous and next slots cannot hold offers. /afk admin reload reads gui.yml again.

Editor

/afk admin shop needs afkplus.admin. Pick a copy of an item from your inventory, type a whole price of at least 1 in the anvil, then click an empty filler in the shop. The real item stays in your inventory. The offer id is the material name, or DIAMOND_SWORD_2 when that id already exists. Name, lore, and enchantments are copied into config.yml. Confirm starts as true. Saving rewrites config.yml and gui.yml, so inline comments in those live files can disappear.

Suggestions

Set Confirm: false on cheap offers like the sample Bread, and leave it true on Diamond. After the first page looks right, add a second page in gui.yml before you use /afk admin shop, so the filler you click is on the page you want.

On this page