Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Console modding permissionThis mod will not be available on Bethesda.net for console users
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
Please log in to find out whether this mod is receiving Donation Points
Changelogs
Version 0.7.30
Added option for the user to choose which types of loose folders to be merged, as some if merged may cause issues in game. Fixed few minor issues.
Version 0.7.26
BMAT no longer includes Archive2 and now it depends on either you having Archive2 from before or to have Creation Kit installed on your PC. As per Bethesda’s policies and rules it forbids any mod to include Archive2 in it (as Archive2 is their property) even though it is a free tool.
Added support for mods with loose files and folders which are sorted based on the load before and load after Vortex rules. Currently supported loose folders (as per community suggestion) are: Textures, Materials, Meshes, Sound, Music, Vis, Strings, LODSettings. If other should be added let me know.
Added support for CCC mods.
Added support for mods which add new files and folders as part of their update.
Added a new BMAT list to allow users to explicitly define which mod to be updated by which mod when BMAT can't find the new mod on its own.
Added a new validation between original BA2 files names and actual archive used. (thanks to wxMichael)
Now when BMAT can't find any of the Vortex files or folders it will ask the user to show BMAT where those are. Provided paths are stored to BMAT config files as reference for BMAT. This should address the issues some of the users were facing where paths and files locations were different across different Windows versions and editions.
The restore/merge choice was moved earlier into the BMAT process, so users won't have to wait for the entire data analysis process to complete if they just want to do a restore.
Performance improvements via multithreaded processing (each loop within BMAT was tested and implemented only where it does improve its performance).
As a cosmetic change the progress bars were standardised and implemented workaround for PowerShell bug 23875.
ModSizeBaseProcessingLimitMB setting is now ignored for mods added to a whitelist.
Mods with texture loose files are merged into a separate BA2 merge from the rest.
BMAT now checks whether a mod BA2 files were compressed as Textures or Main files, and it is not relying on the BA2 file name. This also addresses mods with unsupported BA2 file names like "... - Patch.ba2" or "... - DLC.ba2".
Implemented a workaround for when Vortex fails to change mod folder during mod update.
Fixed issue where BMAT is not recognising if mod is disabled during second BMAT run.
Various code optimisations and fixed few minor bugs.
Version 0.6.82
Added few minor fixes.
Version 0.6.80
Added a fix for users using {USERDATA} in the Vortex mods staging folder path and BMAT cant find the actual path.
Version 0.6.79
Fixed issues where after running BMAT some textures are not loaded with "ModFolderRearange" set to false.
Version 0.6.77
Fixed issues where BMAT can't start Vortex.
Version 0.6.75
Added few more fixes for the Windows paths and Vortex install folder path which was preventing BMAT from automatically starting Vortex.
Version 0.6.73
Added fixes where BMAT can't find Vortex files on some systems due to user settings mismatch. Added feature to handle files skipped by Archive2 which are moved automatically to Main BA2 merge.
BMAT has been split into 3 modules to help with the file validation process on Nexus.
Version 0.6.53
Includes fixes for Windows 10 users like "0 ba2 slots are being used"
Installation and Configuration Guide (replacing the Read Me file)
Working with BMAT Lists
The tool can handle mods additions, changes, updates, removals and so on allowing easy repackage of the BA2 archives.
The tool was designed to save as much disk space as possible, but you still need to keep the tool staging folder for it to work properly.
Fair warning: The tool may not be for the faint of the heart with all its files and folders moves and deletions, and with all the warnings in Vortex, but it gets the job done! Keep in mind that the tool is still in beta versions and even though it has been tested against thousands of mods with different sizes, and folder structures there could be some quirks that may need to be ironed out. Be patient and if you find any issues with the tool, please let me know which mod and which mod version you are trying to merge, so I can make the tool work with that mod in the tool follow-up version.
This tool was tested against 1300+ mods with multiple versions, and 8 FO4 mod collections (aSW + 7 aSW Add-Ons + nearly 250 additional mods) running at the same time on single Vortex profile. Once the tool was installed in Vortex I was able with a single click to merge hundreds of mods down to just few (refer to this article for my test results and findings while developing and using the tool) and was able to move from a constantly crashing game (as I had more than 400 BA2 files) to again playable game.
Note: No offence intended to anyone, but if you do not know what BA2 files are, or what this FO4 limit is all about, or you lack patience then this tool may not be for you … yet 😉
Note: Don’t assume you know what you are doing. Watch the video guides (currently one with more to follow) to understand how the tool was designed and intended to be used, and in what setup.
Prerequisites
Vortex
PowerShell v7
Any mod, and /or mod collections for Fallout 4
And finally … patience 😉
Roadmap
Here you can find the high level changes and improvements that I am planning for the tool.
Adding Support for Loose Files
Adding Support for MO2
Adding GUI
Adding Support for Fallout London
Converting Tool to Vortex Extension
Credits
VilanceD – for his tool which was the inspiration for this tool
Detlefs – for his tool which gave me some useful insights