Джус Скайрим с нейросетью: полный гайд по установке и настройке Mantella

Подробное руководство по установке и настройке мода Mantella для Skyrim, который добавляет в игру диалоги с NPC на основе нейросетей. Рассмотрены требования, пошаговая инструкция, настройка русского языка и ответы на частые вопросы.

Что такое мод Mantella и как он работает

Mantella — это модификация для The Elder Scrolls V: Skyrim, которая интегрирует в игру современные нейросети для создания живых, неповторяющихся диалогов с NPC. В отличие от стандартных скриптовых реплик, Mantella использует три ключевые технологии:

  • Языковая модель (LLM) — «мозг» системы. Она получает контекст: кто ваш персонаж, где вы находитесь, какая погода, что за NPC перед вами. На основе этого генерируется уникальный ответ, учитывающий характер персонажа, лор игры и историю ваших предыдущих разговоров.
  • Синтез речи (TTS) — превращает сгенерированный текст в голос. Используются модели, обученные на оригинальных голосах актёров Skyrim, поэтому NPC говорят своими настоящими голосами с правильными интонациями.
  • Распознавание речи (STT) — позволяет вам не печатать, а просто говорить в микрофон. Игра распознаёт вашу речь и передаёт её NPC.

В результате вы можете спросить у стражника о его отношении к Братьям Бури, попросить каджита рассказать о родине или пофлиртовать с Лидией. Ответы никогда не повторяются, а NPC помнят ваши поступки: если вы украли лошадь в Вайтране, торговец может отказаться с вами разговаривать. Мод также поддерживает диалоги между самими NPC, обмен предметами и совместные приключения.

Системные требования и что нужно подготовить

Для работы Mantella потребуется не только сама игра, но и дополнительное программное обеспечение. Вот минимальный набор:

  • Skyrim Special Edition (рекомендуется GOG-версия для минимизации проблем с совместимостью).
  • Skyrim Script Extender (SKSE) — обязательный компонент для работы многих модов.
  • xVASynth v3 — программа для синтеза речи, которая будет озвучивать NPC.
  • KoboldCpp — интерфейс для запуска языковой модели (LLM) на вашем компьютере.
  • Модели нейросетей — файлы для LLM (например, образы в формате GGUF) и голосовые модели для xVASynth.
  • Mod Organizer 2 — менеджер модов для удобной установки и настройки.

Важно: сама игра не справляется с такой нагрузкой. Мод работает как «мост» между Skyrim и внешними ИИ-серверами или вашей видеокартой. Если вы планируете запускать нейросеть локально, убедитесь, что у вас достаточно мощный GPU (не менее 8 ГБ видеопамяти) и не менее 32 ГБ свободного места на диске для распаковки голосовых моделей.

Также потребуется стабильное интернет-соединение, если вы решите использовать облачные сервисы (например, OpenAI API) вместо локального запуска.

Пошаговая установка: подготовка папок и софта

Установка Mantella состоит из нескольких этапов. Начнём с подготовки окружения.

  1. Установите Skyrim SE (GOG-версия). Убедитесь, что игра обновлена до последней версии.
  2. Скачайте и установите SKSE. Распакуйте архив в папку с игрой так, чтобы файл skse64_loader.exe находился рядом с SkyrimSE.exe.
  3. Создайте рабочую папку, например E:\OpenAI, куда будете складывать все необходимые компоненты.
  4. Скачайте xVASynth v3 (основное приложение и патч v3.0.2). Распакуйте в E:\OpenAI\xVASynth, патч — поверх.
  5. Установите русский словарь транскрипции для xVASynth — он улучшит произношение русских слов. Распакуйте в папку resources\app\python\xvapitch\text\dicts.
  6. Скачайте плагин .lip and .fuz для xVASynth и распакуйте в ту же папку.
  7. Скачайте FaceFXWrapper 0.4 и поместите файл FaceFXWrapper.exe в resources\app\plugins\lip_fuz.
  8. Скачайте xVADict — Elder Scrolls и распакуйте в E:\OpenAI\xVASynth.
  9. Скачайте голосовые модели (например, Female Serana и Male Nord). Создайте папку resources\app\models\Skyrim и поместите файлы туда, переименовав их согласно инструкции (например, sk_serana.json и sk_serana.pt).

После этого запустите xVASynth, включите плагин .lip and .fuz, подключите словари и выберите игру Skyrim. Настройте пути к моделям и выходной папке, затем закройте программу.

Настройка языковой модели и KoboldCpp

