HookLib

模组

· 作者 hohserg

核心模组框架

0 本站下载 0 关注 更新于 9 个月前

最新 3.28 · 1.12.2 · Forge

一键开服(送7天)

简介

这是 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 提供酷炫的标志!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源