# Shop & Sell GUI Addon — Changelog
## Changelog — v1.5.0 → v1.6.0
### New Features
- **Chest Shops** — Players can create shops on chests; GUI on interact; owners sneak-open to stock
- **Crates & Keys** — Placeable crates with unique keys; pre-built Common, Rare, and Legendary loot
- **Bank** — Deposit and withdraw with passive interest (\~1% per hour)
- **Jobs** — Miner, Hunter, and Farmer roles with event-based pay
- **Bounties** — Place a bounty on a player; claim it on kill
- **Gambling** — Coin Flip, RPS, Dice, Higher/Lower, Card War, Number Duel, Odd/Even, Blackjack, Slots
- **XP Payments** — Buy from shop using XP levels or points; pay XP to other players
- **Dynamic Pricing & Sales Tax** — Demand-based prices with optional buy tax
- **Offline Pay** — Send money by player name even when offline
- **Shop Search** — Search items by name inside the shop GUI
- **Worth** — Check the sell price of the item in your hand
- **Multi-Language** — Item names and UI language support
- **Inventory → Shop** — Add items from inventory to shops and marketplace listings
### Improvements
- Balance abbreviations (`1k`, `1.5k`, `2m`, `1b`) across messages, title HUD, and scoreboard
- Expanded daily quests with item, XP, and crate-key rewards
- Admin quest editor: add rewards from inventory or as keys
- HUD pauses during gambling so titles and animations display correctly
- RPS countdown and reveal animations
- Reliable crate open on right-click with a key (no `/crate open` required)
- Reliable chest-shop owner and buyer GUIs
- Event-handler guards to prevent double registration and reduce lag risk
- Critical script load crash fixed (`hud.js` syntax error)
# v1.5 (2026-08-19)
### Bug fixes
- **Shop icons** — Fixed pink/black missing icons for many items by expanding the texture map and improving fallback path logic (blocks, dyes, buckets, saplings, 1.21 items, etc.).
### New: Multi-currency economy
- Default currency remains `money`.
- Admins can **add / edit / remove** custom currencies (id, name, symbol, starting balance).
- Optional **scoreboard sidebar** per currency.
- Optional **sell enabled** per currency (controls whether `/sellgui` can pay in that currency).
- New admin command:
- `/eco give [amount]`
- `/eco remove [amount]`
- `/eco set [amount]`
- `/eco reset `
- `/bal` and `/balance` show all currencies.
### New: Custom shops & marketplace
- Admins create shops bound to a specific currency via `/shopadmin` → Marketplace & Currencies → Shops.
- Per-shop item list with independent buy/sell prices.
- Players browse shops with **`/marketplace`**.
- Optional: items can only be sold for currencies that have selling enabled; `/sellgui` prompts for currency when multiple are available.
### New: Quest system
- **26 default quests** (kills, mining, selling, buying, AFK, playtime, bosses, etc.).
- Each player receives **5 random quests per day**; new set after daily reset.
- Rewards: currency, items, and/or XP levels — fully editable by admins.
- Players use **`/quests`** to view progress and claim rewards.
- Admin: `/shopadmin` → Quests Admin.
### New: AFK zones
- Admins place zones at their location (`/shopadmin` → AFK Zones).
- Configurable name, radius, currency, and amount per minute.
- Low-frequency checks (~every 20s) to avoid TPS impact.
### New: Per-currency death tax
- Master enable switch + optional PVP-only mode.
- **Each currency has its own enable toggle and percent** (e.g. money 10% on, gems off or 5%).
- Configured in `/shopadmin` → Death Tax Settings → Configure per currency.
### HUD improvements (`/hudconfig`)
- Multi-currency placeholders: `$cur_`, `$fmt_` (symbol + color).
- Coordinate placeholders: `$x`, `$y`, `$z`.
- Updated variables help screen.
### Ways to earn custom currencies
- Mob kills (existing, default currency)
- Selling items (`/sellgui` / marketplace)
- Completing quests
- Standing in AFK zones
- Admin `/eco` commands (events, rewards)
### Performance
- Config and economy data cached in memory; dynamic properties written only on change.
- AFK and quest timers use sparse intervals (no heavy per-tick loops).
- Event-driven progress where possible.
### Commands summary (v1.5)
| Command | Access | Description |
|---------|--------|-------------|
| `/shop` | Anyone | Default shop (money) |
| `/sellgui` | Anyone | Sell items (pick currency if multiple enabled) |
| `/marketplace` | Anyone | Custom currency shops |
| `/quests` | Anyone | Daily quests |
| `/bal` / `/balance` | Anyone | View balances |
| `/baltop` | Anyone | Leaderboard |
| `/pay` | Anyone | Pay another player (money) |
| `/eco …` | Admins | Give / remove / set / reset any currency |
| `/shopadmin` | Admins | Prices, icons, quests, marketplace, death tax, AFK |
| `/hudconfig` | Admins | Sidebar / title HUD |
| `/ah` / `/ahsell` | Anyone | Auction house |
| `/trade` | Anyone | Player trading |
| `/holo` | Admins | Baltop holograms |
---
## v1.4
- Previous release (shop, sell GUI, single currency, auction, trade, holograms, mob rewards, HUD).
Shop & Sell GUI Addon gives your Bedrock world a clean survival economy with GUI menus — buy items, sell from inventory, manage prices, and show a customizable money HUD.
Features
Server Shop (/shop) — browse categories, pick quantities (1 / 8 / 16 / 32 / 64), and buy with in-game money
Sell GUI (/sellgui) — sell sellable items from your inventory (1, half, or all)
Starting balance — new players get $100
Buy/sell spread — sell price is a configurable % of buy price (default 45%) so the economy stays healthy
Admin panel (/shopadmin)
Edit item prices
Edit item icons (custom texture paths)
Enable / disable items
Add items to the shop (ID, price, category, icon, sell-only)
Remove items from the shop
Sell multiplier slider
Reset everything to defaults
Advanced HUD (/hudconfig)
Title-style sidebar (right side of screen) or classic scoreboard, or both
Custom multi-line sidebar & sub-bar text
Variables: $money, $player, $server, $health, $xplevel, $dimension, $players, and more
Adjustable refresh rate
Works with vanilla survival items across many categories (ores, blocks, food, tools, combat, nether/end, etc.)
How to install
Download the pack
Import both the Behavior and Resource packs
Enable them on your world (or on the server)
(Optional) Give yourself operator / Game Director for admin commands
No experimental toggles required. Uses the stable Custom Commands API.
Economy design notes
Default prices are tuned so early-game items stay affordable and late-game goals (netherite, elytra, totems, etc.) take real effort. The sell multiplier keeps a buy/sell gap so players can’t infinitely farm for free money.
Admins can change any price, icon, or item list live without restarting the world.
Performance
Light continuous cost. The title HUD updates about once per second by default and scales fine for typical realm / small-server player counts. You can lower the refresh rate or switch to scoreboard-only mode in /hudconfig if needed.
Compatibility
Minecraft Bedrock 1.21.100+
Designed for survival / multiplayer servers and realms
Script modules: @minecraft/server 2.1.0+, @minecraft/server-ui 2.0.0+

