Stock Prices - Supply and Demand

STOCK PRICES - SUPPLY AND DEMAND 1.0.0 - CHANGELOG
==================================================

First release. A dynamic economy for NeoForge 1.21.1 that prices every item from the
live state of your world and (optionally) puts those prices on Spud's Shop stalls.

THE MARKET
- Every Minecraft day the server recomputes a Standard Retail Price (SRP) for every
  obtainable item. One model, one easing rate, so rises and falls behave the same and a
  sudden shock lands within a day or two. References auto-calibrate on first launch, so
  day-one prices equal your base prices and the market moves relative to that.

THE FORCES
- Supply: more of an item in the world, lower its price.
- Hoarding: scarcity is about distribution. The mod measures concentration (average per
  chunk) and discounts a stockpile locked in one place out of the circulating supply, so
  cornering the market raises the price even when the raw total is high.
- Money supply: every currency item in the world counts as money, so hoarding or printing
  currency inflates every price, and losing it in a war deflates them.
- Demand: a tunable demand factor is in the model (live purchase tracking is on the roadmap).

THE KEYBIND
- A Market Prices screen (bind it in Controls, under Stock Prices): search as you type,
  with each item's icon, name, value, a 7-day trend arrow (green up / red down / dash),
  and the percent. Sort by Name, Price, or Movers. Spawn eggs, air, and technical blocks
  are excluded automatically; modded items are fully supported.

SPUD'S SHOP INTEGRATION (optional)
- An SRP checkbox in the owner screen (filled when on, with a hover tooltip). Toggle it
  and the stall hands pricing to the market: updated instantly and again every day, no
  re-toggling.
- Smart bills: prices are written as the fewest, largest coins, so 1000 becomes 10
  diamonds rather than 1000 emeralds. The coin ladder is configurable.

CURRENCY (two-way)
- The configured denominations act as bills (what a stall charges) AND as the money supply
  (every such item in the world, counted at its value). One list, both jobs.

SUPPLY MEASUREMENT
- The mod builds its own per-chunk container index as chunks load and unload, plus ender
  chests and online inventories. Unvisited chunks are never counted; a hidden stockpile
  keeps holding a price up until disturbed.
- Failsafe: container scans are throttled over time, so joining a world never stalls on
  them, and a settling gate keeps the market from recomputing on a half-built index.
- Prices and the index are saved, so they survive a restart untouched.

COMMODITY MODEL
- Synonyms merge to one commodity; reversible storage (block <-> ingot <-> nugget) groups
  by weight; one-way processing (ore vs ingot) stays separate so smelting bottlenecks show.
- Manual include / exclude lists fix anything the auto-detector misses or wrongly grabs.

COMPATIBILITY
- Runs standalone. Spud's Shop (Fork) and an SDM economy are optional, detected at runtime.

COMMANDS
- /stockprices market (open the screen), recompute, reload, and info (inspect the held item:
  its supply, hoarding, effective supply, baseline, SRP, and the economy's money pool).