Ru/Source 2/Docs/Level Design/Import Tool Documentation

= Документация по инструменту импорта =
В состав инструментов мастерской мы включили скрипт , помогающий создателям контента быстро переносить карты и ресурсы в . Прежде чем приступить к работе, необходимо выполнить некоторые подготовительные работы.
=== Предпосылки ===
==== Предварительно скомпилированный контент ====
Предварительно скомпилированный контент (например, любой пользовательский , , и т. д.) должен находиться в папке . Например:
* 
* 
==== Файлы исходной карты ====
Файлы вашей карты () могут находиться где угодно за пределами , если они находятся в папке . Любые префабы или экземпляры , на которые ссылается ваша карта, должны находиться в любой структуре подпапок, ожидаемой картой. Например:
* 
* 
* 
==== Исходные файлы текстур ====
Если у вас есть несжатые исходные файлы текстур (, и т. д.), инструмент импорта попытается использовать их при импорте материалов, в противном случае произойдет сбой. к преобразованию и повторному сжатию файлов (что может снизить качество текстур). Чтобы это было успешно, убедитесь, что ваши исходные файлы находятся в зеркальном расположении в . Например:
* 
* 
== Начало работы ==
=== 1. Установка Python 2.7.14 ===
Чтобы запустить скрипт импорта, вам необходимо установить 2.7.14, который вы можете скачать здесь: https://www.python.org/downloads/release/python-2714.
=== 2. Установка переменных среды ===
Затем вам нужно будет установить две переменные пути среды, чтобы Windows знала, где находится ваша установка и другие библиотеки импорта в папка:
Нажмите , чтобы получить доступ к меню задач опытного пользователя.
* В меню задач опытного пользователя выберите параметр «Система».
* В окне «Система» прокрутите вниз и нажмите «О программе».
* В окне «Система» > «О программе» щелкните ссылку «Дополнительные параметры системы» в нижней части раздела «Характеристики устройства».
* В окне «Свойства системы» перейдите на вкладку «Дополнительно», затем нажмите кнопку «Переменные среды» в нижней части этой вкладки.
* В окне «Переменные среды» (см. рисунок ниже) выделите переменную «Путь» в разделе «Системные переменные» и/или нажмите кнопку «Создать».
* Добавьте переменную path, значением которой будет путь к тому месту, где вы установили , и путь к вашему . Папка, разделенная точкой с запятой. например ; 
* Сделайте это как для Пользовательских переменных, так и для Системных переменных:
=== 3. Установка расширения Colorama ===
Далее вам понадобится расширение под названием colorama. Чтобы установить это, просто откройте командную строку (найдите cmd в меню «Пуск» Windows) и введите
=== 4. Создание нового аддона с помощью инструментов Мастерской ===
Перед запуском импорта вам необходимо создать надстройку Workshop Tools, чтобы импортируемый контент имел допустимое место назначения. Чтобы создать новый аддон, просто запустите игру с помощью Workshop Tools и в пользовательском интерфейсе нажмите «Создать новый аддон» и запишите название на будущее.
=== 5. Поиск сценария импорта ===
Сначала нужно найти скрипт импорта , который можно найти в следующей папке:
После того, как вы нашли папку, вы захотите открыть здесь командную строку. Это можно сделать, просто набрав «cmd» в адресной строке проводника Windows и нажав Enter:
=== 6. Запуск скрипта + параметры ===
Теперь вы готовы запустить скрипт, введя следующее:
==== Параметры скрипта ====
: <s1gameinfopath>
: путь к папке, содержащей gameinfo.txt, это ДОЛЖЕН быть путь, содержащий скомпилированный модель и материалы, которые вы хотите импортировать (например, , ).
 
: <s1contentpath>
: путь к папке с исходным содержимым (, , и т. д.). Как упоминалось выше, чтобы импортер мог успешно найти и использовать исходные файлы текстур, убедитесь, что они находятся в месте, зеркально отражающем расположение (см. пример выше).
: <s2gameinfopath>
: путь к папке, содержащей gameinfo.gi .
: <s2addon>
: Название надстройки Мастерской, которую вы создали ранее. Сюда будут импортированы ваши активы.
: <имя карты>
: Это имя карты () без расширения, например. de_examplemap, который вы хотите импортировать. Если ваша карта находится в подкаталоге папки в . Обязательно добавьте этот путь перед названием вашей карты. Например: 
: -usebsp
: Это запускает карту через специальный процесс vbsp для создания чистой геометрии карты из кистей, удаления скрытых граней и сшивания краев, что упрощает работу с версией в . Он сохраняет кисти мира (vis) и кисти для совместимости с . Этот параметр также объединит все на вашей карте. Обратите внимание, что окончательная геометрия будет триангулирована, но ее очистка — довольно простой процесс, который будет объяснен в другом руководстве.
: -usebsp_nomergeinstances
: используйте это вместо , если вы хотите сгенерировать чистую геолокацию, а также сохранить . Обратите внимание, что это занимает немного больше времени, так как процесс импорта должен выполняться дважды. Окончательная геометрия также будет триангулирована.
: -skipdeps
: Необязательно: пропускает импорт всех зависимостей/контента и создает только файл(ы) vmap. Это обеспечивает «быстрый» импорт, например, при повторении сущностей. Не запускайте с этим, если вы импортируете в первый раз.
Пример:
=== 7. Исправление после импорта ===
После того, как ваш уровень был импортирован, просмотрите Шаги по исправлению после импорта
=== Экспериментальный графический интерфейс ===
В мы включили экспериментальный графический интерфейс для импортера карт, который может помочь упростить процесс импорта, который называется 
Этот графический интерфейс имеет преимущество полезных всплывающих подсказок, легко выбираемых параметров импорта, а также запоминает ваши настройки между сеансами. Обратите внимание, что вам все равно потребуется выполнить предварительные условия и шаги 1–4 выше, чтобы это работало правильно. Мы также включили исходные сценарии , чтобы сообщество могло настроить их по своему усмотрению.
= Устранение неполадок =
Вы можете получить следующую ошибку при импорте, если вы используете скайбокс не по умолчанию. Измените свой скайбокс на и повторите попытку.
Следующая ошибка указывает на то, что в вашем есть пробелы. Изменить