Grimoire-Legacy 项目使用教程
1. 项目介绍
Grimoire-Legacy 是一个通用目的的 Mixin 加载器框架,旨在允许在 Minecraft 1.7.10 和 1.12.2 版本中正确实现 Mixin。该项目的主要功能是提供一个核心模块,用于加载和管理 Mixin 补丁,从而修复和增强 Minecraft 的多个模组。
主要特点
- Mixin 支持:提供 Sponge Mixin 支持,允许开发者创建补丁模块。
- 兼容性:虽然 Grimoire 本身可能与其他项目不兼容,但建议使用 UniMixins 以保持与其他项目的兼容性。
- 持续开发:自 2022 年 1 月 20 日起,该项目由 Aizistral 独立继续开发和维护。
2. 项目快速启动
2.1 环境准备
- Java 8:确保已安装 Java 8 或更高版本。
- Minecraft 1.7.10/1.12.2:确保已安装对应版本的 Minecraft。
2.2 下载与安装
-
克隆仓库:
git clone https://github.com/jshrake/grimoire-legacy.git
-
重命名 JAR 文件: 根据项目说明,可能需要重命名 JAR 文件以确保其正确加载。
mv renameThisPart Grimoire-1.7.10-1.0.2a.jar Grimoire-1.7.10-1.0.2a.jar
-
放置 JAR 文件: 将重命名后的 JAR 文件放置在 Minecraft 的
mods
文件夹中。
2.3 启动 Minecraft
-
启动 Minecraft: 启动 Minecraft 并选择对应的版本(1.7.10 或 1.12.2)。
-
验证安装: 进入游戏后,检查控制台日志以确保 Grimoire 已正确加载。
3. 应用案例和最佳实践
3.1 修复模组问题
Grimoire 主要用于修复 Minecraft 模组中的问题。例如,GTNewHorizons 是一个大型模组整合包,使用 Grimoire 来修复和增强其功能。
3.2 创建补丁模块
开发者可以使用 Grimoire 创建补丁模块,通过 Mixin 技术对 Minecraft 进行修改。以下是一个简单的补丁模块示例:
@Mixin(EntityPlayer.class)
public abstract class MixinEntityPlayer {
@Inject(method = "onUpdate", at = @At("HEAD"))
private void onUpdate(CallbackInfo ci) {
// 自定义代码
}
}
3.3 最佳实践
- 使用 UniMixins:建议使用 UniMixins 以保持与其他项目的兼容性。
- 定期更新:关注 Aizistral 的仓库以获取最新的更新和修复。
4. 典型生态项目
4.1 GTNewHorizons
GTNewHorizons 是一个基于 GregTech 的大型模组整合包,使用 Grimoire 来修复和增强其功能。
4.2 Sponge Mixin
Sponge Mixin 是 Grimoire 的核心依赖,提供了强大的 Mixin 功能,允许开发者对 Minecraft 进行深度定制。
4.3 Aizistral-Studios/Grimoire
Aizistral 的 Grimoire 仓库是当前项目的最新版本,包含更多功能和修复。
通过以上步骤,您可以快速上手并使用 Grimoire-Legacy 项目,享受其强大的 Mixin 功能和模组修复能力。