Difference between revisions of "Archive.exe"

Archive.exe (edit)

Revision as of 23:11, 21 May 2012

9,405 bytes added , 23:11, 21 May 2012

Under construction.

Anonymous user

imported>David Brasher

@@ 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.
-==Why not just pack up your loose files and not even have a .bsa file?==
+==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.
-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, you remove it, and the problem script will cause no more trouble.  No need to go go digging through lists of scripts to delete, move, or reinstall one.
+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 go digging through lists of scripts to delete, move, or reinstall one.
-Many 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.
 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.
@@ Line 140: / Line 140: @@
 = The Scripts Added to the List =
 [[Image:Archive.exe06.JPG|200px|thumb|right]]
+The compiled script files are now part of the list of things that will be made into a .bsa when the command is given.
 <br>
@@ Line 160: / Line 161: @@
 = How to Add Source Scripts to the .bsa =
 [[Image:Archive.exe07.JPG|200px|thumb|right]]
+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 it 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 modding community.
 <br>
@@ Line 180: / Line 186: @@
 = The Scripts Added to the List =
 [[Image:Archive.exe08.JPG|200px|thumb|right]]
+The source script files are now part of the list of things that will be made into a .bsa when the command is given.
 <br>
@@ Line 200: / Line 207: @@
 = How to Add Meshes to the .bsa =
 [[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.
+With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked.
 <br>
@@ Line 220: / Line 231: @@
 = The Meshes Added to the List =
 [[Image:Archive.exe10.JPG|200px|thumb|right]]
+The mesh files are now part of the list of things that will be made into a .bsa when the command is given.
 <br>
@@ Line 240: / Line 252: @@
 = How to Add Textures to the .bsa =
 [[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.
+With textures, a whole folder can often be dragged and dropped because "Recurse Directories" is checked.
 <br>
@@ Line 260: / Line 275: @@
 = The Textures Added to the List =
 [[Image:Archive.exe12.JPG|200px|thumb|right]]
+The texture files are now part of the list of things that will be made into a .bsa when the command is given.
 <br>
@@ Line 280: / Line 296: @@
 = How to Add Sound Files to the .bsa =
 [[Image:Archive.exe13.JPG|200px|thumb|right]]
+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
+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.
 <br>
@@ Line 300: / Line 321: @@
 = The Sound Files Added to the List =
 [[Image:Archive.exe14.JPG|200px|thumb|right]]
+The sound files are now part of the list of things that will be made into a .bsa when the command is given.
 <br>
@@ Line 320: / Line 342: @@
 = How to Make the .bsa Once All the Files Are Gathered =
 [[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.
+Put checkmarks in all the boxes.
+Click on "File."
+Select "Save As"
 <br>
@@ Line 340: / Line 372: @@
 = How to Name the .bsa File =
 [[Image:Archive.exe16.JPG|200px|thumb|right]]
+Name the file with the same name as the mod only with a .bsa file extension.
+Example:
+My Quest Mod.bsa   (Archive)
+My Quest Mod.esp   (Plug-in)
+My Quest Mod.bsa   (Master file that contains the dungeon and house interiors and navmeshing so that
+                    the mod does not have the Navmesh Bug and the actors can walk around freely)
+When you have finished typing in the name click "Save."
 <br>
@@ Line 360: / Line 407: @@
 = What to do With the Files Created =
 [[Image:Archive.exe17.JPG|200px|thumb|right]]
-<br>
+Find where the computer put the new .bsa file.
+In this example, the new files were placed by the computer in Documents.
+Delete the .bsl file.  It is not needed.  It is assumed to be something to do with uploading a file to Steam Workshop.  But if this .bsa is just being created to upload to Steam Workshop with the CK, then this .bsl file still is not needed because another one will be created.  (And then it is not known if that .bsl file is good for anything while maintaining and updating a mod hosted by Steam Workshop.)
+Open the .bsa file and examine it to make sure that it contains everything it is supposed to be there.  Bear in mind that a .bsa file is NOT supposed to contain the .esp, .esm, or readme file.  The .esp and .esm are supposed to be in the same folder as the .bsa so they can be dropped into Skyrim\Data together when installing the mod.  The readme goes one level higher.  It usually is not even decompressed.  It can be read while in the 7-Zip or .rar package that it came in.  If the mod contains additional documents or image files, they go with the readme, not with the .esp.
+Copy or else cut and paste the .bsa file into the folders that are being prepared for the upload.
@@ Line 380: / Line 434: @@
 = Placing the .bsa in the Folder With the Other Files for Upload =
 [[Image:Archive.exe18.JPG|200px|thumb|right]]
+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.
+Gamers will 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."
+It is also 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
 [[Image:Archive.exe19.JPG|200px|thumb|right]]
@@ Line 385: / Line 445: @@
 [[Image:Archive.exe20.JPG|200px|thumb|right]]
 <br>
+Before you actually package 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.
+Hopefully the file has a good descriptive name.  Examples of bad names would be things like:
+*Latest Version
+*File
+*The File
+*BSA Version
+*Fine Version
+*HK36557
+*My Mod
+Examples of good file names would be like:
+*Swords by Skiberine 1_7
+*Dark Dungeon V 2 1
+*Follower Suzy 1 0
+*SwimsuitsForCombat9
+*TheSearchForTheHolyGobletQuest 2_5
+*Glarthirs Blacksmithing Tweaks 37
+*Retextured Swamp Mushrooms V3
+When uploading the file, set it to hidden until you have all pieces uploaded and the file is truly open for business.
+Be sure to upload at least three screenshots to show off the mod.
+Have a good mod description uploaded to advertise the mod, what it edits, and how to start playing it.  The readme file could be used as the mod long description.
+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.