MagicLib - MagicLib 魔法库

MagicLib

中文

❗在报告问题之前，请务必先尝试最新的 beta version，以检查该问题是否仍然存在。

描述

一个多功能模组依赖库。

依赖

功能

兼容 API

• 多版本兼容，是的，我们使用了许多手段来使其兼容运行在 Fabric Loader 上的所有最新 Minecraft 版本（1.14+）。这是如何做到的？Magic :(
• 我们编写了兼容性 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 时，也能更方便地使用相同的功能。

开发

支持

当前主要开发的 Minecraft 版本：1.20.1

并使用 preprocess 来兼容所有版本。

注意：我只接受以下版本的 issues。请注意，此信息具有时效性，任何未列在此处的版本问题都将被关闭

• 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 official mappings 来反混淆 Minecraft 并插入补丁。

文档

英文文档与中文文档逐行对齐。

许可证

本项目采用 LGPLv3 许可证。欢迎学习其实现方式，并将其整合到你自己的项目中。