MagicLoader 2 2.8

• Скачайте MagicLoader 2.
• Распакуйте содержимое ZIP-архива в папку с игрой.

Ваша_папка_с_игрой/
├── OblivionRemastered.exe
├── MagicLoader/
└── ... (остальные файлы)

• Если вы обновляетесь с предыдущей версии, рекомендуется сначала удалить старые файлы (хотя и без этого всё должно работать).
• Для GamePass поместите папку MagicLoader рядом с gamelaunchhelper.exe.
• Готово! Теперь можно переходить к запуску MagicLoader 2.

• Лучше всегда запускать игру через MagicLoader.exe, чтобы он мог корректно управлять модами и поддерживать порядок.
• С технической точки зрения, MagicLoader нужен только при изменении модов, но для стабильности лучше использовать его постоянно.

Шаг 1: Удаление папки MagicLoader​

{Папка с игрой}/
├── OblivionRemastered.exe
└── MagicLoader/ ← Удалите эту папку

Шаг 2: Очистка сгенерированных файлов​

• !_MagicLoader_Core_~mods.pak
• !_MagicLoader_Mods_~mods.pak

Готово!​

• Моды, зависящие от MagicLoader 2, перестанут работать (или будут работать некорректно).
• Дополнительные инструкции по удалению таких модов ищите в их описаниях.

1. В указанной выше папке Data находится подпапка MagicLoader (она создается после первого запуска игры через MagicLoader 2)
2. Поместите полученные .json-файлы в эту подпапку

• Многие архивы с модами уже содержат нужную структуру папок
• Менеджеры модов могут автоматически размещать файлы в нужных местах
• Главное - чтобы .json-файлы оказались где-то внутри Data\MagicLoader

• Можно использовать либо длинное, либо короткое имя параметра (например, -v ИЛИ --version). Использование обоих вариантов одновременно избыточно, но не вызовет ошибок.

Список параметров:​

Примеры JSON-файлов и их функционал​

Пример 1: Добавление новых локаций​

{
    "Plugin": "IntTestMod.esp",
    "NewCells": [
        "ed3",
        "ed4",
        "ed5"
    ],
    "NewStrings": {
        "LOC_FN_Haphy1": "Some New Place",
        "LOC_FN_Haphy2": "A Different Place",
        "LOC_FN_Haphy3": "DON'T DEAD OPEN INSIDE"
    }
}

• Создает 3 новых интерьерных локации (добавляя их в CellsToMapPaths StringTable)
• Добавляет названия для этих локаций (необходимы для работы дверей)
• Поле Plugin обязательно при добавлении новых ячеек

Пример 2: Модификация текста​

{
    "Localization": [
        {
            "Key": "LOC_AD_Settings_SettingTitle_AimAssist",
            "Global_Edit": "$[[LOC_AD_Settings_SettingTitle_AimAssist]] <3"
        },
        {
            "Key": "LOC_AD_Settings_SettingTitle_AimAssist",
            "Global_Edit": "$[[LOC_AD_Settings_SettingTitle_AimAssist]] :3"
        }
    ]
}

• Модифицирует текст настройки "Помощь при прицеливании":
  1. Добавляет " <3" → "Помощь при прицеливании <3"
  2. Добавляет " :3" → "Помощь при прицеливании <3 :3"
• Изменения применяются ко всем языкам
• Поле Plugin не требуется (так как не добавляются новые ячейки)

Пример 3: Улучшение названий ингредиентов​

{
    "Localization": [
        {
            "Key": "LOC_FN_IngredFPotato",
            "EN": "Starch Boulder",
            "DE": "Stärkefels",
            "ES": "Roca de Almidón",
            "FR": "Rocher d’Amidon",
            "IT": "Masso d'Amido",
            "JA": "デンプン岩",
            "PL": "Skrobiowy Głaz",
            "PT": "Pedregulho de Amido",
            "RU": "Крахмальный Валун",
            "ZH": "淀粉巨石"
        }
    ]
}

• Заменяет стандартное название на более эпичное во всех языках
• Русская версия: "Крахмальный Валун" (гораздо солиднее!)

Техническое описание возможностей JSON в MagicLoader 2​

Общие заметки:​

• Поддерживаются подкаталоги
• Мод может содержать несколько JSON-файлов для разделения функционала (с использованием полей Requires)

Основные поля:​

1. "Plugin": "MyMod.esp"
   • Обязательно для использования NewCells или CellMap.
   • Должен указывать на ESP-файл, содержащий добавляемые ячейки.
2. "RequiresVersion": "2.3"
   • Пропускает загрузку мода, если версия MagicLoader ниже указанной.
3. "RequiresJson": ["MyMod.json", "SomeOtherMod.json"]
   • Пропускает файл, если указанные JSON-файлы отсутствуют.
4. "RequiresActivePlugin": ["MyMod.esp", "SomeOtherMod.esp"]
   • Пропускает файл, если указанные ESP-файлы не активны в plugins.txt.
5. "LoadBefore": ["SomeOtherMod.json"]
   • Попытка загрузить текущий файл перед указанными (для приоритета переопределения).
6. "LoadAfter": ["SomeOtherMod.json"]
   • Попытка загрузить текущий файл после указанных (для приоритета переопределения).

Работа с локациями:​

1. "NewCells": ["ed0", "ed1"]
   • Регистрирует новые интерьерные ячейки.
   • Использует короткие FormID (например, 0f000ed0 → "ed0").
   • Автоматически преобразует в нижний регистр.
