概述

MaLiLib 是一个主要为 Masa 的模组提供客户端侧支持的公共代码库模组。

它基本上包含了所有可配置选项、配置文件序列化、按键绑定系统、大多数 GUI 代码和其他的实用组件，以供其他模组使用。

这个模组的名字是 Masa's Litemod Library 的简称，因为我（Masa）没什么想象力为它起个好听的名字（最早这个模组是基于 LiteLoader 制作的）

模组版本

请仔细分辨文件名来下载对应版本，隔代使用 MaLiLib 和其依赖模组会导致一定的兼容性问题。

文件名始终包含对应的模组加载器（例如 Fabric 与 Forge）、Minecraft 版本以及模组版本：

malilib---.jar（例：malilib-fabric-1.15.2-0.10.0-dev.20+arne.6.jar）

对于 MaLiLib 其他版本：

Minecraft 1.13.x，只有 Minecraft 1.13.2 受支持，如有需要请从 Chocohead's 的分支项目 中获取 Rift 进行安装；

Minecraft 1.14.4 及更高的版本提供了 Fabric 和 Forge 两个版本，目前只有 1.14.4 和 1.15.2 存在 Forge 版本，1.16.5 Forge 版本是非官方移植版本，目前不被官方支持但 Curseforge 已经移交给原作者；

依赖模组

依赖 MaLiLib 的最主要的是 Masa 的五件套：

Item Scroller - 0.14.0 及更高版本；

Litematica - 0.0.0-dev.20180614.005445 及更高版本；

MiniHUD - 0.17.0 及更高版本；

TellMe - 0.6.1 及更高版本；

Tweakeroo - 0.8.0 及更高版本。

五件套中每一个模组都会在更新日志中指明所需的 MaLiLib 准确版本。

在 MaLiLib 升级到更新的版本后，若出现五件套中某一个不工作的话，就说明此模组也更新了，也就是说 Masa 会保证他的五件套互相兼容。因此推荐始终使用最新版的 MaLiLib。

对于其他的非 Masa 官方模组，兼容性由作者的更新速度而定。

文档

目前 MaLiLib 并没有一个完整的文档：

“完成目前正在 1.12.2 主开发分支上进行的所有重构工作后，可能会有一些文档出现。

目前最好的入门方法是查看例如Litematica的代码。主要的模组类和 InitHandler.java 类包含了几乎所有进入 MaLiLib 系统的入口点和注册内容。其余部分则主要是一些实用方法和用于创建配置 GUI 和其他 GUI 的基础代码。”

——项目 Issue 中 Masa 回复如此。

注意事项

从 Malilib 的 0.10.0-dev.19 版本开始，MaLiLib 仅将所需的 Fabric API 组件（事实上 Fabric API 是一堆零件的集合体）插入到 MaLiLib 包内，因此你不需要刻意为 MaLiLib 安装 Fabric API；

Windows（LEFT_SUPER）键卡键问题，会导致切换输入法后快捷键失灵，不过该问题已在 Minecraft 1.20 及以上版本解决。可以切换游戏窗口再切换回来、或在 MaLiLib 配置中解决：

按下“打开设置界面（openGuiConfigs）”热键（默认为 A + C），或通过模组菜单打开 MaLiLib 的设置界面，更改“忽略按键（ignoredKeys）”热键为 Windows（LEFT_SUPER）键，效果如图：