🏪 Chest Shop V3 – Player-Driven Economy System

Turn your Minecraft Bedrock world into a living, breathing economy. Chest Shop allows players to open their own shops using chests, sell items to others, track sales, and explore a global marketplace — all wrapped in a clean, modern custom UI built for smooth and immersive gameplay.

Developed by JMAFK BEDROCK

---

✨ Features at a Glance

🛒 Player Shops

• Create a shop instantly by looking at an empty block and running /j:shop create
• Any chest can be a shop – stock items, set prices, and start selling
• Full inventory management – add items, update prices, and retrieve unsold stock
• Chest protection – shop chests are safe from breaking, explosions, and griefing
• Co-Owner System – invite players to help manage your shop as staff members
• Online Player Selection – add co-owners from a dropdown of currently online players
• Role-Based Permissions – primary owners retain full control; co-owners have limited access with clear visual indicators on restricted actions

🌍 Global Marketplace

• Browse every shop in one searchable menu using /j:shop market
• Search for specific items across all player shops
• Filter by category – Blocks, Tools, Food, Ores, and more
• Filter by shop owner to find items from a specific seller
• Pagination support for large and active server markets

💰 Economy System

• Real-time transactions powered by a scoreboard-based currency
• Claim earnings anytime from completed sales
• Configurable global sales tax on all transactions
• Smart price suggestions based on market activity and trends
• Creation fees – admins can set a cost to open new shops

📢 Dual-Loop Broadcast System

• Featured Shop Broadcasts – boost your shop with timed broadcasts visible to all players
• Grouped Alerts – up to 3 featured shops are displayed in a single clean message to reduce chat clutter
• Featured Item & Price Display – showcase a specific item and its price in broadcast messages
• Basic Market Updates – random shop promotions cycle through all participating sellers
• Broadcast Management Hub – pause, resume, or cancel active broadcasts at any time
• Fully Configurable – admins control broadcast intervals, pricing, and toggle the system on/off

🔔 Notifications & Reports

• Sellers are notified when an item is sold
• Buyers receive confirmation after every purchase
• Offline Sales Report – sellers see a summary of what sold while they were away
• Admins get alerts when new seller applications or shop reports are submitted

👑 Admin Controls

• Seller Application System – approve or reject who can sell on the server
• License Appeals – revoked sellers can submit appeals for admin review
• Shop Report System – players can report shops; admins review and take action
• Seller Directory – view all active sellers, their shop count, and online status
• Revoke & Restore seller permissions with detailed reasoning
• Teleport to any shop directly from the admin panel
• Global Configuration – shop limits, taxes, broadcast settings, economy rules, and more

📊 Analytics & Logs

• Per-shop sales history with timestamps
• Player activity tracking – items sold, income claimed, shop performance
• Player statistics – join date, average income, total earnings
• Server-wide market data for admins

🎨 Polished UI & UX

• Custom Chest UI – a beautifully formatted grid layout for the owner menu
• Visual Slot Indicators – unused slots are styled with a clean disabled texture
• Restricted Action Indicators – co-owners see clear visual cues on actions only the primary owner can perform
• Informative Tooltips – hover over any button for context on what it does
• Sound Feedback – confirmation sounds for purchases, errors, and UI interactions
• Shop Relocation – move your shop to a new chest without losing inventory or settings

---

📥 Installation

Step 1: Enable Beta APIs

1. Create a new world or edit an existing one
2. Open the Experiments tab
3. Enable Beta APIs (required for Script API)

Step 2: Apply Packs

1. Download the addon (.mcaddon or .mcpack)
2. Import it into Minecraft
3. Apply both the Behavior Pack and Resource Pack to your world

Step 3: Set Up Currency (Scoreboard)

Run this command in-game to create the currency scoreboard:

/scoreboard objectives add money dummy

To give money to a player:

/scoreboard players add "PlayerName" money 100000

---

🎮 Commands

Player Commands

Command	Description
/j:shop create	Create a new shop (look at an empty block)
/j:shop market	Open the global marketplace
/j:shop apply	Apply to become a seller
/j:shop list	View all shops you own
/j:shop info	View shop info (look at the shop chest)
/j:shop delete	Delete a shop (look at the shop chest)
/j:shop activate	Open addon activation panel
/j:shop help	Display command help

Admin Commands

Command	Description
/j:shopadmin	Open the admin dashboard

⚠️ Admin Access Requirements

• Must be an Operator (OP) or have the admin tag
• Grant access with: /tag "PlayerName" add admin

---

🛠️ How to Use

For Buyers

1. Find a shop chest in the world or open /j:shop market
2. Browse available items and select what you want
3. Choose the quantity and confirm the purchase
4. The item is delivered to your inventory instantly

For Sellers

1. Apply to become a seller using /j:shop apply
2. Wait for admin approval
3. Create a shop with /j:shop create while looking at a block
4. Open the shop chest and place items to sell
5. Set prices through the owner menu
6. Manage broadcasts, co-owners, and settings from the shop panel
7. Claim your earnings anytime

For Admins

1. Add the admin tag: /tag @s add admin
2. Open the admin panel using /j:shopadmin
3. Review seller applications and license appeals
4. Monitor transaction logs and player activity
5. Configure economy settings, broadcast rules, and shop limits
6. Teleport to reported shops for investigation

---

⚙️ Configuration

The addon uses a scoreboard named money as its default currency. Admins can customize:

Setting	Description
Currency Name	Display name for the currency (default: Coins)
Global Sales Tax	Percentage tax on all transactions (0–100%)
Max Shops per Player	Limit how many shops each player can create
Shop Creation Fee	Cost to create a new shop
Require Application	Toggle whether players must apply to sell
Broadcast Enabled	Turn global shop broadcasts on/off
Broadcast Intervals	Control timing for featured and basic broadcasts
Broadcast Price	Set the cost for featured shop promotions

---

📋 Requirements

• Minecraft Bedrock Edition 1.21.50 or newer
• Beta APIs enabled in world settings
• Operator permissions for admin features

---

📝 Changelog — v3.3.0

• ✅ Added Dual-Loop Broadcast System (Featured + Basic broadcasts)
• ✅ Added Broadcast Management Hub – pause, resume, and delete active boosts
• ✅ Added Featured Item Price Display in broadcast messages
• ✅ Added Online Player Selection for adding co-owners
• ✅ Added Visual UI Restrictions – restricted buttons show clear indicators for co-owners
• ✅ Improved Grouped Premium Alerts – up to 3 shops per broadcast message
• ✅ Improved Owner Menu UX – formatted grid layout with disabled slot styling
• ✅ Added License Appeal System for revoked sellers
• ✅ Added Shop Relocation – move shops without losing data

---

🔗 Links

Need help or want updates? Reach out anytime!

• Discord: https://discord.com/invite/CtKukG3Jeu
• YouTube: https://www.youtube.com/@JMAFKBedrock

---

🐛 Support

Found a bug or have a feature suggestion? Join the Discord server or leave a comment — feedback is always welcome and appreciated.

---

Build your economy. Grow your server. Enjoy the experience! 🏪✨