CobblePass

模组

· 作者 Turiddu

适用于 Cobblemon 1.6+ 的辅助模组

0 本站下载 0 关注 更新于 11 个月前

需要前置:GooeyLibs、Cobblemon、Impactor

最新 2.1.0 · 1.21.1 · Fabric

一键开服(送7天)

CobblePass - 宝可梦终极战斗通行证

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

CobblePass UI

功能特性

  • 赛季 (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 需要服务器上安装以下模组:

安装步骤

  1. 确保你正在运行 Minecraft 1.21.1 或更高版本的 Fabric 服务器。
  2. 下载最新版本的 CobblePass 及所有必需的依赖项。
  3. 将 .jar 文件放入服务器的 mods 文件夹中。
  4. 启动服务器。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:

  • mode: 可以是 "FORMULA" 或 "MANUAL"。
  • 如果为 FORMULA: 使用 xpPerLevel 作为基础值,并使用 xpMultiplier 来增加每级所需的经验值。(例如:第 2 级需要 1000 XP,第 3 级需要 1000*1.05=1050 XP,依此类推)
  • 如果为 MANUAL: 使用 manualXpValues 映射表来明确定义每个等级的经验值。
    "manualXpValues": {
      "2": 500,
      "3": 550,
      "4": 600
    }
    

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
  ]
}

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源