用 lip 发布你的模组
完成本教程后,你的模组会在 GitHub 上有第一个发布版本,任何人都能用一条命令 lip install github.com/<you>/my-mod 把它装到自己的服务器上。你将在 lip.toml 中描述模组,让 GitHub Actions 构建发布版本,确认 lip 能看到它,在自己的服务器上安装它,并让它上架 LeviMC 模组。
大约需要半小时,大部分时间在等待发布构建。
你需要准备
- 一个由模组模板创建、能够构建的公开 GitHub 仓库中的模组:见你的第一个 LeviLamina 模组。本教程把仓库称为
github.com/<you>/my-mod。 lip和一个用于测试的服务器:见开你的第一个服务器。本教程使用D:\servers\survival。- 已登录 GitHub、可以推送的 Git。
需要 lip 0.41
本教程的 lip pkg … 命令随 lip 0.41 提供,在正式版发布前它还是预发布版本(lip 0.40 没有这些命令)。用 lip -v 检查版本,需要时从 lip 的发布页安装最新的 0.41。
包是 lip 能安装的任何东西。它的包 ID 是仓库地址去掉 https://:github.com/<you>/my-mod。一个版本就是一个名为 v 加版本号的 Git 标签,例如 v0.1.0,并且该标签处的 lip.toml 写着同样的版本。没有上传这一步:发布就是推送这个标签。
1. 填写 lip.toml
模板自带一个 lip.toml,它告诉 lip 要安装什么。打开它,修改下面这些字段,其余保持不变。
format = 4
id = "github.com/<you>/my-mod" # 包 ID:你的仓库
version = "0.1.0" # 即将发布的版本,不带 "v"
[info] # 显示在 LeviMC 模组和 LeviLauncher 中;lip 忽略它
name = "My Mod"
description = "Says hello."
tags = ["utility"]
logo = "https://avatars.githubusercontent.com/u/<your user id>"然后,在两个 [[variants.""]] 条目中(一个是 side = "server",一个是 side = "client"):
- 在
deps中设置模组适用的 LeviLamina 版本范围。服务端条目使用"26.60.*"这样的范围,与你在xmake.lua中固定的版本一致。客户端范围请保留其注释和写法。 - 在
urls中,把levilamina-mod-template换成你的仓库名:发布工作流上传的是<仓库名>-server-windows-x64.zip和<仓库名>-client-windows-x64.zip。 - 在
place中,把src和dest里的my-mod换成xmake.lua中的 target 名:每个 ZIP 文件里都有文件夹<target>/,它会被放到mods/<target>/。
如果你的模组只用于服务端,请删除整个客户端条目:即 side = "client" 的 [[variants.""]] 以及它下面的 deps 和 assets。
{{id}} 和 {{version}}
lip.toml 中的每个字符串都是模板。{{version}} 会变成上面的 version,所以新的发布只需要修改 version。{{id}} 会变成包 ID。
没有 lip.toml 或只有 tooth.json 的仓库
对于不是由模板创建的仓库,在其根目录运行 lip pkg init:它会询问包 ID,并写入一个最小的 lip.toml,再按上面的方式填写。lip v0.x 的 tooth.json 用 lip pkg migrate 转换;见迁移包。
2. 确认 lip 能读取它
在仓库文件夹中运行:
lip pkg view .你应该看到一段 JSON:manifest 下是你的 id 和 version,以及已填好模板的 urls,例如 https://github.com/<you>/my-mod/releases/download/v0.1.0/my-mod-server-windows-x64.zip。检查这些名字与你的仓库一致。如果文件有错,lip 会告诉你哪里不对。
3. 编写更新日志
发布工作流会把 CHANGELOG.md 中最新的一节复制到发布说明中。按 Keep a Changelog 的格式为这个版本添加一节:
## [0.1.0] - 2026-11-16
### Added
- The `/hello` command.提交并推送所有改动:
git add -A
git commit -m "Release 0.1.0"
git push4. 创建发布版本
- 在 GitHub 上你的仓库页面中,打开 Releases → Draft a new release。
- 在 Choose a tag 中输入
v0.1.0,选择 Create new tag: v0.1.0 on publish。目标是默认分支,也就是你刚推送的提交。 - 给发布起个标题,例如
0.1.0,然后点击 Publish release。 - 打开 Actions 标签页。发布触发了一次工作流运行:它构建服务端和客户端模组,然后上传。等到它出现绿色对勾(几分钟)。
- 再次打开这个发布。你应该在 Assets 下看到两个文件:
my-mod-server-windows-x64.zip和my-mod-client-windows-x64.zip,发布说明是你的更新日志。
标签必须与 version 一致
标签是 v 加完整的语义化版本:v0.1.0,而不是 0.1.0 或 v0.1。在标签 v0.1.0 处,lip.toml 必须写着 version = "0.1.0",否则 lip、LeviMC 模组和 LeviLauncher 都会跳过这个标签。
5. 确认 lip 能看到这个版本
在任意文件夹中运行:
lip pkg view github.com/<you>/my-mod你应该在末尾看到 "versions": ["0.1.0"],manifest 下是你打标签的那个 lip.toml。
6. 像用户一样安装它
-
停止服务器。如果上一个教程留下的
mods\my-mod还在,请删除这个文件夹,确保你测试的只是lip安装的内容。 -
在服务器文件夹中安装你的包:
shellcd D:\servers\survival lip install github.com/<you>/my-mod lip listlip list应该显示github.com/<you>/my-mod@0.1.0。 -
启动服务器。你应该再次看到
Hello from my first mod!,这次来自lip下载的文件。
模组上架后(第 7 步),玩家可以用 LeviLauncher 安装同一个包的客户端构建:见在 Windows 上玩模组。
7. 上架 LeviMC 模组
LeviMC 模组是 lip 的「获取模组」页和 LeviLauncher 显示的目录。它由一份仓库列表构建,即 levimc.org 仓库中的 mods/repos.txt。
通常你什么都不用做:每两小时会有一个机器人在 GitHub 上搜索带有 lip.toml 和 lip 能读取的版本标签的仓库,并发起拉取请求把它们加入列表。维护者合并后,模组会在下一次每小时构建中出现。
想更快上架,可以自己发起这个拉取请求:在 GitHub 上编辑 mods/repos.txt,添加一行 <you>/my-mod。
目录收录一个包的条件是:
- 它的最新版本依赖 LeviLamina,直接依赖或通过其他包依赖均可;
- 它把文件放到
mods/(或plugins/,或游戏加载附加包的位置); - 仓库不是 GitHub 模板,名字也不以
-template、-example、-demo、-sample或-test结尾。
之后你应该能在 https://levimc.org/zh-Hans/mods/github.com/<you>/my-mod/ 找到你的模组,页面上有它的名字、描述、图标、标签和安装命令。
发布下一个版本
- 把
lip.toml中的version改高,例如0.2.0,并在CHANGELOG.md中添加对应的一节。提交并推送。 - 按第 4 步创建发布
v0.2.0。 - 在服务器上,
lip update github.com/<you>/my-mod会安装新版本。
你现在有了什么
- 你的模组在 GitHub 上的一个发布版本,由 GitHub Actions 构建。
- 一个可以用
lip install github.com/<you>/my-mod安装的包,带有对 LeviLamina 的依赖。 - 列表收录后,你的模组会出现在 LeviMC 模组上。
下一步
lip.toml的所有字段:依赖、变体、要保留或删除的文件、钩子:lip.toml。- 包作者使用的命令:
lip pkg init、lip pkg pack、lip pkg view、lip pkg migrate。 - 在发布前安装某个分支或提交:管理包。
lip界面中的同类工具:工具。- 服务器如何安装你的包:给服务器安装模组。