Create: Numismatics Shops

## First release

 

A datapack-driven shop system for Create: Numismatics. Define shops as JSON,

spawn a shopkeeper, and players trade using the money they already have in

Numismatics.

 

**This mod ships an engine, not shops.** It contains no items, prices or shop

content of its own — a modpack supplies those. A working example shop is

included so you can try it immediately:

 

/numshops spawn numismatics_shops:example

 

### Shops

 

- Defined in datapacks at `data/<namespace>/numismatics_shops/<name>.json`

- Fixed stock, plus any number of independently rotating stock groups

- Rotation on Minecraft game time, persisted across restarts — weekly specials

and daily stock keep their schedule through a server restart

- Weighted and unweighted selection, with or without replacement, per-entry chance

- Stock limits, per-player allowances, cooldowns, and timed restocking

- Pick items by id, by tag, or by mod namespace — "ten random decorative blocks

a day" is a few lines of JSON

- Conditions: mod loaded, advancement, scoreboard, time of day, weather,

gamemode, dimension, permission level

 

### Trading

 

- Buy, sell, or both, at any stack size

- Payment from bank balance, a carried bank card, or loose coins, with change

handled automatically

- Buyback proceeds deposit straight into the seller's account

- Bulk ordering with a typed quantity, priced and paid as a single transaction

- Live bank balance and spendable funds shown in the GUI, with category tabs

and search

 

### Shopkeepers

 

- Stationary, invulnerable by default, and they turn to face nearby players

- Skins from a resource pack, a Minecraft account name, or an https URL

- Optional — shops can also be opened by command, by a block, or through the API

 

### Admin

 

- `/numshops list | inspect | spawn | setshop | skin | rotate | restock | reload | open | remove`

- `/numshops inspect` reports current stock, rotation timers, usage counts and

what was skipped and why

 

### Notes

 

- **Required on both client and server.** A client without it will be rejected

at connect.

- Shop definitions are read server-side and synced to clients, so players never

need the datapack.

- Skins set by player name need an online-mode server; offline-mode falls back

to the default skin and logs why.

- Numismatics owns all money. This mod stores no balances of its own, so there

is nothing to reconcile or migrate.

 

### Requires

 

Create: Numismatics 1.1.0+ (and Create). Minecraft 1.21.1, NeoForge 21.1.234+.