- ◆ 游戏版本
- 全版本
- ◆ 服务端核心
- Paper / Purpur / Spigot(纯 Bukkit API)
- ◆ 前置/依赖
- PlaceholderAPI 可选
MagicCard 月卡插件
作者 Aisen | 联系 QQ 1797950 | 插件交流群 974349582
原创玩法、功能扩展、插件定制,欢迎联系 QQ 1797950 洽谈。
简介
MagicCard 是一款面向生存/RPG/小游戏服务器的月卡插件。支持自定义多种月卡类型,玩家获得后按日发放奖励,到期自动停止。
支持 YAML 单机存储 与 MySQL 群组互通,Velocity / Bungee 多子服可共享同一套月卡数据。
功能特性
-
多卡种 — 小月卡、大月卡、黄金月卡…随意自定义
-
发奖方式 — 自动发奖 /
/mc claim手动领取 -
扣天模式 — 按现实时间扣天(含离线)/ 仅上线领取时扣天
-
每日重置 — 定时扣天并清除领取标记,日期幂等防重复
-
群组互通 — MySQL 共享存储,多子服数据同步、全网只领一次
-
生命周期钩子 — 首次开通 / 续费 / 到期 可分别配置指令
-
周奖励 — 周一 ~ 周日可配置额外奖励
-
Title 提示 — 进服大字提示剩余天数
-
PAPI 变量 — 天数、状态、卡种名对外暴露
-
存储 — YAML 本地 / MySQL 共享,一键切换
命令
-
/mc add <玩家> <卡种> <天数>— 给予月卡天数 — 权限magiccard.add -
/mc take <玩家> <卡种> <天数>— 扣除月卡天数 — 权限magiccard.take -
/mc set <玩家> <卡种> <天数>— 设置月卡天数 — 权限magiccard.set -
/mc claim— 手动领取今日奖励 — 权限magiccard.claim -
/mc reload— 重载配置 — 权限magiccard.reload
PlaceholderAPI 变量
-
%magiccard_any%— 是否拥有任意月卡 -
%magiccard_days_<卡种>%— 剩余天数 -
%magiccard_has_<卡种>%— 是否拥有 -
%magiccard_time_<卡种>%— 今日是否已领取 -
%magiccard_continue_<卡种>%— 开通状态 -
%magiccard_display_<卡种>%— 卡种显示名称
配置示例
完整配置见插件生成的 plugins/MagicCard/config.yml,注释齐全。
storage: yaml
mysql:
host: "127.0.0.1"
port: 3306
database: "magiccard"
username: "root"
password: "123456"
table-prefix: "magiccard_"
pool-size: 5
schedule: "4:00"
display:
title: '&f&l%Cards% &7已领取!'
subtitle: '&7剩余 &f&l%days% &7天'
options:
consume-mode: always
title:
hold: 5
fade-in: 5
fade-out: 5
gap: 2
rewards-enabled: true
auto-claim: true
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%'
renew: {}
expire: {}
bonus:
tuesday:
小月卡:
- 'tell:&d今天是周二,祝你开心!'
群组服(Velocity / Bungee)
-
准备一个 MySQL 数据库
-
所有子服配置相同:
storage: mysql
mysql:
host: "127.0.0.1"
port: 3306
database: "magiccard"
username: "root"
password: "你的密码"
-
重启各子服,日志出现「已连接 MySQL,群组数据互通已启用」即成功
-
A 服发的卡,B 服可查看 / 领取;同一日全网只可领一次
-
每日重置全网只执行一次,不会重复扣天
安装说明
-
下载
MagicCard-1.1.0.jar,放入plugins/ -
启动服务器,自动生成
plugins/MagicCard/config.yml -
单机保持
storage: yaml;群组服改为storage: mysql并填好数据库 -
按需修改卡种与奖励指令
-
执行
/mc reload或重启服务器
兼容性
-
游戏版本 — 1.8.8 ~ 1.21.x / 26.x
-
服务端 — Paper / Purpur / Spigot
-
群组代理 — Velocity / BungeeCord(需 MySQL)
-
Java — 8+
-
前置依赖 — 无
-
可选依赖 — PlaceholderAPI
常见问题
Q:修改配置后不生效?
执行 /mc reload 或重启服务器。
Q:奖励怎么发钱/发物品?
奖励是控制台指令,填写经济/物品插件命令即可,例如 money give %player% 100。
Q:天数什么时候扣?
options.consume-mode: always 每天重置自动 -1(离线也扣);online 只在领取时扣。
Q:玩家一直在线跨天怎么发奖?
每日重置后自动发奖(自动模式)或领取提醒(手动模式)。
Q:群组服数据不通怎么办?
确认所有子服都是 storage: mysql,且数据库配置完全一致;查看是否有「MySQL 连接失败」日志。
更新日志
v1.1.0
-
新增 MySQL 共享存储,支持 Velocity/Bungee 群组服数据互通
-
配置
storage: yaml | mysql,单机与群组双模式 -
领取 / 重置 / 到期 全网并发去重,多子服只生效一次
-
表前缀可配置,连接失败自动禁用插件
v1.0.1
-
接入 bStats 使用统计
-
新增更新检查提示
-
新增变量
%magiccard_any% -
玩家数据内存缓存,减少磁盘读写
-
到期检查改为单玩家单卡种
v1.0.0
-
首个正式版本
-
多卡种、自动/手动发奖、每日重置
-
首开 / 续费 / 到期钩子、周奖励、Title、PAPI
感谢使用,欢迎反馈建议!