README.md

Mod Organizer 2 Plugins

Description

This repository contains two Mod Organizer 2 plugins:

1. Merge Plugins Hide: Allows hiding or unhiding plugins that were merged using Merge Plugins or zMerge.
2. Sync Mod Order: Synchronizes mod order from the current profile to another while preserving the enabled/disabled state of mods.

Installation

1. Download the latest .zip file from the Releases page.
2. Extract the contents into Mod Organizer 2's plugins/ folder.
3. Rename the extracted folder to avoid potential errors (e.g., deorder).
4. The plugins will appear in the Tools menu (puzzle piece icon) within Mod Organizer 2.

Merge Plugins Hide

This plugin offers flexibility in managing merged plugins.

Hide Methods

Configure the hiding method by changing the hide-type setting:

1. mohidden: Hides plugins using MO2's virtual file system by appending .mohidden to the plugin file.
2. optional: Hides plugins by moving them to an optional directory within the mod.
3. disable: Hides plugins by disabling them (compatible with zMerge's method).

Sync Mod Order

This plugin allows you to synchronize mod orders between profiles while maintaining the enabled/disabled states of individual mods.

Build Instructions

Prerequisites

• Python 3.12 or newer

First-Time Setup

1. Open a terminal in the project directory.
2. Create a virtual environment:

   python3 -m venv .venv
   

3. Activate the virtual environment:

   On Windows:
   .\.venv\Scripts\Activate.ps1
   
   On Linux:
   source .venv/bin/activate
   

4. Install required packages:

   pip install -r requirements.txt
   

5. Build the resources:

   python build.py
   

Subsequent Builds

1. Activate the virtual environment (if not already activated):

   On Windows:
   .\.venv\Scripts\Activate.ps1
   
   On Linux:
   source .venv/bin/activate
   

2. Run the build script:

   python build.py
   

This will compile the necessary resources for the plugins.