2. "CellMap": {"ed2": "/Game/Maps/Interiors/L_WarehouseCaveBeastLair"}
   • Привязывает ячейку к пользовательской карте (.umap).

Работа с текстом:​

• Добавляет/редактирует записи в StringTable.
• Автоматически определяет таблицу по префиксу (например, LOC_FN_ → FullNames).
• Поддерживаемые таблицы:

AltarDynamicTexts (LOC_AD_), AltarStaticTexts (LOC_ST_), BookContent (LOC_BK_),
Descriptions (LOC_DE_), FullNames (LOC_FN_), HardcodedContent (LOC_HC_),
LogEntries (LOC_LE_), MissingEntries (LOC_ME_), ResponseTexts (LOC_RT_), ScriptContent (LOC_SC_)

• Добавляет строки в конкретную таблицу (без локализации).

• Редактирует строки (например, добавляет суффикс).
• Может использовать значения из любой StringTable.

Локализация:​

"Localization": [
  {
    "Key": "LOC_AD_Option",
    "EN": "Easy Mode",
    "RU": "Лёгкий режим",
    "Global_Edit": "$[[LOC_AD_Option]] :3"
  }
]

• Key: ID строки.
• EN/RU/DE и т.д.: Переводы для языков.
• Global_Edit: Изменение для всех языков (например, добавление ":3").
• RU/RU_Edit: Работают только с установленным русским переводом.

Примечания:​

• Для новых строк обязательно наличие соответствующей записи в StringTable.
• Поля _Edit применяются после основного значения.

Если вы хотите установить MagicLoader:​

1. Распакуйте MagicLoader в корневую папку игры. В результате должны получиться следующие пути:
   • Steam: Oblivion Remastered\MagicLoader\MagicLoader.exe
   • GamePass: The Elder Scrolls IV - Oblivion Remastered\Content\MagicLoader\MagicLoader.exe
2. Установите свои моды как обычно:
   • .esp-файлы поместите в:
     • Steam: Oblivion Remastered\OblivionRemastered\Content\Dev\ObvData\Data\
     • GamePass: The Elder Scrolls IV - Oblivion Remastered\Content\OblivionRemastered\Content\Dev\ObvData\Data\
       (Обратите внимание, что сам MagicLoader не содержит .esp-файлов - это просто подсказка, куда такие файлы обычно помещаются.)
   • .json-файлы для MagicLoaderдолжны находиться в:
     • Steam: Oblivion Remastered\OblivionRemastered\Content\Dev\ObvData\Data\MagicLoader\
     • GamePass: The Elder Scrolls IV - Oblivion Remastered\Content\OblivionRemastered\Content\Dev\ObvData\Data\MagicLoader\
       (Эти файлы должны поставляться с модами, использующими MagicLoader - сам инструмент их не включает.)
   • .pak-модыпоместите в:
     • Steam: Oblivion Remastered\OblivionRemastered\Content\Paks\~mods
     • GamePass: The Elder Scrolls IV - Oblivion Remastered\Content\OblivionRemastered\Content\Paks\~mods
       (Учтите, что MagicLoader не включает .pak-файлы - они создаются при запуске инструмента.)
3. Запустите MagicLoader.exe(находится по указанным выше путям).
   • Если MagicLoader установлен в правильную папку, но всё равно жалуется на неправильное расположение, попробуйте запустить его от имени администратора. Это может быть связано с ограничениями прав доступа в защищённых папках (например, стандартных директориях Steam).
4. MagicLoader сообщит, если обнаружит проблемы (например, неправильную папку), а также укажет количество найденных совместимых модов.
5. Нажмите "Do Magic" и дождитесь завершения патчинга.
6. Если всё прошло успешно, появится сообщение: "The magic was successful!"
7. Поздравляем! Данные модов были внедрены в ремастер. Закройте MagicLoader и запустите Oblivion!

Удаление MagicLoader​

Удаление мода, использующего MagicLoader​

1. Удалите .json-файлэтого мода из папки:
   • Steam: Oblivion Remastered\OblivionRemastered\Content\Dev\ObvData\Data\MagicLoader\
   • GamePass: The Elder Scrolls IV - Oblivion Remastered\Content\OblivionRemastered\Content\Dev\ObvData\Data\MagicLoader\
2. Запустите MagicLoader.exe, нажмите "Do Magic" и дождитесь завершения.

Альтернативный вариант (для автоматизации)​

Как использовать MagicLoader в своих модах?​

Пример .json-файла:​

{
    "Plugin": "IntTestMod.esp",
    "NewCells": [
        "ed3",
        "ed4"
    ],
"CellMap": {
"ed5": "Game/Maps/Interiors/L_MyCustomMap"
},
    "FullNames": {
        "LOC_FN_Haphy1": "Some New Place",
        "LOC_FN_Haphy2": "A Different Place",
        "LOC_FN_Haphy3": "DON'T DEAD OPEN INSIDE"
    }
}

• Plugin: имя вашего .esp-файла (обязательно для добавления новых локаций или карт).
• NewCells: Editor ID новых внутренних локаций (конечные нули можно опускать).
• CellMap: если у вас есть кастомная карта, укажите Editor ID локации и путь к карте.
• FullNames: пары "ключ-значение" для добавления строк в таблицу названий (существующие записи с таким же ключом будут перезаписаны).

Планируются ли новые функции?​