FancyNpcs + FancyNpcsModel Folia maintenance 2026.08.09

FancyNpcs + FancyNpcsModel Folia 维护版

这是从公开维护分支 f59fa73 构建并验证的首个双插件版本，面向 Minecraft 1.21.11、Java 25 与 Folia/Luminol。

包含内容

• FancyNpcs-2.11.0+370.jar
• FancyNpcsModel-1.1.0+10.jar

主要修复

• /npc skin 的正版用户名、SkinsRestorer、服务端 Profile 与 Mojang 查询移出 Folia 区域线程，避免换肤命令卡住服务器。
• 为皮肤查询增加有限线程池、队列、超时、同请求合并，以及同一 NPC 仅应用最后一次请求的保护。
• 修复 BetterModel 模型按玩家可见性加载，避免新玩家进入时让旧玩家的模型重复闪白。
• 处理离开并重新进入加载范围、NPC 移动/旋转、模型重载和插件关闭时的 tracker 生命周期。
• 隐藏模型 NPC 的原版实体与原版发光轮廓，并将左右键交互转发到 FancyNpcs 动作。

验证

• Gradle shadowJar 源码构建通过。
• 在独立 Luminol 1.21.11 环境中与 BetterModel 3.2.0、SkinsRestorer 15.12.5 一同启动和正常停止通过。
• 临时 NPC 连续执行五次 /npc skin <npc> LegoLegs33121 后皮肤成功应用；紧随其后的标记命令在 184 ms 内被处理，未等待网络查询。

SHA-256

FancyNpcs-2.11.0+370.jar
7769DC41861982BD83DE8548A3D5B271878405C8B3A79654C85219D6BD42CBD4

FancyNpcsModel-1.1.0+10.jar
A9C5B4E2A6D9FCE609191BEA17A0386B2E3A6F468852BF1CD67BAECE7C071651

部署提示

请完整停止子服后替换两个 JAR，确保 plugins 目录中每种插件只保留一个版本，再正常启动。不要使用 PlugManX 热替换这组插件。首次部署前请备份旧 JAR、配置和 NPC 数据。

本维护版只承诺上述测试组合；其他 Minecraft 版本、Paper/Spigot 或不同 BetterModel API 版本需要单独验证。