Difference between revisions of "Archive.exe"
Typo.
imported>David Brasher m (Formatting.) |
imported>Chesko (Typo.) |
||
| (11 intermediate revisions by 4 users not shown) | |||
| Line 7: | Line 7: | ||
So because of these issues, it is good to be able to package your files using a different program. Archive.exe will work even if the CK is just giving out error messages. Archive.exe can help you package any mod, no matter how complicated it is and no matter how many pieces it comes in. So you could use it to pack up mods to upload to Steam Workshop as well as mods to upload to various Skyrim mod sites. | So because of these issues, it is good to be able to package your files using a different program. Archive.exe will work even if the CK is just giving out error messages. Archive.exe can help you package any mod, no matter how complicated it is and no matter how many pieces it comes in. So you could use it to pack up mods to upload to Steam Workshop as well as mods to upload to various Skyrim mod sites. | ||
==Why | ==Why Not Just Pack Up the Loose Files and Not Even Have a .bsa File?== | ||
Mods that use .bsa files instead of loose files are easy to install. Gamers will not install them wrong so frequently and complain to the mod maker about the mod not working because of their own mistakes. | Mods that use .bsa files instead of loose files are easy to install. Gamers will not install them wrong so frequently and complain to the mod maker about the mod not working because of their own mistakes. | ||
But more importantly, mods that use .bsa files are easy to uninstall permanently or temporarily. Skyrim uses external scripts. If lots of mods with loose file scripts are used, the game can soon be a big mess and nobody will be able to figure out which mod caused a problem by editing which script. With a .bsa file, just remove it, and the problem script will cause no more trouble. No need to | But more importantly, mods that use .bsa files are easy to uninstall permanently or temporarily. Skyrim uses external scripts. If lots of mods with loose file scripts are used, the game can soon be a big mess and nobody will be able to figure out which mod caused a problem by editing which script. With a .bsa file, just remove it, and the problem script will cause no more trouble. No need to go digging through lists of scripts to delete, move, or reinstall one. | ||
Some gamers like to use different mods when they are playing different characters. Perhaps a certain gamer would have a bunch of stealth mods to be used only when playing as a thief. Mods with .bsa files are easy to temporarily remove and then install again when it is time to play a different character. | Some gamers like to use different mods when they are playing different characters. Perhaps a certain gamer would have a bunch of stealth mods to be used only when playing as a thief. Mods with .bsa files are easy to temporarily remove and then install again when it is time to play a different character. | ||
| Line 17: | Line 17: | ||
Using .bsa files for .esp dependent mesh and texture replacer mods can also save a lot of headaches when things start to go wrong with how things look in the game. | Using .bsa files for .esp dependent mesh and texture replacer mods can also save a lot of headaches when things start to go wrong with how things look in the game. | ||
So packing mods with a .bsa file instead of with loose files is considered to be following best practices for Skyrim modding. | So packing mods with a .bsa file instead of with loose files is considered to be following best practices for Skyrim modding. | ||
= Where to | = Where to Find Archive.exe on the Computer = | ||
[[Image:Archive.exe01.JPG|200px|thumb|right]] | [[Image:Archive.exe01.JPG|200px|thumb|right]] | ||
Different people install Skyrim in different places, but the directory will be like this: | Different people install Skyrim in different places, but the directory will be like this: | ||
| Line 123: | Line 123: | ||
To figure out what scripts are needed, there are a couple of tricks that can be helpful: | To figure out what scripts are needed, there are a couple of tricks that can be helpful: | ||
*Open the CK archive function to see what scripts and source scripts it can find. Beware! The CK can't see all the scripts that are needed and won't list them all. Vanilla Skyrim scripts that are edited by a mod seem to be its big blind spot. | *Open the CK archive function to see what scripts and source scripts it can find. Beware! The CK can't see all the scripts that are needed and won't list them all. Vanilla Skyrim scripts that are edited by a mod seem to be its big blind spot. | ||
*Go into the quests in the mod and compile all scripts. This will change the date stamp on the .pex files (but not the .psc files.) Go into scripts placed on objects that the mod attaches scripts to. | *Go into the quests in the mod and compile all scripts. This will change the date stamp on the .pex files (but not the .psc files.) Go into scripts placed on objects that the mod attaches scripts to. re-save them. This will change their date stamp. In the scripts folder in Windows Explorer, sort the scripts by date. The scripts that go with the mod will have today's date. (This won't work as well if more than one mod have been worked on on the packaging and upload day.) | ||
<br> | <br> | ||
| Line 151: | Line 151: | ||
Select the .psc script files associated with the mod and drag and drop them into the Archive.exe window. | Select the .psc script files associated with the mod and drag and drop them into the Archive.exe window. | ||
And why are these even needed? The gamer does not need them. Skyrim will play just fine without them. But modders will not be able to open the mod and figure out exactly how things work. They will not be able to study the skillful way | And why are these even needed? The gamer does not need them. Skyrim will play just fine without them. But modders will not be able to open the mod and figure out exactly how things work. They will not be able to study the skillful way the mod was built and learn from it. They will not be able to tweak it to make it suit the way they like to play. | ||
The worst thing is that they will not be able to troubleshoot it. It could be that they will figure out a solution to a bad problem. They will share this information, and a better version of the mod can be uploaded with very little effort on the original author's part. a wise modder would not want to forgo this valuable information. A generous modder would not want to give people a mod they could not admire in the CK, learn from, and tweak to their taste. Open source is a good thing. Skyrim would not be so fun if it was closed source and no modding possible. So it is good to share this ability with other modders just as Bethesda shared a moddable Skyrim with the | The worst thing is that they will not be able to troubleshoot it. It could be that they will figure out a solution to a bad problem. They will share this information, and a better version of the mod can be uploaded with very little effort on the original author's part. a wise modder would not want to forgo this valuable information. A generous modder would not want to give people a mod they could not admire in the CK, learn from, and tweak to their taste. Open source is a good thing. Skyrim would not be so fun if it was closed source and no modding was possible. So it is good to share this ability with other modders just as Bethesda shared a moddable Skyrim with the Elder Scrolls fans. | ||
<br> | <br> | ||
| Line 184: | Line 184: | ||
= How to Add Meshes to the .bsa = | = How to Add Meshes to the .bsa = | ||
[[Image:Archive.exe09.JPG|200px|thumb|right]] | [[Image:Archive.exe09.JPG|200px|thumb|right]] | ||
In this example the meshes are the facegen data created to work around the Dark Face Bug. Just because a mod has no new swords and armor does not mean that no meshes need to be packaged. If the mod contains new NPCs or vanilla Skyrim NPCs with edited faces, then facegen data needs to be generated, packaged, and uploaded with the rest of the mod. | In this example the meshes are the facegen data created to work around the [[Dark Face Bug|Dark Face Bug]]. Just because a mod has no new swords and armor does not mean that no meshes need to be packaged. If the mod contains new NPCs or vanilla Skyrim NPCs with edited faces, then facegen data needs to be generated, packaged, and uploaded with the rest of the mod. | ||
With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked. | With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked. | ||
| Line 215: | Line 215: | ||
= How to Add Textures to the .bsa = | = How to Add Textures to the .bsa = | ||
[[Image:Archive.exe11.JPG|200px|thumb|right]] | [[Image:Archive.exe11.JPG|200px|thumb|right]] | ||
In this example the textures are the facegen data created to work around the Dark Face Bug. Just because a mod has no new clothing or recolored creatures does not mean that no textures need to be packaged. If the mod contains new NPCs or vanilla Skyrim NPCs with edited faces, then facegen data needs to be generated, packaged, and uploaded with the rest of the mod. | In this example the textures are the facegen data created to work around the [[Dark Face Bug|Dark Face Bug]]. Just because a mod has no new clothing or recolored creatures does not mean that no textures need to be packaged. If the mod contains new NPCs or vanilla Skyrim NPCs with edited faces, then facegen data needs to be generated, packaged, and uploaded with the rest of the mod. | ||
With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked. | With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked. | ||
| Line 249: | Line 249: | ||
In this example voiced dialog is being added to the .bsa. Voiced dialog is easy to add to the list because the dialog is in a folder named after the mod. (Which is why the voiced dialog gets broken if an .esp is renamed by a gamer who does not like the original name.) The whole folder can be dragged and dropped because "Recurse Directories" is checked. | In this example voiced dialog is being added to the .bsa. Voiced dialog is easy to add to the list because the dialog is in a folder named after the mod. (Which is why the voiced dialog gets broken if an .esp is renamed by a gamer who does not like the original name.) The whole folder can be dragged and dropped because "Recurse Directories" is checked. | ||
The voiced dialog files in a mod should be refuzed into .fuz files rather than left as .wav and .lip files. There is a common problem where the voiced dialog will not play on a measurable minority of random computers if the dialog is left in .wav + .lip format rather than .fuz format. There seems to be no way to predict which mods will not work on which computers. So it is safest to refuz the voiced dialog files before uploading | The voiced dialog files in a mod should be refuzed into .fuz files rather than left as .wav and .lip files. Unfuzer may be downloaded here: http://skyrim.nexusmods.com/downloads/file.php?id=9797 There is a common problem where the voiced dialog will not play on a measurable minority of random computers if the dialog is left in .wav + .lip format rather than .fuz format. There seems to be no way to predict which mods will not work on which computers. So it is safest to refuz the voiced dialog files before uploading | ||
Another advantage of .fuz files is that they are tiny. When building a mod with voiced dialog, it can quickly become too huge for easy uploading and downloading. Using .fuz file helps greatly with file size. | Another advantage of .fuz files is that they are tiny. When building a mod with voiced dialog, it can quickly become too huge for easy uploading and downloading. Using .fuz file helps greatly with file size. | ||
| Line 278: | Line 278: | ||
[[Image:Archive.exe15.JPG|200px|thumb|right]] | [[Image:Archive.exe15.JPG|200px|thumb|right]] | ||
When it is decided that everything has been gathered up and nothing has been left out, it is time to turn the files on the list into a .bsa. | When it is decided that everything has been gathered up and nothing has been left out, it is time to turn the files on the list into a .bsa. | ||
Click on "File." | Click on "File." | ||
| Line 285: | Line 283: | ||
Select "Save As" | Select "Save As" | ||
<br> | <br> | ||
| Line 301: | Line 300: | ||
<br> | <br> | ||
= How to Name the .bsa File = | = How to Name the .bsa File = | ||
[[Image:Archive.exe16.JPG|200px|thumb|right]] | [[Image:Archive.exe16.JPG|200px|thumb|right]] | ||
Name the file with the same name as the mod only with a .bsa file extension. | Name the file with the same name as the mod only with a .bsa file extension. For example: | ||
My Quest Mod.esp (Plug-in) | |||
My Quest Mod.bsa (Archive) | My Quest Mod.bsa (Archive) | ||
When you have finished typing in the name click "Save." | When you have finished typing in the name click "Save." | ||
| Line 341: | Line 341: | ||
To figure out how to package a mod, it might be handy to look at one that has been downloaded and played. One that is known to be packaged right because it works properly. Here is how the sample mod, "My Quest Mod" is packaged. It is shown in three views from top to bottom. The folder that will be compressed with 7-Zip is the one named "My Quest Mod 1_0" Note that this is where the version number is placed along with in the file description in the .esp and in the readme. It is very important to give mods version numbers. There is always one more bug somewhere. It is only a matter of time until it is found. Conscientious modders will fix these bugs and release new versions. | To figure out how to package a mod, it might be handy to look at one that has been downloaded and played. One that is known to be packaged right because it works properly. Here is how the sample mod, "My Quest Mod" is packaged. It is shown in three views from top to bottom. The folder that will be compressed with 7-Zip is the one named "My Quest Mod 1_0" Note that this is where the version number is placed along with in the file description in the .esp and in the readme. It is very important to give mods version numbers. There is always one more bug somewhere. It is only a matter of time until it is found. Conscientious modders will fix these bugs and release new versions. | ||
A gamers may say, "Yur mod sux! it brkn an it dusnt wurk! plz hlp me!!!" | |||
The modder can calmly ask which version number the gamer is using, and upon receiving the answer, can say, "That problem was fixed in version 1_4, but you are using version 1_2. All you need to do is download the new version and your problem will go away." | The modder can calmly ask which version number the gamer is using, and upon receiving the answer, can say, "That problem was fixed in version 1_4, but you are using version 1_2. All you need to do is download the new version and your problem will go away." | ||
It | It can also be helpful to have version numbers or other identifiers on mods if there are different current versions with different features tailored to the tastes of different kinds of players. It can also prevent mistakes where modders grab the wrong version of the mod and start expanding or tweaking it, only to discover the work has been wasted on an obsolete version rather than the current version of the mod | ||
Before | Before actually packaging the mod, The .bsa should be installed and tested. Disable or remove all the scripts, meshes, textures, and sounds that were packed into the .bsa. Don't delete them yet, just move them or rename them so that the game cannot find them and has to refer to the .bsa instead of the looses files. See if the dialog works. See if the scripts work, see if the meshes and textures work. (This could be done while testing the voiced dialog, just see if the NPCs have the Dark Face Bug or not.) | ||
If all of this checks out okay, then it is time to compress the mod with 7-Zip or Winrar. It seems that 7-Zip compresses the files smaller, but more users seem to own Winrar than 7-Zip. Just don't use the old fashioned .zip files. They take way more space that .7z or .rar files. | If all of this checks out okay, then it is time to compress the mod with 7-Zip or Winrar. It seems that 7-Zip compresses the files smaller, but more users seem to own Winrar than 7-Zip. Just don't use the old fashioned .zip files. They take way more space that .7z or .rar files. | ||
| Line 355: | Line 355: | ||
*The File | *The File | ||
*BSA Version | *BSA Version | ||
* | *Final Version | ||
*HK36557 | *HK36557 | ||
*My Mod | *My Mod | ||
| Line 371: | Line 371: | ||
=Uploading the File= | =Uploading the File= | ||
When uploading the file, set it to hidden until you have all pieces uploaded and the file is truly open for business. | There are many different mod hosting websites where you can upload your creation. There can be benefits to uploading your mod to multiple sites (increased visibility, increased availabilty if one of the hosts experienced downtime) as well as drawbacks (more time spent uploading the latest version across multiple sites, more user bases that may need to be monitored for support). Different sites have different rules; be sure to read and understand the terms and conditions of use before uploading to a site. For Skyrim mods, some popular hosting sites are the Skyrim Nexus, the Steam Workshop, TES Alliance, Dark Creations, and Holds of Skyrim. | ||
Have a good mod description | When uploading the file, set it to hidden (if the host allows this) until you have all pieces uploaded and the file is truly open for business. Upload screenshots, if applicable, to show off the mod. Have a good mod description written and ready before you upload, stating what the mod does and how to start using it. (This can often be taken from the readme file.) Upload the readme file in some form or other so that it can be viewed without downloading the entire mod first, if possible. | ||
Upload the readme file in some form or other so that it can be viewed without downloading the entire mod first. | |||
It would be good to run the readme file and mod description through a spell checker, because many potential downloaders are turned off by bad spelling. They react a similar way to a missing file that has not been uploaded yet. (The file is in the process of being uploaded but the modder failed to set the file to hidden.) Potential downloaders also react badly to mods with no screenshots. ("No pic, no click!") If the mod description is so vague that the potential downloaders can't tell what the mod is supposed to do, it is also quite harmful to the download count. | |||
Package the mod properly so that it works on computers besides your own, and advertize and present it well at the download point, and the mod will get lots of downloads. The gamers will be happy, and will leave positive comments and endorsements. | |||
=Scripting Archive.exe= | |||
Archive.exe includes the ability to process simple scripts to build BSAs, useful if you often need to re-archive the same set of files, or a large set with only a few changes. Note that this functionality is still being investigated; make back-ups, proceed with caution, and test extensively before publicly releasing any archives done with this method. | |||
In the same directory as Archive.exe, you'll want a script file with a .txt extension (say "mymodpackerscript.txt") that looks something like this: | |||
<pre> | |||
Log: Logs\Archives\MyModArchiveLog.txt | |||
New Archive | |||
Set File Group Root: Data\ | |||
Add File Group: mymodfiles.txt | |||
Save Archive: Data\MyMod.bsa | |||
</pre> | |||
Then in the same directory, create a file called "mymodfiles.txt" that lists the files you want to include in the BSA: | |||
<pre> | |||
Sound\Voice\MyMod.esp\femalecommander\MyMod_MyModCoreDialo_0000F063_1.fuz | |||
Sound\Voice\MyMod.esp\femalecommander\MyMod_MyModCoreDialo_0000D562_1.fuz | |||
Scripts\MyModCoreDialogueScript.pex | |||
etc. | |||
</pre> | |||
(Make sure both files have Windows-style line endings.) | |||
Then you can either run your script through the GUI, or on the command line enter <code>archive mymodpackerscript.txt</code> | |||
The GUI will pop-up, build the archive, and then close. If MyMod.bsa already existed in the save location, it will be renamed MyMod.bak. | |||
Checkboxes can be checked using a script by using the Check: function (see Discussion tab for more details): | |||
<pre>Check: Misc</pre> | |||
=Other Guides on How to Pack Up a .bsa File= | =Other Guides on How to Pack Up a .bsa File= | ||
| Line 388: | Line 416: | ||
[[File Menu#Create Archive|Create Archive]] | [[File Menu#Create Archive|Create Archive]] | ||
[[Uploading To Steam Workshop|Uploading To Steam Workshop]] | |||
[[Category:Tutorials]] | |||