模组如何加载
Minecraft 基岩版本身不支持模组:模组是原生代码,由加载器在游戏启动时放进游戏进程。本页说明 LeviLauncher 使用哪些加载器、模组放在哪里,以及添加模组的几种方式之间的关系。
模组放在哪里 Windows
每个实例都有一个 mods\ 文件夹(见文件夹与文件)。每个模组是其中的一个文件夹,带有描述该模组的 manifest.json:
| 字段 | 含义 |
|---|---|
name |
模组名称。 |
entry |
加载器加载的文件,相对于模组文件夹(一个 .dll)。 |
version |
模组版本。 |
type |
由哪个加载器加载:preload-native 由 LeviLauncher 的原生加载器加载;LeviLamina 的模组有它们自己的类型。 |
author |
作者(可选)。 |
模组属于某一个实例,不受隔离影响,隔离只涉及游戏数据。
关闭模组(在 管理模组 中,或用 LeviLauncher.exe mod disable)会把它的 manifest.json 改名为 manifest.json.close;重新开启时再改回来。模组的文件留在原处,查找 manifest.json 的加载器就不会再找到这个模组。
两个加载器 Windows
LeviLauncher 的原生加载器
LeviLauncher 安装或准备实例时,会把自己的加载器 LeviLauncher.dll 放在游戏可执行文件旁边,并把它加入可执行文件的导入表,使 Windows 随游戏一起加载它。这适用于 x64 构建,GDK 和 UWP 都一样;隔离也是靠它实现的。
游戏启动时,原生加载器按名称顺序遍历 mods\ 中的文件夹,加载每个 type 为 preload-native 的模组的 entry。没有 manifest.json 的文件夹和其他类型的模组会被跳过。如果实例里有另一个预加载器(游戏旁边的 preloader.dll),原生加载器会把全部模组加载交给它。原生加载器需要 Visual C++ 运行库(x64),LeviLauncher 会检查并提供安装。
LeviLamina
LeviLamina 是 LeviMC 的模组加载器。LeviMC 模组上的大多数模组都是 LeviLamina 模组:它们需要支持该实例游戏版本的 LeviLamina。LeviLauncher 在其支持的版本的 GDK 实例上安装 LeviLamina(安装版本时的 安装 LeviLamina 开关,或 实例设置 的 加载器 选项卡),作为内置包管理器的一个软件包。
添加模组的三种方式 Windows
| 你添加的是 | LeviLauncher 的做法 |
|---|---|
LeviMC 模组 中的模组(或 mod install owner/repo) |
用内置的、与 lip 兼容的包管理器把它作为软件包安装:下载适用于本平台的发布版本,安装它依赖的软件包,并记录在实例的 .lip\state.json 中。模组需要 LeviLamina 而已安装的版本不合适(或尚未安装)时,会先安装一个兼容的 LeviLamina。这样安装的模组可以作为软件包更新和删除。 |
.mcmod 模组包(或 .zip) |
解压到 mods\ 下的一个新文件夹。压缩包中必须包含 manifest.json。 |
单个 .dll |
放进 mods\ 下的一个新文件夹,并为它写一个 manifest.json:默认以文件名为名称,类型为 preload-native,版本为 0.0.0。 |
软件包在它的 lip.toml 和 .lip\state.json 中用 side(client 或 server)和 platform(例如 win-x64)记录它在哪里运行。对客户端,LeviLauncher 安装模组的 client 变体(如果有),否则安装其默认变体。详情(包括旧软件包如何迁移)见模组与集成。
Android Android
Android 版加载原生模组:在游戏进程中运行的 .so 库。请把装了模组的环境放在隔离的版本中,并只安装来源可信的模组。想自己制作,请参阅 LeviLamina 文档中的 Android 原生模组。