- 版权类型
- 原创
- 插件中文名称
- 月卡插件
- 插件英文名称
- MonthCard
- 原帖地址
- 原创
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- PlayerPoints
Vault
PlaceholderAPI
- 适配版本（Java）
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
跨服数据同步 玩家在任意服务器领取、消耗月卡天数，全服群组实时同步，彻底告别“这服有卡那服无”的尴尬。
多存储支持 支持 YAML (本地)、MySQL、SQLite，可按需切换。使用 MySQL 存储即可天然实现跨服数据共享。
双模式到期 自然时间模式：按日历到期；登录扣除模式：玩家每领取一次奖励，剩余天数减1，灵活适应不同服需求。
自动/手动领取 支持上线自动弹出 Title 奖励提示，也支持手动
例如：显示白银月卡剩余天数 ->
Q：支持哪些经济插件？
A：通过 Vault 支持所有主流经济插件（如 EssentialsX、CMI、玩家经济等）。
Q：可以自定义奖励吗？
A：可以，支持金钱、点券、执行命令、物品奖励，且每种月卡可配置多种奖励。
Q：跨服同步有延迟吗？
A：取决于数据库性能和网络，通常在 1-3 秒内同步。插件内置了智能缓存和定时更新机制以平衡性能与实时性。
Q：支持 PlaceholderAPI 吗？
A：支持！可使用占位符 月卡%type% 到期%date%显示玩家指定月卡剩余天数，方便在菜单或其他插件中展示。
多存储支持 支持 YAML (本地)、MySQL、SQLite，可按需切换。使用 MySQL 存储即可天然实现跨服数据共享。
双模式到期 自然时间模式：按日历到期；登录扣除模式：玩家每领取一次奖励，剩余天数减1，灵活适应不同服需求。
自动/手动领取 支持上线自动弹出 Title 奖励提示，也支持手动
/monthcard claim 领取，满足不同玩家习惯。
功能一览
月卡管理
- 支持多种月卡类型（如白银、黄金月卡），可自定义奖励。
- 奖励支持：游戏币（Vault）、点券（PlayerPoints）、执行命令、发放物品。
- 精细控制月卡有效期和到期逻辑。
玩家体验
- 上线自动检测并发放奖励（可开关），并以 Title 大标题 醒目提示。
- 到期前自动提醒（可配置提前天数）。
- 简洁指令
/monthcard check随时查看自己所有月卡状态。
管理功能
- 管理员一键发放/扣除月卡：
/monthcard give/take <玩家> <类型> <天数>。 - 实时重载配置：
/monthcard reload，无需重启服务器。 - 完整的权限节点支持，精细化控制管理权限。
指令与权限
/mc help | 查看帮助 | 无 |
/mc claim | 手动领取今日奖励 | monthcard.use |
/mc check | 查看月卡状态 | monthcard.use |
/mc give <玩家> <类型> <天数> | 给玩家发放月卡 | monthcard.admin |
/mc take <玩家> <类型> <天数> | 扣除玩家月卡天数 | monthcard.admin |
/mc reload | 重载插件配置 | monthcard.admin |
三、PlaceholderAPI 变量
将<type> 替换为月卡ID (如 byyk 或 hjyk)：%monthcard_days_left_<type>% | 剩余天数 | 29 |
%monthcard_expiry_<type>% | 到期时间/日期 | 2026-01-01 或 30 Days |
%monthcard_status_<type>% | 月卡状态 (激活/未激活) | Active 或 Inactive |
%monthcard_has_<type>% | 是否拥有该月卡 | true 或 false |
例如：显示白银月卡剩余天数 ->
%monthcard_days_left_byyk%
YAML：
# 月卡插件配置文件 (MonthCard Configuration)
storage:
# 存储类型: yaml (本地文件), mysql (数据库), sqlite (本地数据库)
type: "yaml"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"
pool-settings:
maximum-pool-size: 10
minimum-idle: 5
connection-timeout: 30000
sqlite:
file: "storage.db"
settings:
# 到期模式设置
# REALTIME: 自然时间模式 (按日历时间到期，无论是否上线)
# LOGIN: 登录扣除模式 (玩家每领取一次奖励，剩余天数减 1)
expiry-mode: "REALTIME"
# 每日重置时间 (格式 HH:mm)
reset-time: "00:00"
# 是否进服自动领取奖励
auto-claim: true
# Title 提示设置
title:
# 总开关
enable: true
# 领取成功提示
claim:
duration: 3
main: "&a每日奖励"
sub: "&7已领取 %type% 奖励 (剩余: %date%)"
# 过期提示 (进服时显示)
expiry:
enable: true
duration: 5
main: "&c月卡已过期"
sub: "&7您的 %type% 已过期，请及时续费"
# 到期提醒设置 (Chat/Title 预警)
reminder:
enable: true
# 提前多少天开始提醒
days-before: 3
cards:
byyk:
display-name: "&7[白银月卡]"
rewards:
money: 1000.0
points: 20
commands:
- "give %player% iron_ingot 1"
hjyk:
display-name: "&6[黄金月卡]"
rewards:
money: 2000.0
points: 30
commands:
- "give %player% gold_ingot 1"
- 安装前置插件：确保服务器已安装 Vault、PlaceholderAPI、PlayerPoints (可选)、LuckPerms (可选)。
- 放置插件：将 MonthCardPro.jar 放入 plugins 文件夹。
- 首次启动：启动服务器，插件会自动生成配置文件。
- 配置数据库（如需跨服）：在 config.yml 中设置 storage.type: mysql 并填写正确的数据库信息。
- 重载插件：执行 /monthcard reload 或重启服务器。
- 当 storage.type 设置为 mysql 时，所有服务器的插件都会连接至同一个数据库。
- 玩家的月卡数据（类型、剩余天数、最后领取时间）集中存储于此。
- 任何服务器上的操作（领取、发放）都会实时更新数据库，其他服务器通过定时检测或事件驱动立即同步状态。
Q：支持哪些经济插件？A：通过 Vault 支持所有主流经济插件（如 EssentialsX、CMI、玩家经济等）。
Q：可以自定义奖励吗？
A：可以，支持金钱、点券、执行命令、物品奖励，且每种月卡可配置多种奖励。
Q：跨服同步有延迟吗？
A：取决于数据库性能和网络，通常在 1-3 秒内同步。插件内置了智能缓存和定时更新机制以平衡性能与实时性。
Q：支持 PlaceholderAPI 吗？
A：支持！可使用占位符 月卡%type% 到期%date%显示玩家指定月卡剩余天数，方便在菜单或其他插件中展示。
- v1.0.0(2026.1.8)
- 首次发布，实现月卡核心功能。
- 支持 YAML、MySQL、SQLite 存储。
- 实现跨服数据同步。
- 上线自动领取与 Title 提示。
