Keep armor on during meal cutscene

[size=4][b]# Keep Armor On During Meal Cutscene[/b][/size]

[size=4][b]A small REFramework Lua mod for Monster Hunter Wilds that keeps your hunter's chest armor visible during the meal/villager cutscene that normally swaps your outfit for the inner-clothes set.[/b][/size]

[size=4][b]## What it does[/b][/size]

[size=4][b]The meal cutscene at the campsite/villager normally replaces your hunter's full armor outfit (chest, arms, waist, slinger) with a fixed inner-clothes set so everyone shows the same body in the cutscene. This mod blocks that swap so your armor stays visible.[/b][/size]

[size=4][b]- Chest, arms, waist, slinger: visible (your equipped armor stays on)[/b][/size]
[size=4][b]- Other slots (helm, legs, mantle): unchanged from vanilla[/b][/size]
[size=4][b]- Cutscene plays normally otherwise — animations, dialogue, camera, NPC[/b][/size]

[size=4][b]## Requirements[/b][/size]

[size=4][b]- Monster Hunter Wilds (any version, since the mod doesn't use binary addresses)[/b][/size]
[size=4][b]- REFramework (nightly recommended)[/b][/size]

[size=4][b]That's it. No other dependencies.[/b][/size]

[size=4][b]## Installation[/b][/size]

[size=4][b]### Option 1 — Manual[/b][/size]

[size=4][b]Extract the contents of the zip into your game folder:[/b][/size]

[size=4][b][/b][/size] <br />[size=4][b]&lt;game install&gt;/MonsterHunterWilds/[/b][/size] <br />[size=4][b]└── reframework/[/b][/size] <br />[size=4][b]    └── autorun/[/b][/size] <br />[size=4][b]        └── keep_armor_on.lua[/b][/size] <br />[size=4][b][/b][/size]

[size=4][b]The reframework/autorun/ folder is created by REFramework on first run; if it doesn't exist, launch the game once with REFramework installed first.[/b][/size]

[size=4][b]### Option 2 — Fluffy Mod Manager[/b][/size]

[size=4][b]Drag the .zip into Fluffy Mod Manager's Wilds mod list and click Enable.[/b][/size]

[size=4][b]### Option 3 — Vortex / generic[/b][/size]

[size=4][b]Point the mod manager at the .zip. The path inside the archive (reframework/autorun/...) is the standard REFramework Lua mod layout.[/b][/size]

[size=4][b]## Usage[/b][/size]

[size=4][b]There's nothing to configure — once installed, the mod is on. The next time you trigger the meal cutscene, your armor stays visible.[/b][/size]

[size=4][b]To toggle it off without uninstalling: open REFramework's menu (default Insert key) → Script Generated UI → expand "Keep Armor On (Meal Cutscene) v1.0" → uncheck the "Block meal-cutscene inner-clothes swap" checkbox.[/b][/size]

[size=4][b]## Compatibility & Caveats[/b][/size]

[size=4][b]- Tested on a female hunter wearing a custom armor set. The mod's match pattern (/002/100/ in the inner-clothes prefab path) is gender-agnostic, so it should work for male hunters too — but male hunters are not personally verified yet.[/b][/size]
[size=4][b]- Other mods: doesn't touch any binary, doesn't conflict with armor/skill/effect mods. Safe to run alongside BoneSystem, ArmorVariantManager, etc.[/b][/size]
[size=4][b]- Game updates: the mod looks up app.mcPlayerPartsBuilder.createPartsGameObject by name and matches the inner-clothes set by a stable path substring. As long as Capcom doesn't rename the method or relocate the inner-clothes set ID, future title updates should not break the mod.[/b][/size]
[size=4][b]- Other cutscenes: if any other cutscene also uses the Female/002/100/ (or Male/002/100/) inner-clothes set, this mod will block it too. Only the meal cutscene has been observed using this set in normal play. (verified in CG Galleries)[/b][/size]
[size=4][b]- Online play: the mod is purely client-side visual and doesn't modify any save data or game files. Should be safe online; no guarantees against future Capcom anti-tamper changes.[/b][/size]

[size=4][b]## Uninstall[/b][/size]

[size=4][b]Delete reframework/autorun/keep_armor_on.lua from your game folder. (Or uncheck/remove via your mod manager.)[/b][/size]

[size=4][b]## How it works (technical)[/b][/size]

[size=4][b]The cutscene fires 5 calls to app.mcPlayerPartsBuilder.createPartsGameObject(...) per transition. The 4th argument is a via.Prefab whose get_Path() identifies what to load:[/b][/size]

[size=4][b]- Normal armor: GameDesign/Equip/_Prefab/Armor/<gender>/<armor_id>/<variant>/<slot>/<...>.pfb[/b][/size]
[size=4][b]- Cutscene inner-clothes: GameDesign/Equip/_Prefab/Armor/<gender>/002/100/<slot>/ch03_002_*.pfb[/b][/size]

[size=4][b]The mod's pre-hook returns SKIP_ORIGINAL when the prefab path contains /002/100/. The engine never instantiates the inner-clothes parts, so the previously-loaded armor parts remain visible. At cutscene end, the engine attempts to recreate the armor parts (paths don't match the inner pattern → we pass them through), which is effectively idempotent since the armor parts were never destroyed.[/b][/size]

[size=4][b]No native hooks, no MinHook, no binary addresses. Pure IL2CPP method-name targeting via REFramework's sdk.hook.[/b][/size]

[size=4][b]## Credits[/b][/size]

[size=4][b]Discovery + implementation: lxchhh3[/b][/size]

[size=4][b]Built with the REFramework modding toolkit.[/b][/size]

[size=4][b]## Changelog[/b][/size]

[size=4][b]v1.0 (2026-05-10) — initial release.[/b][/size]
[size=4][b]v1.1 (2026-05-11) - Now support all four types of inner clothes
[/b][/size]