PhysicShop

🏪 PhysicShop - Advanced Shop System for Minecraft

<div align="center">

A comprehensive, immersive shopping experience plugin for Minecraft servers

Features • Commands • Installation • Configuration

</div>

---

📋 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

- 🌍 Auto-Expansion - Isolated void world with custom generation - 🏢 Auto-Expansion - Automatic floor creation with configurable layouts - 🎨 Auto-Expansion - Beautiful pre-built shops with smooth stone floors, blackstone ceilings, and quartz walls - 🚪 Auto-Expansion - 4x3 entrance with glass panels for visibility - 🔄 Auto-Expansion - New floors automatically generated when all shops are sold

💰 Economy Integration

- 💳 Transaction Tracking - Full integration with any Vault-compatible economy plugin - 💵 Transaction Tracking - Set shop purchase prices and refund percentages - 🏦 Transaction Tracking - Get money back when selling your shop (configurable percentage) - 📊 Transaction Tracking - Complete buy/sell history for shops

🛒 Trading System

- 📝 Smart Validation - Create `[Buy]` and `[Sell]` signs on chests - 📦 Smart Validation - Configure item quantities (1-64 per transaction) - 💱 Smart Validation - Support for both European (comma) and US (dot) decimal formats - 🔔 Smart Validation - Shop owners receive instant alerts on transactions - ✅ Smart Validation - Automatic checks for stock, space, and funds

⭐ Rating System

- 🌟 Auto-Reset - Let customers rate shops from 1 to 5 stars - 📈 Auto-Reset - Browse the best shops sorted by rating - 📊 Auto-Reset - View rating distribution and averages - 🏆 Auto-Reset - See top-performing shops - 💬 Auto-Reset - Get notified when someone rates your shop - 🔄 Auto-Reset - Ratings cleared when shop changes ownership

🎮 User Interface

- 🖼️ Pagination - Intuitive menus for all interactions - 📱 Pagination - Central hub for all features - 🏬 Pagination - Manage all your owned shops - 🗺️ Pagination - Navigate between floors with shop availability info - ⚡ Pagination - Teleport, rate, buy, and sell with simple clicks - 📄 Pagination - Smooth navigation through large shop lists (45 shops per page)

🔒 Protection System

- 🛡️ Admin Override - Only owners can build in their shops - 🚫 Admin Override - Prevent unauthorized modifications - 🔐 Admin Override - Lock chests, furnaces, and all containers - 🎯 Admin Override - Secure item frames, armor stands, and paintings - 🚪 Admin Override - Protected doors, buttons, and levers - 👑 Admin Override - Configurable admin permissions for management

⚙️ Configuration

- 📝 Data Persistence - Fully customizable messages in `messages.yml` - 🎨 Data Persistence - Full color code support (`&a`, `&c`, etc.) - 🌐 Data Persistence - Easy translation support - 🔧 Data Persistence - Configure shop size, prices, limits, and more - 📊 Data Persistence - Set maximum shops per player - 💾 Data Persistence - All data saved in organized YAML files

🏃 Performance

- ⚡ Lightweight - Efficient world and shop creation - 💾 Lightweight - Reduced database queries - 🔄 Lightweight - Non-blocking shop operations - 📦 Lightweight - Minimal server impact

---

📜 Commands & Permissions

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/physicshop` or `/ps` | Open main menu | None | | `/ps create` | Create a new floor | `physicshop.admin.create` | | `/ps delete <id>` | Delete a floor | `physicshop.admin.delete` | | `/ps tp <id>` | Teleport to a floor | `physicshop.teleport` | | `/ps list` | List all floors | `physicshop.list` | | `/ps info <id>` | View floor information | `physicshop.info` | | `/ps myshops` | View your owned shops | None | | `/ps sell <id>` | Sell one of your shops | None | | `/ps menu` | Reopen main menu | None |

Permissions

| Permission | Description | Default | |------------|-------------|---------| | `physicshop.*` | All permissions | OP | | `physicshop.admin.*` | All admin permissions | OP | | `physicshop.user.*` | All user permissions | All Players | | `physicshop.admin.create` | Create floors | OP | | `physicshop.admin.delete` | Delete floors | OP | | `physicshop.admin.build` | Build anywhere in PhysicShop world | OP | | `physicshop.teleport` | Teleport to floors | All Players | | `physicshop.list` | List all floors | All Players | | `physicshop.info` | View floor info | All Players |

---

🎯 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 ```bash 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`

```yaml

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: ```yaml 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

---

<div align="center">

⭐ If you enjoy PhysicShop, please star this project!

Made with 🔥 by LeGarri

</div>