跳到主要内容

EMC 签到联合

EMC 签到联合是一款签到日历 + 战令双系统插件，通过可视化月历 GUI 让玩家每日签到领奖，同时集成赛季制战令系统，以免费/高级双轨道奖励持续激励玩家活跃。

核心功能​

  • 日历签到 — 可视化月历 GUI，点击即签，四色状态区分已签/今日/未签/可补签
  • 连续签到奖励 — 3/7/14/21/30 天连续签到递进奖励
  • 累计签到奖励 — 10/30/50/100 天里程碑奖励
  • 补签机制 — 对过去未签到日期付费补签，每月次数上限可配
  • 战令系统 — 赛季制 30 级战令，签到获取经验，免费 + 高级双轨道
  • 双经济 — 通过反射无缝对接 Vault 金币和 PlayerPoints 点券
  • 登录提醒 — 玩家上线自动提醒签到

环境要求​

项目要求
服务端Spigot/Paper 1.12.2+
JavaJava 8+
可选依赖Vault（金币奖励/补签花费）、PlayerPoints（点券奖励/补签花费）
数据存储YAML 文件（自动保存）

安装步骤​

  1. 从下载页面获取 EMC签到联合-1.0-SNAPSHOT.jar
  2. 将 jar 文件放入服务器的 plugins/ 目录
  3. （可选）安装 Vault + 经济插件以启用金币奖励
  4. （可选）安装 PlayerPoints 以启用点券奖励
  5. 启动服务器，插件自动生成 config.yml
  6. 根据需要修改配置后执行 /qd reload 重载

架构概览​

EMC签到联合
├── command/         # 命令处理
│   ├── SignInCommand    — /signin (/qd) 签到主命令
│   └── BattlePassCommand — /battlepass (/bp) 战令命令
├── manager/         # 业务逻辑
│   ├── SignInManager    — 签到/补签/奖励发放
│   ├── BattlePassManager — 战令等级/经验/奖励领取
│   └── EconomyManager   — Vault/PlayerPoints 经济桥接
├── gui/             # GUI 界面
│   ├── SignInGui        — 签到日历 GUI（54格箱子）
│   └── BattlePassGui    — 战令 GUI（分页，双轨道）
├── data/            # 数据层
│   ├── DataManager      — 玩家数据加载/保存
│   └── PlayerData       — 玩家签到/战令数据模型
├── listener/        # 事件监听
│   ├── PlayerListener   — 登录提醒
│   └── GuiListener      — GUI 点击处理
└── util/            # 工具类
    ├── MsgUtil          — 消息发送/颜色/命令执行
    └── VersionHelper    — 跨版本 Material 兼容

数据存储​

玩家数据以 YAML 文件存储在 plugins/EMC签到联合/data/ 目录，每个玩家一个文件。数据包含：

  • 签到日期集合
  • 连续签到天数
  • 累计签到天数
  • 上次签到日期
  • 本月补签次数
  • 战令等级/经验
  • 高级战令状态
  • 已领取的免费/高级奖励