# ExcellentShop / CoinsEngine Configs (Staged)

This directory holds **post-first-run** configuration overrides for the migration.

## How it works

ExcellentShop and CoinsEngine generate their own opinionated default
configs the first time the plugin starts. Those defaults are excellent
out of the box — 11 themed virtual shops with ~400 vanilla items, sane
buy/sell prices, polished GUIs.

Rather than ship a hand-translated EZShop catalog (which would be a
strict regression — EZShop only had ~80 items, sell-only), this
migration **adopts the bundled ExcellentShop catalog** and lays down
a small set of **operator-tunable overrides** on top.

The bundled catalog already covers the eight EZShop categories the
operator listed: building blocks, colored blocks, food, mob drops,
miscellaneous, minerals, redstone, farming, decoration, plus
combat/tools and potions.

## Files in this dir

- `apply-overrides.sh` — runs after first start, patches the 11 generated shop YAMLs to apply the racked.ru tweaks listed below.
- `coinsengine/config.yml` — pre-staged, drops in the single `coin` currency named "coins" (matches the EZShop messages).
- `coinsengine/currencies/coin.yml` — currency definition.
- `excellentshop/config.yml` — top-level plugin overrides (modules: virtual=on, auction=on, chest=OFF).
- `excellentshop/modules/virtual_shop/config.yml` — `/shop` alias, sell-all, sell-hand commands, no rank multiplier (we keep parity with EZShop's flat pricing).
- `excellentshop/modules/auction/config.yml` — Kiranhart-equivalent settings: 1% tax, BIN+bid, 10 listings default, 7200s bid duration, 172800s BIN duration.

## What's NOT staged

- Per-item prices — bundled defaults are kept. If the operator wants to align specific items to legacy EZShop prices, edit the generated `plugins/ExcellentShop/modules/virtual_shop/shops/<id>/config.yml` files and adjust `sell` / `sellAll` price fields. EZShop legacy table preserved at `legacy-ezshop-prices.yml` for reference.
- `legacy-ezshop-prices.yml` — full export of EZShop's `item-prices` map; reference only.

## Layout reference (54-slot per category from YOU500 ask)

Bundled shops are 54-slot (6 rows) by default with category icons in the
main menu, exactly the layout described in `SHOP-SYSTEM-DECISION.md`.
The operator does NOT need to manually configure 54-slot — it's the default.
