Description of the Program Functionality

The program is designed to automatically launch files when Mod Organizer 2 (MO2) starts. It consists of two main components: a file launcher plugin and a settings editor.

1. Unpacking:
- Unpack the contents of the archive into the MO2 plugins folder.

2. Using the ExePreload Plugin:
- After unpacking, go to the MO2 menu.
- Find the plugin ExePreload there.
- In the ExePreload plugin, you can configure the list of files you want to launch at MO2 startup.

3. Markers:
- background: the file will be launched in the background.
- foreground: the program will wait for the file to finish executing (including MO2 will not be loaded until the file finishes).

4. Program Files:
- preload_plugin.py - the main plugin that automatically launches files specified in preload.ini at MO2 startup.
- preload.ini - a settings file that lists files to be launched and markers (background or foreground).
- preload_plugin_menu.py - a settings editor invoked through the MO2 menu. It allows editing the list of files and markers. Deleting this file does not affect the main plugin's operation.

Example preload.ini contents:


[Files]
file1 = C:/path/to/your/file1.exe, background, always
file2 = C:/path/to/your/file2.exe, foreground, once
file3 = C:/path/to/your/file3.exe, background, disabled


Explanation of parameters in preload.ini:

- [Files]: Section containing the list of files to be launched.
- file1: Parameter name representing the first file.
- C:/path/to/your/file1.exe: Path to the executable file.
- background: Marker indicating that the file will be launched in the background.
- always: Launch frequency parameter indicating that the file will be launched every time MO2 starts.
- file2: Parameter name representing the second file.
- C:/path/to/your/file2.exe: Path to the executable file.
- foreground: Marker indicating that the program will wait for the file to finish executing.
- once: Launch frequency parameter indicating that the file will be launched only once.
- file3: Parameter name representing the third file.
- C:/path/to/your/file3.exe: Path to the executable file.
- background: Marker indicating that the file will be launched in the background.
- disabled: Launch frequency parameter indicating that the file will not be launched.

5. preload_plugin_menu.py - settings editor invoked through the MO2 menu. Allows editing the list of files, markers, and launch frequency. Deleting this file does not affect the main plugin's operation.

Using the preload.ini editor:

1. Adding entries:
- Add entries for the files you want to run at MO2 startup:
- File Path: Path to the executable file.
- Marker:
- background: the file will be launched in the background.
- foreground: the program will wait for the file to finish executing.
- Frequency:
- always: the file will be launched every time MO2 starts.
- once: the file will be launched only once.
- disabled: the file will not be launched.

2. Editor interface:
- Adding an entry: Click the "Add Entry" button and select the file.
- Saving changes: Click the "Save" button.
- Deleting an entry: Click the "Delete" button.
- Closing the window: Click the "Close" button.




Описание функционала программы

Программа предназначена для автоматического запуска файлов при загрузке Mod Organizer 2 (MO2). Она состоит из двух основных компонентов: плагина для запуска файлов и редактора настроек.

1. Распаковка:
- Распакуйте содержимое архива в папку плагинов MO2.

2. Использование плагина ExePreload:
- После распаковки перейдите в меню MO2.
- Найдите там плагин ExePreload.
- В плагине ExePreload вы можете настроить список файлов, которые вы хотите запускать при старте MO2.

3. Маркеры:
- background: файл будет запущен в фоновом режиме.
- foreground: выполнение программы будет ожидать завершения файла (в том числе и MO2 не будет загружен, пока файл выполняется).

4. Файлы программы:
- preload_plugin.py - основной плагин, который автоматически запускает файлы, указанные в preload.ini, при загрузке MO2.
- preload.ini - файл настроек, в котором указаны файлы для запуска и маркеры (background или foreground).
- preload_plugin_menu.py - редактор настроек, вызываемый через меню MO2. Позволяет редактировать список файлов и маркеры. Удаление этого файла не влияет на работу основного плагина.

Пример содержимого preload.ini:


[Files]
file1 = C:/path/to/your/file1.exe, background, always
file2 = C:/path/to/your/file2.exe, foreground, once
file3 = C:/path/to/your/file3.exe, background, disabled


Разбор параметров в preload.ini:

- [Files]: Секция, содержащая список файлов для запуска.
- file1: Имя параметра, обозначающее первый файл.
- C:/path/to/your/file1.exe: Путь к исполняемому файлу.
- background: Маркер, указывающий, что файл будет запущен в фоновом режиме.
- always: Параметр частоты запуска, указывающий, что файл будет запускаться при каждом старте MO2.
- file2: Имя параметра, обозначающее второй файл.
- C:/path/to/your/file2.exe: Путь к исполняемому файлу.
- foreground: Маркер, указывающий, что выполнение программы будет ожидать завершения файла.
- once: Параметр частоты запуска, указывающий, что файл будет запускаться только один раз.
- file3: Имя параметра, обозначающее третий файл.
- C:/path/to/your/file3.exe: Путь к исполняемому файлу.
- background: Маркер, указывающий, что файл будет запущен в фоновом режиме.
- disabled: Параметр частоты запуска, указывающий, что файл не будет запускаться.

5. preload_plugin_menu.py - редактор настроек, вызываемый через меню MO2. Позволяет редактировать список файлов, маркеры и частоту запуска. Удаление этого файла не влияет на работу основного плагина.

Использование редактора preload.ini:

1. Добавление записей:
- Добавьте записи о файлах, которые вы хотите запустить при старте MO2:
- File Path (Путь к файлу): путь к исполняемому файлу.
- Marker (Маркер):
- background: файл будет запущен в фоновом режиме.
- foreground: выполнение программы будет ожидать завершения файла.
- Frequency (Частота):
- always: файл будет запускаться при каждом старте MO2.
- once: файл будет запускаться только один раз.
- disabled: файл не будет запускаться.

2. Интерфейс редактора:
- Добавление записи: нажмите кнопку "Add Entry" (или "Добавить запись") и выберите файл.
- Сохранение изменений: нажмите кнопку "Save" (или "Сохранить").
- Удаление записи: нажмите кнопку "Delete" (или "Удалить").
- Закрытие окна: нажмите кнопку "Close" (или "Закрыть").