TransmogifyFix

TransmogifyFix

一个固定版本加上一些优化

TransmogifyFix预览查看大图

Transmogify v5.4.0 非官方修复构建


修复了模组在当前游戏版本（4.1.0.0 / 黑暗觉者补丁）下卡在“Initializing Transmogify...” / “Preparing weapon appearances”的问题，并新增增量武器路径缓存，使后续启动时跳过武器外观阶段。


问题所在


  1. AddWeapons() 在 app.EquipmentManager.WeaponCatalog 填充之前运行。由于目录为空，new_count 保持为 0，CATEGORY_ITEM_LIST[CAT_WEAPON] 从未被创建，末尾的 table.sort() 抛出 “bad argument #1 to 'sort' (table expected, got nil)”。该异常终止了 Init 协程且没有任何重试，因此模组永远停留在初始状态。

  1. utils.PrefabLoader:Step() 在最多 64 个预制体并发的情况下，等待 get_Ready() / get_MeshReady() / get_MaterialReady() 时没有超时。只要有一个预制体永远未就绪，整个构建就会永久停滞。

此构建的改动


[list] []在构建前等待武器目录（状态为“Waiting for the weapon catalog”）[/] []在排序前创建分类表，因此排序永远不会收到 nil[/] []每个预制体 20 秒超时，并记录原因（prefab-not-ready / mesh=... material=...）[/] []磁盘上的网格/材质路径缓存：reframework/data/Transmogify/weapon_paths_cache.json。仅准备新增或发生变化的预制体；每次启动时重新读取 8 个缓存预制体作为健全性检查[/] []缓存失败会降级为普通完整构建，而不会破坏初始化[/] []utils.Log() 同时通过 print() 输出，因为 log.info 在当前 REFramework 构建中静默无输出[/] [/list]

预期日志（re2_framework_log.txt）


首次启动：“Weapon prefabs: 592 prepared, 0 served from the path cache”，随后“Init complete in 18.2 s: 539 weapon and shield appearances, 1240 clothing appearances”。


后续启动：“Weapon prefabs: 0 prepared, 860 served from the path cache”。


安装


[list]
[1]正常安装 Transmogify v5.4.0（Fluffy Mod Manager），以确保 YowaveUtils.dll 和字体存在[2]将此文件中的两个 Lua 文件复制并覆盖已安装的文件[3]启动游戏[/list]
**已知遗留问题**

仍有 8 个预制体报告 [prefab-not-ready]，现在会被跳过而不再挂起：wp09_005_00、wp09_009_00、wp09_010_00、wp09_011_00、wp10_001_00、wp10_004_00、wp220005_00_0、wp227003_10_0。它们似乎属于黑暗觉者内容；已安装的 REFramework nightly（01422，2026-09-13）早于 2026-10-19 的游戏版本，因此其 pak/DLC 钩子可能无法提供它们。需要在更新的 nightly 上验证。


依赖


REFramework（nightly）、Transmogify v5.4.0、原模组所需的 _ScriptCore。

致谢与许可


原模组：Transmogify，作者 Yowave1 - https://www.nexusmods.com/dragonsdogma2/mods/420
这是非官方修复，仅包含两个修改过的 Lua 脚本（不含原始资源）。源码与差异：https://github.com/Neko-Yukari/dd2-transmogify-fix
若原作者恢复开发，此页面将被下架。