简介
这是 MinecraftForge 核心模组(coremods)的框架。
基本上,它对模组开发者很有用。
本项目的目标是提供一种简便的方式,在不直接修改现有代码的情况下改变其逻辑,而是通过编写额外的代码来实现。
无需掌握 JVM 字节码知识。
嗯,发布这个项目有点晚了,因为 Mixins 已经风靡全球,但我发现 HookLib 更顺手,而且我还有一些未实现的绝妙想法,会让它变得更好。所以也许这还有意义。
入门指南
理解 Hooks(钩子)
当你想要修改某段代码,而这段代码属于 Minecraft 或其他模组时,你可以编写如下代码:
@HookContainer
public class MyHooks {
@Hook
@OnBegin
public static void resize(Minecraft mc, int x, int y) {
System.out.println("Resize, x=" + x + ", y=" + y);
}
}
HookLib 会在 Minecraft 类中查找名为 resize 且带有两个 int 类型参数的方法,并将对 MyHooks#resize 的调用插入到找到的目标方法的开头。
然后在窗口大小调整时,你会在控制台中看到消息。
添加到项目
-
在 build.gradle 中添加依赖:
repositories { maven { url " } } dependencies { implementation "curse.maven:hooklib:12345" }
-
添加 VM 选项
-Dfml.coreMods.load=gloomyfolken.hooklib.minecraft.MainHookLoader
也可以通过 Gradle 配置:
minecraft {
mappings channel: 'snapshot', version: '20171003-1.12'
runs {
client {
workingDirectory project.file('run')
property "fml.coreMods.load", "gloomyfolken.hooklib.minecraft.MainHookLoader" //这里
}
server {
workingDirectory project.file('run')
property "fml.coreMods.load", "gloomyfolken.hooklib.minecraft.MainHookLoader" //这里
}
}
}
- 在你的 IDE 中执行 Gradle 刷新
下一步学习
查看 我们的 Wiki 以获取 API 详情和高级技巧。
路线图
-
将 HookLib 打造为用于核心模组的加载器 -
在方法调用处设置注入点 -
打印可能的 @LocalVariable 参数的方式 -
在表达式处设置注入点 -
访问私有变量的方式 -
移植到新版 Minecraft
-
用于编译时验证的注解处理器
-
核心模组的配置文件
-
缓存已应用钩子的目标类
致谢
- 感谢 @GloomyFolken 开发原始的 HookLib!
- 感谢 @Foreck 提供酷炫的标志!
你是这个资源的作者?登录后可认领此资源。
相似资源
一个用于收集生物掉落物的多区块模组。
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
查看物品与配方
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
适用于 MC 1.18+ 的 Effekseer 加载器
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