Ru/XBLAH's Modding Tool

— это инструмент, написанный XBLAH для повышения продуктивности и качества жизни моддеров Valve.
При запуске инструмента он автоматически установит бета-версию "upcoming" для вашего Source SDK 2013 SP, если вы этого ещё не сделали. Возможно, вам придется подождать несколько секунд, пока он перезапустит Steam и завершит обновление.
Для начала выберите на панели инструментов базовую игру и мод, над которыми хотите работать. Инструмент автоматически обнаружит все совместимые игры на основе , и , которые вы установили через Steam. Дополнительные библиотеки могут быть добавлены вручную.
__TOC__
== Файл ==
=== Новый мод ===
Создание базового мода на движке Source обычно требует больше, чем просто создание gameinfo.txt. Моды, основанные на играх Half-Life и Half-Life 2, могут быть созданы с помощью XBLAH's Modding Tool с использованием интуитивно понятного интерфейса, который создает все необходимые файлы и каталоги. Также поддерживаются моды, основанные на .
* При создании модов для Half-Life 2 инструмент заменит файл шрифта по умолчанию, так что все символы будут доступны. Стандартный файл шрифтов содержит только символы, из которых состоит Half-Life.
* При создании модов, основанных на Mapbase, инструмент по умолчанию будет включать PBR шейдеры, созданные Thexa.
Доступ к созданию базового мода можно получить в инструменте через Modding > New. 
Смотрите больше на странице .
Чтобы создать новый мод, выберите базовую игру. Затем выберите версию (необязательно). Наконец, вставьте имя папки мода. Имейте в виду, что это не имя или название мода, а уникальное имя папки со строчными буквами и дефисами. Как только все настроено, нажмите Create, и у вас будет полностью рабочий мод, готовый к расширению.
=== Открытие папки игры ===
XBLAH's Modding Tool предоставляет ярлык для выбранной базовой папки игры, доказывая свою полезность в случае, если вам нужно изменить какие-либо файлы вручную.
Доступ к ярлыку можно получить в инструменте через File > Open Game Folder.
=== Библиотеки Steam ===
Библиотеки, используемые играми и модами в инструменте, устанавливаются автоматически, если у вас есть законная установка Steam. Имейте в виду, что установленные здесь библиотеки используются только инструментом, а игры и моды по-прежнему будут использовать свою информацию об игре [gameinfo.txt] для монтирования своего содержимого.
Доступ к редактированию/просмотру подключенных библиотек можно получить в инструменте через File > Steam Libraries.
==== Добавление библиотеки ====
Вы можете добавить библиотеку вручную, нажав кнопку и выбрав каталог, содержащий папку SteamApps. Это особенно полезно, когда у вас нет правильной установки Steam, но вы все равно хотите создавать моды. Чтобы инструмент заработал, вставьте свои игры в папку SteamApps, а затем выберите родительский каталог, если эта папка SteamApps является библиотекой.
==== Удаление библиотеки ====
Вы можете удалить созданную вручную библиотеку, выбрав библиотеку и нажав на значок 
==== Найти библиотеку на диске ====
Вы можете открыть каталог библиотеки, нажав кнопку 
== Моддинг ==
=== Запуск ===
Вы можете запускать моды прямо из XBLAH's Modding Tool, без перезапуска Steam при создании или установке нового мода. XBLAH's Modding Tool поддерживает множество различных режимов запуска. Он содержит основные предустановки для каждой игры, что не помешает вам добавлять новые предустановки. 
Доступ к запуску можно получить в инструменте через Modding > Run, либо в разделе Run в панели инструментов.
Чтобы запустить мод, выберите предустановку и нажмите OK. При желании вы можете установить дополнительную команду. Команды, начинающиеся с -, являются параметрами быстрого доступа, а команды, начинающиеся с +, являются консольными командами. Эта дополнительная команда будет добавлена к команде предустановки, а не заменит ее. 
==== Добавление предустановки ====
Вы можете создать новую предустановку, нажав кнопку .
* Режим запуска может быть полноэкранным, оконным или VR (для совместимых игр). 
* Покрытие сообщит инструменту, какие игры и моды будут поддерживаться. Это может быть Глобальный, Только текущий движок, Только текущая игра или Только текущий мод.
* Вы можете выбрать исполняемый путь. Если ничего не выбрано, инструмент автоматически выберет исполняемый файл игры. Обычно это работает для совместимых игр.
* При желании вы можете установить дополнительные команды, чтобы они один раз вызывались после запуска игры.
==== Редактирование предустановки ====
Вы также можете проверить предустановленные конфигурации, нажав кнопку 
==== Удаление предустановки ====
Вы можете удалить предустановку, нажав кнопку 
Если вы перепутали предустановки и хотите восстановить заводские настройки, вы можете нажать кнопку Reset. 
=== Открытие папки Мода ===
XBLAH's Modding Tool предоставляет ярлык для выбранной папки мода, доказывая свою полезность в случае, если вам нужно изменить какие-либо файлы вручную. 
Доступ к ярлыку можно получить в инструменте через Modding > Open Mod Folder.
=== Проводник ===
Все файлы, подключенные к информации об игре (gameinfo.txt), можно предварительно просмотреть с помощью XBLAH's Modding Tool в проводнике. Проводник [англ. File Explorer] заменяет в качестве основного инструмента для просмотра файлов. Проводник будет монтировать все .vpk и свободные файлы в соответствии с информацией об игре, чтобы показать моддеру полный список файлов. Это избавляет моддера от необходимости просматривать .vpk по отдельности, а встроенные функции инструмента обычно исключают необходимость извлечения файлов из .vpk, поскольку к ним можно получить доступ изначально.
Доступ к нему можно получить в инструменте через Modding > File Explorer.
Смотрите больше на странице .
Проводник содержит контекстные меню для каждого файла, нацеленные на их соответствующий собственный редактор.
=== Очистка мода ===
Перед отправкой мода XBLAH's Modding Tool предоставляет моддеру список ненужных файлов, которые можно удалить нажатием одной кнопки. 
Очистка производится в инструменте через Modding > Clean.
Смотрите больше на странице .
=== Информация о игре / Game Info ===
Информацию о моде можно редактировать с помощью XBLAH's Modding Tool через пользовательский интерфейс, не требуя от моддера возиться с текстовыми файлами. Он включает в себя все основные ключи Source SDK 2013 Single-player и Source SDK 2013 Multi-player, что более чем достаточно для большинства моддеров Source. 
Редактирование текстовых файлов производится в инструменте через Modding > Game info.
Смотрите больше на странице .
File:XBLAH's Modding Tool - Modding - Game info 1.png|Имя
File:XBLAH's Modding Tool - Modding - Game info 2.png|Параметры
File:XBLAH's Modding Tool - Modding - Game info 3.png|Список игр Steam
File:XBLAH's Modding Tool - Modding - Game info 4.png|Движок и инструменты
=== Главы ===
Главы для однопользовательских игр могут быть созданы с помощью XBLAH's Modding Tool через пользовательский интерфейс. Моддер может легко создавать новые главы, выбирать изображения глав, фоновые изображения глав, первую карту главы, фоновую карту, а инструмент сделает всю грязную работу по созданию необходимых .vtf, .vmt и скриптов. Он дает возможность автоматически размывать фоновые изображения, поэтому моддер можетсделать снимок экрана с фоновой картой, а инструмент применит обычное размытие. Это устраняет необходимость сохранения файлов .vtf, создания изображений глав со странными пропорциями и т.д. 
Доступ к главам можно получить в инструменте через Modding > Chapters.
Смотрите больше на страницах и .
=== Меню ===
Элементы [англ. items] главного меню могут быть добавлены, изменены или убраны с помощью XBLAH's Modding Tool на основе предоставленного списка опций.
Доступ к элементам главного меню можно получить в инструменте через Modding > Menu.
Смотрите больше на странице .
File:XBLAH's Modding Tool - Modding - Menu 1.png|Меню элементов
File:XBLAH's Modding Tool - Modding - Menu 2.png|Добавление элементов
=== Монтирование контента ===
Контент, смонтированный в моде, можно редактировать с помощью XBLAH's Modding Tool, указывая на директории и .vpk в желаемом порядке, без риска испортить информацию об игре. 
Доступ к монтированию контента можно получить в инструменте через Modding > Content Mount.
=== Ресурсы ===
==== Копирование в папку Custom ====
Вы можете выбрать несколько VMF в XBLAH's Modding Tool и он перечислит вам все необходимые ресурсы, показывая вам, к какому пакету или свободной папке они принадлежат, и дает вам возможность скопировать то, что вы хотите, в отдельную в /custom/. По умолчанию он выберет все файлы, не расположенные внутри VPK, но вы также можете извлекать файлы из VPK на ходу.
В настоящее время инструмент обнаруживает следующие файлы:
* Скомпилированные арты
* Материалы (в том числе необходимые файлы)
* Модели (в том числе необходимые файлы)
* Спрайты
* Звуки (used by ambient_generic)
* Частицы
* Небо
Доступ к экспорту можно получить в инструменте через Modding > Assets > Export.
==== Упаковка файлов ====
Инструмент позволяет выбрать нужные файлы и упаковать их в VPK. Выбранные файлы будут автоматически удалены после того, как они будут упакованы в VPK, тем самым очистив папку с модами. VPK будет сохранен в /custom/.
Доступ к упаковке можно получить в инструменте через Modding > Assets > Pack.
==== Распаковка файлов ====
Вы можете быстро преобразовать смонтированные VPK в распакованные файлы, чтобы улучшить процесс моддинга. Все файлы в VPK будут извлечены в папку мода, и у вас будет возможность удалить VPK.
Доступ к распаковке можно получить в инструменте через Modding > Assets > Unpack.
==== Упаковка папки Custom ====
Вместо того, чтобы вручную упаковывать файлы в VPK, вы можете выбрать папку в каталоге Custom, и инструмент преобразует все распакованные файлы в один VPK. У вас будет возможность удалить распакованные файлы.
Доступ к упаковке папки Custom можно получить в инструменте через Modding > Assets > Pack Custom Folder.
==== Удаление дубликатов ====
Инструмент выведет список всех файлов с одинаковым именем, относительным каталогом и содержимым и будет смонтирован как минимум дважды, а также даст вам возможность удалить лишние распакованные файлы одним нажатием кнопки.
Доступ к упаковке папки Custom можно получить в инструменте через Modding > Assets > Remove Duplicates.
== Анимация ==
=== Choreography Editor ===
Редактор хореографии из Source Engine будет автоматически настроен при запуске через XBLAH's Modding Tool, также будут исправлены недостающие иконки.
Доступ к редактору хореографии можно получить в инструменте через Animations > Choreography Editor.
== Карты ==
=== Редактор ===
Редакторы уровней будут автоматически скопированы и настроены при запуске через XBLAH's Modding Tool.
Для Goldsrc инструмент будет запускать Jack'a с правильными конфигурациями, готовыми для редактирования и компиляции. Для Source инструмент будет запускать Hammer++ (для совместимых веток) или стандартный Hammer 4 с инструментами компиляции Slartibarty (для совместимых веток). Он также будет запускать Hammer++, готовый к использованию с Mapbase, без каких-либо специальных настроек или ярлыков.
Доступ к редактору карт можно получить в инструменте через Maps > Editor.
=== Декомпиляция ===
Скомпилированные карты для Goldsrc и Source можно декомпилировать с помощью XBLAH's Modding Tool. Инструмент покажет все смонтированные свободные или упакованные в .vpk карты. Вы сможете декомпилировать карты не извлекая их заранее. Декомпилированные карты будут сохранены в папку /mapsrc/ как отдельный файл.
Доступ к декомпиляции карт можно получить в инструменте через Maps > Decompile.
=== Папка Префабов ===
Есть удобный ярлык для папки с игровых префабов.
Доступ к папке с префабами может быть получен в инструменте через Maps > Prefabs Folder.
== Материалы ==
=== Редактор неба ===
LDR Небо может быть создано прямо из изображений с помощью XBLAH's Modding Tool, используя интуитивно понятный интерфейс, который создает все необходимые .vtf и .vmt. Всё, что вам нужно сделать, это выбрать каждую грань кубической карты, предварительно просмотреть её и сохранить. Редактор неба имеет встроенный 3D-предварительный просмотр для проверки неба на бесшовность, поддержку обычных квадратных скайбоксов, а также на фиксированность [англ. Clamped]. 
Доступ к редактору неба можно получить в инструменте через Materials > Skybox Editor.
Смотрите больше на странице .
== Частицы ==
=== Генерация манифеста частиц ===
Для рендеринга частиц в игре необходим манифест. Манифест частиц может быть сгенерирован автоматически с помощью XBLAH's Modding Tool на основе всех частиц, установленных в моде.
Доступ к генерации манифеста частиц можно получить в инструменте через Particles > Generate Manifest.
== Звуки ==
=== Генерация манифеста звукового ландшафта ===
Файл манифеста необходим для воспроизведения звукового ландшафта [англ. Soundscape] в игре. Этот файл может быть сгенерирован автоматически с помощью XBLAH's Modding Tool на основе всех файлов звукового ландшафта, установленных в моде.
Доступ к генерации Soundscape манифестов может быть получен в инструменте через Sounds > Generate Soundscape Manifest.
== Внешние ссылки ==
* Страница XBLAH's Modding Tool в Modding Assets
* Небольшой обзор программы.