EconomyShopGUI 服务器GUI商店插件

EconomyShopGUI (ESGUI)

Minecraft 服务器 GUI 商店插件，玩家通过箱子式菜单点击物品即可向服务器购买 / 出售物品。所有商品、分类均可通过游戏内命令增删改，无需手改配置文件、无需重启服务器。

免费版：功能完整，可长期免费使用，SpigotMC / BukkitDev / Polymart 下载
付费版：在免费版基础上解锁高级功能，SpigotMC / Polymart / gpplugins.com 购买
地址2为付费版，积分解锁下载jar直接就能使用。
下载链接1为官方下载地址，有免费版也有付费。
下载地址2为付费版jar，本人购买并获得了此插件的授权jar网盘地址，收取部分积分不过分吧。
请看清楚支持的范围，我不负责处理问题。
发布之前，已经确认过插件和付费相关内容可以正常使用。

版本与兼容性

| 项目 | 说明 |
| :--- | :--- |
| 服务端 | Bukkit / Spigot / Paper（官方明确不支持 mod/hybrid 服务端） |
| Minecraft 版本 | 1.8.x – 最新版（v7.x 起不再支持 1.16.3 及以下；旧版请用 v6.16.4） |
| Java | 视对应 MC 版本要求而定 |
| 经济依赖（必装其一） | Vault（+Essentials 等经济插件）/ PlayerPoints / CoinsEngine / GemsEconomy / UltraEconomy / VotingPlugin |
| 可选依赖 | PlaceholderAPI、DiscordSRV、GeyserMC/Floodgate（基岩版支持） |

功能对比：免费版 vs 付费版
两者共有（免费版全部包含）
游戏内命令增删改商品与分类，无需配置文件、无需重启
无限商品数量、无限分页、支持子分类
多货币：可按分区或按商品设置不同货币
折扣与出售倍率：通过权限节点为不同玩家组设置
季节性定价：按季节为商品或整店设置价格修正
不安全附魔：可超出默认等级上限附魔
多经济插件兼容（Vault / PlayerPoints / GemsEconomy / UltraEconomy 等）
第三方刷怪笼兼容（10+ 款主流刷怪笼插件）
NPC 商店、实体商店（ShopStands）
DiscordSRV 钩子：交易实时推送到 Discord 频道
基岩版玩家支持（GeyserMC / Floodgate）
PlaceholderAPI 扩展：100+ 占位符组合
19+ 种语言文件，所有消息可自定义
每版本默认商店配置 + 社区市场预设布局
100% 自定义物品：附魔物品、药水、刷怪笼、知识书、玩家头颅、皮革甲 RGB 染色、烟花、山羊角、诡异药水、自定义盔甲纹饰、灾厄之瓶等
交易日志导出（/eshop logs export，免费版可导出前 3 条占位符，付费版扩展至前 10 条）
禁止的游戏模式列表、不同点击类型绑定不同动作
仅付费版拥有

| 功能 | 说明 |
| :--- | :--- |
| GUI 编辑器 | 游戏内可视化编辑商品，无需手改 YAML |
| NBT 物品支持 | 直接使用其他插件的自定义物品 |
| 命令物品 | 购买/出售时执行多条命令 |
| 延迟命令 | 购买后数天/周/月再执行命令 |
| 限量库存 | 商品在指定时间窗口内有总量上限 |
| 限量出售 | 指定物品在指定时间内最多被出售 N 次 |
| 内置 cron 调度 | 固定周期自动补货 |
| 直接物品支持 | 直接使用受支持插件的物品作为材质 |
| 轮换商店 | 每隔 X 周期随机展示一批商品 |
| 每件物品独立货币 | 不同商品可使用不同货币结算 |
| 物品经济 | 用游戏内物品（支持自定义数据）购买/出售 |
| 等级经济 | 用经验等级购买/出售 |
| 动态定价 | 根据供需自动浮动价格 |
| 单物品权限 | 为特定商品单独设置权限节点 |
| PlaceholderAPI 深度支持 | 商品名/描述/导航栏均可使用占位符 |
| 自定义附魔直连 | EcoEnchants / AdvancedEnchantments / ExcellentEnchants / CrazyEnchantments |
| 物品前置要求 | 未达成指定物品条件前无法交易该商品 |
| 额外刷怪笼支持 | EpicSpawners、UpgradeableSpawners |
| 自定义头颅纹理 | 通过 base64 哈希添加自定义头颅 |
| MySQL 同步 | 多服间同步限量库存 / 倍率 / 动态定价 |
| 商店搜索 | /shop search 在 GUI 内搜索商品 |
| 在线更新 | /eshop update 游戏内直接下载新版本 |

