📦 Easy-Shop-Mod – Official Description

🎯 Overview

Easy-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.

---

📥 Download / Source

👉 GitHub Repository

• Yarn Version (V5.0.0):

  This is the last stable release using Yarn mappings.

• Official Mapping Versions (Starting from V6.7.2+):

  Beginning from version V6.7.2 and above, the mod has been fully migrated to Official Mappings.
  These versions are designed to:

  • Ensure compatibility with newer Minecraft versions (beyond 1.21.11)
  • Provide better long-term support and maintainability

• Future Support:
  Forge support will be added to ensure the mod works on both Fabric and Forge platforms.

---

⚙️ 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

---

🌍 Language Support — Available from v7.1.4+

• Added full multi-language support to the mod.

• The mod now automatically updates its language based on the game's selected language in real-time.

• 🌐 Supported Languages:

  • 🇬🇧 English (en_us)
  • 🇫🇷 French (fr_fr)
  • 🇪🇸 Spanish (es_es)
  • 🇩🇪 German (de_de)
  • 🇮🇹 Italian (it_it)
  • 🇧🇷 Portuguese (pt_br)
  • 🇷🇺 Russian (ru_ru)
  • 🇨🇳 Chinese (zh_cn)
  • 🇯🇵 Japanese (ja_jp)

• 🔁 Right-to-Left (RTL) Support:

  • 🇸🇦 Arabic (ar_sa) is now supported with proper RTL rendering.

---

🧑‍🖼️ Player Skin Requirement (Important)

Starting from:

• Minecraft 1.21.11 → Easy Shop Mod v7.1.6 and above

• Minecraft 26.1.x → Easy Shop Mod v8.0.1 and above

• To ensure that your player face appears correctly in:

  • Shops List (All)

• You must manually place your skin file in the following path:

\config\Easy Shop Mod\My Skin

• 📏 Skin Requirements:

  • The skin must be in .png format
  • Resolution must be exactly: 64×64

• 🖼️ Behavior:

  • If the skin is placed correctly → your face will appear normally to all players
  • If no skin is found → the default Steve face will be used

• ⚠️ This system is required for proper face rendering in these versions.

---

🖥️ 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
• Shop Move — Available from v7.1.4+

---

🎒 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-blocked:

• 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

Easy-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.