Fallen Lib

用于修补模组类的委托式 API。

它可以挂钩指定的类或所有子类，
从而在扩展模组行为时减少重复修补。

要使用此 API，必须实现 `IFallenPatch` 接口，并为类添加带有正确参数的 `@FallenPatch` 注解。

例如： 

@FallenPatch(
        priority = 1000,
        targets = @Targets(
                exact = {SomeClass.class},
                subclass = {SuperClass.class}),
        inserters = {FallenInserters.class})
public class FallenPatch implements IFallenPatch {
    private final IPatchDescriptor desc;
    // Here you must provide a constructor like this.
    public FallenPatch(IFallenPatchCtorContext iFallenPatchCtorContext) {
        desc = iFallenPatchCtorContext.currentPatch();
    }

    @Override
    public void apply(ClassNode cn, IFallenPatchContext iFallenPatchContext) {
        MethodInsnNode hook = iFallenPatchContext.getFallenInserter(
                InserterKey.of("xxx.xxx.FallenInserters",
                        "hook",
                        InserterType.STANDARD_VOID));
        for (MethodNode method : cn.methods) {
            InsnList insns = method.instructions;
            if (insns == null) continue;
            PatchUtil.insertMethodHook(cn,
                    method,
                    m -> m instanceof MethodInsnNode mn
                            && mn.owner.equals("xxx.xxx.ClassName")
                            && mn.name.equals("methodName")
                            && mn.desc.startsWith("(Ljava/lang/Object;")
                            && Type.getReturnType(mn.desc).getSort() != Type.VOID,
                    InserterType.STANDARD_VOID,
                    hook,
                    false,
                    false);
        }
    }
}

`inserters` 指向一个至少包含一个带有 `@FallenInserter` 注解方法的类。
例如 `FallenInserters.class`：

public class FallenInserters {
    @FallenInserter(type = InserterType.STANDARD_VOID)
    public static void hook(IInserterContext<Object, Object> ctx, Object... args) {
        Object rec = ctx.receiver();
    }
}

{
  "required": true,
  "min_version": "1.2.0",
  "package": "xxx.package.name",
  "fallen_patches": [
    "FallenPatch",
    "PatchClassName"
  ]
}

目前，FallenPatch 仅支持修补模组类。
未来可能会添加更多支持。

与 FallenPatch 配合使用时，请在具有正确参数类型和返回类型的方法上使用 `@FallenInserter` 注解，

现在有 2 种 InserterType：

`InserterType.STANDARD` 

`InserterType.STANDARD_VOID`

默认类型是 standard，使用方式如下： 

@FallenInserter(type = InserterType.STANDARD)
public static Object hook(IInserterContext<Object, Object> ctx, Object... args) {
    return ctx.ret();
}

@FallenInserter(type = InserterType.STANDARD_VOID)
public static void hook(IInserterContext<Object, Object> ctx, Object... args) {
}

`ctx` 有 `ctx.receiver()` 和 `ctx.ret()“ 方法，分别用于获取 `this（可能为 null）` 和被插入方法的返回对象。如果该方法有返回值，并且方法中的 `replaceReturn` 标志为 `true`，则返回值会替换原方法的返回值。你可以尝试使用以下工具 `ObjectModifierFactory` 修改该对象的数值字段并返回。

`args` 是一个 `Object[]`，包含被插入方法的所有参数。`InserterType.STANDARD` 在方法执行后调用，因此这些参数仅供查看，请勿修改。

如果你正确配置并实现了带有正确注解的 IFallenPatch 接口，就可以这样获取：

 MehtodInsnNode hookMethod = iFallenPatchContext.getFallenInserter(
                InserterKey.of("your.class.name", 
                               "methodName", 
                               InserterType));

PatchUtil.insertMethodHook()

让补丁编写更简单（不过还是没有 mixin 那么简单）。

复制对象

修改数值字段

使用缓存和字段名称筛选器

例如： 

public class FallenInserters {
    // this needs a Predicate<String>
   private static final ObjectModifierFactory FACTORY = new ObjectModifierFactory(s -> {
            String filedName = s.toLowerCase();
            if (name.contains("xxx")) return true;
            return false;});
   @FallenInserter(type = InserterType.STANDARD)
    public static Object hook(IInserterContext<Object, Object> ctx, Object... args) {
        Object ret = ctx.ret()
        return FACTORY.doSomething(ret);
    }
}

此工具主要用于在运行时调整对象，而不修改原始对象。

这是一个类似服务的注册表。通过在你的模组中实现官方的 IMixinConnector 类，你可以在 IDEA 中测试按条件加载的 mixin 配置。

使用方法如下：指定一个实现了 IMixinConnector 的类，然后在 resources 根目录中放置一个符合以下格式的 json 配置：

{
  "required": true,
  "min_version": "1.3.2",
  "mixin_connector": "net.kayn.apotheotic_hostility.FGAMixinConnector"
}

“mixin_connector” 键的值应为你的类引用。

现在可以像 1.21.1 一样，在 Apotheosis 1.20.1 中通过数据包注册额外的宝石加成。

文件路径应为 `resources/namespace/extra_gem_bonuses/somegembonus.json`