CobblePass - 宝可梦终极战斗通行证
欢迎使用全新改版的 CobblePass!该模组为你的 Cobblemon 服务器提供了一套深度集成且高度可定制的战斗通行证系统。通过包含免费和高级轨道、季节性内容以及大量可配置奖励的奖励性进度系统,吸引你的玩家参与互动。

功能特性
- 赛季 (Seasons): 创建具有可配置持续时间和奖励的独特战斗通行证赛季。
- 双轨奖励 (Dual Reward Tracks): 实现
free(免费)和 premium(高级)两种奖励层级。
- 动态图形用户界面 (Dynamic GUI): 为整洁、直观且分页的 GUI(
/bp),供玩家查看进度并领取奖励。
- 经验值进度 (XP Progression):
- 通过各种游戏内行为获取经验值:捕捉、击败、进化、孵化和交易宝可梦。
- 两种经验值进度模型:
FORMULA: 每级所需的经验值基于可配置的乘数增加。
MANUAL: 手动定义每一级所需的精确经验值。
- 多样化奖励类型 (Diverse Reward Types):
ITEM: 授予 Minecraft 或其他模组中的任何物品,支持完整的 NBT 数据。
POKEMON: 奖励玩家特定的宝可梦,包括等级、闪光状态及其他属性。
COMMAND: 执行任何服务器命令作为奖励,支持玩家名称和 UUID 占位符。
- 管理员管理 (Admin Management):
- 全套用于管理赛季、玩家和配置的命令。
- 创建、启动、停止和删除赛季。
- 实时修改玩家的经验值、等级和高级会员状态。
- 无需重启服务器即可重新加载配置。
- 经济系统集成 (Economy Integration): 使用任何与 Impactor 兼容的经济插件收取高级通行证费用。
- 高度可配置 (Highly Configurable): 通过直观的 JSON 文件调整从经验值到奖励模板和赛季设置的所有内容。
- 数据完整性 (Data Integrity): 玩家数据可靠保存,并包含防止损坏的安全措施。
依赖项
CobblePass 需要服务器上安装以下模组:
安装步骤
- 确保你正在运行 Minecraft 1.21.1 或更高版本的 Fabric 服务器。
- 下载最新版本的 CobblePass 及所有必需的依赖项。
- 将
.jar 文件放入服务器的 mods 文件夹中。
- 启动服务器。CobblePass 将在
config/cobblepass/ 目录中生成其默认配置文件。
快速入门:创建你的第一个赛季
使用游戏内的创建工具,设置新的战斗通行证非常简单。
步骤 1:创建战斗通行证
- 以操作员身份运行命令:
/battlepass create
- 这将打开一个 GUI,你可以在其中设置:
- 持续时间 (Duration): 赛季的天数长度。
- 最高等级 (Max Level): 玩家能达到的最高等级。
- 高级开关 (Premium Toggle): 该赛季是否包含高级轨道。
- 点击“Create Battle Pass”。这将生成
config.json 和 tiers.json 文件,并重置所有玩家的进度以重新开始。
步骤 2:配置你的奖励
- 打开
config/cobblepass/tiers.json。
- 默认情况下,它填充了占位符奖励(苹果)。自定义每个等级的
freeReward 和 premiumReward。请参阅下方的详细 tiers.json 配置 部分,查看物品、宝可梦和命令奖励的示例。
- 这也是你可以定义可重用的奖励
templates(模板)的地方!
步骤 3:配置设置
- 打开
config/cobblepass/config.json。
- 调整经验值获取值(
catchXP、defeatXP 等)、高级通行证的费用(premiumCost)和经验值进度模型(xpProgression)。有关更多详细信息,请参阅 config.json 配置 部分。
步骤 4:重新加载配置
- 保存对 JSON 文件的更改后,运行命令:
/battlepass reload
- 这将把所有新设置和奖励加载到服务器中,无需重启。
步骤 5:开始赛季!
- 当你准备好开始赛季时,运行:
/battlepass season start
- 计时器将启动,玩家现在可以开始赚取经验值了!
命令
基础命令为 /battlepass,别名包括 /bp 和 /pass。
玩家命令
| 命令 |
描述 |
/bp |
打开主战斗通行证 GUI,以查看进度并领取奖励。 |
/bp premium |
显示有关高级通行证的信息,包括费用和状态。 |
/bp premium buy |
如果启用了 premiumMode 且玩家资金充足,则购买高级通行证。 |
/bp claim <level> [premium] |
一种通过命令行领取特定等级奖励的方式。GUI 是主要方法。 |
管理员命令 (权限级别 4)
| 命令 |
描述 |
/bp create |
打开 GUI,从头创建一个新的战斗通行证赛季。 |
/bp delete confirm |
删除所有战斗通行证文件(config.json、tiers.json 和所有玩家数据)。此操作不可逆。 |
/bp season start |
启动当前配置的赛季。 |
/bp season stop |
停止活跃赛季,暂停计时器。 |
/bp reload |
从磁盘重新加载 config.json 和 tiers.json。玩家数据不受影响。 |
/bp addxp <player> <amount> |
向玩家的经验值池中添加指定数量的经验值。 |
/bp addlevels <player> <amount> |
向玩家的通行证中添加指定数量的等级。 |
/bp premiumanage add <player> |
免费授予玩家高级会员状态。 |
/bp premiumanage remove <player> |
撤销玩家的高级会员状态。 |
配置文件
所有配置均位于 config/cobblepass/ 目录中。
config.json
此文件控制通行证的核心机制。
{
"catchXP": 50,
"defeatXP": 25,
"evolveXP": 100,
"hatchXP": 75,
"tradeXP": 50,
"premiumCost": 1000,
"seasonDurationDays": 30,
"currentSeason": 1,
"seasonStartTime": 1729898400000,
"seasonEndTime": 1732490400000,
"enablePermissionNodes": true,
"premiumMode": true,
"xpProgression": {
"mode": "FORMULA",
"xpPerLevel": 1000,
"xpMultiplier": 1.05,
"manualXpValues": {}
}
}
XP 数值 (catchXP, defeatXP 等): 每次行动获得的通行证经验值数量。
premiumCost: 高级通行证的价格,使用服务器的经济系统计算。
seasonDurationDays: 赛季的长度(天数),通过 /bp create 设置。
currentSeason, seasonStartTime, seasonEndTime: 这些由 /bp season 和 /bp create 命令自动管理。请勿手动编辑。
enablePermissionNodes: 设置为 true 以使用权限插件来控制命令访问权限。
premiumMode: 设置为 true 以启用当前赛季的高级进度轨道。
xpProgression:
tiers.json
这是你通行证的核心,所有奖励都在此处定义。
{
"templates": {
"rare_candy_stack": {
"type": "ITEM",
"data": { "id": "cobblemon:rare_candy", "Count": 5 }
},
"greeting_command": {
"type": "COMMAND",
"command": "tellraw %player% {\"text\":\"Thanks for supporting the server!\",\"color\":\"gold\"}",
"data": { "id": "minecraft:paper", "display_name": "§6Server Thank You" }
}
},
"tiers": [
{
"level": 1,
"freeReward": {
"type": "ITEM",
"data": { "id": "cobblemon:poke_ball", "Count": 10 }
}
},
{
"level": 5,
"freeReward": {
"$template": "rare_candy_stack"
},
"premiumReward": {
"type": "POKEMON",
"data": {
"species": "eevee",
"level": 5,
"shiny": true
}
}
},
{
"level": 10,
"premiumReward": {
"$template": "greeting_command"
}
}
]
}
- templates: (可选)在此处定义可复用的奖励。给模板起一个名字(例如 "rare_candy_stack"),然后在层级中使用
"$template": "rare_candy_stack" 引用它。这对于重复出现的奖励非常有用。
- tiers: 层级对象列表。每个对象必须包含一个
level。
- 奖励对象: 可以是
freeReward(免费奖励)或 premiumReward(高级奖励)。
- type:
ITEM(物品)、POKEMON(宝可梦)或 COMMAND(命令)。
- data:
- 对于
ITEM: 物品的 id 及其 Count(数量)。你也可以在此添加任何其他 NBT 数据。
- 对于
POKEMON: 必须指定 species(物种)。你还可以指定 level(等级)、shiny(闪光)、ability(特性)等。GUI 中显示的图标将是该宝可梦的精灵图。
- 对于
COMMAND: id 指定在 GUI 中显示的物品。你还可以添加自定义的 display_name(显示名称)。
- command: (仅适用于
COMMAND 类型)要执行的命令字符串。使用 %player% 代表玩家名称,使用 %uuid% 代表其 UUID。
玩家数据
玩家进度单独存储在 config/cobblepass/players/<uuid>.json 中。建议不要手动编辑这些文件,但如果需要用于诊断或手动修正,它们可能很有用。
{
"version": "1.0",
"level": 5,
"xp": 250,
"isPremium": true,
"claimedFreeRewards": [
1,
2,
3,
4,
5
],
"claimedPremiumRewards": [
5
]
}
CobblePass - The Ultimate Battle Pass for Cobblemon
Welcome to the completely revamped CobblePass! This mod provides a deeply integrated and highly customizable battle pass system for your Cobblemon server. Engage your players with a rewarding progression system, complete with free and premium tracks, seasonal content, and a wide array of configurable rewards.

