Difference between revisions of "Bethesda mod archives"

From Nexus Mods Wiki
Jump to: navigation, search
m
m (Pickysaurus moved page Incompatible mod archives to Bethesda mod archives: More fitting title)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Gamebyro engine can load files from specialised archives into the game on startup. This allows DLCs and mods to package all their files together without worrying about them being accidentally overwritten and further simplifies the modding process by minimising the number of files. These archives can be either BSA (Oblivion, Fallout 3, Fallout New Vegas and Skyrim) or BA2 (Fallout 4 and Fallout 76) format files. Extracting or modifying archives should be considered an advanced modding technique and in most cases is unnecessary to allow the game to function correctly.  
+
 
 +
The Gamebyro engine can load files from specialised archives into the game on startup. This allows DLCs and mods to package all their files together without worrying about them being accidentally overwritten and further simplifies the modding process by minimising the number of files. These archives can be either BSA (Morrowind, Oblivion, Fallout 3, Fallout New Vegas and Skyrim) or BA2 (Fallout 4 and Fallout 76) format files. Extracting or modifying archives should be considered an advanced modding technique and in most cases is unnecessary to allow the game to function correctly.
 +
 
 
 
 
 
 
  
 
== Mod archive compatibility ==
 
== Mod archive compatibility ==
  
The BSA and BA2 archives are not automatically compatible with all games. Even among the variations of the same file type, they can cause unwanted side effects such as preventing the game from starting up. The table below lists the types of BSA and BA2 and how they behave with each Gamebyro title.
+
The BSA and BA2 archives are not automatically compatible with all games. Even among the variations of the same file type, they can cause unwanted side effects such as preventing the game from starting up. The table below lists the types of BSA and BA2 and how they behave with each Gamebyro title. The version of the archive can be determined by inspecting the file header. 
  
 
{| class="wikitable" style="width: 100%;"
 
{| class="wikitable" style="width: 100%;"
 
|-
 
|-
 
! scope="row" | Game
 
! scope="row" | Game
 +
! scope="col" | BSA v100
 
! scope="col" | BSA v103
 
! scope="col" | BSA v103
 
! scope="col" | BSA v104
 
! scope="col" | BSA v104
 
! scope="col" | BSA v105
 
! scope="col" | BSA v105
 
! scope="col" | BA2 v1
 
! scope="col" | BA2 v1
 +
|-
 +
! scope="row" | Morrowind
 +
| <span style="color:#1abc9c;">Compatible</span>
 +
| <span style="color:#e74c3c;">Incompatible</span>
 +
| <span style="color:#e74c3c;">Incompatible</span>
 +
| <span style="color:#e74c3c;">Incompatible</span>
 +
| Ignored
 
|-
 
|-
 
! scope="row" | Oblivion
 
! scope="row" | Oblivion
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
 
| Ignored
 
| Ignored
Line 22: Line 32:
 
|-
 
|-
 
! scope="row" | Fallout 3
 
! scope="row" | Fallout 3
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| ''Untested''
 
| ''Untested''
 
| <span style="color:#1abc9c;">Compatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
Line 28: Line 39:
 
|-
 
|-
 
! scope="row" | Fallout New Vegas
 
! scope="row" | Fallout New Vegas
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| ''Untested''
 
| ''Untested''
 
| <span style="color:#1abc9c;">Compatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
Line 34: Line 46:
 
|-
 
|-
 
! scope="row" | Skyrim (2011)
 
! scope="row" | Skyrim (2011)
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#f39c12;">Limited Support</span>
 
| <span style="color:#f39c12;">Limited Support</span>
 
| <span style="color:#1abc9c;">Compatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
Line 40: Line 53:
 
|-
 
|-
 
! scope="row" | Skyrim Special Edition
 
! scope="row" | Skyrim Special Edition
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#e74c3c;">Incompatible</span>
 
| <span style="color:#e74c3c;">Incompatible</span>
Line 46: Line 60:
 
|-
 
|-
 
! scope="row" | Fallout 4
 
! scope="row" | Fallout 4
 +
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
Line 52: Line 67:
 
|-
 
|-
 
! scope="row" | Skyrim VR
 
! scope="row" | Skyrim VR
 +
| <span style="color:#e74c3c;">Incompatible</span>
 
| ''Untested''
 
| ''Untested''
| &nbsp;
+
| <span style="color:#e74c3c;">Incompatible</span>
| &nbsp;
+
| <span style="color:#1abc9c;">Compatible</span>
 
| Ignored
 
| Ignored
 
|-
 
|-
 
! scope="row" | Fallout 4 VR
 
! scope="row" | Fallout 4 VR
 +
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
Line 64: Line 81:
 
|-
 
|-
 
! scope="row" | Fallout 76
 
! scope="row" | Fallout 76
 +
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
 
| Ignored
Line 69: Line 87:
 
| <span style="color:#1abc9c;">Compatible</span>
 
| <span style="color:#1abc9c;">Compatible</span>
 
|}
 
|}
 +
 +
