Wrye Bash
About
Wrye Bash is a mod management utility for games based on Bethesda's Creation
Engine, with a rich set of features.
This is a fork of the Wrye Bash related code from the
SVN 3177 trunk revision.
We are in the process of refactoring the code to eventually support more games,
offering the same feature set for all of them.
Please read the Contributing section below if interested in
contributing.
Supported Games
Here is a list of supported games with the minimal patch version that Bash was
tested on (previous versions or latest versions may or may not work):
- Oblivion (patch 1.2.0.416)
- Fallout 3 (patch 1.7.0.3)
- Fallout New Vegas (patch 1.4.0.525)
- Skyrim (patch 1.9.36.0)
- Enderal (patch 1.5.8.0)
- Fallout 4 (patch 1.10.163.0)
- Skyrim Special Edition (patch 1.5.97.0)
Download
Docs are included in the download but we are setting them up also online
here.
Installation
- Short version: just use the installer, and install everything to their
default locations.
- Long version: see the General Readme for information, and the
Advanced Readme for even more details.
To run Wrye Bash from the latest dev code (download from here)
you need:
- A game to manage from the supported games.
- Python 2.7 32-bit (latest 2.7 is recommended)
NB: the 32-bit version is required even if you are on a 64-bit
operating system.
Once you have those, install the required packages by running:
path/to/python.exe -m pip install -r requirements.txt
Refer to the readmes for detailed instructions. In short:
- Install one of the supported games (Oblivion, Skyrim, Fallout).
- Install Python and plugins above.
- Extract the downloaded Wrye Bash archive into your game folder.
- Run Wrye Bash by double-clicking "Wrye Bash Launcher.pyw" in the new Mopy
folder.
WINE
Wrye Bash 306 runs on WINE - with some hiccups. In short:
- Do not use the installer - instead wine-install the python prerequisites
above, then unzip/clone the python version in your game folder
- Edit
Mopy/bash/balt.py - add canVista = False just above the
def setUAC(button_,uac=True): so it becomes
...
canVista = False
def setUAC(button_,uac=True):
...
- Run Bash as
wine python /path/to/Mopy/Wrye Bash Launcher.pyw
For details see our wiki article.
Wine issue: #240
Questions ? Feedback ?
We are currently monitoring this thread at the AFK Mods forum and
the Wrye Bash Discord.
Please be sure to ask there first before reporting an issue here. If asking for
help please provide the info detailed in our Reporting a bug wiki page.
In particular it is essential you produce a bashbugdump.log.
Latest betas
In the second post of the AFK Mods thread, as well as in the
#wip-builds channel on Discord, there are links to the latest python
and standalone (exe) builds. Be sure to check those out for bleeding edge
bugfixes and enhancements. Feedback appreciated!
Contributing
To contribute to the code, fork the repo and set your fork up as
detailed in [git] Syncing a Fork with the main repository.
A good starting point is the currently worked on issues
(see also issue 200 for some refactoring tasks we need help with).
The recommended way to code for Bash is Pycharm (set up instructions).
Please also read at least:
When ready do not issue a pull request - contact instead a member of the team
in the relevant issue and let them review. Then those branches can be pulled
from your fork and integrated with upstream. Once this is done a couple times
you get write rights.
Main Branches
-
dev: the main development
branch - approved commits end up here. Do not directly push to this branch -
push to your branches and contact someone from the owners team in the relevant
issue.
-
master: the production
branch, contains stable releases. Use it only as reference.
-
nightly:
bleeding edge branch. Commits land here for testing.
