aboutsummaryrefslogtreecommitdiff
path: root/libs/installer_wizard/README.md
diff options
context:
space:
mode:
authorSulfurNitride <SulfurNitride@users.noreply.github.com>2026-02-11 02:37:39 -0600
committerSulfurNitride <SulfurNitride@users.noreply.github.com>2026-02-11 02:37:39 -0600
commit7ee008e150bc5bcf76082d726f719ee0fdfda982 (patch)
tree27fb39be241fdb5ac2734c574de678977d1856d0 /libs/installer_wizard/README.md
Fluorine Manager: full Linux port of Mod Organizer 2
Complete native Linux port with FUSE-based virtual filesystem, Proton/umu-run integration, and Flatpak packaging. Key features: - FUSE VFS replacing Windows USVFS (in-process + standalone helper for Flatpak) - Proton/GE-Proton/umu-run launcher with env var forwarding - Flatpak support (sandbox-aware VFS, NXM handler, umu-run) - Wine prefix management UI - Case-insensitive path resolution for Linux filesystems - QSettings-safe INI handling (avoids Bethesda INI corruption) - Portable instance support with auto-generated launcher scripts Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Diffstat (limited to 'libs/installer_wizard/README.md')
-rw-r--r--libs/installer_wizard/README.md83
1 files changed, 83 insertions, 0 deletions
diff --git a/libs/installer_wizard/README.md b/libs/installer_wizard/README.md
new file mode 100644
index 0000000..b8db085
--- /dev/null
+++ b/libs/installer_wizard/README.md
@@ -0,0 +1,83 @@
+# MO2 BAIN Wizard Installer Plugin
+
+This plugin can be used to install BAIN archives containing a wizard script (`wizard.txt`).
+
+## How to install?
+
+Go to the [releases page](https://github.com/Holt59/modorganizer-installer_wizard/releases) and download
+the latest release for your MO2 version.
+
+### A few words on INI Tweaks
+
+Mod Organizer 2 does not currently manage INI Tweaks, so the Wizard installer is partially functional
+regarding them.
+
+- The installer will create proper INI Tweaks when requested, but these will not be applied
+ to the game INI files automatically. If INI Tweaks are present, a pop-up should appear at
+ the end of the installation.
+- INI Tweaks for OBSE script are directly applied to the OBSE scripts.
+
+## How to contribute?
+
+### Setting-up the environment
+
+Below are the steps to setup a development environment.
+
+
+1. Clone this repository into the Mod Organizer 2 plugins folder.
+
+```bash
+# (Optional) you can change the name of the folder:
+git clone https://github.com/Holt59/modorganizer-installer_wizard installer_wizard
+```
+
+2. **Requirements:** You need a Python 3.8 installation. The list of requirements is in
+ [`requirements.txt`](requirements.txt):
+
+```bash
+# Those are only the development requirements.
+pip install -r requirements
+```
+
+3. "Build" the installer:
+
+```bash
+# This will install the 3rd party libraries in src/lib (required for the installer) and convert the .ui files into .py files.
+make.ps1
+```
+
+4. Create a root `__init__.py` - MO2 will not find and load the plugin unless there is a
+ `__init__.py` file in the root of the folder, so you need to create one:
+
+```python
+from .src import createPlugin
+```
+
+### Opening a Pull-Request
+
+Once you are satisfied with your changes, you can
+[open a pull-request](https://github.com/Holt59/modorganizer-installer_wizard/pulls).
+Before doing so, you should check that your code is properly
+formatted and clean:
+
+```bash
+# The -vv option is mandatory, otherwise tox will crash...
+tox -vv -e py38-lint
+```
+
+### The interpreter
+
+The interpreter used by the installer is from the
+[`bain-wizard-interpreter`](https://github.com/Holt59/bain-wizard-interpreter) package.
+For issues related to interpreter (i.e. the script is wrongly parsed), open issues on the interpreter repository.
+
+## License
+
+MIT License
+
+Copyright (c) 2020 Mikaƫl Capelle
+
+See [LICENSE](LICENSE) for more information.
+
+**Note:** The release archives contains external libraries that are under their
+own LICENSE.