命令列表
玩家命令

| 命令 | 说明 |
| :--- | :--- |
| /shop | 打开主商店菜单 |
| /shop <分类名> | 直接打开指定分类 |
| /sellall | 出售背包内所有可售物品 |
| /sellall <材质> | 出售背包内指定材质的所有物品 |
| /sellall hand | 出售手中物品 |
| /sellgui | 打开出售 GUI，关闭时批量出售放入的物品 |
| /shop search | 搜索商品（付费版） |
管理员命令

| 命令 | 说明 |
| :--- | :--- |
| /sreload | 重载插件 |
| /editshop additem <分类> <价格> | 添加手中物品到商店 |
| /editshop edititem <分类> <序号> | 编辑已有商品 |
| /editshop deleteitem <分类> <序号> | 删除商品 |
| /editshop addsection <名称> | 新建分类 |
| /editshop editsection <名称> | 编辑分类 |
| /editshop deletesection <名称> | 删除分类 |
| /editshop import <来源> | 从其他插件导入配置 |
| /shopgive <玩家> <分类> <序号> [数量] | 将商店物品发给玩家 |
| /eshop uploadLayout | 上传当前商店布局到市场 |
| /eshop installLayout <ID> | 从市场下载预设布局 |
| /eshop logs export | 导出交易日志 |
| /eshop update | 在线更新插件（付费版） |

权限节点
免费版

| 权限 | 说明 |
| :--- | :--- |
| EconomyShopGUI.shop | 允许使用商店 |
| EconomyShopGUI.shop.<分类名> | 允许访问指定分类 |
| EconomyShopGUI.shop.all | 允许访问所有分类 |
| EconomyShopGUI.sellall | 允许使用 /sellall |
| EconomyShopGUI.sellall.<分类名> | 允许出售指定分类的物品 |
| EconomyShopGUI.sellall.all | 允许出售所有分类物品 |
| EconomyShopGUI.sellallitem | 允许使用 /sellall <材质> |
| EconomyShopGUI.sellallhand | 允许使用 /sellall hand |
| EconomyShopGUI.sellgui | 允许使用 /sellgui |
付费版额外权限

| 权限 | 说明 |
| :--- | :--- |
| EconomyShopGUI.shop.search | 使用商店搜索 |
| EconomyShopGUI.eshop.import | 使用导入命令 |
| EconomyShopGUI.eshop.editor | 使用 GUI 编辑器 |
| EconomyShopGUI.eshop.playerstock.add | 调整玩家库存数量 |
| EconomyShopGUI.eshop.playerstock.set | 设置玩家库存数量 |
| EconomyShopGUI.eshop.stock.add | 调整全局库存数量 |
| EconomyShopGUI.eshop.stock.set | 设置全局库存数量 |
| EconomyShopGUI.eshop.dynamicpricing.reset | 重置动态定价 |

配置文件

插件配置文件位于 plugins/EconomyShopGUI/，核心文件：
config.yml — 主配置（经济插件选择、语言、消息格式、禁用游戏模式等）
sections.yml — 商店分类（主菜单入口）
shops/.yml — 各分类下的商品列表
language/.yml — 语言文件

config.yml 关键片段：

economy:
provider: Vault # Vault / PlayerPoints / GemsEconomy / UltraEconomy
default-currency: "" # 留空使用默认

settings:
language: en-US
sell-all-enabled: true
shopstands-enabled: true
discord-hook-enabled: false

商品 YAML 示例：

items:
material: DIAMOND
amount: 1
buy-price: 500
sell-price: 250
slot: 0

安装步骤
下载对应版本 jar（免费版从 SpigotMC/BukkitDev，付费版从 SpigotMC/Polymart）
放入服务器 plugins/ 目录
安装并配置经济插件（如 Vault + Essentials）
启动服务器，让插件生成默认配置与默认商店
用 /editshop 命令或编辑 YAML 调整商品
/sreload 重载生效
从免费版升级到付费版

升级非常简单，推荐用导入命令：
在免费版环境下执行 /editshop import 备份当前布局
关闭服务器，替换 jar 为付费版
启动服务器，执行 /editshop import economy_shop_gui（或对应导入源）
也可从 ShopGUI+ 或 Essentials 的 worth.yml 直接导入

获取支持
Discord：官方支持服务器（wiki 与插件页面均有邀请链接）
Wiki：wiki.gpplugins.com
测试服务器：testserver.gpplugins.com（1.8–1.21 天空岛）
语言翻译：Crowdin 项目页提交翻译

制作 by LT-YHC