F4 OAR Conversion Tool v0.3.0 EXPERIMENTAL

F4 OAR Conversion Tool v0.3.0 (EXPERIMENTAL)

This is an experimental companion utility, not a game plugin. Expect rough edges, UI changes, and possible conversion bugs. Keep backups of any weapon mod folders / ESPs you run through it.

What it does

Converts weapon animation setups that use Tactical Reload into Open Animation Replacer (F4) submods / config files for runtime reload replacement, and can optionally clean Tactical Reload keywords / the master dependency out of a weapon's ESP.

Changes since v0.2.0

• Multi-weapon pack splitting. ESPs / BA2s with multiple WEAP forms (e.g. Ozzy M4 Platform) now produce a separate OAR SubMod per matched weapon, each with its own IsEquipped condition. Matching uses subgraph target keywords when present, and falls back to Anims* keyword-suffix heuristics when not.
• OR-composited IsEquipped when a single animation folder is shared by more than one weapon form.
• GUI reflects the split without bloating the form. Weapon-folder checkboxes show the matched weapon EDID/FormID inline when 2+ weapons are detected; queue summaries show the SubMod fan-out count (e.g. TR:... (5x SubMods)). Single-weapon jobs stay as compact as before.
• Compacted UI. Fewer rows, tighter padding, Keep Output Location / Keep BA2 options moved onto existing rows, smaller default window.

How to use

1. Unzip anywhere
2. Run F4OARConversionTool.exe
3. Add a source folder or BA2 archive, set options, Preview / Add to Queue, then convert
4. Review the generated OAR folders / ESP output before deploying into a modlist

Logs are written next to the executable under logs/.

Notes

• Still EXPERIMENTAL.
• Requires a working F4 Open Animation Replacer install for the converted output to do anything in-game.
• Always keep originals; treat cleaned ESPs as needing a smoke-test in FO4Edit / in-game before shipping.
• BA2 archive support format re-derived from BSA Browser by AlexxEG (https://github.com/AlexxEG/BSA_Browser).