PhysicShop

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

? PhysicShop - Advanced Shop System for Minecraft

? Overview

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.

✨ Features

?️ Dynamic Shop System

• ? Dedicated Shopping World - Isolated void world with custom generation
• ? Multi-Floor Architecture - Automatic floor creation with configurable layouts
• ? Modern Shop Design - Beautiful pre-built shops with smooth stone floors, blackstone ceilings, and quartz walls
• ? Glass Storefronts - 4x3 entrance with glass panels for visibility
• ? Auto-Expansion - New floors automatically generated when all shops are sold

? Economy Integration

• ? Vault Support - Full integration with any Vault-compatible economy plugin
• ? Configurable Pricing - Set shop purchase prices and refund percentages
• ? Partial Refunds - Get money back when selling your shop (configurable percentage)
• ? Transaction Tracking - Complete buy/sell history for shops

? Trading System

• ? Sign-Based Trading - Create [Buy] and [Sell] signs on chests
• ? Bulk Trading - Configure item quantities (1-64 per transaction)
• ? Flexible Pricing - Support for both European (comma) and US (dot) decimal formats
• ? Real-Time Notifications - Shop owners receive instant alerts on transactions
• ✅ Smart Validation - Automatic checks for stock, space, and funds

⭐ Rating System

• ? 5-Star Rating - Let customers rate shops from 1 to 5 stars
• ? Top Rated Shops - Browse the best shops sorted by rating
• ? Rating Analytics - View rating distribution and averages
• ? Leaderboard - See top-performing shops
• ? Owner Notifications - Get notified when someone rates your shop
• ? Auto-Reset - Ratings cleared when shop changes ownership

? User Interface

• ?️ Beautiful GUIs - Intuitive menus for all interactions
• ? Main Menu - Central hub for all features
• ? My Shops - Manage all your owned shops
• ?️ Floor Browser - Navigate between floors with shop availability info
• ⚡ Quick Actions - Teleport, rate, buy, and sell with simple clicks
• ? Pagination - Smooth navigation through large shop lists (45 shops per page)

? Protection System

• ?️ Shop Ownership - Only owners can build in their shops
• ? Block Protection - Prevent unauthorized modifications
• ? Container Security - Lock chests, furnaces, and all containers
• ? Entity Protection - Secure item frames, armor stands, and paintings
• ? Interaction Control - Protected doors, buttons, and levers
• ? Admin Override - Configurable admin permissions for management

⚙️ Configuration

• ? Messages System - Fully customizable messages in messages.yml
• ? Color Support - Full color code support (&a, &c, etc.)
• ? Multi-Language Ready - Easy translation support
• ? Flexible Settings - Configure shop size, prices, limits, and more
• ? Shop Limits - Set maximum shops per player
• ? Data Persistence - All data saved in organized YAML files

? Performance

• ⚡ Optimized Generation - Efficient world and shop creation
• ? Smart Caching - Reduced database queries
• ? Async Operations - Non-blocking shop operations
• ? Lightweight - Minimal server impact

? Commands & Permissions

Commands

Permissions

? How It Works

? For Shop Owners

1. Purchase a Shop

   • Right-click on a "FOR SALE" sign in any shop
   • Confirm purchase in the GUI
   • Shop is instantly yours!

2. Build Your Shop

   • Place blocks, chests, and decorations inside
   • Your shop, your rules!
   • Protected from other players

3. Set Up Trading

   • Place a chest with items
   • Attach a sign to the chest
   • Write:

     [Sell]  or  [Buy]
     16      (quantity)
     10.50   (price)
     (auto-filled item name)

4. Manage Your Empire

   • View all shops: /ps myshops
   • Teleport instantly to any shop
   • Track your ratings and reputation

?️ For Customers

1. Browse Shops

   • Open menu: /ps
   • View "Top Rated Shops" ⭐
   • Filter by floor or rating

2. Shop & Trade

   • Right-click trade signs to buy/sell
   • Instant transactions
   • Safe and secure

3. Rate Your Experience

   • Right-click any shop in Top Rated GUI
   • Give 1-5 stars
   • Help others find the best shops!

? Installation

1. Requirements

   • Spigot/Paper 1.21+
   • Vault
   • Economy plugin (EssentialsX, CMI, etc.)

2. Install

   1. Download PhysicShop.jar
   2. Place in /plugins/ folder
   3. Restart server
   4. Configure config.yml and messages.yml
   5. Reload or restart

3. First Setup

   • First floor is auto-created on startup
   • Default world: PhysicShopWorld
   • Access via /ps command

⚙️ Configuration

config.yml

# Shop dimensions
shop-size:
  length: 10   # Length along corridor (X axis)
  width: 10    # Depth away from corridor (Z axis)
  height: 5    # Height of the shop

# Corridor settings
corridor-length: 50  # Total corridor length

# Economy
shop-price: 1000.0              # Purchase price
shop-refund-percentage: 50.0    # Refund on sell (0-100)
max-shop-per-player: 3          # Max shops per player

messages.yml

Fully customizable messages with color codes:

• All player messages
• GUI titles and descriptions
• Error messages
• Success notifications

Example:

shop:
  purchased: "&aSuccessfully purchased shop #{id}!"
  purchase-price: "&7Price: &6${price}"

? Customization

Trade Signs

Create unlimited trading possibilities:

• Buy signs (shop purchases from players)
• Sell signs (shop sells to players)
• Custom quantities
• Flexible pricing

? Data Storage

All data stored in organized YAML files:

• data.yml - Shop ownership, coordinates, ratings
• messages.yml - All text and messages
• config.yml - Plugin configuration

? License

This plugin is proprietary software. All rights reserved.

? Credits

Built with ❤️ for the Minecraft community

Dependencies:

• Vault
• Spigot/Paper