跳到主要内容

模块总览

EMC 高级商店采用模块化架构，共 19 个功能模块，每个模块可在 config.yml 中独立启用/禁用。

基础商店模块​

1. 官方售卖商店 (AdminShop)​

服主通过配置文件或 GUI 配置商品，支持分类浏览、购买出售、限购、折扣促销和动态定价。

  • 命令：/shop
  • 模块 ID：admin-shop

2. 全球自由上架商店 (GlobalMarket)​

玩家自由上架物品，设定价格和数量，全服玩家可浏览购买。支持上架费、税率、过期自动下架、搜索筛选。

  • 命令：/market
  • 模块 ID：global-market

3. 回收站 (RecycleShop)​

批量出售物品给系统，支持一键出售背包中同类物品。回收数据反馈至经济宏观调控系统。

  • 命令：/recycle
  • 模块 ID：recycle-shop

社交玩法模块​

4. 玩家个人商店 (PlayerShop)​

放置告示牌开店，商品 GUI 管理，离线交易，商店评分与搜索。支持 VIP 扩容和商店装饰。

  • 命令：/pshop
  • 模块 ID：player-shop

5. 拼团购商店 (GroupBuy)​

发起拼团活动，设定目标人数和优惠价格。达到人数自动成团，支持阶梯价格和倒计时。

  • 命令：/groupbuy
  • 模块 ID：group-buy

6. 拍卖行 (Auction)​

玩家发起拍卖，竞价出价，支持一口价、加价幅度设定和拍卖倒计时。

  • 命令：/auction
  • 模块 ID：auction

7. 求购/悬赏系统 (WantToBuy)​

发布求购单，预付货款，其他玩家可直接出售满足求购。支持有效期和最大同时求购数量。

  • 命令：/wtb
  • 模块 ID：want-to-buy

娱乐玩法模块​

8. 转盘 (SpinWheel)​

可配置奖品池，概率权重系统，转盘 GUI 动画效果。每日免费次数 + 付费抽取，保底机制。

  • 命令：/spin
  • 模块 ID：spin-wheel

9. 抽奖 (Lottery)​

彩票系统，奖池累积，定时开奖。支持多种玩法，中奖概率可配置，全服公告。

  • 命令：/lottery
  • 模块 ID：lottery

10. 每日商店 (DailyShop)​

每日随机刷新商品，从预设商品池随机选取，支持限购数量。

  • 命令：/dailyshop
  • 模块 ID：daily-shop

高级功能模块​

11. 限时特卖 (FlashSale)​

限时折扣商品，倒计时显示，限量抢购，定时自动开启/关闭。

  • 命令：/flashsale
  • 模块 ID：flash-sale

12. 黑市 (BlackMarket)​

不定时开放，稀有物品交易，价格波动，神秘商品（购买前不知道是什么）。

  • 命令：/blackmarket
  • 模块 ID：black-market

13. 自定义货币商城 (CustomCurrencyShop)​

管理员通过配置定义任意自定义货币（通过 PAPI 变量读取余额，命令扣除/充值），然后配置使用该货币购买的商品。支持多分类、购买限制、附加命令执行。

  • 命令：/emcshop cshop [分类]
  • 模块 ID：currency-shop
  • 配置文件：shops/currency-shop.yml

14. 优惠券/折扣券 (Coupon)​

管理员创建折扣券、满减券、免税券等，可配置适用范围、使用条件和有效期。

  • 命令：/coupon
  • 模块 ID：coupon

15. 赠送系统 (GiftSystem)​

赠送物品给在线/离线玩家，支持匿名赠送和赠送记录查询。

  • 命令：/gift <玩家>
  • 模块 ID：gift

16. 租赁系统 (RentalShop)​

租借物品限时使用，到期自动回收，支持续租和租赁历史记录。

  • 命令：/rent
  • 模块 ID：rental-shop

辅助模块​

17. NPC 商店 (NPCShop)​

绑定 Citizens NPC 作为商店入口，右键 NPC 打开对应商店 GUI，NPC 头顶全息显示。

  • 命令：/npcshop
  • 模块 ID：npc-shop

18. 收藏夹/关注 (Favorites)​

收藏商品，关注玩家商店新品上架通知，降价提醒和目标价格自动提醒。

  • 命令：/fav
  • 模块 ID：favorites

19. 商店排行榜 (Leaderboard)​

交易额排行、商店评分排行，每日/每周/每月/总榜，GUI + 全息投影展示。

  • 命令：/shoptop
  • 模块 ID：leaderboard

模块开关配置​

在 config.yml 中配置各模块的启用状态：

modules:
  admin-shop:
    enabled: true
  global-market:
    enabled: true
  group-buy:
    enabled: true
  spin-wheel:
    enabled: true
  lottery:
    enabled: true
  flash-sale:
    enabled: true
  auction:
    enabled: true
  currency-shop:
    enabled: true
  daily-shop:
    enabled: true
  black-market:
    enabled: true
  recycle-shop:
    enabled: true
  player-shop:
    enabled: true
  want-to-buy:
    enabled: true
  coupon:
    enabled: true
  favorites:
    enabled: true
  gift:
    enabled: true
  npc-shop:
    enabled: true
  leaderboard:
    enabled: true
  craft-shop:
    enabled: true
  rental-shop:
    enabled: true

禁用的模块不会注册命令和监听器，不占用服务器资源。