🏪 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
- Create a new world or edit an existing one
- Open the Experiments tab
- Enable Beta APIs (required for Script API)
Step 2: Apply Packs
- Download the addon (
.mcaddon or .mcpack)
- Import it into Minecraft
- 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
- Find a shop chest in the world or open
/j:shop market
- Browse available items and select what you want
- Choose the quantity and confirm the purchase
- The item is delivered to your inventory instantly
For Sellers
- Apply to become a seller using
/j:shop apply
- Wait for admin approval
- Create a shop with
/j:shop create while looking at a block
- Open the shop chest and place items to sell
- Set prices through the owner menu
- Manage broadcasts, co-owners, and settings from the shop panel
- Claim your earnings anytime
For Admins
- Add the admin tag:
/tag @s add admin
- Open the admin panel using
/j:shopadmin
- Review seller applications and license appeals
- Monitor transaction logs and player activity
- Configure economy settings, broadcast rules, and shop limits
- 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!
🐛 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! 🏪✨
