Документация по моддингу Mount & Blade II: Bannerlord
Официальные руководства TaleWorlds по созданию модов для Bannerlord: модули, ассеты, сцены, инструменты редактора, звук, мультиплеер и морской контент. Справочник по коду: документация API.
С чего начать
Впервые занимаетесь моддингом Bannerlord? Пройдите эти шаги по порядку:
- Создание модуля - Краткое руководство: создайте и зарегистрируйте свой первый модуль.
- Добавление и переопределение ассетов: добавляйте новые ассеты или заменяйте существующие.
- Слияние XML-файлов модуля с нативными файлами: изменяйте игровые данные, не копируя файлы целиком.
- Загрузка/обновление мода: опубликуйте мод в Steam Workshop.
- Часто задаваемые вопросы: ответы на частые проблемы.
Я хочу…
Создавать сцены и ландшафт
Создавать сцены миссий
Добавлять предметы и оружие
Добавлять звуки и музыку
Создавать корабли и морской контент
Создавать контент для мультиплеера
Изменять интерфейс, шрифты и баннеры
Все разделы
Управление ассетами
Создание модулей, добавление и переопределение ассетов: сетки, материалы, текстуры, анимации, префабы и многое другое.
Миссии Bannerlord
Что нужно каждой сцене миссии, а также компоненты сценариев и обратные вызовы, на которых построен геймплей.
Редактор
Редактор сцен и редакторы ресурсов: ландшафт, навмеши, материалы, скелеты и ткань.
Audio Modding
Добавление звуков и музыки с помощью FMOD Studio: от настройки событий до звука сцен и оптимизации.
War Sails
Создание кораблей, сцен морских набегов и контента карты мира для дополнения War Sails.
Multiplayer
Запуск сервера, создание собственных режимов игры и сцен для мультиплеера.
Лучшие практики
Рекомендуемые подходы к слиянию XML, XSLT, расширению кода и производительности сцен.
Steam Workshop
Загрузка и обновление мода в Steam Workshop.
Сообщество и ресурсы
- Документация API: справочник по коду Bannerlord.
- Discord сообщества моддинга Mount & Blade: задавайте вопросы и общайтесь с другими моддерами.
- Developer Workshop – Map Editor: официальная трансляция TaleWorlds о работе с редактором карты кампании (на английском языке).
- Форумы TaleWorlds – The Smithy: официальный форум разработки модов.
- Участие на GitHub: предлагайте исправления или новые страницы для этой документации.
Ресурсы от сообщества
Эти ресурсы созданы и поддерживаются сообществом, а не TaleWorlds. Некоторые из них сделаны для старых версий игры, поэтому детали могут отличаться в текущей версии. Большинство материалов доступно только на английском языке.
Документация и руководства
- Bannerlord Documentation: руководства от сообщества, включая Gauntlet UI и упаковку модов для Vortex.
- BannerlordModding.LT: вики сообщества о процессах, техниках и советах по моддингу.
- Unofficial Bannerlord API Docs (BUTR): справочник API для каждой версии игры, созданный на основе файлов игры.
- BUTR Documentation: инструкции по отладке Harmony, отчётам о сбоях и публикации модов через GitHub Actions.
- Форум Documentation & Tutorials: руководства от сообщества на форумах TaleWorlds.
Руководства сообщества (Google Docs)
- 3D Asset Workflow: подготовка 3D-ассетов для Bannerlord.
- Asset Import Workflow: пошаговый процесс импорта ассетов.
- Importing Assets into BL Editor: как добавить свои ассеты в редактор Bannerlord.
- Importing Material Maps in Editor: импорт текстур и карт материалов.
- Basic World Mapping: введение в создание собственной карты кампании.
- Adding Custom Scenes to Custom Battle: проверка собственных сцен в режиме «Своя битва».
- Adding Flora to flora_kinds: регистрация новой растительности в flora_kinds.
- Bannerlord Layer Buttons, Options, and Settings (не завершено): назначение кнопок слоёв, параметров и настроек редактора.
Видеоуроки
- Lesser Scholar – Artisan Workshop Mod: курс по C# из 19 частей: настройка, поведения кампании, диалоги, Gauntlet UI, Harmony и публикация.
- A_Jannik: точки входа C#, отладка и патчи Harmony.
- Danqna & Gispry: серия по C# из 6 частей: настройка Visual Studio, диалоги, сохранения и меню MCM.
- Macbeth of Gondor: серия из 19 частей по редактору сцен: ландшафт, растительность, navmesh, сезоны, префабы и барьеры.
- Banner Lab: моддинг XML без кода: войска, предметы, культуры, королевства, герои и поселения.
- Lykon Development: войска, оружие и королевства в XML, экраны загрузки и рисование весов в Blender.
- Adam Dotlačil: собственные луки, арбалеты и колчаны, а также анимации рук для собственных моделей.
- BabyLettuce – Skeletons & Races: полное руководство по собственным скелетам и расам.
Инструменты
- Bannerlord Scene Toolkit от FiefEvictionNotice: инструменты, работающие внутри редактора сцен: замена и перекраска материалов, создание, распределение и отражение префабов, анализ сцен и резервные копии. См. видеоурок (на английском языке).
- XBannerlord от cookgreen: редактор XML для Windows, который показывает XML-файлы Bannerlord в виде дерева и позволяет изменять выбранный узел в диалоге с ИИ-моделью. Интерфейс на английском и китайском языках. Исходный код на GitHub.
- Bannerlord Crafting Tool от haterade22: инструмент для Windows, который показывает части оружия для ковки в 2D и 3D, позволяя настроить их смещения и проверить длину оружия без запуска игры.
Стартовые наборы
- Campaign Map Prefab Starter Pack от Lemmy1916: готовая карта кампании с поселениями и скриптами для создания новой карты мира.
- War Sails Campaign Map Prefab Starter Pack от Lemmy1916: та же стартовая карта, настроенная для War Sails.