AdventurePass
一、简介
AdventurePass —— 一款功能丰富的冒险通行证（赛季通行证 / Battle Pass）系统插件，类似 Fortnite / PUBG 赛季通行证机制，玩家通过完成任务获取经验升级通行证等级，解锁丰厚奖励。
插件拥有 82 个类，涵盖完整的通行证、任务、赛季、排行榜、加速器、可视化编辑器等功能模块。
核心特性
- 多通行证类型 > 免费 / 高级 / 定制多种通行证层级
- 38 种任务类型 > 挖矿/击杀/钓鱼/合成/移动/登录/酿造等
- 赛季机制 > 自动赛季轮换、历史赛季存档
- 加速器 > 经验加成道具/活动
- 可视化编辑器 > GUI 任务编辑器
- 排行榜 > 通行证等级排行
- 周锁定 > 每周逐步解锁任务
- 多经济 > Vault / PlayerPoints / 像素币
- 数据存储 > JSON / MySQL，跨服同步
- PAPI 变量 > PlaceholderAPI 占位符
- 6 大外部插件挂钩 > MythicMobs / Jobs / mcMMO / Votifier / Citizens / WorldGuard
二、插件前置
- AdventureLib — 框架库（必须）
- Vault — 可选，经济系统
- PlayerPoints — 可选，点券经济
- PlaceholderAPI — 可选，PAPI 变量
- AdventureManage — 可选，联动
- MythicMobs / Jobs / mcMMO / Votifier / Citizens / WorldGuard — 可选，任务挂钩
下一篇安装与配置 →
安装与配置
环境要求
| 项目 | 要求 |
|---|---|
| 服务端 | Spigot / Paper 1.21+ |
| Java | 21+ |
| 必须前置 | AdventureLib |
安装步骤
- 确保
AdventureLib-3.0.0.jar已安装 - 放入
AdventurePass-2.0.0.jar - 启动服务器自动生成配置
- 编辑通行证和任务配置
/apassadmin reload
架构总览
| 模块 | 说明 |
|---|---|
pass/ | 通行证加载、服务、奖励管理 |
quest/ | 38 种任务类型 + 6 种外部挂钩 |
season/ | 赛季管理与轮换 |
booster/ | 经验加速器 |
editor/ | 可视化任务编辑器 |
leaderboard/ | 排行榜系统 |
menu/ | 菜单布局引擎 |
gui/ | GUI 管理 |
economy/ | 多经济桥接 |
storage/ | JSON / MySQL 存储 |
sync/ | Plugin Message 跨服同步 |
上一篇← 概览
下一篇通行证机制 →
通行证机制
通行证类型
支持多种通行证层级（Tier），每个层级有独立的奖励路线。
- 免费通行证 — 所有玩家可用
- 高级通行证 — 付费解锁额外奖励
等级与奖励
- 完成任务获取经验 → 升级通行证等级
- 每个等级解锁对应层级的奖励
RewardManager管理奖励发放- 奖励类型：物品 / 金币 / 命令 / 权限
加速器
| 类型 | 说明 |
|---|---|
| 全局加速器 | 影响全服所有玩家 |
| 个人加速器 | 仅影响持有者 |
上一篇← 安装与配置
下一篇任务系统 →
任务系统
38 种内置任务类型
| 类别 | 任务类型 |
|---|---|
| 方块 | BlockBreak, BlockPlace |
| 战斗 | KillMob, KillPlayer, Damage |
| 采集 | Fishing, Shear, Milk, Bucket |
| 制作 | Craft, Anvil, Enchant, Brew, Smelt |
| 消耗 | Consume, Drop, Pickup, ItemBreak |
| 移动 | Movement, RideMob, Sleep |
| 经济 | GainExp, PlayTime, Login |
| 交互 | Click, Chat, ExecuteCommand, Trade, Projectile, Regenerate |
外部插件任务挂钩
| 插件 | 任务 |
|---|---|
| MythicMobs | 击杀 MythicMobs 怪物 |
| Jobs | Jobs 职业经验/等级 |
| mcMMO | mcMMO 技能经验/等级 |
| Votifier | 投票 |
| Citizens | NPC 交互 |
任务控制
- 每日重置 —
DailyQuestReset自动刷新 - 任务难度 —
QuestDifficulty分级 - 任务管线 —
QuestPipeline链式处理 - 可视化编辑 —
QuestEditorManagerGUI 编辑器
上一篇← 通行证机制
下一篇赛季与经济 →
赛季与经济
赛季系统
- SeasonManager — 管理赛季周期和轮换
- 赛季结束自动结算、存档和重置
- 管理员可手动开启新赛季
经济桥接
| 经济 | 说明 |
|---|---|
| Vault | 标准金币 |
| PlayerPoints | 点券 |
| PixelCoin | 内置像素币 |
数据存储
| 方案 | 说明 |
|---|---|
JsonStorage | JSON 文件本地存储 |
MySQLStorage | MySQL 数据库存储 |
PluginMessageSync | BungeeCord/Velocity 跨服数据同步 |
上一篇← 任务系统
下一篇命令列表 →
命令列表
玩家命令 /apass
别名：/pass, /ap
| 命令 | 说明 | 权限 |
|---|---|---|
/apass | 打开通行证界面 | adventurepass.use |
/apass open | 打开通行证 GUI | adventurepass.use |
/apass stats | 查看个人进度 | adventurepass.use |
/apass help | 帮助信息 | adventurepass.use |
管理命令 /apassadmin
| 命令 | 说明 |
|---|---|
/apassadmin reload | 重载配置 |
/apassadmin givepoints <玩家> <数量> | 给予经验点 |
/apassadmin setpoints <玩家> <数量> | 设置经验点 |
/apassadmin settier <玩家> <层级> | 设置通行证层级 |
/apassadmin setpass <玩家> <等级> | 设置通行证等级 |
/apassadmin givecoins <玩家> <数量> | 给予像素币 |
/apassadmin reset <玩家> | 重置玩家数据 |
/apassadmin newseason | 开启新赛季 |
/apassadmin booster | 管理加速器 |
/apassadmin editor | 任务编辑器 |
/apassadmin leaderboard | 排行榜管理 |
上一篇← 赛季与经济
下一篇权限与集成 →
权限与集成
权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
adventurepass.use | 基础使用 | true |
adventurepass.admin | 管理员命令 | OP |
adventurepass.bypass.weeklock | 绕过周锁定 | false |
adventurepass.editor | 任务编辑器 | OP |
adventurepass.booster | 加速器管理 | OP |
上一篇← 命令列表