Skip to content

Celestial Launcher插件开发文档

给启动器加一个新的下载源,或者给它加一个新的界面。从零写一个能用的插件,到发布上架。

Celestial Launcher

这份文档写给谁 ​

写给稍微懂点编程、但没有写过 Celestial 插件的人。

它不教 TypeScript、不教 Vue、不教怎么用终端——那些是前提。它只讲启动器特有的东西:插件能碰什么、不能碰什么、启动器替你做掉了哪些脏活、以及为什么这么设计。

每讲一个概念,顺序都是:

  1. 启动器为什么这么设计 —— 理解了原因,你才知道边界在哪。
  2. 你要写什么 —— 可以直接复制的代码。
  3. 不这么做会怎样 —— 真实的报错长什么样,以及怎么从报错找回这里。

两类插件,先选一个 ​

启动器有两套互不相通的插件系统。它们的 manifest 格式不同、目录不同、能做的事也不同:

内容源UI 插件
一句话给启动器加一个下载源给启动器加界面和功能
有界面吗没有有
装在哪content-sources/plugins/
索引文件content-sources.jsonplugins.json
提交表单「提交内容源」「提交插件」
想写哪个开始开始

还不确定?看你该写哪一种,它用几个问题帮你判断。

Celestial Launcher 基于 Modrinth App 构建,遵循其开源许可。