PhysicShop

# 🏪 PhysicShop - Advanced Shop System for Minecraft <div align="center"> !(https://img.shields.io/badge/version-1.0.0-blue.svg) !(https://img.shields.io/badge/minecraft-1.21-brightgreen.svg) !(https://img.shields.io/badge/spigot-compatible-orange.svg) **A comprehensive, immersive shopping experience plugin for Minecraft servers** (#-features) • (#-commands--permissions) • (#-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. !(https://cdn.modrinth.com/data/cached_images/5ec8df3ac34a629a3d31c1d30cb1e96cd27c6956.png) !(https://cdn.modrinth.com/data/cached_images/156195cd5625ad996bd87243b5995ae16b6a9afa.png) !(https://cdn.modrinth.com/data/cached_images/b39a8ba40583524adf7bf95c7899ba96217eb769.png) !(https://cdn.modrinth.com/data/cached_images/5b3b1bccfe18d37595490ad3382d2e057c8ebcf0.png) --- ## ✨ 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 `` and `` 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 | 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 s