Pomelo’s Shop

A feature-rich in-game shop mod for minecraft, allowing players to buy and sell items through a graphical interface with a built-in currency system!!!

Features

• Graphical Shop Interface — Browse items across categories with an intuitive GUI.
• Player Trading — Players can list their own items for sale and set both buy,sell prices, quantity, and inventory for buying and selling goods. All changes sync to all online players.
• Currency System — Built-in per-player money, stored persistently.
• Key Binding — Quick shop access with the “N” key, customizable in controls settings.
• Category Management — Create, delete, and manage shop categories, right-click to edit category name,parent-child category hierarchy support.
• Item Banning — Admins can ban specific items from being listed
• Configurable Permissions — Toggle which actions require admin privileges
• Item Copy & Paste — Copy item info with Ctrl+C while hovering，paste item to current category with Ctrl+V or pasted items added at the end of category.Copies all item properties: item, prices, stock.
• Bilingual Support — Full Chinese and English translationuts
• Auto-Save — Automatic data persistence every 5 seconds, shop data saved to world directory.Reliable data recovery on server restart.
• Item Display — Price display overlay on items (buy/sell prices).
• Shop Data Import/Export — Export /shop export Import /shop import . Exported files are saved in /shop exports/.json.
• Category Sorting and Edit — Move Up /shop category moveup . Move Down /shop category movedown .Right mouse button to edit name.

Hotkey

| Hotkey |Description |
| ———- |——————————————— |
| Default: N |Open shop (configurable in Controls settings) |

Player Commands

| Command |Description |Example |
| ——————————————————————————- |————————– |———————————– |
| /shop(This command does not exist in the 1.20.1 Forge version. Please press N.) |Open shop interface |/shop |
| /shop balance |Check current balance |/shop balance |
| /shop sell <price> [amount] |List item in hand for sale |/shop sell 100 or /shop sell 100 64 |
| /shop category create <ID> <name> |Create a new category |/shop category create blocks Blocks |
| /shop category list |List all categories |/shop category list |

Admin Commands (Requires Permission Level 2)

| Command |Description |Example |
| —————————————– |—————————— |———————————————– |
| /shop add <player> <amount> |Add money to player’s balance |/shop add Steve 1000 |
| /shop set <player> <amount> |Set player’s balance |/shop set Steve 5000 |
| /shop reload |Reload shop data |/shop reload |
| /shop clear |Clear all shop items |/shop clear |
| /shop category moveup <category_name> |Move category up in order |/shop category moveup Blocks |
| /shop category movedown <category_name> |Move category down in order |/shop category movedown Blocks |
| /shop category setparent <child> <parent> |Set category’s parent category |/shop category setparent “ChildName” ParentName |
| /shop category setparent <child> none |Remove category’s parent |/shop category setparent “ChildName” none |
| /shop ban <item_id> |Ban an item from being listed |/shop ban minecraft:bedrock |
| /shop unban <item_id> |Unban a previously banned item |/shop unban minecraft:bedrock |
| /shop banlist |View list of banned items |/shop banlist |
| /shop export <filename> |Export shop data to JSON |/shop export shop_backup |
| /shop import <filename> |Import shop data from JSON |/shop import shop_backup |

Shop Interface Controls

| Action |Description |
| ———————— |———————————————————————– |
| Left Click Item |Buy item(cannot buy if stock is 0) |
| Right Click Item |Sell 1 item(stock +1 after selling) |
| Shift + Right Click Item |Batch sell (sell all of that item in inventory,(stock +1 after selling) |
| Ctrl + Right Click Item |Delete your own listing |
| Shift + Left Click Item |Edit your own listing (amount, price, category, stock) |
| Ctrl + C (hover on item) |Copy item |
| Ctrl + V |Paste item to current category (added at the end) |