简易商店模组

简易商店模组

添加一个NPC，让你可以与其他玩家交易任何你想要的东西。

经济

简易商店模组预览查看大图

📦 Easy-Shop-Mod – 官方说明

🎯 概述

Easy-Shop-Mod 在 Minecraft 中引入了完整的玩家驱动交易系统，允许每位玩家使用自定义 NPC（村民）创建和管理自己的个人商店。

其他玩家可以与这些商店互动，根据店主定义的报价浏览并购买物品，在游戏世界中创造无缝且沉浸式的交易体验。

📥 下载 / 源码

👉 GitHub 仓库

  • Yarn 版本（V5.0.0）：

    这是最后一个使用 Yarn 映射的稳定版本。

  • 官方映射版本（从 V6.7.2+ 开始）：

    从版本 V6.7.2 及更高版本开始，该模组已完全迁移到官方映射。 这些版本旨在：

    • 确保与**更新的 Minecraft 版本（1.21.11 之后）**兼容
    • 提供更好的长期支持和可维护性

⚙️ 核心功能

  • 使用专用 NPC 创建个人商店
  • 玩家对玩家交易系统
  • 高级商店管理（添加 / 移除报价）
  • 已获得物品的持久存储系统
  • 多个直观的图形界面
  • 完全同步的客户端-服务器系统

/shop create （旧版中为 /create_shop）

旧版

  • Minecraft 1.21.11 → Easy Shop Mod v7.1.7 及更早版本
  • Minecraft 26.1.x → Easy Shop Mod v8.0.2 及更早版本

从上述旧版之后发布的版本开始，命令为 /shop create。

为玩家创建一个新商店。

  • 生成一个名为 [PlayerName]'s Shop 的 NPC
  • NPC 固定不动（AI 已禁用）
  • NPC 无法被伤害
  • 防止重复创建商店

/shop close （旧版中为 /close_shop）

旧版

  • Minecraft 1.21.11 → Easy Shop Mod v7.1.7 及更早版本
  • Minecraft 26.1.x → Easy Shop Mod v8.0.2 及更早版本

从上述旧版之后发布的版本开始，命令为 /shop close。

关闭当前商店并从世界中移除 NPC。

  • 所有商店报价均会保留。
  • 存储内容均会保留。
  • 该商店之后可以重新打开，不会丢失数据。

/shops

打开一个 UI，显示所有可用商店及其有效报价数量。

/shop recover

允许玩家恢复已删除商店中保存的所有物品。

可用版本：

  • Minecraft 1.21.11 → Easy Shop Mod v7.2.1 及更高版本
  • Minecraft 26.1.x → Easy Shop Mod v8.1.5 及更高版本
  • Minecraft 26.2 → Easy Shop Mod v9.0.0 及更高版本
  • Minecraft 26.3 及更新版本 → 未来的 Easy Shop Mod 版本将支持最新的 Minecraft 版本

将打开一个恢复窗口，其中包含：

  • 所有曾作为商店报价列出的物品。
  • 所有曾存储在商店 Storage 中的物品。

这可确保商店被删除后不会丢失任何物品。

👑 管理员命令

以下命令**仅限管理员（OP）**使用。

可用版本：

  • Minecraft 1.21.11 → Easy Shop Mod v7.2.1 及更高版本
  • Minecraft 26.1.x → Easy Shop Mod v8.1.5 及更高版本
  • Minecraft 26.2 → Easy Shop Mod v9.0.0 及更高版本
  • Minecraft 26.3 及更新版本 → 未来的 Easy Shop Mod 版本将支持最新的 Minecraft 版本

/shopadmin transfer <Old Owner Name> <New Owner Name>

将商店的所有权转移给另一位玩家。

要求：

  • 新所有者必须尚未拥有商店。
  • 如果新所有者之前拥有商店，则必须先将其删除。

当所有权转移时：

  • 所有商店报价均会转移。
  • 所有 Storage 内容均会转移。
  • 新所有者成为商店的完全所有者，并对其拥有完全控制权。

/shopadmin delete <Player Name>

删除指定玩家的商店。

此命令：

  • 永久移除商店及其 NPC。
  • 不会删除玩家的物品。
  • 商店报价和 Storage 中的所有物品均会保留，以便之后恢复。

👆 世界内交互

右键点击商店 NPC：

  • 所有者 → 打开商店管理界面
  • 其他玩家 → 打开商店购买界面

