幻化变体修复

幻化变体修复

修复了幻化护甲显示错误模型变体的问题:笨重的手套袖口、错误的袖子、裤子穿透靴子。幻化装备现在看起来与真实套装完全一致。适用于任何幻化组合、基础游戏、两个资料片、免费DLC以及NG+。

[size=5][b]Transmog Variant Fix[/b][/size]

[b]Transmogged armor finally looks like the real thing.[/b]

[size=4][b]The problem[/b][/size]
Transmog Tesham Mutna (or almost any Toussaint / Witcher gear) over another armor and the pieces don't match the real set: gloves get bulky leather cuffs, sleeves are wrong, pants clip through boots.

[size=4][b]Why it happens[/b][/size]
Gloves, chest armor, pants, boots and hair have several model [i]variants[/i]. The game picks one by checking the [b]item names[/b] of the other pieces you are wearing - for example, Tesham Mutna gloves use their slim version only if the chest piece is on a list of specific armors.
Transmog only swaps the visual template; the item underneath keeps its real name. So the game keeps checking the real names, doesn't find them on the lists and falls back to the wrong variant. The same applies to the rule that decides whether pants are tucked under the armor.

[size=4][b]What this mod does[/b][/size]
[list]
[]Picks the correct variant using the [b]transmog appearance[/b] of every piece instead of the real item names.[/]
[]Works with [b]any combination[/b] - no per-armor patches. Covers every chest, gloves, pants, boots and hair item of the base game, Hearts of Stone, Blood and Wine, the free DLCs and NG+ (457 items).[/]
[]Also fixes the pants "collapse" (tucked under armor) rule and hoods/hair.[/]
[]Transmog menu preview shows the corrected look.[/]
[]Tooltips, inventory icons and quests that require wearing a specific item keep working as usual.[/]
[/list]
[size=4][b]Requirements[/b][/size]
[list]
[]The Witcher 3 version 5.0 or newer - the update that added the built-in transmog (not available on 4.x). Tested on 5.01.[/]
[/list]
[size=4][b]Installation[/b][/size]
[list=1]
[]Extract the archive.[/]
[]Copy the [b]mods[/b] and [b]dlc[/b] folders into your game folder ([i]The Witcher 3\[/i]), merging if asked.[/]
[]Start the game. Scripts compile automatically on the first launch.[/]
[/list]
[size=4][b]Uninstallation - please read[/b][/size]
The mod stores helper items on your equipped gear. Before removing it:
[list=1]
[]Open the debug console and run [b]tmfx_uninstall()[/b][/]
[]Save the game.[/]
[]Delete [i]mods\modTransmogVariantFix[/i] and [i]dlc\dlctmfx[/i].[/]
[/list]If you removed it without doing this, simply redo your transmog at an armorer.

[size=4][b]Console commands[/b][/size]
[list]
[][b]tmfx_refresh()[/b] - recompute the variants right now.[/]
[][b]tmfx_uninstall()[/b] - remove all helper items from the save.[/]
[/list]
[size=4][b]Compatibility[/b][/size]
No vanilla files are replaced - the mod only uses script annotations ([i]@wrapMethod[/i]), so it should coexist with most mods. Wrapped functions:
[spoiler]
W3PlayerWitcher: EquipItemInGivenSlot, UnequipItemFromSlot, OnSpawned
CR4Player: OnGameCameraTick
CR4TransmogMenu: OnConfigUI, UpdateEntityTemplate
CInventoryComponent: HasTransmogAppearance
W3TooltipComponent: GetBaseItemData
W3QuestCond_IsItemEquipped: EvaluateImpl[/spoiler]
Armor added by [b]other mods[/b] is not covered yet.

[size=4][b]Known limitations[/b][/size]
[list]
[]Inside the transmog menu the fix is paused (the preview is corrected); your character updates when you close the menu.[/]
[]After changing hairstyle at a barber while wearing a transmogged hood, equip something or run tmfx_refresh() to update the hair.[/]
[/list]
[size=4][b]Bug reports[/b][/size]
If a combination still looks wrong, post in the Bugs tab with: the [b]real items[/b] you are wearing, the [b]transmog appearances[/b] applied, and a screenshot.

[size=4][b]Support[/b][/size]
This mod is and will always be [b]free[/b] - every feature, for everyone.
If it improved your game and you want to say thanks, you can endorse it, or leave a voluntary donation through the Nexus donation button. Donations don't unlock anything - they just help me keep making fixes like this. Thank you!

[size=2]The Witcher 3 is a trademark of CD PROJEKT S.A. This is an unofficial, free fan modification, not affiliated with or endorsed by CD PROJEKT RED.[/size]