- ◆ 游戏版本
- 全版本
- ◆ 服务端核心
- Paper / Purpur / Spigot（纯 Bukkit API）
- ◆ 前置/依赖
- PlaceholderAPI 可选
MagicCard 月卡插件
简介
MagicCard 是一款面向生存/RPG/小游戏服务器的月卡插件。支持自定义多种月卡类型，玩家获得后按日发放奖励，到期自动停止。
纯 Bukkit API 开发，兼容 1.8.8 ~ 1.21.x / 26.x，开箱即用，无需前置、无授权验证。
功能特性
| 功能 | 说明 |
|---|---|
| 多卡种 | 小月卡、大月卡、黄金月卡…随意自定义 |
| 发奖方式 | 自动发奖 / /mc claim 手动领取 |
| 扣天模式 | 按现实时间扣天（含离线）/ 仅上线领取时扣天 |
| 每日重置 | 定时扣天并清除领取标记，日期幂等防重复 |
| 生命周期钩子 | 首次开通 / 续费 / 到期 可分别配置指令 |
| 周奖励 | 周一 ~ 周日可配置额外奖励 |
| Title 提示 | 进服大字提示剩余天数，停留/淡入淡出可调 |
| PAPI 变量 | 天数、状态、卡种名对外暴露 |
| 存储 | YAML 本地存储，简单可靠 |
命令
| 命令 | 说明 | 权限 |
|---|---|---|
/mc add <玩家> <卡种> <天数> |
给予月卡天数 | magiccard.add |
/mc take <玩家> <卡种> <天数> |
扣除月卡天数 | magiccard.take |
/mc set <玩家> <卡种> <天数> |
设置月卡天数 | magiccard.set |
/mc claim |
手动领取今日奖励 | magiccard.claim |
/mc reload |
重载配置文件 | magiccard.reload |
别名：/mcc /magiccard
权限默认值：add / take / set / reload = OP，claim = 所有人
PlaceholderAPI 变量
代码:
%magiccard_any% 是否拥有任意月卡（true / false）
%magiccard_days_<卡种>% 剩余天数
%magiccard_has_<卡种>% 是否拥有（true / false）
%magiccard_time_<卡种>% 今日是否已领取（1 / 0）
%magiccard_continue_<卡种>% 开通状态（0 未开通 / 1 已开通）
%magiccard_display_<卡种>% 卡种显示名称
示例：%magiccard_days_小月卡%
配置示例
YAML:
# 每日重置时间
schedule: "4:00"
# Title 提示（占位符：%Cards% 卡种名，%days% 剩余天数）
display:
title: '&f&l%Cards% &7已领取!'
subtitle: '&7剩余 &f&l%days% &7天'
options:
consume-mode: always # always=现实时间扣天 | online=领取时扣天
title:
hold: 5 # Title 停留秒数
fade-in: 5
fade-out: 5
gap: 2 # 多卡种弹出间隔
rewards-enabled: true
auto-claim: true # true=自动发奖 | false=手动领取
# 奖励指令（bc: 广播 / tell: 私聊 / 其余为控制台命令）
plans:
小月卡:
- 'money give %player% 1'
- 'points give %player% 1'
大月卡:
- 'money give %player% 10'
- 'points give %player% 10'
# 生命周期钩子
lifecycle:
enroll: # 首次开通
小月卡:
- 'bc:&7%player% &8» &f开通了 &b%card%'
大月卡:
- 'bc:&7%player% &8» &f开通了 &b%card%'
renew: {} # 续费
expire: {} # 到期
# 周奖励（monday=周一 ... sunday=周日）
bonus:
tuesday:
小月卡:
- 'tell:&d今天是周二，祝你开心！'
指令前缀说明
| 写法 | 行为 |
|---|---|
bc: 消息 |
全服广播 |
tell: 消息 |
私聊玩家 |
| 其他 | 控制台执行命令 |
占位符：%player% 玩家名、%card% 卡种名、%days% 剩余天数
安装说明
- 下载
MagicCard.jar - 放入
plugins/文件夹 - 启动服务器，自动生成
plugins/MagicCard/config.yml - 按需修改卡种与奖励指令
- 执行
/mc reload或重启服务器
兼容性
| 项目 | 支持 |
|---|---|
| 游戏版本 | 1.8.8 ~ 1.21.x / 26.x |
| 服务端 | Paper / Purpur / Spigot（纯 Bukkit API） |
| Java | 8+ |
| 前置依赖 | 无 |
| 可选依赖 | PlaceholderAPI |
常见问题
Q：修改配置后不生效？
执行 /mc reload 或重启服务器。
Q：奖励怎么发钱/发物品？
奖励是控制台指令，填写你服务器经济/物品插件的命令即可，例如 money give %player% 100、give %player% 钻石 1。
Q：天数什么时候扣？
options.consume-mode: always 时每天重置自动 -1（离线也扣）；online 则只在玩家领取奖励时扣。
Q：玩家一直在线跨天怎么发奖？ 每日重置后，在线玩家会自动收到当日奖励（自动模式）或领取提醒（手动模式）。
更新日志
v1.0.0
- 首个正式版本
- 多卡种月卡支持
- 自动 / 手动发奖
- 每日重置与扣天
- 首开 / 续费 / 到期钩子
- 周奖励
- Title 提示（时长可配）
- PlaceholderAPI 变量
作者
Aisen
联系 QQ：1797950
感谢使用，欢迎反馈建议！
原创玩法、功能扩展、插件定制，欢迎联系 QQ 1797950 洽谈。
