- 版权类型
- 原创
- 插件中文名称
- 魔法月卡
- 插件英文名称
- MagicCard
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- Folia
- Purpur
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]
# MagicCard 月卡插件
简洁易用的多卡种月卡系统 · 自动/手动发奖 · 每日重置 · PAPI 变量
**作者** Aisen ｜ **联系 QQ** 1797950
原创玩法、功能扩展、插件定制，欢迎联系 QQ 1797950 洽谈。
[/MD]
[MD] ## 简介 **MagicCard** 是一款面向生存/RPG/小游戏服务器的月卡插件。支持自定义多种月卡类型，玩家获得后按日发放奖励，到期自动停止。 纯 Bukkit API 开发，**兼容 1.8.8 ~ 1.21.x / 26.x**，开箱即用，无需前置、无授权验证。 [/MD]
[MD] ## 功能特性 - **多卡种** — 小月卡、大月卡、黄金月卡…随意自定义 - **发奖方式** — 自动发奖 / `/mc claim` 手动领取 - **扣天模式** — 按现实时间扣天（含离线）/ 仅上线领取时扣天 - **每日重置** — 定时扣天并清除领取标记，日期幂等防重复 - **生命周期钩子** — 首次开通 / 续费 / 到期 可分别配置指令 - **周奖励** — 周一 ~ 周日可配置额外奖励 - **Title 提示** — 进服大字提示剩余天数，停留/淡入淡出可调 - **PAPI 变量** — 天数、状态、卡种名对外暴露 - **存储** — YAML 本地存储，简单可靠 [/MD]
[MD] ## 命令 - `/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 = 所有人 [/MD]
[MD] ## PlaceholderAPI 变量 - `%magiccard_any%` — 是否拥有任意月卡（true / false） - `%magiccard_days_<卡种>%` — 剩余天数 - `%magiccard_has_<卡种>%` — 是否拥有（true / false） - `%magiccard_time_<卡种>%` — 今日是否已领取（1 / 0） - `%magiccard_continue_<卡种>%` — 开通状态（0 未开通 / 1 已开通） - `%magiccard_display_<卡种>%` — 卡种显示名称 示例：`%magiccard_days_小月卡%` [/MD]
[MD] ## 配置示例 完整配置见插件生成的 `plugins/MagicCard/config.yml`，注释齐全。 [/MD]
[MD] **指令前缀说明** - `bc: 消息` — 全服广播 - `tell: 消息` — 私聊玩家 - 其他 — 控制台执行命令 **占位符**：`%player%` 玩家名、`%card%` 卡种名、`%days%` 剩余天数 [/MD]
[MD] ## 安装说明 1. 下载 `MagicCard.jar` 2. 放入 `plugins/` 文件夹 3. 启动服务器，自动生成 `plugins/MagicCard/config.yml` 4. 按需修改卡种与奖励指令 5. 执行 `/mc reload` 或重启服务器 [/MD]
[MD] ## 兼容性 - **游戏版本** — 1.8.8 ~ 1.21.x / 26.x - **服务端** — Paper / Purpur / Spigot（纯 Bukkit API） - **Java** — 8+ - **前置依赖** — 无 - **可选依赖** — PlaceholderAPI [/MD]
[MD] ## 常见问题 **Q：修改配置后不生效？** 执行 `/mc reload` 或重启服务器。 **Q：奖励怎么发钱/发物品？** 奖励是控制台指令，填写你服务器经济/物品插件的命令即可，例如 `money give %player% 100`、`give %player% 钻石 1`。 **Q：天数什么时候扣？** `options.consume-mode: always` 时每天重置自动 -1（离线也扣）；`online` 则只在玩家领取奖励时扣。 **Q：玩家一直在线跨天怎么发奖？** 每日重置后，在线玩家会自动收到当日奖励（自动模式）或领取提醒（手动模式）。 [/MD]
[MD] 感谢使用，欢迎反馈建议！ [/MD]
[MD] ## 简介 **MagicCard** 是一款面向生存/RPG/小游戏服务器的月卡插件。支持自定义多种月卡类型，玩家获得后按日发放奖励，到期自动停止。 纯 Bukkit API 开发，**兼容 1.8.8 ~ 1.21.x / 26.x**，开箱即用，无需前置、无授权验证。 [/MD]
[MD] ## 功能特性 - **多卡种** — 小月卡、大月卡、黄金月卡…随意自定义 - **发奖方式** — 自动发奖 / `/mc claim` 手动领取 - **扣天模式** — 按现实时间扣天（含离线）/ 仅上线领取时扣天 - **每日重置** — 定时扣天并清除领取标记，日期幂等防重复 - **生命周期钩子** — 首次开通 / 续费 / 到期 可分别配置指令 - **周奖励** — 周一 ~ 周日可配置额外奖励 - **Title 提示** — 进服大字提示剩余天数，停留/淡入淡出可调 - **PAPI 变量** — 天数、状态、卡种名对外暴露 - **存储** — YAML 本地存储，简单可靠 [/MD]
[MD] ## 命令 - `/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 = 所有人 [/MD]
[MD] ## PlaceholderAPI 变量 - `%magiccard_any%` — 是否拥有任意月卡（true / false） - `%magiccard_days_<卡种>%` — 剩余天数 - `%magiccard_has_<卡种>%` — 是否拥有（true / false） - `%magiccard_time_<卡种>%` — 今日是否已领取（1 / 0） - `%magiccard_continue_<卡种>%` — 开通状态（0 未开通 / 1 已开通） - `%magiccard_display_<卡种>%` — 卡种显示名称 示例：`%magiccard_days_小月卡%` [/MD]
[MD] ## 配置示例 完整配置见插件生成的 `plugins/MagicCard/config.yml`，注释齐全。 [/MD]
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今天是周二，祝你开心！'[MD] **指令前缀说明** - `bc: 消息` — 全服广播 - `tell: 消息` — 私聊玩家 - 其他 — 控制台执行命令 **占位符**：`%player%` 玩家名、`%card%` 卡种名、`%days%` 剩余天数 [/MD]
[MD] ## 安装说明 1. 下载 `MagicCard.jar` 2. 放入 `plugins/` 文件夹 3. 启动服务器，自动生成 `plugins/MagicCard/config.yml` 4. 按需修改卡种与奖励指令 5. 执行 `/mc reload` 或重启服务器 [/MD]
[MD] ## 兼容性 - **游戏版本** — 1.8.8 ~ 1.21.x / 26.x - **服务端** — Paper / Purpur / Spigot（纯 Bukkit API） - **Java** — 8+ - **前置依赖** — 无 - **可选依赖** — PlaceholderAPI [/MD]
[MD] ## 常见问题 **Q：修改配置后不生效？** 执行 `/mc reload` 或重启服务器。 **Q：奖励怎么发钱/发物品？** 奖励是控制台指令，填写你服务器经济/物品插件的命令即可，例如 `money give %player% 100`、`give %player% 钻石 1`。 **Q：天数什么时候扣？** `options.consume-mode: always` 时每天重置自动 -1（离线也扣）；`online` 则只在玩家领取奖励时扣。 **Q：玩家一直在线跨天怎么发奖？** 每日重置后，在线玩家会自动收到当日奖励（自动模式）或领取提醒（手动模式）。 [/MD]
[MD] 感谢使用，欢迎反馈建议！ [/MD]