KoboldCpp — это программа, которая запускает языковую модель на вашем компьютере. Вот как её настроить:

  1. Скачайте KoboldCpp (файл koboldcpp.exe, около 500 МБ) и сохраните в E:\OpenAI\Kobold.
  2. Скачайте образ нейросети (GGUF-файл). Есть два варианта: лёгкая и быстрая модель или более качественная, но медленная. Сохраните файл в ту же папку.
  3. Запустите KoboldCpp. В открывшемся окне снимите галочку с Launch Browser, нажмите GGUF Text Model: Browse и выберите скачанный образ. Увеличьте размер контекста до 8192.
  4. Если хотите включить «зрение» NPC (чтобы они реагировали на то, что вы носите или держите в руках), перейдите на вкладку Loaded Files и укажите дополнительный образ для распознавания.
  5. Сохраните настройки в файл settings.kcpps. Можно создать два конфига — с зрением и без, чтобы переключаться между ними.

После этого KoboldCpp будет готов к работе. При первом запуске модель может загружаться долго (до нескольких минут), это нормально.

Установка модов через Mod Organizer 2

Теперь нужно установить основные моды, необходимые для работы Mantella. Используйте Mod Organizer 2 (MO2).

  1. Скачайте и установите Mod Organizer 2 в отдельную папку, например E:\SkyrimAI\MO2. При первом запуске выберите портативный режим и укажите версию игры GOG.
  2. Скачайте следующие моды (сохраните во временную папку):
  • Unofficial SSE Patch
  • Unofficial SSE Patch — RUS
  • Address Library for SKSE Plugins (версия All in one 1.6.X)
  • PapyrusUtil SE (версия 4.6 для SKSE 2.2.6)
  • SkyUI Russian translation
  • UIExtensions
  • World Encounter Hostility Fix (Performance Version)
  • No NPC Greetings (Special Edition)
  • Mantella
  • FonixData File (Mod Manager Install)
  • SSE Russian Fix Console (опционально)
  1. Установите моды в MO2 в указанном порядке. После установки Mantella закройте MO2.
  2. Настройте Mantella: откройте папку E:\SkyrimAI\MO2\mods\Mantella и в файле GPT_SECRET_KEY.txt пропишите строку http://localhost:5001/api/. Затем в файле custom_user_folder.ini укажите путь custom_user_folder = E:/SkyrimAI/Mantella/ и создайте эту папку.

Теперь все компоненты готовы к первому запуску.

Первый запуск и финальная настройка

После установки всех компонентов выполните следующие шаги:

  1. Запустите xVASynth, KoboldCpp и Mod Organizer 2.
  2. Запустите Skyrim из MO2. Дождитесь загрузки игры — автоматически откроется окно консоли Mantella. Когда раздастся звук лопнувшей струны и откроется браузер, закройте всё.
  3. Настройте файлы конфигурации:
  • Перейдите в %USERPROFILE%\Documents\My Games\Skyrim Special Edition GOG.
  • Удалите Skyrim.INI и скопируйте туда файл Skyrim_Default_ru.ini из папки E:\SkyrimAI\Skyrim, переименовав его в Skyrim.INI.
  • Отредактируйте SkyrimPrefs.ini: установите разрешение, полноэкранный режим (рекомендуется bFull Screen=0, bBorderless=1), включите субтитры (bDialogueSubtitles=1, bGeneralSubtitles=1).
  • Скопируйте оба файла в E:\SkyrimAI\MO2\profiles\Default.
  1. Отредактируйте config.ini Mantella (находится в E:\SkyrimAI\Mantella): укажите game = Skyrim, skyrim_mod_folder = E:\SkyrimAI\MO2\mods\Mantella, llm_api = KoboldCpp, model = Custom model.

После этого можно запускать игру снова. Если всё настроено правильно, NPC начнут отвечать на ваши вопросы уникальными фразами.

Как настроить русский язык в Mantella

Mantella изначально разрабатывалась для английского языка, но энтузиасты адаптировали её для русского. Вот что нужно сделать:

  1. Убедитесь, что ваш STT (распознавание речи) работает с русским языком. Для этого используйте Whisper (встроен в Mantella) вместо Moonshine.
  2. Настройте языковую модель (LLM). В главном промте (файл config.ini или в настройках Mantella) пропишите, что общение должно вестись на русском языке. По умолчанию используется переменная {language}, но можно добавить более подробные инструкции.
  3. Настройте TTS (синтез речи). Для русского языка лучше всего подходит xVASynth с русскими голосовыми моделями. Также можно использовать Piper или XTTS. Если TTS плохо говорит по-русски, вы всё равно сможете читать субтитры.
  4. Измените файл CSV с персонажами. В папке Mantella найдите файл, где указаны акценты NPC, и замените en,fr на ru. Это заставит игру использовать русские голосовые модели.
  5. Для продвинутой настройки можно арендовать GPU на runpod.io и использовать кастомный докер-образ с русским акцентом (например, Mantella bannana-RU).

Обратите внимание: русскоязычных голосовых моделей пока немного, но их количество постепенно растёт. Если какая-то модель отсутствует, Mantella будет использовать ближайшую доступную, выдавая ошибку в логе, но диалог всё равно состоится.

