JFFL

JFFL

JFFL是一个用于Javassist的Minecraftforge字节码操作库的工具,提供类似mixin的声明式补丁注入功能,允许开发者在启动时使用注解修改Minecraft和其他模组的类。

基础库

JFFL - 面向 Forge Loader 的 Javassist 框架

JFFL 是一个基于 Javassist 的 Minecraft Forge 字节码操作库,提供类似 Mixin 的声明式补丁注入能力。它允许开发者通过注解在运行时修改 Minecraft 及其他模组的类,而无需直接编写底层 ASM 或 Javassist 代码。


特性

  • 声明式注解驱动
  • 回调处理器
  • 映射重映射支持
  • 灵活的注入点

安装与依赖

repositories {
    // 将 JFFL 模组的 .jar 放入 libs 文件夹
    flatDir {
        dir 'libs'
    }
}
// 写入 dependencies(将 {versino} 替换为实际版本号):
dependencies {
    implementation fg.deobf("wertygh:jffl:{version}")
}

与 Mixin 的关系

JFFL 不是 Mixin 的替代品,而是提供另一种可选方案。两者可以共存,但不建议将两者同时应用于同一个类,因为这可能导致意外冲突。JFFL 的优势包括:

  • 轻量级,基于 Javassist 源码级操作,更易于调试
  • 支持动态回调注册,无需生成合成方法

开发与调试

在开发环境中(jffl.dev=true):

  • JFFL 输出详细日志
  • 使用 @DumpClass 将修改后的类输出到 .jffl-dump 目录
  • 支持直接使用 MCP/Mojang 名称而无需加载映射

许可证

BSD 零条款许可证


贡献与反馈

欢迎提交 Issue 和 Pull Request! 项目作者:wertygh