Features
- Seasons: Create unique battle pass seasons with configurable durations and rewards.
- Dual Reward Tracks: Implement both
free and premium reward tiers.
- Dynamic GUI: A clean, intuitive, and paginated GUI (
/bp) for players to view progress and claim rewards.
- XP Progression:
- Gain XP from various in-game actions: catching, defeating, evolving, hatching, and trading Pokémon.
- Two XP progression models:
FORMULA: XP required per level increases based on a configurable multiplier.
MANUAL: Manually define the exact XP required for each level.
- Diverse Reward Types:
ITEM: Grant any item from Minecraft or other mods, with full NBT support.
POKEMON: Reward players with specific Pokémon, including level, shininess, and other attributes.
COMMAND: Execute any server command as a reward, with placeholders for player name and UUID.
- Admin Management:
- A full suite of commands for managing seasons, players, and configurations.
- Create, start, stop, and delete seasons.
- Modify player XP, levels, and premium status on the fly.
- Reload configurations without a server restart.
- Economy Integration: Charge for the premium pass using any Impactor-compatible economy plugin.
- Highly Configurable: Tweak everything from XP values to reward templates and season settings through intuitive JSON files.
- Data Integrity: Player data is saved reliably and includes safeguards against corruption.
Dependencies
CobblePass requires the following mods to be installed on your server:
Installation
- Ensure you have a Fabric server running Minecraft 1.21.1 or later.
- Download the latest versions of CobblePass and all required dependencies.
- Place the
.jar files into your server's mods folder.
- Start your server. CobblePass will generate its default configuration files in the
config/cobblepass/ directory.
Getting Started: Your First Season
Setting up a new Battle Pass is easy with the in-game creation tool.
Step 1: Create the Battle Pass
- As an operator, run the command:
/battlepass create
- This will open a GUI where you can set:
- Duration: The length of the season in days.
- Max Level: The highest level players can achieve.
- Premium Toggle: Whether this season will have a premium track.
- Click "Create Battle Pass". This generates
config.json and tiers.json files and resets all player progress for a fresh start.
Step 2: Configure Your Rewards
- Open
config/cobblepass/tiers.json.
- By default, it's filled with placeholder rewards (Apples). Customize each level's
freeReward and premiumReward. See the detailed tiers.json Configuration section below for examples of Item, Pokémon, and Command rewards.
- This is where you can also define reusable reward
templates!
Step 3: Configure Settings
- Open
config/cobblepass/config.json.
- Adjust XP gain values (
catchXP, defeatXP, etc.), the cost of the premium pass (premiumCost), and the XP progression model (xpProgression). See the config.json Configuration section for more details.
Step 4: Reload the Configuration
- Once you've saved your changes to the JSON files, run the command:
/battlepass reload
- This will load all your new settings and rewards into the server without needing a restart.
Step 5: Start the Season!
- When you're ready for the season to begin, run:
/battlepass season start
- The timer will start, and players can now begin earning XP!
Commands
The base command is /battlepass with aliases /bp and /pass.
Player Commands
| Command |
Description |
/bp |
Opens the main Battle Pass GUI to view progress and claim rewards. |
/bp premium |
Shows information about the premium pass, including cost and status. |
/bp premium buy |
Purchases the premium pass if premiumMode is enabled and the player has enough funds. |
/bp claim <level> [premium] |
A command-based way to claim a reward for a specific level. The GUI is the primary method. |
Admin Commands (Permission Level 4)
| Command |
Description |
/bp create |
Opens a GUI to create a new Battle Pass season from scratch. |
/bp delete confirm |
Deletes all Battle Pass files (config.json, tiers.json, and all player data). This is irreversible. |
/bp season start |
Starts the currently configured season. |
/bp season stop |
Stops the active season, pausing the timer. |
/bp reload |
Reloads config.json and tiers.json from the disk. Player data is unaffected. |
/bp addxp <player> <amount> |
Adds a specified amount of XP to a player's pass. |
/bp addlevels <player> <amount> |
Adds a specified number of levels to a player's pass. |
/bp premiumanage add <player> |
Grants a player premium status for free. |
/bp premiumanage remove <player> |
Revokes a player's premium status. |
Configuration Files
All configuration is located in the config/cobblepass/ directory.
config.json
This file controls the core mechanics of the Battle Pass.
{
"catchXP": 50,
"defeatXP": 25,
"evolveXP": 100,
"hatchXP": 75,
"tradeXP": 50,
"premiumCost": 1000,
"seasonDurationDays": 30,
"currentSeason": 1,
"seasonStartTime": 1729898400000,
"seasonEndTime": 1732490400000,
"enablePermissionNodes": true,
"premiumMode": true,
"xpProgression": {
"mode": "FORMULA",
"xpPerLevel": 1000,
"xpMultiplier": 1.05,
"manualXpValues": {}
}
}
XP Values (catchXP, defeatXP, etc.): The amount of Battle Pass XP granted for each action.
premiumCost: The price for the premium pass, using your server's economy.
seasonDurationDays: The length of a season in days, set via /bp create.
currentSeason, seasonStartTime, seasonEndTime: These are managed automatically by the /bp season and /bp create commands. Do not edit manually.
enablePermissionNodes: Set to true to use a permissions plugin for command access.
premiumMode: Set to true to enable the premium track for the current season.
xpProgression:
tiers.json
The heart of your Battle Pass, where all rewards are defined.
{
"templates": {
"rare_candy_stack": {
"type": "ITEM",
"data": { "id": "cobblemon:rare_candy", "Count": 5 }
},
"greeting_command": {
"type": "COMMAND",
"command": "tellraw %player% {\"text\":\"Thanks for supporting the server!\",\"color\":\"gold\"}",
"data": { "id": "minecraft:paper", "display_name": "§6Server Thank You" }
}
},
"tiers": [
{
"level": 1,
"freeReward": {
"type": "ITEM",
"data": { "id": "cobblemon:poke_ball", "Count": 10 }
}
},
{
"level": 5,
"freeReward": {
"$template": "rare_candy_stack"
},
"premiumReward": {
"type": "POKEMON",
"data": {
"species": "eevee",
"level": 5,
"shiny": true
}
}
},
{
"level": 10,
"premiumReward": {
"$template": "greeting_command"
}
}
]
}
- templates: (Optional) Define reusable rewards here. Give a template a name (e.g., "rare_candy_stack") and then reference it in a tier using
"$template": "rare_candy_stack". This is great for recurring rewards.
- tiers: A list of tier objects. Each object must have a
level.
- Reward Objects: Can be
freeReward or premiumReward.
- type:
ITEM, POKEMON, or COMMAND.
- data:
- For
ITEM: The id of the item and its Count. You can add any other NBT data here too.
- For
POKEMON: The species is required. You can also specify level, shiny, ability, and more. The display item in the GUI will be a sprite of that Pokémon.
- For
COMMAND: The id specifies which item to display in the GUI. You can also add a custom display_name.
- command: (Only for
COMMAND type) The command string to execute. Use %player% for the player's name and %uuid% for their UUID.
Player Data
Player progress is stored individually in config/cobblepass/players/<uuid>.json. It's recommended not to edit these files manually, but they can be useful for diagnostics or manual corrections if needed.
{
"version": "1.0",
"level": 5,
"xp": 250,
"isPremium": true,
"claimedFreeRewards": [
1,
2,
3,
4,
5
],
"claimedPremiumRewards": [
5
]
}
评论 0
登录后参与评分
还没有评论,来抢沙发吧