hangelog

All notable changes to Universal Shop for NeoForge are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Platform: NeoForge 21.1.x · Minecraft: 1.21.1 · Java: 21

[Unreleased]

Fixed

• Fixed mod failing to load when ModConfigEvent.Reloading was registered on the NeoForge game bus instead of the mod lifecycle bus.

[1.0.0] - 2026-06-10

Initial release for NeoForge 1.21.1.

Added

Shop (/shop)

• GUI shop with buy and sell modes (/shop, /shop sell).

• Rarity-based pricing with configurable scale, power curve, min/max bounds, and per-item overrides in config.

• Per-item stock limits with automatic restock on a configurable interval.

• Restock banner overlay when the shop restocks (configurable duration).

• Catalog search with spyglass filter (client search box syncs to server).

• Bulk buy: left-click 1, right-click configurable amount, shift-click max stack.

• Player balance display in the shop GUI.

• /shop balance — check balance.

• /shop pay <player> <amount> — send money to another player.

• /shop nextrestock — time until the next automatic restock.

• /shop help — command help with operator sections when permitted.

Quick sell (/sell)

• /sell / /sell hand — sell one item from your hand.

• /sell hand <count> — sell a specific amount.

• /sell all — sell all tradeable items in inventory.

• /sell help — command help.

Auction house (/ah)

• Full auction GUI with deposit slots and emerald list button.

• /ah sell <price> and /ah sell <price> <count> — list from hand.

• /ah sellall <price> — list every tradeable stack.

• /ah price <amount> — set GUI deposit list price.

• /ah buy <id> — buy by listing id (short prefix supported).

• /ah cancel <id> — cancel your listing.

• /ah my — GUI filtered to your listings (click to cancel).

• /ah list — view active listings in chat.

• /ah help — command help.

• Configurable listing limits and expiry.

Admin & runtime customization (operator, level 2)

• /shop admin settings — view live shop settings.

• /shop admin enable / disable — toggle the shop (blocks /shop and /sell when disabled).

• /shop admin reset — reset runtime overrides to config defaults.

• /shop admin sellratio, startingbalance, currency — economy settings.

• /shop admin stock enable / disable, restockhours, basestock, minstock, bulk — stock and GUI settings.

• /shop admin baseprice, pricescale, raritypower, minprice, maxprice — global pricing (reprices catalog).

• /shop price set|get|reset <item> [price] — per-item buy price overrides.

• /shop price maxstock set|reset <item> <amount> — per-item max stock overrides.

• /shop restock [item] — force restock all or one item.

• /shop stock set|add <item> <amount> — set or add current stock.

• /shop setbalance <player> <amount> — set a player's balance.

• /shop admin help — admin command help.

Configuration

• config/universalshop-common.toml with grouped sections: economy, pricing, stock, gui, commands.

• Configurable starting balance, currency symbol, sell ratio, price overrides, stock overrides, restock interval, bulk amount, auto-focus search, permission levels, and auction limits.

Permissions

• LuckPerms-compatible nodes: universalshop.command.shop, universalshop.command.sell, universalshop.command.ah.

Persistence

• World data under <world>/universalshop/:

  • balances.json — player balances.

  • auctions.json — active auction listings.

  • stock.json — current shop stock and restock schedule.

  • shop_settings.json — runtime shop settings from admin commands.

  • price_overrides.json — command-set item prices.

  • stock_max_overrides.json — command-set per-item max stock.

Integration

• Compatible with Jobs & Careers — job payouts deposit into Universal Shop balances.

Fixed

• Multiplayer crash when opening /shop or /ah (client attempted to access server-only price/auction managers).

• Search box typing E closing the shop GUI (inventory key conflict); search consumes keys while focused.

• Blocked unobtainable items from the trade catalog (e.g. end portal frame).

• Shop inventory section uses vanilla chest texture instead of a custom slate texture.

Version matrix

Other loaders (Forge 1.20.1, Fabric) are maintained in sibling repositories; see README.