收录到模组浏览器

This content is not available in your language yet.

Copper 启动器里的模组浏览器并不自己维护一份模组清单：其中 Copper 模组的列表来自 copper-mods 每天自动生成的索引 mods.json。索引把 GitHub 上符合收录标准的仓库汇总成条目，不需要提 PR——仓库满足条件，下一次扫描就会自动出现。

收录标准

扫描每天跑一次，逐个仓库检查下面几条：

条件	说明
元数据在仓库根目录	根目录必须有 `copper.mod.json` 或 `copper.mod.hjson`，不能放在 `assets/` 下。这正是加载器查找的位置，布局不对的模组 Copper 本来也装不上
仓库带指定 topic	仓库需要添加 `mindustry-copper-mod` topic，扫描按它发现模组
公开且未归档	私有仓库与已归档仓库都会被跳过
不是模板仓库	GitHub 的 `is_template` 标记，以及一份已知模板与示例仓库（`MDTCopper/mod-template`、`Anuken/ExampleMod` 之类）的排除表都会跳过。模板往往和真实模组用同一个 `id`，收录它会占掉真实模组的位置
元数据合法	元数据交给加载器自己的解析器解析：加载器启动时会拒绝的，这里同样跳过，并记进扫描日志

图标从仓库的默认分支读：先找根目录的 icon.png，没有就找 assets/icon.png。两处都没有也能收录，只是浏览器里没有图标。图标不会从 release 附件里取。

想不进浏览器、又不改变加载器的行为，就在元数据的 extra 对象里写 browser: false。加载器与游戏都会忽略 extra 里不认识的字段，所以这对它们完全不可见：

"extra": { "browser": false }

模组浏览器只把两种形式的 tag 当成可下载的版本：与 copper.mod.json 里的 version 完全相同的，以及它后面加 -beta 的测试版。去掉 -beta 之后，tag 必须与 version 严格相等：

索引发布的 version 取自仓库默认分支上的元数据，浏览器要让 release 的 tag 与它对应上，才能把版本列表和索引里的版本对起来、判断玩家手里的构建是不是旧的。测试标记只写在 tag 上，version 始终是 1.2.3 这样的纯 SemVer。

对同一个 version，测试版与正式版不能并存：发了 1.2.3-beta，就不能再发 1.2.3。测试结束之后要抬升版本号，用新版本发布正式版——测试版 1.2.3-beta 之后发的是 1.2.4，而不是补一个 1.2.3。

每个可下载 tag 的 release 至少带一个 .jar 附件，且名字必须是下面两种之一。<仓库名> 指仓库路径的最后一段（example/examplemod 即 examplemod）：

<仓库名>.jar
<仓库名>-<版本>.jar

<版本> 取元数据里的 version：测试版的 -beta 只出现在 tag 上，附件名与正式版一致。以仓库 example/examplemod、版本 1.2.3 为例：

在元数据的 dependencies 里写清 mindustry（需要时再写 loader）的支持范围。这条过滤条件会原样发布成索引里的 gameRequirement，启动器在下载任何东西之前就用它判断构建能不能跑在玩家选的游戏版本上；不写表示接受任意版本：

"dependencies": { "mindustry": ">=159", "loader": ">=0.2.0" }

启动器比对的是版本号：改了代码、重新发布，却没升 version，玩家那边看不出有更新。索引里的 lastUpdated 只是仓库最后一次推送的时间，它不参与更新判断。测试版转正式版同理——抬升版本号再发，不能拿同一个版本号补发正式版，见同一个版本只发一次。

让加载器检查元数据。 copper-mods 仓库自带的 validate 命令用加载器的解析器跑一遍：
Terminal window
```
./gradlew validate -Ptarget=<模组目录或 Jar>
```
打印 ok: the loader accepts this metadata. 就是通过；退出码 3 表示加载器会拒绝这个模组，需要先修好再发布。

逐项核对清单。

检查项	期望
元数据文件	仓库根目录有 `copper.mod.json` 或 `copper.mod.hjson`
topic	仓库已添加 `mindustry-copper-mod`
可见性	公开、未归档
模板	不是模板仓库，也不在排除表里
`version`	合法的 SemVer；tag 是它本身或它加 `-beta`，这样才会进版本列表；同一个版本号下只有一个 release
附件	release 里有 `<仓库名>.jar` 或 `<仓库名>-<版本>.jar`
版本范围	`dependencies.mindustry` 写清了支持范围

现象	常见原因
完全搜不到	仓库没加 `mindustry-copper-mod` topic；元数据不在仓库根目录；`extra.browser` 写成了 `false`；仓库已归档，或被当成模板跳过
扫描日志里被跳过	元数据不合法，加载器会拒绝——本地跑一次 `validate` 看具体报错
列出来了却下载不了	release 里没有 `.jar` 附件，或附件名不符合命名规范；只打了 tag、没发构建也算这种
某个 release 不在版本列表里	tag 不是 `<版本>` 或 `<版本>-beta` 的形式，浏览器不把它当成可下载的版本
下载了却装不上	release 的 tag 与元数据 `version` 对不上（去掉 `-beta` 后仍须严格相等）；或 `dependencies.mindustry` 的范围把玩家当前的游戏版本排除了
发了新版但玩家看不到更新	没有升 `version`，或用同一个 tag 覆盖了旧 release
玩家装了测试版却等不到正式版	正式版复用了测试版的版本号；测试结束要抬升版本号，用新版本发正式版

扫描日志会写明每个仓库被跳过的原因，逐项排查的做法见 copper-mods 的说明。