feat(incision): 新增字节码织入模块与 Accessor API

Ray_Hughes

Author: FxRayHughes

.gitignore

@@ -5,4 +5,6 @@ bin
 .settings
 .classpath
 .project
-doc
+doc
+.claude/
+nul

common/src/main/java/taboolib/common/PrimitiveLoader.java

@@ -56,6 +56,9 @@ static List<String[]> deps() {
         deps.add(new String[]{"!org.ow2.asm".substring(1), "asm", "9.8"});
         deps.add(new String[]{"!org.ow2.asm".substring(1), "asm-util", "9.8"});
         deps.add(new String[]{"!org.ow2.asm".substring(1), "asm-commons", "9.8"});
+        // 都是必要的 incision 强制依赖
+        deps.add(new String[]{"!org.ow2.asm".substring(1), "asm-tree", "9.8"});
+        deps.add(new String[]{"!org.ow2.asm".substring(1), "asm-analysis", "9.8"});
         return deps;
     }
 

module/bukkit-nms/src/main/kotlin/taboolib/module/nms/AsmClassTranslation.kt

@@ -85,6 +85,8 @@ class AsmClassTranslation(val source: String) {
             newBytes = remapper.applyRequireTransform(newBytes)
             // 应用 dynamic 转换（检测并替换 dynamic() 调用为直接 JVM 指令）
             newBytes = remapper.applyDynamicTransform(newBytes)
+            // 应用额外 transformer（incision 等模块在此织入）
+            newBytes = remapper.applyExtraTransforms(source, newBytes)
             // 缓存
             BinaryCache.save("remap/$source", combinedVersion) { newBytes }
             // 保存字节码用于调试

module/bukkit-nms/src/main/kotlin/taboolib/module/nms/remap/RemapTranslation.kt

@@ -6,6 +6,7 @@ import org.objectweb.asm.ClassWriter
 import org.objectweb.asm.Opcodes
 import taboolib.common.reflect.ClassHelper
 import taboolib.module.nms.MinecraftVersion
+import java.util.concurrent.CopyOnWriteArrayList
 
 /**
  * 插件内部的类
@@ -29,6 +30,36 @@ open class RemapTranslation : Remapper() {
     val obc2 = "org/bukkit/craftbukkit/${MinecraftVersion.minecraftVersion}/"
     val obc3 = "org/bukkit/craftbukkit/"
 
+    companion object {
+
+        /**
+         * 额外的字节码变换器 —— 在 remap + require + dynamic 三步之后执行。
+         *
+         * 供 [taboolib.module.incision] 等模块在 NMSProxy 管线末端注入自定义织入逻辑。
+         * 每个 transformer 的签名：`(className, bytes) -> ByteArray?`；
+         * 返回 null 表示不修改，返回非 null 则替换当前字节码继续传递下一个 transformer。
+         *
+         * 线程安全：使用 [java.util.concurrent.CopyOnWriteArrayList]。
+         */
+        @JvmStatic
+        val extraTransformers: MutableList<(String, ByteArray) -> ByteArray?> = CopyOnWriteArrayList()
+    }
+
+    /** 运行 [extraTransformers] 管线；供 [taboolib.module.nms.AsmClassTranslation] 调用。 */
+    fun applyExtraTransforms(className: String, classBytes: ByteArray): ByteArray {
+        if (extraTransformers.isEmpty()) return classBytes
+        var cur = classBytes
+        for (t in extraTransformers) {
+            try {
+                val out = t(className, cur)
+                if (out != null) cur = out
+            } catch (e: Throwable) {
+                e.printStackTrace()
+            }
+        }
+        return cur
+    }
+
     override fun map(internalName: String): String {
         return translate(internalName)
     }
@@ -143,4 +174,4 @@ open class RemapTranslation : Remapper() {
             classBytes
         }
     }
-}
+}