Возможные проблемы и их решение

При установке и настройке Mantella могут возникнуть следующие трудности:

  • Игра не запускается или вылетает. Проверьте, что все моды установлены в правильном порядке, а SKSE соответствует версии игры. Убедитесь, что вы используете GOG-версию, а не Steam — с ней меньше проблем.
  • NPC молчат или отвечают невпопад. Возможно, не настроен KoboldCpp или не указан правильный API-ключ. Проверьте файл GPT_SECRET_KEY.txt — там должна быть строка http://localhost:5001/api/.
  • Русский язык не работает. Убедитесь, что в STT выбран Whisper, а в промте указан русский язык. Также проверьте, что голосовые модели для xVASynth поддерживают кириллицу.
  • Долгая загрузка. При первом запуске KoboldCpp может загружаться до 5–10 минут. Это нормально. В дальнейшем запуск будет быстрее.
  • Ошибки в логе Mantella. Не все ошибки критичны. Например, сообщение о несоответствии голосовой модели не мешает диалогу — просто используется другая модель.

Если проблема не решается, обратитесь к сообществу на Nexus Mods или YouTube, где выложены подробные видеоинструкции.

Альтернативы Mantella: мод CHIM

Помимо Mantella, существует ещё один популярный мод для интеграции нейросетей в Skyrim — CHIM. Он предоставляет более широкий функционал: например, вы можете сказать NPC «Садись», и он сядет на ближайший стул. CHIM также поддерживает русский язык, но его установка сложнее.

Основные отличия:

  • CHIM требует более тонкой настройки, но позволяет управлять действиями NPC.
  • Mantella проще в установке и подходит для новичков.
  • Оба мода могут использовать любые языковые модели: ChatGPT, Llama, Grok, Sonnet и другие. Полный список доступен на openrouter.ai.

Если вы хотите максимального погружения и готовы потратить время на настройку, выбирайте CHIM. Если нужен быстрый результат — Mantella.

Практические советы для комфортной игры

Чтобы получить максимум удовольствия от Skyrim с нейросетью, следуйте этим рекомендациям:

  • Используйте микрофон хорошего качества. Распознавание речи работает точнее, если вас хорошо слышно.
  • Начинайте с простых диалогов. Спросите у стражника дорогу или поинтересуйтесь погодой — это поможет проверить, всё ли настроено правильно.
  • Экспериментируйте с разными голосовыми моделями. Не все модели звучат одинаково хорошо. Попробуйте несколько, чтобы найти ту, что вам нравится.
  • Не бойтесь ошибок в логах. Mantella — сложная система, и мелкие сбои неизбежны. Если диалог состоялся, всё в порядке.
  • Обновляйте моды. Разработчики постоянно улучшают Mantella и CHIM, добавляют новые голоса и исправляют баги. Следите за обновлениями на Nexus Mods.

Помните, что мод всё ещё находится в стадии активной разработки. Некоторые функции могут работать нестабильно, но сообщество энтузиастов быстро реагирует на проблемы.

Вопросы и ответы

Сложно ли установить Mantella новичку?

Установка требует внимательности и следования инструкции, но при наличии базовых навыков работы с файлами и модами справится большинство пользователей. Рекомендуется посмотреть видео-гайд на YouTube для наглядности.

Нужен ли мощный компьютер для работы мода?

Да, особенно если вы запускаете языковую модель локально. Рекомендуется видеокарта с 8+ ГБ памяти и 32 ГБ свободного места на диске. Если ваш ПК слабый, можно использовать облачные сервисы (например, OpenAI API), но это потребует оплаты.

Поддерживает ли Mantella русский язык?

Да, мод поддерживает русский язык, но для этого нужно дополнительно настроить STT (Whisper), LLM (указать язык в промте) и TTS (использовать русские голосовые модели). Полноценная русская версия доступна с конца февраля 2025 года.

Можно ли использовать Mantella с VR-версией Skyrim?

Да, мод совместим с Skyrim VR. Настройка аналогична обычной версии, но могут потребоваться дополнительные корректировки для работы с контроллерами.

Что делать, если NPC не отвечают или отвечают не по теме?

Проверьте, запущен ли KoboldCpp и правильно ли указан API-ключ в файле GPT_SECRET_KEY.txt. Также убедитесь, что в config.ini указана правильная модель и язык.

Сколько места занимает мод со всеми голосовыми моделями?

Около 17 ГБ после установки, но для первой распаковки требуется до 32 ГБ свободного места. Рекомендуется заранее освободить диск.

Есть ли альтернативы Mantella?

Да, основной альтернативой является мод CHIM. Он сложнее в установке, но предоставляет больше возможностей (например, управление действиями NPC). Оба мода поддерживают русский язык.