描述

要用魔法打败魔法。

注意

百科中提供模组文件下载，由于对应MC版本并非选择式，自行填写会弄乱版本分类，故将包装jar版本填写为通用，具体支持MC版本请查看带有MC版本后缀的文件，但我们强烈建议您下载包装jar。因为：

关于最近频繁出现的问题：“为什么我的游戏无法检测到MagicLib“，请查看此issue。

功能

兼容 API

• 多版本兼容，是的，我们使用了一些手段来兼容Fabric Loader上运行的所有Minecraft版本（1.14+）。这是怎么做到的？魔法:(
  

• 我们编写了 兼容API，用于平衡各版本间的差异。对于同时维护多个MC版本模组开发者来说，可以在一定程度上忽视 Mojang 对于 MC 的更改。你不必关心 Mojang 做了什么，使用 API 你将轻松地使不同MC版本间使用相同的代码。

依赖检查

我们加入了一套完整的依赖检查系统，通过表达式，甚至自定义谓词来验证依赖可用性，他可以应用于多种场景，例如：

• MagicLibMixinPlugin为模组提供了额外的依赖检查，它弥补了Fabric Loader的一些缺陷，例如，他为客户端侧和服务端侧设置不同的依赖。
  

• 依赖检查同样可以应用在Mixin上，仅当条件满足时，Mixin才会被应用。
  

• 依赖检查同样可以应用配置管理上，以实现仅当满足条件时，该配置项才会被展示。
  

• 在以后的开发中可能还包含更多的功能。

I18n

• 我们重新实现了独立于MC的I18n，并且可以设置 MagicLib I18n 的备用语言列表。Mojang在对待I18n文本使用了一些手段，使得String.format的部分特性不可用，这通常会让人很恼火。
  

Malilib 扩展

• 我们为 Malilib 编写了一个非常实用的配置管理模块，我们将尽可能的使用基本数据类型与 Java注解 来生成配置清单。同时对于配置文件，我们加入了配置版本系统，这将有助于您在配置文件结构发生重大变动时，快速的编写您自定义的迁移解决方案。
  

• 我们移植了一些来自高版本Malilib的特性，以便于在使用适配较低版本 Minecraft 的 Malilib 时，使用同样的特性。

开发
支持

当前主开发版本：1.20.1
并且使用 预处理 来兼容各版本。
注意: 我仅接受以下版本的议题，也就是每个MC主要版本的最后一次更新。请注意该信息的时效性，任何不在此列出的版本议题均会被关闭。

此版本信息请以GitHub自述文件为准！

• Minecraft 1.14.4
  

• Minecraft 1.15.2
  

• Minecraft 1.16.5
  

• Minecraft 1.17.1
  

• Minecraft 1.18.2

• Minecraft 1.19.2

• Minecraft 1.19.3

• Minecraft 1.19.4

• Minecraft 1.20.1

混淆映射表

此模组使用 Mojang 官方的混淆映射表来反混淆 Minecraft，并插入补丁程序。

文档

英文文档与中文文档是逐行对应的。

许可

此模组在 LGPLv3 许可证下发布。 你可以自由学习，或将其融入到你自己的项目中。