Cobblemon ShinyDex

Cobblemon ShinyDex

一款 Cobblemon 附属模组，将完成宝可梦图鉴变成真正的目标：按地区追踪进度，并获得能实际提高闪光宝可梦出现概率的闪光护符——当然，前提是你先达成佩戴资格。

支持 Fabric 和 NeoForge，适用于 Minecraft 1.21.1，需要 Cobblemon 1.8.0 或更高版本。

宝可梦种类会从 Cobblemon 的已实现列表中读取，因此数据包和附属模组添加的宝可梦也会自动收录——本模组无需更新。

功能

闪光护符

一种可穿戴饰品，能够提高遇见闪光宝可梦的概率。它不是初始物品：默认情况下，完成全国图鉴后才会获得护符，而且只有获得资格的玩家才能使用。通过其他方式装备护符不会产生任何效果。

护符的所有设置都可以自定义，并且支持热重载，无需重启服务器：包括闪光概率、所需完成的地区，以及是否计入传说、幻之宝可梦、悖论宝可梦和究极异兽；还可以设置必须捕获宝可梦还是只需见过，甚至可以完全禁用护符获取。

图鉴追踪

追踪全部十个地区的进度——关都、城都、丰缘、神奥、合众、卡洛斯、阿罗拉、伽勒尔、帕底亚和全国图鉴。

每个图鉴都能查看已实装、已见过和已捕获的宝可梦数量，以及精确的完成百分比。缺失列表支持分页，并按属性着色，页码箭头也可以点击。

进度成就

每个地区各有一个进度成就，最终挑战为全国图鉴；此外还有一个闪光护符成就，在满足服务器设定的条件后即可获得护符。

语言

支持英语、法语、德语、西班牙语（西班牙和墨西哥）、意大利语、巴西葡萄牙语、俄语、乌克兰语、波兰语、荷兰语、土耳其语、日语、韩语以及中文（简体和繁体）。宝可梦名称采用 Cobblemon 自带的翻译，因此会按照你安装的语言包显示，并涵盖 Cobblemon 收录的所有宝可梦。

命令

有效地区：kanto、johto、hoenn、sinnoh、unova、kalos、alola、galar、paldea、national。unys也可作为 Unova 的别名使用。

missing列表中，图鉴编号以金色显示，宝可梦名称则以其主要属性的颜色显示。底部的翻页箭头可以点击，无需重新输入命令即可浏览列表。

/shinydex missing kanto
/shinydex missing unova 2
/shinydex completion national

配置

首次启动时会在 config/cobblemon_shinydex/main.json 创建文件：

{
  "configVersion": 1,
  "shinyCharm": {
    "enabled": true,
    "spawnChance": 3750,
    "requireUnlock": true
  },
  "unlock": {
    "enabled": true,
    "regions": ["national"],
    "mode": "caught",
    "includeLegendaries": true,
    "includeMythicals": true,
    "includeParadox": true,
    "includeUltraBeasts": true,
    "extraExcludedLabels": []
  }
}

shinyCharm — 护符效果

unlock — 护符获取条件

这些规则仅适用于护符。地区进度以及 /shinydex check、missing 和 completion 始终按完整图鉴统计已捕获的宝可梦。使用 /shinydex charm 可查看按护符规则计算的进度。

玩家获得护符后会永久保留：之后收紧规则也不会收回护符。

验证

超出范围或未知的值会被修正，而不是导致崩溃——未知地区会被移除，无效的 mode 会回退为 caught——修正后的文件也会写回，因此你可以查看实际生效的设置。如果 regions 列表中没有任何有效值，则会重置为 ["national"]，而不会被视为“无要求”。

旧版本的配置（config/shinydex.json，{ "shinyCharmSpawnChance": ... }）会自动迁移：其中的概率会转移到 config/cobblemon_shinydex/main.json，旧文件则会重命名为 shinydex.json.old。

运行 /shinydex reload 即可在不重启的情况下应用更改。

安装

1. 为 Minecraft 1.21.1 安装 Cobblemon 1.8.0 或更高版本。
2. 为你的加载器安装配套饰品模组：
   • Fabric — Trinkets（以及 Fabric API 和 Fabric Language Kotlin）
   • NeoForge — Curios（以及 Kotlin for Forge）
3. 将与你的加载器匹配的 ShinyDex jar 文件放入 mods/。
4. 启动游戏。

依赖项

护符使用项链栏位。在 NeoForge 上，该模组会自行声明此栏位，因此 Curios 开箱即用，无需额外配置。

服务器说明

进度检查会限流，并跳过已完成的地区，因此在成熟的服务器上，无论玩家数量多少，该模组的刻消耗都几乎为零。

解锁要求会在真正起作用的环节强制执行——生成时，而不只是检查物品栏栏位。通过命令、其他模组或漏洞获得的护符，在未获得进度前仍不会生效（除非 requireUnlock 为 false）。

在旧版本中已完成全国图鉴的玩家会保留护符，不会再次获得一个。

构建

./gradlew build

Jar 文件会生成在 fabric/build/libs/ 和 neoforge/build/libs/ 中。-dev 和 -sources jar 是构建产物；用于发布的是不带这些后缀的版本化 jar。

本项目采用标准的 Architectury 多加载器布局：共享代码位于 common/，加载器专用的接线代码位于 fabric/ 和 neoforge/。

问题反馈

请通过 问题追踪页面提交错误报告和建议。如果遇到闪光概率问题，请附上你的 config/cobblemon_shinydex/main.json，并注明你使用的加载器。