F4 OAR Conversion Tool v0.2.0 EXPERIMENTAL

F4 OAR Conversion Tool v0.2.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.1.0

• Fixed broken weapon forms in patched ESPs. FormID remapping after removing the Tactical Reload master now rewrites every affected FormID inside opaque subrecords (OBTS, APPR, WAMD, etc.), not just the ones with dedicated handling, and keyword stripping no longer reorders subrecords. Weapons no longer come out empty/broken after cleanup.
• BA2 archives as a source. Point the tool at a .ba2 directly (in lieu of a source folder); it extracts meshes\actors, runs the conversion, and lets you keep or discard the extracted files afterward. BA2 parsing/extraction is an independent Python re-implementation, format re-derived by reading (not linking against) BSA Browser by AlexxEG.
• Selective Idle Empty files. Only copies WPNIdleReady*, WPNEquip*, and WPNIdleSighted.hkx into the OAR output when that exact file already exists in the matching source folder, instead of inventing a full set for every nested mag/attachment folder.
• WPNReloadTactical.hkx support. Some TR packs name the reserve-reload animation WPNReloadTactical.hkx instead of WPNReloadReserve.hkx; both are now treated identically for root discovery and conversion.
• ESP autodetect + picker. The ESP in a source folder is found automatically; if more than one plugin is present, you pick which one from a small dialog.
• Auto-naming. Pack / TR SubMod / Idle SubMod names are filled in from the source folder, BA2, or ESP name as soon as you pick one (BA2 archive-role suffixes like "- Main" are trimmed sensibly).
• "Keep Output Location" option to hold the destination path steady across queued jobs instead of clearing it each time.
• UI and reliability fixes: the window fits its contents by default, Preview works and a persistent per-session log file is written under logs/ next to the executable, and the source-folder picker is now clearly labeled "Weapon folders to convert" instead of the unexplained "anim roots".

How to use

1. Unzip anywhere
2. Run F4OARConversionTool.exe
3. Add source folder(s) or a BA2 archive to the queue, set options per entry, 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: this is the first version with its source code committed to the repository (previously only the built executable had been published).
• 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.