refactor(heads): 优化材质获取逻辑并升级依赖版本

- 将 Heads.kt 中的材质获取改为异步非阻塞方式
- 添加 ConcurrentHashMap 缓存机制提升性能
- 实现黑名单功能防止重复失败请求
- 升级 taboolib 依赖从 2.0.27 到 2.0.30 版本
- 修改 gradle.properties 项目版本为 3.9.25

Author: YsGqHY

build.gradle.kts

@@ -5,7 +5,7 @@ plugins {
     java
     idea
     kotlin("jvm") version "2.1.0"
-    id("io.izzel.taboolib") version "2.0.27"
+    id("io.izzel.taboolib") version "2.0.30"
 }
 
 // 这段。一言难尽，但我不想动 (依托)
@@ -72,7 +72,7 @@ subprojects {
             disableOnSkippedVersion = false
         }
         version {
-            taboolib = "6.2.4-e6c8347"
+            taboolib = "6.2.4-86dd2bf"
             coroutines = null
         }
     }

gradle.properties

@@ -1,2 +1,2 @@
 group=me.arasple.mc.trmenu
-version=3.9.24
+version=3.9.25

plugin/src/main/kotlin/trplugins/menu/util/bukkit/Heads.kt

@@ -14,11 +14,13 @@ import taboolib.library.reflex.Reflex.Companion.invokeMethod
 import taboolib.library.xseries.XMaterial
 import taboolib.module.nms.MinecraftVersion
 import taboolib.platform.util.BukkitSkull
+import taboolib.common.platform.function.submit
 import trplugins.menu.module.internal.hook.HookPlugin
 import java.io.BufferedReader
 import java.io.InputStreamReader
 import java.net.URL
 import java.util.*
+import java.util.concurrent.ConcurrentHashMap
 
 /**
  * @author Arasple
@@ -43,6 +45,16 @@ object Heads {
     private val NAME = if (MinecraftVersion.major >= 1.20) "name" else "getName"
     private val USE_PROFILE = runCatching { OfflinePlayer::class.java.getDeclaredMethod("getPlayerProfile") }.isSuccess
 
+    // 异步材质缓存: 玩家名 -> 材质URL
+    private val textureCache = ConcurrentHashMap<String, String>()
+    // 正在异步加载中的玩家名集合，防止重复请求
+    private val loading = ConcurrentHashMap.newKeySet<String>()
+    // 获取失败计数: 玩家名 -> 失败次数
+    private val failedCount = ConcurrentHashMap<String, Int>()
+    // 失败超过3次后加入黑名单，不再请求
+    private val blacklisted = ConcurrentHashMap.newKeySet<String>()
+    private const val MAX_RETRIES = 3
+
     fun cacheSize(): Int {
         return CACHED_SKULLS.size
     }
@@ -87,7 +99,7 @@ object Heads {
         if (player != null) {
             return getPlayerHead(player)
         }
-        val texture = seekTexture(name)
+        val texture = seekTextureAsync(name)
         return if (texture == null) DEFAULT_HEAD else getCustomHead(texture)
     }
 
@@ -101,7 +113,7 @@ object Heads {
                     return getCustomHead(texture.getProperty<String>(VALUE)!!)
                 }
             }
-            val texture = seekTexture(player.name)
+            val texture = seekTextureAsync(player.name)
             return if (texture == null) DEFAULT_HEAD else getCustomHead(texture)
         }
     }
@@ -119,7 +131,50 @@ object Heads {
         return null
     }
 
-    fun seekTexture(name: String): String? {
+    /**
+     * 非阻塞获取材质：返回缓存值或 null，并在后台异步请求 Mojang API
+     * 首次调用返回 null（显示默认头颅），下次菜单刷新时从缓存获取
+     * 失败超过 3 次后将该名称加入黑名单，不再请求
+     */
+    private fun seekTextureAsync(name: String): String? {
+        val key = name.lowercase()
+        // 已缓存直接返回
+        textureCache[key]?.let { return it }
+        // 已被黑名单标记，不再请求
+        if (key in blacklisted) return null
+        // 未在加载中则发起异步请求
+        if (loading.add(key)) {
+            submit(async = true) {
+                try {
+                    val texture = fetchTexture(name)
+                    if (texture != null) {
+                        textureCache[key] = texture
+                        failedCount.remove(key)
+                    } else {
+                        recordFailure(key)
+                    }
+                } catch (_: Exception) {
+                    recordFailure(key)
+                } finally {
+                    loading.remove(key)
+                }
+            }
+        }
+        return null
+    }
+
+    private fun recordFailure(key: String) {
+        val count = failedCount.merge(key, 1) { old, inc -> old + inc } ?: 1
+        if (count >= MAX_RETRIES) {
+            blacklisted.add(key)
+            failedCount.remove(key)
+        }
+    }
+
+    /**
+     * 实际执行 HTTP 请求获取材质（仅在异步线程调用）
+     */
+    private fun fetchTexture(name: String): String? {
         val user = urlJson(USER_API + name)
         if (user != null && user.has("id")) {
             val uuid = user["id"].asString
@@ -140,6 +195,10 @@ object Heads {
         return null
     }
 
+    fun seekTexture(name: String): String? {
+        return textureCache[name.lowercase()]
+    }
+
     private fun urlJson(url: String): JsonObject? {
         val text = urlText(url)
         return if (text.trim { it <= ' ' }.isEmpty()) {