概述

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

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

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

模组版本

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

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

malilib-<模组加载器>-<Minecraft 版本>-<模组版本>.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 已经移交给原作者；

• Minecraft 1.20.5 及更高版本，需要从 Sakura-ryoko 的仓库获取。

依赖模组

依赖 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 回复如此。

1.20.5 及以上更高版本的更新

Masa 对 1.20.5 及以上更高版本的模组制作感到厌倦，并表示在重写完 Masa 全家桶之前不会有对最新版本的更新。在此期间由 Sakura-Ryoko 接手更新最新版本。

“我厌倦了，至少对新的 Minecraft 版本上的模组制作失去了兴趣（我目前更在意在旧的 Minecraft 版本上继续制作模组，就比如 Indev/Infdev/Alpha/Beta，当然还有 1.12.2 和 1.13.2……并且我在刻意的避免接触任何 1.20.5 以上的代码，无论是出于原则或者其他原因……目前我的想法是，我不会再自己更新这些模组了，至少在我完成并将臭名昭著的模组重写工作从 1.12.2 移植到更高版本的MC之前……如果这真的会发生的话，因为我已经好几个月没碰这些了……换句话说，我不会再亲自将旧代码版本的模组移植到新的MC版本。”

—— Reddit 上 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）键，效果如图：