BattlePassPixel

# BattlePassPixel
这是一个供 Pixelmon 服务器使用的 BattlePass 模组。此模组必须搭配 Pixelmon 才能运行。

它会响应捕捉和对战宝可梦等事件，以及其他原版事件，鼓励玩家按照自己喜欢的方式游玩。
每位玩家都有一份 BattlePass，用于追踪自己的等级、升至下一级所需的进度，以及可领取的奖励数量。
玩家可通过下文介绍的 RewardPack 系统领取特定等级的奖励。每升一级，玩家都可以领取随机奖励。

除了追踪上述活动外，玩家还可以接受悬赏任务，完成指定目标后可获得更多等级进度奖励。

此模组高度可配置，大多数数值都可以通过配置文件修改，以满足服务器需求。

## 管理员命令：
– /giveprogress [player] [amount]：为玩家增加等级进度。
– /giveselfprogress [amount]：为自己增加等级进度。
– /resetrank [player] [–confirmationargument1] [–confirmationargument2]：删除玩家的进度。删除的数据会保存在 defaultconfigs 中，以防误操作。
– /newrewardpack [rank] [item] [amount]：在运行时创建新的 RewardPack。
– /newrandomreward [weight] [item] [amount]：创建一项新的随机奖励，玩家执行 /claimranks 时会进行抽取。权重越高，获得该奖励的几率越大。查看 RankupRewardConfig.json 了解此列表中已添加的奖励，并决定是否要手动添加或移除奖励。
– /reloadrewardpacks：无需重启服务器即可重新加载 RewardPacksConfig.json 文件。如果你在运行时手动编辑了配置文件，此命令会很有用。
– /completeallbounties [player] [–confirmationargument]：作弊完成某位玩家的所有悬赏任务。

## 普通玩家命令：
– /checkrank：查看自己的等级以及升至下一级的进度。
– /claimranks：领取每个尚未领取的随机等级奖励。
– /claimrewardpacks：检查是否有尚未领取的新 RewardPack；如果有，则发放相应奖励。
– /togglebattlepassmessages：切换是否允许向聊天栏发送消息。如果玩家觉得这些消息很烦，可以关闭。
– /togglebattlepassbossbar：切换是否在 Boss 血条中显示 BattlePass 信息。
– /getjournal：获取一本日志，其中会显示所有当前可领取的悬赏任务。
– /acceptbounty [number]：日志用于领取当前可领取的悬赏任务。玩家无需手动使用此命令。
– /acceptedbounties：查看执行此命令的玩家已领取的所有悬赏任务。
– /discardbounty [number as shown from /acceptedbounties] [–confirmationargument]：放弃指定的悬赏任务。任务编号可通过 /acceptedbounties 查看。

## 追踪的活动：
– 捕捉宝可梦（包含传说宝可梦奖励和等级）
– 击败宝可梦（包含传说宝可梦奖励、等级和 Boss 阶级）
– 击败训练家（包含宝可梦数量、等级和 Boss 阶级）
– 进化宝可梦（包含传说宝可梦奖励，适用于从 typenull 进化为 silvally）
– 孵化宝可梦（包含满值（31）IV 奖励。基础奖励会乘以满值 IV 的数量）
– 成功使用 Pixelmon 或原版钓竿收线
– 摘取树果有 7% 的几率获得积分，另有 1% 的几率获得双倍积分奖励。
– 挖掘会掉落经验的方块（煤炭、钻石、石英、金粒矿石）

## RewardPack 系统：
基本说明：
RewardPack 系统允许服务器管理员为达到指定等级的玩家设置新奖励。
每个 RewardPack 只能领取一次，除非重置玩家的通行证，或修改该 RewardPack 的 UUID。

### 创建自定义 RewardPacks：
服务器管理员可以在运行时执行 /newrewardpack 命令，在 defaultconfigs\RewardPacksConfig.json 文件中添加一行。
能够访问服务器文件的用户也可以直接修改此文件。请遵循文件中的格式约定。
重要提示：必须将每个 RewardPack 单独放在新的一行中，通常在所用的 IDE 中会以数字标示行号。示例：

– {“rank”:4,”uuid”:”0ac0b6e7-c466-46d2-b02e-359aa5d36579″,”pairs”:[{“itemID”:”minecraft:bookshelf”,”amount”:5},{“itemID”:”minecraft:experience_bottle”,”amount”:16,”nbt”:”{}”}]}
达到 4 级的玩家都能获得以下物品：5 个书架和 16 个经验瓶。
– “rank” 用于定义等级。
– “uuid” 用于检查是否已领取过重复奖励。除非你希望玩家能够再次领取此奖励包，否则不要修改它。
你可以在线生成唯一的 UUID，也可以通过提供的命令创建 RewardPack，获取随机 UUID。
– “pairs” 定义了一种非常简单的结构，称为 ItemPair。它由 itemID（例如 pixelmon:poke_ball 或 minecraft:oak_door）以及要发放的物品数量组成。
– 如果创建 RewardPack 时指定了 NBT 数据，则会保存在 “nbt” 中。
从 0.4.1 版本起，如果定义了 NBT 数据，系统会保存该数据。
– 如果你以前从未接触过 JSON 文件，请注意：只要输错其中一行，或漏掉逗号、括号等符号，RewardPack 就会无法读取。
如果你不知道自己在做什么，请只使用游戏内提供的命令。
删除 RewardPackConfig 后，服务器重启时会重新生成默认奖励包。请小心，别丢失自定义的奖励包。
最后，删除任何默认条目都不会有问题；但要让外部修改生效，必须重启服务器。

## 悬赏系统
悬赏系统允许玩家接取悬赏任务，其中包含一个会追踪进度的目标。完成悬赏后，系统会自动领取任务，并向玩家发放战斗通行证积分奖励。
玩家可选的悬赏每 30 分钟（默认值）重置一次。在此期间，玩家可以接取完全相同的悬赏。玩家尚未完成的悬赏会继续追踪，其余悬赏则会被移除以节省空间。

### 可接取的悬赏：
– 悬赏示例：
– 捕捉或击败最多 3 种指定类型的宝可梦各 x 只，或任意类型的宝可梦 x 只。
– 捕捉或击败 x 只传说宝可梦。
– 击败 x 名训练家。
– 击败 x 只 Boss 宝可梦。
– 钓鱼收线 x 次。

玩家可以使用 /acceptedbounties 查看自己接取的悬赏，也可以放弃难度过高的悬赏。