Celestial Plugin Store

Celestial Launcher 的商店索引。启动器读取本仓库 main 分支根目录的两个文件：

文件	内容	商店页
plugins.json	启动器插件	设置 → 插件
content-sources.json	内容源插件（下载源）	设置 → 内容源

索引只是指向下载地址的清单，不包含也不执行任何插件代码。用户安装时，启动器仍会重新 校验插件的 manifest.json 并要求用户逐项授权，所以合并一个条目 PR 不等于信任其代码。

插件和内容源是两套独立的插件体系：插件给启动器加界面和功能，内容源只提供下载源 （搜索、详情、下载地址），本身不提供任何界面。两者分开提交、分开收录。

想自己写一个？

这个仓库同时是开发者中心——索引、类型定义、文档、脚手架都在这里：

docs/	开发者文档：从零写一个内容源、字段参考、接口速查、发布上架
sdk/index.d.ts	内容源接口的权威类型定义（只有类型，无运行时代码）
templates/content-source/	复制一份就能开工的骨架

下面这份 README 讲的是怎么把已有的插件收录进商店。

更新检测怎么工作

启动器自动检测你插件仓库的最新 Release：它读取 github.com/<owner>/<repo>/releases/latest 重定向到的 tag，和你本地已安装版本（manifest.json 里的 version）比较，发现更高的 tag 就提示「有更新」。

因此你发布新版时，只需要在插件仓库打新 tag 并发布 Release，不必回来改商店——除非你的 插件 id、名称、下载地址等元信息变了。商店页显示的版本号也来自这个最新 Release 的 tag， plugins.json 里不再需要写版本号。

Tag 命名规范（必须遵守）

tag 必须是下面两种形式之一，否则无法被正确比较：

• x.x.x —— 例如 1.0.0、2.3.1
• vx.x.x —— 例如 v1.0.0、v2.3.1

不要用 release-1.0、1.0、最新版 这类命名。版本号按数字逐段比较（1.10.0 > 1.9.0）。

如何提交 / 更新插件

方式一：提 Issue（推荐）

1. 点 Issues → New issue → 「提交插件」。
2. 按表单填写：
   • 插件 id —— 必须和你 manifest.json 里的 id 完全一致（更新检测靠它匹配）。
   • 插件名称
   • 仓库（owner/repo） —— 例如 Wemsur/terracotta-plugin。
   • 下载直链 —— 推荐用 GitHub「永远指向最新 Release」的直链： https://github.com/<owner>/<repo>/releases/latest/download/<资源名>.zip
   • 作者、简介、标签（tags）（选填）。
3. 提交后，机器人会把 Issue 转成一个修改 plugins.json 的 PR。维护者审核无误后合并， 你的插件即出现在商店中；PR 合并会自动关闭对应 Issue。

如果表单信息有误（缺字段、下载链接不是 https、仓库格式不对等），机器人会在 Issue 下留言 指出问题，不会生成 PR——按提示编辑 Issue 即可重新触发。

方式二：直接提 PR

Fork 本仓库，在 plugins.json 的 plugins 数组里追加（或按 id 替换）你的条目，提交 PR。 提交前请确保 JSON 合法。

插件条目字段（plugins.json）

{
  "id": "com.example.terracotta",
  "name": "陶瓦联机",
  "description": "一句话简介",
  "author": "你的名字",
  "github": "Wemsur/terracotta-plugin",
  "repo": "https://github.com/Wemsur/terracotta-plugin",
  "download": "https://github.com/Wemsur/terracotta-plugin/releases/latest/download/terracotta.zip",
  "tags": ["联机"]
}

字段	必填	说明
id	✅	与 manifest.json 一致，商店内唯一
name	✅	显示名称
github	✅	owner/repo，用于自动检测最新 Release 和显示版本号
download	✅	https 直链，指向打包好的 .zip；推荐用 latest-release 重定向直链
repo	选填	插件主页/仓库链接，显示为可点链接（通常填 https://github.com/<github>）
description / author / tags / icon	选填	元信息

注意：条目里不要再写 version 字段——版本号由启动器从最新 Release 的 tag 实时读取。

如何提交 / 更新内容源

内容源和插件的提交方式完全一样，只是表单和索引文件不同。

方式一：提 Issue（推荐）

1. 点 Issues → New issue → 「提交内容源」。
2. 按表单填写：
   • 内容源 id —— 必须和你 manifest.json 里的 id 完全一致。
   • 内容源名称
   • 仓库（owner/repo） —— 例如 Wemsur/Celestial-Content-Plugins。
   • 下载直链 —— 推荐用： https://github.com/<owner>/<repo>/releases/latest/download/<资源名>.zip
   • 提供的内容类型 —— 多选，填 manifest 里的机器名（见下表）。
   • 作者、简介、标签（选填）。
3. 提交后，机器人会把 Issue 转成一个修改 content-sources.json 的 PR。

方式二：直接提 PR

Fork 本仓库，在 content-sources.json 的 sources 数组里追加（或按 id 替换）你的条目。

内容源条目字段（content-sources.json）

{
  "id": "example",
  "name": "示例内容站",
  "description": "一句话简介",
  "author": "你的名字",
  "github": "Wemsur/Celestial-Content-Plugins",
  "repo": "https://github.com/Wemsur/Celestial-Content-Plugins",
  "download": "https://github.com/Wemsur/Celestial-Content-Plugins/releases/latest/download/example-0.1.0.zip",
  "contentTypes": ["world"],
  "tags": ["地图"]
}

字段	必填	说明
id	✅	与 manifest.json 一致，商店内唯一
name	✅	显示名称
github	✅	owner/repo，用于自动检测最新 Release
download	✅	https 直链，指向打包好的 .zip；推荐用 latest-release 重定向直链
contentTypes	✅	提供哪些内容类型，取值见下表；至少一个
repo	选填	内容源主页/仓库链接（通常填 https://github.com/<github>）
description / author / tags / icon	选填	元信息

contentTypes 是启动器的封闭取值，只能从下面七个里选——它决定了你的内容源出现在哪些 标签页下：

取值	含义
mod	模组
modpack	整合包
resourcepack	资源包
shader	光影
datapack	数据包
world	世界（地图）
skin	皮肤

插件要求

• 插件必须托管在 GitHub 且有 Releases（自动更新检测依赖此）。
• download 必须是 http(s)，直接指向 zip 文件。
• tag 命名符合上面的规范。
• id 与插件 manifest.json 保持一致。

内容源要求

• 内容源必须托管在 GitHub 且有 Releases，tag 命名遵循同一规范。
• download 必须是 https，直接指向打包好的 zip。
• id 与内容源 manifest.json 保持一致。
• contentTypes 至少一个，且必须是上表里的取值。
• 内容源只应声明它确实提供的能力；manifest.json 里声明了 content_types，两者要能对上。