新的转译逻辑，Paper/Spigot 1.20.4、1.21.11、26.1 测试通过

Author: Micalhl

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

@@ -216,7 +216,7 @@ object MinecraftVersion {
 
     /**
      * 当前运行版本的 Paper 映射文件
-     * 仅用与对 TabooLib 本体的 NMSProxy Impl 进行二次转译（插件本体会自动转译）
+     * 一、用于对 TabooLib 本体的 NMSProxy Impl 进行二次转译（插件本体会自动转译）
      *
      * ```
      * 方法/字段逻辑：
@@ -236,6 +236,38 @@ object MinecraftVersion {
      * ```
      *
      * 这么做的原因是要保证 TabooLib 本体必须能够在 Spigot 环境下运行。
+     *
+     * 二、用于在 Spigot Deobf 环境下，将所有 NMSProxy Impl 进行转译
+     *
+     * 在 26.1 版本后，Minecraft 不再被混淆，这意味着不再有混淆表公布
+     * 所以，需要提供一种新的转译逻辑，在 1.17 至 1.20.4 中，将 Mojang Deobf 转译为 Spigot Deobf。
+     *
+     * ```
+     * 方法/字段逻辑：
+     * Spigot Deobf -> Mojang Obf (1.18+)
+     * Mojang Deobf -> Mojang Obf
+     *
+     * 以 SystemUtils 为例：
+     * net/minecraft/Util.backgroundExecutor() -> net/minecraft/SystemUtils.g()
+     *                                         ^
+     *                               通过检索下载到的 Spigot 混淆表获得
+     * net/minecraft/SystemUtils.ioPool() -> net/minecraft/SystemUtils.g()
+     *                                    ^
+     *                  如果是 Paper 服务端则检索服务端里的 reobf.tiny，
+     *                  如果是 Spigot 则下载对应版本的 reobf.tiny 并检索
+     * 类逻辑：
+     * Spigot Deobf 保持不变
+     * Mojang Deobf -> Spigot Deobf
+     *              ^
+     *  通过 reobf.tiny 查找并转译为 Spigot Deobf
+     *
+     * 以 SystemUtils 为例：
+     * net/minecraft/util/SystemUtils 保持不变
+     * net/minecraft/util/Util -> net/minecraft/util/SystemUtils
+     * ```
+     *
+     * 这么做是为了让用户可以在 1.17+ 只通过 Mojang Deobf 而不是 Spigot Deobf 编写 nms 代码，
+     * 而不需要同时为了兼容 26.1 和低版本，编写两套代码。
      */
     val paperMapping by unsafeLazy {
         // 如果已被其他插件加载，直接从内存中读取
@@ -325,7 +357,6 @@ object MinecraftVersion {
         }
         // 在 Bukkit 平台下，注册 Reflex 重定向实现
         // 如果是非混淆服务端（26.1+），则不注册
-        // TODO: 原本版本出问题
         if (runningPlatform == Platform.BUKKIT && !isUnobfuscated) {
             Reflex.remapper.add(if (isMojangMapping) RemapReflexPaper() else RemapReflexSpigot())
         }

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

@@ -53,9 +53,17 @@ open class RemapTranslation : Remapper() {
                 spigotName = if (MinecraftVersion.isMojangMapping) MinecraftVersion.paperMapping.classMapSpigotToMojang[spigotName] ?: spigotName else spigotName
                 spigotName.replace('.', '/')
             } else {
-                key
+                // 如果是非 Universal CraftBukkit 环境，且这里是 Mojang.Fullname，则：尝试获取 Spigot.Fullname 并返回，如果获取不到，那么 key 就是 Spigot.Fullname 本身
+                if (!MinecraftVersion.isMojangMapping) {
+                    MinecraftVersion.paperMapping.classMapMojangToSpigot[key.replace('/', '.')]?.replace('.', '/') ?: key
+                } else {
+                    // 如果为 Universal CraftBukkit 环境，这里不管是 Spigot.Fullname 还是 Mojang.Fullname 都不需要动
+                    // 如果是 Spigot.Fullname，Paper PluginRemapper 会进行转译
+                    key
+                }
             }
         } else {
+            // TODO 如果是 Mojang.Fullname 则尝试寻找对应的 Spigot.Fullname
             if (key.startsWith("net/minecraft")) "net/minecraft/server/${MinecraftVersion.minecraftVersion}/${key.substringAfterLast('/')}" else key
         }
     }

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

@@ -33,7 +33,14 @@ open class RemapTranslationLegacy : RemapTranslation() {
             val runningOwner = translate(owner).replace('/', '.')
             // 追溯父类和接口
             val findPath = parentsCacheMap.getOrPut(runningOwner) { findParents(runningOwner).reversed() }
-            return MinecraftVersion.spigotMapping.fields.find { it.translateName == name && it.path in findPath }?.mojangName ?: name
+            // 这里肯定是非 Universal CraftBukkit 环境
+            // 先尝试当作 Mojang Deobf 转为 Mojang obf，否则当作 Spigot Deobf 转为 Mojang obf
+            // 这里有个好处是：Spigot 方法和字段的映射在 1.18+ 才提供，但是 Mojang Deobf 从 1.17 开始就提供了，可以直接使用
+            var mojangName = MinecraftVersion.paperMapping.fields.find { it.translateName == name && it.path in findPath }?.mojangName
+            if (mojangName == null) {
+                mojangName = MinecraftVersion.spigotMapping.fields.find { it.translateName == name && it.path in findPath }?.mojangName
+            }
+            return mojangName ?: name
         }
         return name
     }
@@ -54,10 +61,20 @@ open class RemapTranslationLegacy : RemapTranslation() {
             val runningOwner = translate(owner).replace('/', '.')
             // 追溯父类和接口
             val findPath = parentsCacheMap.getOrPut(runningOwner) { findParents(runningOwner).reversed() }
-            return MinecraftVersion.spigotMapping.methods.find {
+            // 这里肯定是非 Universal CraftBukkit 环境
+            // 先尝试当作 Mojang Deobf 转为 Mojang obf，否则当作 Spigot Deobf 转为 Mojang obf
+            // 这里有个好处是：Spigot 方法和字段的映射在 1.18+ 才提供，但是 Mojang Deobf 从 1.17 开始就提供了，可以直接使用
+            var mojangName = MinecraftVersion.paperMapping.methods.find {
                 // 根据复杂程度依次对比
                 it.translateName == name && it.path in findPath && RemapHelper.checkParameterType(desc, it.descriptor)
-            }?.mojangName ?: name
+            }?.mojangName
+            if (mojangName == null) {
+                mojangName = MinecraftVersion.spigotMapping.methods.find {
+                    // 根据复杂程度依次对比
+                    it.translateName == name && it.path in findPath && RemapHelper.checkParameterType(desc, it.descriptor)
+                }?.mojangName
+            }
+            return mojangName ?: name
         }
         return name
     }