🌍 语言支持 — 从 v7.1.4+ 起可用

  • 为模组添加了完整的多语言支持。

  • 模组现在会根据游戏中所选语言实时自动更新其语言。

  • 🌐 支持的语言：

    • 🇬🇧 英语（en_us）
    • 🇫🇷 法语（fr_fr）
    • 🇪🇸 西班牙语（es_es）
    • 🇩🇪 德语（de_de）
    • 🇮🇹 意大利语（it_it）
    • 🇧🇷 葡萄牙语（pt_br）
    • 🇷🇺 俄语（ru_ru）
    • 🇨🇳 中文（zh_cn）
    • 🇯🇵 日语（ja_jp）

  • 🔁 从右到左（RTL）支持：

    • 🇸🇦 阿拉伯语（ar_sa）现已支持正确的 RTL 渲染。

🧑‍🖼️ 玩家皮肤要求（重要）

从以下版本开始：

  • Minecraft 1.21.11 → Easy Shop Mod v7.1.6 及更高版本
  • Minecraft 26.1.x → Easy Shop Mod v8.0.1 及更高版本
  • Minecraft 26.2 → Easy Shop Mod v9.0.0 及更高版本
  • Minecraft 26.3 及更新版本 → 未来的 Easy Shop Mod 版本将支持最新的 Minecraft 版本

为确保你的玩家头像在以下界面中正确显示：

  • Shops List (All)

你必须手动将皮肤文件放置在以下路径：

\config\Easy Shop Mod\My Skin

📏 皮肤要求

  • 皮肤必须为 .png 格式。
  • 分辨率必须恰好为 64×64。

🖼️ 行为

  • 如果皮肤放置正确 → 你的头像将对所有玩家正常显示。
  • 如果未找到皮肤 → 将使用默认的 Steve 头像。

📂 快速文件夹访问 （新增）

从以下版本开始：

  • Minecraft 1.21.11 → Easy Shop Mod v7.2.1 及更高版本
  • Minecraft 26.1.x → Easy Shop Mod v8.1.5 及更高版本
  • Minecraft 26.2 → Easy Shop Mod v9.0.0 及更高版本
  • Minecraft 26.3 及更新版本 → 未来的 Easy Shop Mod 版本将支持最新的 Minecraft 版本

如果未找到皮肤，聊天消息将显示路径：

\config\Easy Shop Mod\My Skin

点击聊天中的此路径将自动打开 My Skin 文件夹，让你可以快速将皮肤文件放置到正确位置。

注意： 此可点击的文件夹快捷方式仅在上述版本中可用。

⚠️ 在这些版本中，此系统是正确渲染头像所必需的。

🖥️ 用户界面

🧩 店主界面

允许完全控制商店：

  • 添加出售物品
  • 设置价格
  • 查看和管理报价
  • 移除报价
  • 访问存储
  • 商店移动 — 从 v7.1.4+ 起可用

🎒 物品栏选择

让玩家从自己的物品栏中选择要出售的物品。

🔎 物品选择器

用于选择游戏中任意物品作为价格：

  • 搜索功能
  • 多页导航
  • 支持所有带等级的附魔书

🔢 数量输入

允许指定价格所需的数量。

🛒 买家界面

简单且用户友好的界面：

  • 浏览可用报价
  • 选择报价
  • 执行购买

📦 存储界面

显示从交易中收到的所有物品：

  • 自动存储付款
  • 所有者可随时取回物品

💾 数据系统

ShopData

  • 所有者名称
  • 交易列表
  • 存储内容

ShopTrade

  • 正在出售的物品
  • 所需物品（价格）

ShopManager

  • 全局处理所有商店
  • 持久保存数据
  • 存储 NPC UUID
  • 数据保存在世界文件中

🌐 网络系统

该模组使用结构化数据包系统来同步数据：

  • 添加 / 移除交易
  • 执行购买
  • 打开界面
  • 实时同步商店数据

🔒 安全与验证

  • NPC 无法被杀死
  • NPC 移动已禁用
  • 编辑时进行所有权验证
  • 完成交易前进行物品验证

📊 概要

  • 3 个命令
  • 8 个用户界面
  • 完全持久化的数据系统
  • 基于玩家的经济
  • 流畅直观的 UI
  • 多人游戏交易支持

✅ 结论

Easy-Shop-Mod 提供了一个强大且用户友好的交易系统，增强了 Minecraft 中的多人互动。玩家可以轻松创建、管理和与商店互动，使游戏内交易更加动态和有趣。