Go to file
2020-04-27 23:03:57 -05:00
.github/ISSUE_TEMPLATE Updated bug_report issue template 2020-04-26 09:12:39 +00:00
Branding Fix using spaces instead of %20 in the generated URL for file uploader 2020-04-26 14:05:41 +02:00
Compression.BSA Merge pull request #751 from wabbajack-tools/2.0-release-day-bug-fixes 2020-04-27 06:16:46 -06:00
Compression.BSA.Test BSA building is now async, status updates during compression 2020-04-20 15:36:33 -06:00
extra Added test file 2020-01-27 14:23:33 +01:00
VS Snippets ReadmeCommand canExecute implementation. ModList to property 2019-10-11 22:37:35 -05:00
Wabbajack Adjusted TempFolder init concepts 2020-04-27 22:17:06 -05:00
Wabbajack.App.Test Added some missing refactors on some projects that were unloaded 2020-04-27 23:03:57 -05:00
Wabbajack.BuildServer Bump Version numbers and changelog for 2.0.2.0 2020-04-27 15:41:34 -06:00
Wabbajack.BuildServer.Model Switch the indexed archives backend to MSSQL for better ACID support 2020-01-25 21:50:17 -07:00
Wabbajack.BuildServer.Test Added some missing refactors on some projects that were unloaded 2020-04-27 23:03:57 -05:00
Wabbajack.CLI Bump Version numbers and changelog for 2.0.2.0 2020-04-27 15:41:34 -06:00
Wabbajack.Common Adjusted TempFolder init concepts 2020-04-27 22:17:06 -05:00
Wabbajack.Common.CSP No more MessagePack, Json is love, Json is life 2020-04-06 14:48:54 -06:00
Wabbajack.Common.Test Hotfixes 2020-04-27 15:32:19 -06:00
Wabbajack.Launcher Bump Version numbers and changelog for 2.0.2.0 2020-04-27 15:41:34 -06:00
Wabbajack.Lib Adjusted TempFolder init concepts 2020-04-27 22:17:06 -05:00
Wabbajack.Test Added some missing refactors on some projects that were unloaded 2020-04-27 23:03:57 -05:00
Wabbajack.VirtualFileSystem Adjusted TempFolder init concepts 2020-04-27 22:17:06 -05:00
Wabbajack.VirtualFileSystem.Test BSA archives are now lazily extracted. 2020-04-16 21:52:19 -06:00
.editorconfig Wabbajack.Lib Compilation steps nullable enabled 2020-04-10 13:23:23 -05:00
.gitignore Fix how we clean the download cache (#170) 2019-11-14 14:53:29 -07:00
.runsettings Clean up some references try to get tests to work 2019-12-26 17:41:33 -07:00
azure-list-validation.yml Update azure-list-validation.yml for Azure Pipelines 2019-11-06 07:24:52 -07:00
azure-pipelines.yml Update azure-pipelines.yml for Azure Pipelines 2020-04-07 22:39:31 -06:00
CHANGELOG.md Bump Version numbers and changelog for 2.0.2.0 2020-04-27 15:41:34 -06:00
CONTRIBUTING.md Grammar Fixes - Noticed "than" was used instead of "then" (#564) 2020-02-22 14:53:22 +01:00
LICENSE.txt Update LICENSE.txt 2020-01-20 18:11:26 -07:00
NexusPage.html Fix typos + inconsistencies in logs 2020-01-13 22:11:07 +01:00
README.md Update Patreon supporters 2020-04-21 06:20:51 -06:00
RECIPES.md Update RECIPES.md, revert line in README.md to SKSE 2019-11-11 21:15:47 +01:00
Wabbajack.sln Adding tests for the build server, changed the Queue Service over to SQL 2020-04-03 16:40:52 -06:00
Wabbajack.sln.DotSettings Bit of a first draft of a launcher 2020-02-06 21:20:49 -07:00

Wabbajack

Build Status

Wabbajack is an automated ModList installer that can recreate contents of a folder on another machine without ever distributing copyrighted materials or syncing data between the source and destination machine. Wabbajack will create instructions for a ModList when compiling, those can be as simple as Download Mod abc from the Nexus or complex as Clean the Game ESM files using zEdit.

  • wabbajack.org The official Wabbajack website where you can find instructions and a Gallery for some ModLists.
  • Discord The official Wabbajack discord for instructions, ModLists, support or friendly chatting with fellow modders.
  • Patreon contains update posts and keeps the Code Signing Certificate alive.

Supported Games and Mod Manager

Game Platform Mod Manager Notes
Oblivion Steam, GOG MO2 Normal and GotY Edition
Oblivion Steam MO2
Fallout 3 Steam MO2
Fallout New Vegas Steam MO2
Skyrim Steam MO2
Skyrim Special Edition Steam MO2
Fallout 4 Steam MO2
Skyrim VR Steam MO2

Installing a ModList

Every ModList comes with its own set of instructions which you should read before doing anything. The following steps are the general steps you would take, but every ModList is different from one another so don't rely on those.

A ModList comes as a .wabbajack file. You might have a .zip, .7z or .rar file which contains the ModList so extract the archive using 7zip before starting Wabbajack. Once extracted, start Wabbajack and click on the Install a ModList from Disk button and select the extracted .wabbajack file.

On the installation screen, configure the installation/staging and downloads folder before clicking the begin button. Once everything is correctly setup, the button will be clickable and you can proceed with the installation.

The installation can take everything from a few minutes to hours depending on the size of the ModList, your Internet speed and your hardware so just be patient and wait for Installation complete! You may exit the program. to appear in the log.

Creating your own ModList

Caching before compilation

Wabbajack will index all files in the game folder during compilation. It is highly recommended that you run a compilation with an empty ModList and copy the vfs_cache.bin file to a safe location. Depending on the game, indexing can take a long time for the game files alone so having done it already will save you time.

Notes before compiling

Overview video on YouTube.

Before doing anything make sure that:

  1. Wabbajack is not inside commonly used folders like Documents, Downloads, Desktop but rather on a very high level directory like C:\Wabbajack\.
  2. The game you modded is not inside the default Steam folder C:\Program Files (x86)\Steam\steamapps\common, see this post on how to move your library.
  3. You have a stable connection to the Internet

Creating a ModList from an MO2 Profile

Wabbajack must not be located inside the MO2 folder or else the entire universe and the time-space continuum we know and love will be destroyed... this includes all kitten and puppies you have ever seen so be careful!

MO2 must be in Portable and every archive you used in your MO2 profile has some sort of download information attached:

  • You need all archives and all .meta files for those archives inside your MO2/downloads/ folder.
  • If you downloaded a file manually from the Nexus, make sure its in the MO2/downloads/ folder and click Query Info from the right-click menu in MO2.
  • For other files like ENBSeries, SKSE, SRO, etc. look at the RECIPES.md file.

Wabbajack Flags

There are special flags that can be placed in a mod's notes or comments to trigger special behavior in Wabbajack:

  • WABBAJACK_INCLUDE - All mod files will be inlined into the .wabbajack file
  • WABBAJACK_ALWAYS_ENABLE - The mod's files will be considered by the compiler even if the mod is disabled in the profile
  • WABBAJACK_NOMATCH_INCLUDE - The mod's files will be included as inline files inside the .wabbajack file even if Wabbajack did not found any match for them

Patches

Wabbajack can create binary patches for files that have been modified after installation. This could be an .esp that has been cleaned or patched. It could also be a mesh or texture that has been optimized to work better in a given game.

In any case, a BSDiff file is generated. The output of this process is copied directly into the ModList instructions. However! It is important to note that the patch file 100% useless without the source file. So original + patch = final_file. Without the original file, the final file cannot be recreated. This allows us to distribute arbitrary changes without violating copyrights as we do not copy copyrighted material. Instead, we copy instructions on how to modify the copyrighted material.

Starting Wabbajack

Once you have everything setup, launch Wabbajack and click the Create a ModList button. Select MO2 as your Mod Manager and point to your modlist.txt file located at MO2\profile\<profile_name>\modlist.txt. Make sure that the downloads folder is set correctly.

You now also have the option to change some properties for your ModList. Users will see those information when they select your ModList before installation. You can not change these properties during/after compilation!

When everything is correctly set up, click the begin button and wait for Wabbajack to finish. Depeding on your hardware, size of your MO2 folder and game of choice, this can take up anything from a few minutes to hours. Do note that whenever Wabbajack has an error you can restart the compilation and Wabbajack will resume at the exact position.

Wabbajack is finished when you see Done Building ModList in the log. At that point you can close Wabbajack and the .wabbajack file will be located in the same folder as Wabbajack.exe.

FAQ

How can I get Wabbajack to handle mods from X?

Look at the RECIPES.md file, we keep a knowledge base of how to deal with given types of mods in that file.

How do I contribute to Wabbajack?

Look at the CONTRIBUTING.md file for detailed guidelines.

How does Wabbajack differ from Automaton?

I (halgari) used to be a developer working on Automaton. Sadly development was moving a bit too slowly for my liking, and I realized that a complete rewrite would allow the implementation of some really nice features (like BSA packing). As such I made the decision to strike out on my own and make an app that worked first, and then make it pretty. The end result is an app with a ton of features, and a less than professional UI. But that's my motto when coding "make it work, then make it pretty".

Can I charge for a Wabbajack Modlist I created?

No, as specified in the license, Wabbajack modlists must be available for free. Any payment in exchange for access to a Wabbajack installer is strictly prohibited. This includes paywalling, "pay for beta access", "pay for current version, previous version is free", or any sort of other quid-pro-quo monitization structure. The Wabbajack team reserves the right to implement software that will prohibit the installation of any lists that are paywalled.

Can I accept donations for my installer?

Absolutely! As long as the act of donating does not entitle the donator to access to the installer. The installer must be free, donations must be a "thank you" not a purchase of services or content.

All original code in Wabbajack is given freely via the GPL3 license. Parts of Wabbajack use libraries that carry their own Open Sources licenses, those parts retain their original copyrights. Selling of ModList files is strictly forbidden. As is hosting the files behind any sort of paywall. You recieved this tool free of charge, respect this by giving freely as you were given.

Thanks to

Our testers and Discord members who encourage development and help test the builds.

Patreon Supporters

Daedra level Patreon Supporters

  • Ancalgon
  • Theo
  • Dascede
  • Kristina Poňuchálková
  • metherul
  • Decopauge123
  • ButteredMolerat
  • Phillip Zolla
  • Shawn Merrill
  • Steven Kimsey
  • NexVotum
  • Randall Johnson
  • Isaac Testerman
  • Bryan Karsh
  • Coyney
  • Roy Martinez
  • Bob Bob
  • yreeFJ
  • Rob
  • Jessica Frost
  • Andrew Johnson
  • John D Ford
  • Cybel
  • Zack McMurtry
  • Fermin Ayucar
  • Antoine Arcand

Chicken and Mudcrab level Supporters

  • SirLach
  • Druwski
  • Soothsayre
  • krageon
  • Scumbag
  • Burt Wheeler
  • Jesse Earl Rockwell
  • Mike Gray
  • Theryl
  • Daniel Gardner
  • Dapper
  • Corapol
  • HQM
  • Argos
  • sorrydaijin
  • William Chudziak
  • N Kalim
  • Miguel Conde Gallastegui
  • Flawedspirit
  • rainslave
  • Brandon Alanskas
  • Nordwulf
  • John Mallett
  • Chris LaGrange
  • Aleksandar Ljubičić
  • LegitRob95
  • LND
  • Parks
  • Hiyoko Yoko
  • MarkEE Mark
  • Absolute Phoenix
  • SirLach
  • Will Thrash
  • Doug H
  • Aymerick
  • Ryan Nuckolls
  • Tyler Long
  • Kyle Rector
  • KarMagick
  • IEatASS
  • Jasagna
  • Jeffrey B Eppes
  • daniel gonzalez
  • Luke Szabolcsky
  • Alex Lewis
  • Lisa Croxford
  • Mattloki
  • Aaaron Wagner
  • Ronald Bishop
  • BigSandwhich
  • Cal Wheeler
  • King Joffrey
  • Jack Hayden
  • Alxariam
  • doomstove
  • Tate Chambers
  • Nechrion
  • Salvatore Aliberti
  • Kevin Smith
  • Joko
  • Antoine Arcand
  • Kyle Reynolds
  • Pascal
  • Jake D Hagood
  • Kyle McCall