模组与集成

LeviLauncher 支持超出“基础启动器”范围的模组相关工作流。

当前可用能力

导入模组包（.mcmod）
仍兼容 .zip 包和单独的 .dll 模组：在文件选择框中选择 所有文件 (*.*) 即可
启用或禁用已安装模组
删除不再需要的模组
使用 CurseForge 相关浏览与获取流程
使用兼容 lip 的内置包管理器安装 LIP 软件包
配合 LeviLamina 等加载器工作流

这是高级区域

模组、加载器与包安装集成的兼容性变化往往更快，尤其是在 Minecraft 预览版（Preview）上。请把这里当作高级能力，逐步测试。

向游戏加载原生模组（.so 库）
在隔离版本中维护带模组的环境

想开发原生模组？请参阅 LeviLamina 文档中的 Android 原生模组。

CurseForge Windows

启动器提供 CurseForge 相关浏览与包流程，帮助你在应用内更方便地寻找合适资源。

适合以下需求：

需要更引导式的查找体验
想更快看到某个项目的兼容文件
不想所有搜索都在启动器外完成

lip 与 LeviLamina Windows

LeviLauncher 内置了兼容 lip 的包管理器，无需另外安装 lip 或 .NET 运行时。它遵循 lip：每个版本的软件包记录在 .lip/state.json 中，软件包从其 lip.toml 读取（只有 tooth.json 的旧软件包仍可使用）。用旧版启动器安装过 LeviLamina 或 LIP 软件包的版本（tooth_lock.json）会在第一次软件包操作时自动迁移。开启 使用镜像源 时，从 GitHub 下载软件包会经过设置中的 GitHub 代理；否则直接连接 GitHub（如已设置系统代理，则经过系统代理）。之前保存过的 GitHub 代理，或 lip 的 config.toml（位于 %APPDATA%\lip，例如通过 lip config set github_proxy <URL> 设置）中的 github_proxy，在两种情况下都会生效。清理缓存 可删除已下载的软件包文件。

自 lip v0.40 起，lip.toml 与 .lip/state.json 中的每个条目都用 side（server 或 client）和 platform（.NET 运行时标识符，例如 win-x64）表示其运行位置；lip v0.39 及更早版本把它们叫作 platform 和 runtime。由 lip v0.39 及更早版本或旧版启动器写入、仍使用旧键名的 .lip/state.json，会在下一次包操作前自动转换：把 platform 改名为 side、把 runtime 改名为 platform。lip 仍无法读取的文件会被拒绝，并提示需要的修改：把 platform 改名为 side、把 runtime 改名为 platform，或重新安装该版本的软件包。

这类集成更适合希望使用包驱动或加载器驱动工作流的高级用户。

最佳实践：

先从稳定的正式版（Release）版本开始
不要一次变更多个高风险因素
记录下“最后一次成功工作”的版本组合

要为客户端版本添加 LeviLamina，请参阅 LeviLamina 文档中的在Windows上安装客户端。

LeviMC 模组页面

LeviMC 模组 页面列出 levimc.org/mods 中提供 Windows x64 客户端构建的模组（即有 side = "client" 且 platform = "win-x64" 的条目）。可以按名称、ID、作者、标签或简介搜索；按相关性、星标、最近更新或最新发布排序；并按游戏版本、LeviLamina 版本、标签（前置库 / API、经济等推荐标签排在最前，也可以排除某个标签）、许可证（宽松等类别或 SPDX ID）、依赖和作者（模组页面上的 …的更多项目）筛选。安装模组时会选择其 client 变体，没有时选择默认变体，再没有时选择第一个有客户端构建的其他变体；在模组页面中也可以改选其他这样的变体。

原生模组 Android

原生模组会在游戏进程中运行原生代码。只安装来自可信来源的模组，并先在隔离版本中测试。

如果要自己开发，请参阅 LeviLamina 文档中的 Android 原生模组。

如果加了模组后出错

先禁用最新加入的模组
与上一个可正常工作的状态进行对比
进一步测试前先转移或备份重要世界
然后继续查看更新与故障排查