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;
    // 这里必须提供一个这样的构造函数。
    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 接口，那么您可以：

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

PatchUtil.insertMethodHook()

以简化修补过程（虽然不如 mixin 那么简单）。

复制一个对象

修改数字字段

使用缓存和字段名称过滤器

例如：

public class FallenInserters {
    // 这需要一个 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 的类，然后在 资源根目录 中放置一个 JSON 配置文件，格式如下：

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

键 "mixin_connector" 应该指向您的类引用。

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

结构应为 resources/namespace/extra_gem_bonuses/somegembonus.json