Что такое мод 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 состоит из нескольких этапов. Начнём с подготовки окружения.
- Установите Skyrim SE (GOG-версия). Убедитесь, что игра обновлена до последней версии.
- Скачайте и установите SKSE. Распакуйте архив в папку с игрой так, чтобы файл
skse64_loader.exeнаходился рядом сSkyrimSE.exe. - Создайте рабочую папку, например
E:\OpenAI, куда будете складывать все необходимые компоненты. - Скачайте xVASynth v3 (основное приложение и патч v3.0.2). Распакуйте в
E:\OpenAI\xVASynth, патч — поверх. - Установите русский словарь транскрипции для xVASynth — он улучшит произношение русских слов. Распакуйте в папку
resources\app\python\xvapitch\text\dicts. - Скачайте плагин .lip and .fuz для xVASynth и распакуйте в ту же папку.
- Скачайте FaceFXWrapper 0.4 и поместите файл
FaceFXWrapper.exeвresources\app\plugins\lip_fuz. - Скачайте xVADict — Elder Scrolls и распакуйте в
E:\OpenAI\xVASynth. - Скачайте голосовые модели (например, Female Serana и Male Nord). Создайте папку
resources\app\models\Skyrimи поместите файлы туда, переименовав их согласно инструкции (например,sk_serana.jsonиsk_serana.pt).
После этого запустите xVASynth, включите плагин .lip and .fuz, подключите словари и выберите игру Skyrim. Настройте пути к моделям и выходной папке, затем закройте программу.
Настройка языковой модели и KoboldCpp
KoboldCpp — это программа, которая запускает языковую модель на вашем компьютере. Вот как её настроить:
- Скачайте KoboldCpp (файл
koboldcpp.exe, около 500 МБ) и сохраните вE:\OpenAI\Kobold. - Скачайте образ нейросети (GGUF-файл). Есть два варианта: лёгкая и быстрая модель или более качественная, но медленная. Сохраните файл в ту же папку.
- Запустите KoboldCpp. В открывшемся окне снимите галочку с
Launch Browser, нажмитеGGUF Text Model: Browseи выберите скачанный образ. Увеличьте размер контекста до 8192. - Если хотите включить «зрение» NPC (чтобы они реагировали на то, что вы носите или держите в руках), перейдите на вкладку
Loaded Filesи укажите дополнительный образ для распознавания. - Сохраните настройки в файл
settings.kcpps. Можно создать два конфига — с зрением и без, чтобы переключаться между ними.
После этого KoboldCpp будет готов к работе. При первом запуске модель может загружаться долго (до нескольких минут), это нормально.
Установка модов через Mod Organizer 2
Теперь нужно установить основные моды, необходимые для работы Mantella. Используйте Mod Organizer 2 (MO2).
- Скачайте и установите Mod Organizer 2 в отдельную папку, например
E:\SkyrimAI\MO2. При первом запуске выберите портативный режим и укажите версию игры GOG. - Скачайте следующие моды (сохраните во временную папку):
- 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 (опционально)
- Установите моды в MO2 в указанном порядке. После установки Mantella закройте MO2.
- Настройте Mantella: откройте папку
E:\SkyrimAI\MO2\mods\Mantellaи в файлеGPT_SECRET_KEY.txtпропишите строкуhttp://localhost:5001/api/. Затем в файлеcustom_user_folder.iniукажите путьcustom_user_folder = E:/SkyrimAI/Mantella/и создайте эту папку.
Теперь все компоненты готовы к первому запуску.
Первый запуск и финальная настройка
После установки всех компонентов выполните следующие шаги:
- Запустите xVASynth, KoboldCpp и Mod Organizer 2.
- Запустите Skyrim из MO2. Дождитесь загрузки игры — автоматически откроется окно консоли Mantella. Когда раздастся звук лопнувшей струны и откроется браузер, закройте всё.
- Настройте файлы конфигурации:
- Перейдите в
%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.
- Отредактируйте
config.iniMantella (находится вE:\SkyrimAI\Mantella): укажитеgame = Skyrim,skyrim_mod_folder = E:\SkyrimAI\MO2\mods\Mantella,llm_api = KoboldCpp,model = Custom model.
После этого можно запускать игру снова. Если всё настроено правильно, NPC начнут отвечать на ваши вопросы уникальными фразами.
Как настроить русский язык в Mantella
Mantella изначально разрабатывалась для английского языка, но энтузиасты адаптировали её для русского. Вот что нужно сделать:
- Убедитесь, что ваш STT (распознавание речи) работает с русским языком. Для этого используйте Whisper (встроен в Mantella) вместо Moonshine.
- Настройте языковую модель (LLM). В главном промте (файл
config.iniили в настройках Mantella) пропишите, что общение должно вестись на русском языке. По умолчанию используется переменная{language}, но можно добавить более подробные инструкции. - Настройте TTS (синтез речи). Для русского языка лучше всего подходит xVASynth с русскими голосовыми моделями. Также можно использовать Piper или XTTS. Если TTS плохо говорит по-русски, вы всё равно сможете читать субтитры.
- Измените файл CSV с персонажами. В папке Mantella найдите файл, где указаны акценты NPC, и замените
en,frнаru. Это заставит игру использовать русские голосовые модели. - Для продвинутой настройки можно арендовать 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). Оба мода поддерживают русский язык.