# \ud83c\udfea PhysicShop – Advanced Shop System for Minecraft<\/p>\n
\n
\n<\/p>\n
**A comprehensive, immersive shopping experience plugin for Minecraft servers**<\/p>\n
[Features](#-features) \u2022 [Commands](#-commands–permissions) \u2022 [Installation](#-installation) \u2022 [Configuration](#-configuration)<\/p>\n<\/div>\n
—<\/p>\n
## \ud83d\udccb Overview<\/p>\n
**PhysicShop** transforms your Minecraft server into a thriving marketplace where players can own, customize, and operate their own physical shops. Built with performance and user experience in mind, this plugin offers an intuitive GUI-based system combined with powerful features for both shop owners and customers.
\n
\n
\n
\n<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfd7\ufe0f **Dynamic Shop System**
\n– \ud83c\udf0d **Dedicated Shopping World** – Isolated void world with custom generation
\n– \ud83c\udfe2 **Multi-Floor Architecture** – Automatic floor creation with configurable layouts
\n– \ud83c\udfa8 **Modern Shop Design** – Beautiful pre-built shops with smooth stone floors, blackstone ceilings, and quartz walls
\n– \ud83d\udeaa **Glass Storefronts** – 4×3 entrance with glass panels for visibility
\n– \ud83d\udd04 **Auto-Expansion** – New floors automatically generated when all shops are sold<\/p>\n
### \ud83d\udcb0 **Economy Integration**
\n– \ud83d\udcb3 **Vault Support** – Full integration with any Vault-compatible economy plugin
\n– \ud83d\udcb5 **Configurable Pricing** – Set shop purchase prices and refund percentages
\n– \ud83c\udfe6 **Partial Refunds** – Get money back when selling your shop (configurable percentage)
\n– \ud83d\udcca **Transaction Tracking** – Complete buy\/sell history for shops<\/p>\n
### \ud83d\uded2 **Trading System**
\n– \ud83d\udcdd **Sign-Based Trading** – Create `[Buy]` and `[Sell]` signs on chests
\n– \ud83d\udce6 **Bulk Trading** – Configure item quantities (1-64 per transaction)
\n– \ud83d\udcb1 **Flexible Pricing** – Support for both European (comma) and US (dot) decimal formats
\n– \ud83d\udd14 **Real-Time Notifications** – Shop owners receive instant alerts on transactions
\n– \u2705 **Smart Validation** – Automatic checks for stock, space, and funds<\/p>\n
### \u2b50 **Rating System**
\n– \ud83c\udf1f **5-Star Rating** – Let customers rate shops from 1 to 5 stars
\n– \ud83d\udcc8 **Top Rated Shops** – Browse the best shops sorted by rating
\n– \ud83d\udcca **Rating Analytics** – View rating distribution and averages
\n– \ud83c\udfc6 **Leaderboard** – See top-performing shops
\n– \ud83d\udcac **Owner Notifications** – Get notified when someone rates your shop
\n– \ud83d\udd04 **Auto-Reset** – Ratings cleared when shop changes ownership<\/p>\n
### \ud83c\udfae **User Interface**
\n– \ud83d\uddbc\ufe0f **Beautiful GUIs** – Intuitive menus for all interactions
\n– \ud83d\udcf1 **Main Menu** – Central hub for all features
\n– \ud83c\udfec **My Shops** – Manage all your owned shops
\n– \ud83d\uddfa\ufe0f **Floor Browser** – Navigate between floors with shop availability info
\n– \u26a1 **Quick Actions** – Teleport, rate, buy, and sell with simple clicks
\n– \ud83d\udcc4 **Pagination** – Smooth navigation through large shop lists (45 shops per page)<\/p>\n
### \ud83d\udd12 **Protection System**
\n– \ud83d\udee1\ufe0f **Shop Ownership** – Only owners can build in their shops
\n– \ud83d\udeab **Block Protection** – Prevent unauthorized modifications
\n– \ud83d\udd10 **Container Security** – Lock chests, furnaces, and all containers
\n– \ud83c\udfaf **Entity Protection** – Secure item frames, armor stands, and paintings
\n– \ud83d\udeaa **Interaction Control** – Protected doors, buttons, and levers
\n– \ud83d\udc51 **Admin Override** – Configurable admin permissions for management<\/p>\n
### \u2699\ufe0f **Configuration**
\n– \ud83d\udcdd **Messages System** – Fully customizable messages in `messages.yml`
\n– \ud83c\udfa8 **Color Support** – Full color code support (`&a`, `&c`, etc.)
\n– \ud83c\udf10 **Multi-Language Ready** – Easy translation support
\n– \ud83d\udd27 **Flexible Settings** – Configure shop size, prices, limits, and more
\n– \ud83d\udcca **Shop Limits** – Set maximum shops per player
\n– \ud83d\udcbe **Data Persistence** – All data saved in organized YAML files<\/p>\n
### \ud83c\udfc3 **Performance**
\n– \u26a1 **Optimized Generation** – Efficient world and shop creation
\n– \ud83d\udcbe **Smart Caching** – Reduced database queries
\n– \ud83d\udd04 **Async Operations** – Non-blocking shop operations
\n– \ud83d\udce6 **Lightweight** – Minimal server impact<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands & Permissions<\/p>\n
### Commands<\/p>\n
| Command | Description | Permission | ### Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \ud83c\udfaf How It Works<\/p>\n ### \ud83c\udfea **For Shop Owners**<\/p>\n 1. **Purchase a Shop** 2. **Build Your Shop** 3. **Set Up Trading** 4. **Manage Your Empire** ### \ud83d\udecd\ufe0f **For Customers**<\/p>\n 1. **Browse Shops** 2. **Shop & Trade** 3. **Rate Your Experience** —<\/p>\n ## \ud83d\udd27 Installation<\/p>\n 1. **Requirements** 2. **Install** 3. **First Setup** —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n ### `config.yml` # Corridor settings # Economy ### `messages.yml`<\/p>\n Fully customizable messages with color codes: **Example:** —<\/p>\n ## \ud83c\udfa8 Customization<\/p>\n ### Trade Signs<\/p>\n Create unlimited trading possibilities: —<\/p>\n ## \ud83d\udcca Data Storage<\/p>\n All data stored in organized YAML files: —<\/p>\n ## \ud83d\udcdd License<\/p>\n This plugin is proprietary software. All rights reserved.<\/p>\n —<\/p>\n ## \ud83d\ude4f Credits<\/p>\n Built with \u2764\ufe0f for the Minecraft community<\/p>\n **Dependencies:** —<\/p>\n ### \u2b50 If you enjoy PhysicShop, please star this project!<\/p>\n **Made with \ud83d\udd25 by LeGarri**<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" Transform your server into a thriving economy with physical shops, real-time trading, and player ratings<\/p>\n","protected":false},"featured_media":121071,"template":"","meta":{"_minecraft_slug":"physicshop","_minecraft_project_id":"EHkWeQI2","_minecraft_author":"LeGarri","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":42,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"physicshop.zip","_minecraft_size_bytes":61805,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:32:01.461097Z","_minecraft_date_created":"2026-01-24T22:12:09.618823Z","_minecraft_date_modified":"2026-01-19T10:19:40.297942Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/physicshop","_minecraft_icon_attachment_id":121071,"_minecraft_imported_at":"2026-06-07T02:55:30+00:00","_minecraft_import_hash":"68dfbfbaae2126032e10ecfc2424de7f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-121070","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/physicshop` or `\/ps` | Open main menu | None |
\n| `\/ps create` | Create a new floor | `physicshop.admin.create` |
\n| `\/ps delete
\n| `\/ps tp
\n| `\/ps list` | List all floors | `physicshop.list` |
\n| `\/ps info
\n| `\/ps myshops` | View your owned shops | None |
\n| `\/ps sell
\n| `\/ps menu` | Reopen main menu | None |<\/p>\n
\n|————|————-|———|
\n| `physicshop.*` | All permissions | OP |
\n| `physicshop.admin.*` | All admin permissions | OP |
\n| `physicshop.user.*` | All user permissions | All Players |
\n| `physicshop.admin.create` | Create floors | OP |
\n| `physicshop.admin.delete` | Delete floors | OP |
\n| `physicshop.admin.build` | Build anywhere in PhysicShop world | OP |
\n| `physicshop.teleport` | Teleport to floors | All Players |
\n| `physicshop.list` | List all floors | All Players |
\n| `physicshop.info` | View floor info | All Players |<\/p>\n
\n – Right-click on a “FOR SALE” sign in any shop
\n – Confirm purchase in the GUI
\n – Shop is instantly yours!<\/p>\n
\n – Place blocks, chests, and decorations inside
\n – Your shop, your rules!
\n – Protected from other players<\/p>\n
\n – Place a chest with items
\n – Attach a sign to the chest
\n – Write:
\n“`
\n [Sell] or [Buy]
\n 16 (quantity)
\n 10.50 (price)
\n (auto-filled item name)
\n“`<\/p>\n
\n – View all shops: `\/ps myshops`
\n – Teleport instantly to any shop
\n – Track your ratings and reputation<\/p>\n
\n – Open menu: `\/ps`
\n – View “Top Rated Shops” \u2b50
\n – Filter by floor or rating<\/p>\n
\n – Right-click trade signs to buy\/sell
\n – Instant transactions
\n – Safe and secure<\/p>\n
\n – Right-click any shop in Top Rated GUI
\n – Give 1-5 stars
\n – Help others find the best shops!<\/p>\n
\n – Spigot\/Paper 1.21+
\n – Vault
\n – Economy plugin (EssentialsX, CMI, etc.)<\/p>\n
\n“`bash
\n 1. Download PhysicShop.jar
\n 2. Place in \/plugins\/ folder
\n 3. Restart server
\n 4. Configure config.yml and messages.yml
\n 5. Reload or restart
\n“`<\/p>\n
\n – First floor is auto-created on startup
\n – Default world: `PhysicShopWorld`
\n – Access via `\/ps` command<\/p>\n
\n“`yaml
\n# Shop dimensions
\nshop-size:
\n length: 10 # Length along corridor (X axis)
\n width: 10 # Depth away from corridor (Z axis)
\n height: 5 # Height of the shop<\/p>\n
\ncorridor-length: 50 # Total corridor length<\/p>\n
\nshop-price: 1000.0 # Purchase price
\nshop-refund-percentage: 50.0 # Refund on sell (0-100)
\nmax-shop-per-player: 3 # Max shops per player
\n“`<\/p>\n
\n– All player messages
\n– GUI titles and descriptions
\n– Error messages
\n– Success notifications<\/p>\n
\n“`yaml
\nshop:
\n purchased: “&aSuccessfully purchased shop #{id}!”
\n purchase-price: “&7Price: &6${price}”
\n“`<\/p>\n
\n– Buy signs (shop purchases from players)
\n– Sell signs (shop sells to players)
\n– Custom quantities
\n– Flexible pricing<\/p>\n
\n– `data.yml` – Shop ownership, coordinates, ratings
\n– `messages.yml` – All text and messages
\n– `config.yml` – Plugin configuration<\/p>\n
\n– Vault
\n– Spigot\/Paper<\/p>\n