- 版权类型
- 原创
- 插件中文名称
- 通行证
- 插件英文名称
- CyPass
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
CyPass赛季通行证 · 让玩家每天都有理由上线
任务 / 等级 / 双奖励轨 / 商店 / 赛季管理
你是不是也遇到过
- 想搞赛季活动，任务靠手记，奖励靠手动发
- 免费玩家没动力，付费玩家觉得没区别
- 赛季结束了，数据不知道怎么清
- 任务全服一样，玩家互相抄作业
服主 说：
CyPass 把这条线做完了。
它是怎么运作的
- 玩家上线自动激活默认通行证（可在
passes/配多个） - 做任务累积经验，经验升级（等级是全局的）
- 每升一级，按档位发放奖励：免费轨所有玩家可领，付费轨需要解锁
- 付费档位在通行证商店购买（点券或金币）
- 赛季结束，管理员结束赛季并清理数据，再开新赛季
核心功能
- 任务系统：每日 / 每周 / 赛季 / 副本任务，按目录自动加载
- 随机任务池：每人每周期随机抽几个，同一玩家固定不变
- 即时结算：事件驱动，完成瞬间弹提示，不靠定时扫
- 多档位：每个通行证最多 4 个档位，免费 + 付费自由组合
- 奖励模板：按等级范围批量发奖，支持每 10 级里程碑
- 单级覆盖：指定等级单独给奖励，最精准的控制
- 通行证商店：用点券 / 金币解锁付费档位或购买其他通行证
- 领取系统：一键领取所有可领奖励，领取记录可查
- 赛季管理：开始 / 结束赛季、设置时间、结束前提醒
- 经验倍率：按权限给 2 倍 / 3 倍经验
- 进度条：聊天 / 菜单里显示经验进度，字符和颜色可配
- 自动清理：旧任务记录定时清理，数据库不会越滚越大
三个常见场景
生存服赛季
每日挖矿、打怪、生活任务，配合免费 / 付费双轨，赛季结束重置。
付费解锁
免费玩家拿基础奖励，花点券解锁金苹果档，拿额外奖励。
活动赛季
开一个限时赛季，任务和奖励单独配，结束后开新赛季。
运行环境
- 服务端：Paper 1.21.11
- Java：21 及以上
- 硬依赖：无
- 软依赖：Vault（金币奖励 / 金币购买）、PlayerPoints（点券）、PlaceholderAPI、LuckPerms、MythicMobs（对应任务类型）
没装经济插件也能跑，只是金币 / 点券类奖励会失败。
前置组件
- Vault（可选，金币）—— SpigotMC
- PlayerPoints（可选，点券）—— SpigotMC
- PlaceholderAPI（可选，变量）—— SpigotMC
- MythicMobs（可选，Mythic 任务）—— 按需安装
安装
- 把
CyPass-1.2.2.jar放进plugins/，重启 - 生成
config.yml、passes/、quests/、rewards/、gui/ - 按需修改任务、奖励和档位
- 执行
/cypass admin season start开启第一个赛季 /cypass reload重载配置
命令
/cypass menu—— 打开通行证主界面/cypass quests—— 任务列表/cypass rewards—— 奖励轨道/cypass shop—— 通行证商店/cypass info [玩家]—— 查看等级 / 经验 / 进度/cypass claim—— 一键领取可领奖励/cypass season—— 查看当前赛季/cypass reload—— 重载配置
管理员命令
/cypass admin season start|end|settime—— 赛季开始 / 结束 / 改时间/cypass admin player <玩家> info|exp|level|progress|reset—— 玩家数据/cypass admin exp <玩家> <数量>—— 加经验/cypass admin level <玩家> <数量>—— 加等级/cypass admin setlevel <玩家> <等级>—— 设等级/cypass admin tier <玩家> <档位> activate|reset—— 档位解锁 / 重置/cypass admin reward <玩家> ...—— 手动发奖励/cypass admin debug—— 调试信息
权限
cypass.use—— 基本使用，默认所有玩家cypass.admin—— 管理权限（含 season / player / reward / reload 子权限）cypass.exp.2x—— 任务经验 ×2cypass.exp.3x—— 任务经验 ×3（优先于 2x，不叠加）
配置示例
YAML：
level:
start: 0
max: 50
base-experience: 100
experience-multiplier: 1.0
quests:
daily-reset-hour: 0
weekly-reset-day: 1
random-pool:
enabled: true
daily-count: 3
weekly-count: 3
progress:
instant-settle: true
auto-settle-seconds: 5
exp-multipliers:
- permission: cypass.exp.3x
multiplier: 3.0
- permission: cypass.exp.2x
multiplier: 2.0
season:
auto-name: "默认赛季"
must-end-first: true
announce-login: true
end-warning-enabled: true
end-warning-days: 7
通行证与档位
passes/default.yml：
YAML：
id: default
default: true
tiers:
free:
row: 1
display-name: "&f免费版"
free: true
golden:
row: 3
display-name: "&6金苹果版"
price: 100
pay: points奖励在
rewards/*.yml 定义，按等级范围批量发，支持每 10 级里程碑和单级覆盖。
常见问题
Q：任务进度不动？
确认任务类型和玩家行为匹配，
instant-settle 开着时是实时的；也可以等 auto-settle-seconds 兜底结算。Q：任务每天不刷新？
看
daily-reset-hour 和 weekly-reset-day，按服务器时间算。Q：奖励领不了？
免费档所有玩家可领；付费档要先在商店解锁，或让管理员
/cypass admin tier。Q：付费档怎么解锁？
/cypass shop 用点券或金币购买，价格在 passes/*.yml 的 price。Q：赛季结束数据怎么办？
/cypass admin season end 结束赛季，旧任务记录会按配置自动清理。Q：经验倍率叠加吗？
不叠加，按配置顺序取第一个命中的权限。
Q：能开多个通行证吗？
可以，
passes/ 下每个文件一个通行证，商店里能买。
文档
license.mc33.top/docs/cypass
获取完整版
爱发电 · CyPass
一次购买，长期使用
