📦 Shop-Mod – Official Description

🎯 Overview

Shop-Mod introduces a complete player-driven trading system in Minecraft, allowing each player to create and manage their own personal shop using a custom NPC (villager).

Other players can interact with these shops to browse and purchase items based on offers defined by the shop owner, creating a seamless and immersive trading experience within the game world.

⚙️ Core Features

• Create a personal shop using a dedicated NPC
• Player-to-player trading system
• Advanced shop management (add / remove offers)
• Persistent storage system for earned items
• Multiple intuitive graphical interfaces
• Fully synchronized client-server system

📜 Commands

/create_shop

Creates a new shop for the player.

• Spawns an NPC named [PlayerName]'s Shop
• NPC is stationary (AI disabled)
• NPC is invulnerable
• Prevents duplicate shop creation

/close_shop

Closes the current shop and removes the NPC from the world. All data (offers and storage) remains.

/shops

Opens a UI that displays a list of all available shops along with the number of active offers.

👆 In-World Interaction

Right-clicking the shop NPC:

• Owner → Opens shop management interface
• Other players → Opens shop purchase interface

🖥️ User Interfaces

🧩 Shop Owner Interface

Allows full control over the shop:

• Add items for sale
• Set prices
• View and manage offers
• Remove offers
• Access storage

🎒 Inventory Selection

Lets the player choose items from their inventory to sell.

🔎 Item Picker

Used to select any item in the game as a price:

• Search functionality
• Multi-page navigation
• Supports all enchanted books with levels

🔢 Amount Input

Allows specifying the quantity required for the price.

🛒 Buyer Interface

Simple and user-friendly interface:

• Browse available offers
• Select an offer
• Execute purchase

📦 Storage Interface

Displays all items received from trades:

• Automatically stores payments
• Owner can retrieve items anytime

💾 Data System

ShopData

• Owner name
• List of trades
• Storage contents

ShopTrade

• Item being sold
• Required item (price)

ShopManager

• Handles all shops globally
• Saves data persistently
• Stores NPC UUIDs
• Data saved in world files

🌐 Network System

The mod uses a structured packet system to synchronize data:

• Add / remove trades
• Execute purchases
• Open interfaces
• Sync shop data in real-time

🔒 Security & Validation

• NPC cannot be killed
• NPC movement is disabled
• Ownership verification for editing
• Item validation before completing trades

📊 Summary

• 3 Commands
• 7 User Interfaces
• Fully persistent data system
• Player-based economy
• Smooth and intuitive UI
• Multiplayer trading support

✅ Conclusion

Shop-Mod provides a robust and user-friendly trading system that enhances multiplayer interaction in Minecraft. Players can easily create, manage, and interact with shops, making in-game trading more dynamic and engaging.