Below is a more detailed explanation of each status.&nbsp;
 +
 +
*Untested - This combination has not been tested, feel free to update this article if you are able to test.&nbsp;
 +
*Ignored - The game will not attempt to load this file.&nbsp;
 +
*<span style="color:#1abc9c;">Compatible&nbsp;</span>- This is the intended archive format for this game and is fully compatible.&nbsp;
 +
*<span style="color:#f39c12;">Limited Support&nbsp;</span>- This archive type is not intended to be used with the game but does appear to work. The exact impact on loading times, stability or general performance is unknown. It is not recommended to continue to use this combination.
 +
*<span style="color:#e74c3c;">Incompatible&nbsp;</span>- This combination will cause a critical error, usually crashing the game.&nbsp;
 +
 +
&nbsp;
  
 
=== Mod manager archive checking ===
 
=== Mod manager archive checking ===
 +
 +
Some mod managers include a feature that will automatically check archive versions and identify any mismatches. At the time of writing, only Vortex and Wryebash include this feature.&nbsp;
 +
 +
&nbsp;
  
 
== Extracting and packaging archives ==
 
== Extracting and packaging archives ==
  
[[Category:Skyrim]] [[Category:Skyrim Special Edition]] [[Category:Fallout 4]] [[Category:Oblivion]] [[Category:New Vegas]] [[Category:Mod Creation]]
+
There are several community tools available to unpack and create new BSA and BA2 archives. At present no&nbsp;single tool can process all types of archive. Below is a list of tools that can be used in each instance. For community-created tools, you should refer to any documentation offered by the developer if you are unclear on how to use it.&nbsp;
 +
 
 +
{| class="wikitable" style="width: 800px;"
 +
|-
 +
! scope="row" | Archive Format
 +
! scope="col" | Compatible Tools
 +
|-
 +
| BSA v100 (Morrowind)
 +
|
 +
*[http://mw.modhistory.com/download-95-5215 BSAPack (Community)]
 +
 
 +
|-
 +
| BSA v103 (Oblivion)
 +
|
 +
*[https://www.nexusmods.com/oblivion/mods/3311 BSA Commander (Community)]
 +
 
 +
|-
 +
| BSA v104 (Fallout 3, New Vegas, Skyrim 2011)
 +
|
 +
*Creation Kit (Official)
 +
*[https://www.nexusmods.com/fallout4/mods/78 Bethesda Archive Extractor (Community)]
 +
*[https://www.nexusmods.com/skyrimspecialedition/mods/23316 Cathedral Assets Optimizer(Community)]
 +
 
 +
|-
 +
| BSA v105 (Skyrim Special Edition)
 +
|
 +
*Creation Kit 2.0 (Official)
 +
*[https://www.nexusmods.com/fallout4/mods/78 Bethesda Archive Extractor (Community)]
 +
*[https://www.nexusmods.com/skyrimspecialedition/mods/23316 Cathedral Assets Optimizer(Community)]
 +
 
 +
|-
 +
| BA2 v1 (Fallout 4, Fallout 76)
 +
|
 +
*Creation Kit (Official)
 +
*[https://www.nexusmods.com/fallout4/mods/78 Bethesda Archive Extractor (Community)]
 +
*[https://www.nexusmods.com/skyrimspecialedition/mods/23316 Cathedral Assets Optimizer(Community)]
 +
 
 +
|}
 +
 
 +
 
 +
 
 +
 
 +
== Frequently Asked Questions (FAQ) ==
 +
 
 +
=== I'm getting a warning about incompatible mod archives, how can I resolve it? ===
 +
 
 +
A common mistake - particularly between Skyrim 2011 and Skyirm Special Edition - is to try and load a mod from another game or game version, ensure the mod you're trying to use is designed for the game you are trying to play.
 +
 
 +
If you are sure you have the correct mod, it's possible the mod author used the wrong tools when packing their archives (or the correct tools did not exist when the mod was made). In this scenario, the best thing to do is to extract the contents of the BSA/BA2 and delete it. You can see a list of tools to do this under [[#Extracting_and_packaging_archives|#Extracting and packaging archives]].
 +
 
 +
'''Note:''' Extracting a BSA v104 when playing with Skyrim Special Edition will prevent the game from crashing to desktop (CTD) but if the BSA contains incompatible texture or mesh assets this will still cause crashes when those resources are loaded. You should use Cathedral Assets Optimizer (or another compatible tool) to ensure all assets are game-ready.
 +
 
 +
[[Category:Skyrim]] [[Category:Skyrim Special Edition]] [[Category:Fallout 4]] [[Category:Oblivion]] [[Category:New Vegas]] [[Category:Morrowind]] [[Category:Mod Creation]]

Latest revision as of 16:29, 8 April 2021

The Gamebyro engine can load files from specialised archives into the game on startup. This allows DLCs and mods to package all their files together without worrying about them being accidentally overwritten and further simplifies the modding process by minimising the number of files. These archives can be either BSA (Morrowind, Oblivion, Fallout 3, Fallout New Vegas and Skyrim) or BA2 (Fallout 4 and Fallout 76) format files. Extracting or modifying archives should be considered an advanced modding technique and in most cases is unnecessary to allow the game to function correctly.

 

Mod archive compatibility

The BSA and BA2 archives are not automatically compatible with all games. Even among the variations of the same file type, they can cause unwanted side effects such as preventing the game from starting up. The table below lists the types of BSA and BA2 and how they behave with each Gamebyro title. The version of the archive can be determined by inspecting the file header. 

Game BSA v100 BSA v103 BSA v104 BSA v105 BA2 v1
Morrowind Compatible Incompatible Incompatible Incompatible Ignored
Oblivion Incompatible Compatible Ignored Ignored Ignored
Fallout 3 Incompatible Untested Compatible Untested Ignored
Fallout New Vegas Incompatible Untested Compatible Untested Ignored
Skyrim (2011) Incompatible Limited Support Compatible Incompatible Ignored
Skyrim Special Edition Incompatible Incompatible Incompatible Compatible Ignored
Fallout 4 Ignored Ignored Ignored Ignored Compatible
Skyrim VR Incompatible Untested Incompatible Compatible Ignored
Fallout 4 VR Ignored Ignored Ignored Ignored Compatible
Fallout 76 Ignored Ignored Ignored Ignored Compatible

Below is a more detailed explanation of each status. 

  • Untested - This combination has not been tested, feel free to update this article if you are able to test. 
  • Ignored - The game will not attempt to load this file. 
  • Compatible - This is the intended archive format for this game and is fully compatible. 
  • Limited Support - This archive type is not intended to be used with the game but does appear to work. The exact impact on loading times, stability or general performance is unknown. It is not recommended to continue to use this combination.
  • Incompatible - This combination will cause a critical error, usually crashing the game. 

 

Mod manager archive checking

Some mod managers include a feature that will automatically check archive versions and identify any mismatches. At the time of writing, only Vortex and Wryebash include this feature. 

 

Extracting and packaging archives

There are several community tools available to unpack and create new BSA and BA2 archives. At present no single tool can process all types of archive. Below is a list of tools that can be used in each instance. For community-created tools, you should refer to any documentation offered by the developer if you are unclear on how to use it. 

Archive Format Compatible Tools
BSA v100 (Morrowind)
BSA v103 (Oblivion)
BSA v104 (Fallout 3, New Vegas, Skyrim 2011)
BSA v105 (Skyrim Special Edition)
BA2 v1 (Fallout 4, Fallout 76)



Frequently Asked Questions (FAQ)

I'm getting a warning about incompatible mod archives, how can I resolve it?

A common mistake - particularly between Skyrim 2011 and Skyirm Special Edition - is to try and load a mod from another game or game version, ensure the mod you're trying to use is designed for the game you are trying to play.

If you are sure you have the correct mod, it's possible the mod author used the wrong tools when packing their archives (or the correct tools did not exist when the mod was made). In this scenario, the best thing to do is to extract the contents of the BSA/BA2 and delete it. You can see a list of tools to do this under #Extracting and packaging archives.

Note: Extracting a BSA v104 when playing with Skyrim Special Edition will prevent the game from crashing to desktop (CTD) but if the BSA contains incompatible texture or mesh assets this will still cause crashes when those resources are loaded. You should use Cathedral Assets Optimizer (or another compatible tool) to ensure all assets are game-ready.