EMC 高级商店

EMC 高级商店（EMCAdvancedShop）是一款模块化全功能商店插件，内置 19 个独立功能模块，涵盖官方商店、全球市场、拍卖行、转盘、抽奖、玩家商店、黑市等，支持多货币经济体系（含 PAPI 自定义货币）与宏观调控系统。

主要功能

• 官方商店 — 服主配置商品，支持分类、限购、折扣促销
• 全球市场 — 玩家自由上架物品，全服浏览购买
• 拍卖行 — 竞价拍卖，支持一口价和加价幅度设定
• 拼团购 — 拼团优惠，阶梯价格，倒计时自动成团
• 转盘/抽奖 — 概率权重奖品池，保底机制，每日免费次数
• 玩家商店 — 告示牌开店，离线交易，商店评分
• 每日商店 — 每日随机刷新商品，限购
• 黑市 — 不定时开放，稀有物品交易
• 回收站 — 批量出售物品，一键回收
• 32 种物品源 — 通过反射对接 MythicMobs、ItemsAdder、Oraxen、MMOItems、Slimefun 等 32 种物品插件无需硬依赖
• 自定义货币商城 — 通过 PAPI 变量定义任意货币，配置对应商品
• 优惠券 — 折扣券、满减券、免税券
• 收藏夹 — 收藏商品，降价提醒
• 赠送系统 — 赠送物品给在线/离线玩家
• NPC 商店 — Citizens NPC 绑定商店入口
• 排行榜 — 交易额、商店评分排行
• 租赁系统 — 物品限时租借
• 求购系统 — 发布求购单，预付货款

环境要求

项目	要求
服务端	Paper/Spigot 1.12.2+
Java	Java 8+
必需依赖	Vault（经济桥接）
可选依赖	PlayerPoints、PlaceholderAPI、Citizens、HolographicDisplays、DecentHolograms、WorldGuard、LuckPerms、ProtocolLib

安装步骤

1. 确保服务器已安装 Vault 及对应的经济插件（如 EssentialsX）
2. 从下载页面获取 EMC高级商店-1.0-SNAPSHOT.jar
3. 将 jar 文件放入服务器的 plugins/ 目录
4. 启动服务器，插件会自动生成配置文件：
   • config.yml — 主配置（模块开关等）
   • messages.yml — 消息文本
   • economy.yml — 经济配置
   • economy-control.yml — 宏观调控配置
   • price-limiter.yml — 价格限制配置
5. 根据需要在 config.yml 中启用/禁用各功能模块
6. 执行 /emcshop reload 重载配置

架构概览

EMCAdvancedShop
├── 配置管理 (ConfigManager)     — YAML 多文件配置热重载
├── GUI 框架 (GuiManager)        — 统一箱子 GUI，分页/导航
├── 经济系统 (EconomyManager)    — Vault + PlayerPoints + PAPI 自定义货币
├── 物品源 (ItemSourceManager)  — 32 种插件物品反射对接
├── 宏观调控 (EconomyControl)    — 供需动态定价
├── 价格限制 (PriceLimiter)      — 上架价格区间管控
├── 通知系统 (NotifyManager)     — 交易通知/全服广播
├── 交易日志 (TradeLogManager)   — 审计与异常检测
├── 反作弊 (AntiExploitManager)  — 防刷/冷却/黑名单
├── 数据存储 (StorageManager)    — YAML/SQLite/MySQL
├── 命令系统 (CommandManager)    — 子命令注册与 Tab 补全
└── 模块管理 (ModuleManager)     — 19 个独立功能模块

第三方插件兼容

类别	插件	说明
经济	Vault / EssentialsX	主要金币桥接
点券	PlayerPoints / TokenManager	第二货币
占位符	PlaceholderAPI	注册自定义占位符，GUI 中使用外部占位符
NPC	Citizens	NPC 商店绑定
全息	HolographicDisplays / DecentHolograms	商店全息投影
权限	LuckPerms	VIP 等级判断
区域	WorldGuard	区域内开店限制
物品	MythicMobs / ItemsAdder / Oraxen / MMOItems / Slimefun 等	32 种物品源反射对接（详见文档）