Mount & Blade Bannerlord Modding Tools (перевод описания)

        Mount & Blade Bannerlord Modding Tools
                    (перевод описания)

В этой теме я предлагаю всем заинтересованным выкладывать свои переводы описания инструмента для моделирования “Mount & Blade Bannerlord Modding Tools” (по главам), выложенного разработчиками на : http://docs.modding.bannerlord.com/


               Model Viewer  (Просмотр Моделей) - добавление моделей в сцены.

Доступ к средству просмотра моделей можно получить из верхней строки Editor > Window > Show Model Viewer



На левой панели вы можете изменить атмосферу (Atmosphere), скрыть/показать землю ( hide/show ground) или добавить столько объектов, сколько захотите. Объекты могут быть либо людьми (Human), простыми мешами (Mesh) или чехлами\футлярами ??? (holster). Нажатие кнопки Добавить объект (Add Entity) откроет окно с моделями для выбора типа этого объекта.

         Transform (Преобразовывание) :

На этой панели можно задать местоположение, поворот и масштаб (Position, Rotation, and Scale) объектов.

         Animation (Анимация) :

На этой панели вы можете выбрать тип скелета и анимацию.
Вы также можете фильтровать анимации по их названию.
Система фильтрации (Filtering system) довольно сильна через весь движок, так что вы можете точно настроить свою фильтрацию.       

Примеры :

idle = будет фильтровать анимации, который содержит “idle”

.idle = будет фильтровать анимации, которая начинается с “idle”

idle. = будет фильтровать анимацию, которая заканчивается на “idle”

-idle =  будет фильтровать анимацию, которая не содержит “idle”

Вы также можете использовать комбинации этих фильтров, поставив пробел между ними :

“idle -barmaid 2.” = будет фильтровать анимацию, которая содержит “idle”, и не содержит “barmaid”, а заканчивается на “2”. (например, “guard_idle_2”, который соответствует этому условию)
“idle hangout 7” = будет фильтровать анимацию, содержащую “idle”, “hangout” и “7”. (например “” anim_hangout_idle_7", который соответствует этому условию)

          Blend (Смешивание) :

 Вы также можете совмещать несколько анимаций с помощью панели смешивания (blend panel).

          Visual (Визуализация) :

С этой панели вы можете поместить любой mesh в любую часть человека, и вы можете выбрать пол (gender) этого человека.
hide body - спрятать тело.
hide hands - спрятать руки.
hide feet - спрятать ноги.

body parts (часть тела) - выбор меша для указанной части тела.

Источник оригинала темы данных переводов :
https://gamesource.org/topic/7134-mount-blade-bannerlord-modding-tools-перевод-описания/
При публикации сторонними ресурсами ссылка обязательна.

                         Cloth Simulation (Моделирование ткани)

                           Preparing Mesh (Подготовка мешей) :

Система моделирования ткани использует альфа-каналы вершин мешей (alpha channels of vertices of meshes). Значения в альфа-канале представляют, насколько вершина может отойти от своего исходного положения.
0,1 альфа-канала означает, что вершина может быть перемещена на 0,1 единицы от своего исходного положения с помощью моделирования ткани. Если вы установите ноль в альфа-значение, это означает, что вершина будет зафиксирована на своем месте и не будет обновляться при моделировании.


(Shaded)


(Vertex Alpha)

Черные части управляются системой скининга (skinning system), в то время как белые части моделируются.
Стоит отметить, что вычисления скиннинга выполняются для всех вершин, независимо от того, фиксированы они или нет.
Позиции skinned vertices (очищенных вершин) используются в качестве опорных точек для моделируемых вершин (simulated vertices).
Вы можете представить, что смоделированная вершина (simulated vertex) может перемещаться только внутри сферы с радиусом R и центром C. Здесь в качестве радиуса используется альфа-канал цвета вершины (vertex color), а в качестве центра - skinned position.


(Shaded)


(Vertex Alpha)

                          Simulation Types (Типы моделирования) :

Direct simulation (Прямое моделирование) :

При прямом моделировании вершины визуализируемой сетки (vertices of rendered mesh) моделируются непосредственно с помощью моделирования ткани.
Этот метод может быть использован для мешей с простой топологией (например, решетка, сетка и т.п.) и небольшим количеством вершин.
По мере увеличения числа вершин затраты на производительность моделирования будет больше.

Mapped simulation (Отображенное моделирование) :

В некоторых случаях ваш меш может не подходить для моделирования ткани. Некоторые примеры - это доспехи с двусторонними полигонами (double sided polygons), одежда с более чем одним слоем или меши с большим количеством полигонов. В таких случаях для моделирования может быть использована отдельный меш (separate mesh). Если используется отдельный моделируемый меш (separate simulation mesh), то вершины этого меша моделируются имитацией ткани. Вершины исходного меша (original mesh) будут сопоставлены с моделируемым мешем (simulated mesh) и перемещаться вместе с ней.





На приведенных выше изображениях меши с правой стороны используются для моделирования, а левые визуализируются в соответствии с моделируемыми результатами. Для достижения реалистичных результатов ваш моделируемный меш (simulation mesh) должен плотно сопоставляться с мешем рендеринга и никогда не должен его перекрывать. Другими словами, меш рендеринга никогда не должен проникать в меш моделирования. Если это так, то, поскольку расчеты коллизий выполняются для моделирования меша, вы можете увидеть артефакты коллизии (simulation mesh), такие как проникновение ног в броню.

                                  Cloth Editor (Редактор Ткани) :

Чтобы включить имитацию ткани для мешей (cloth simulation for a mesh), необходимо настроить некоторые игровые настройки. Редактор ткани (Cloth Editor) используется для настройки мешей для моделирования. Редактор ткани можно открыть из меню панели инструментов в Редакторе ( toolbar menu in editor).



        Preview properties (Свойства предварительного просмотра) :

Preview mesh (Предварительный просмотр мешей) :

Чтобы начать работу с мешами, вы должны зайти в Preview mesh menu (меню предварительного просмотра мешей) и выбрать sub meshes, которые будут моделироваться на Render mesh cloth properties panel (панели свойств ткани Render mesh). Если альфа-каналы меша окрашены правильно, то он должна начать моделироваться в окне предварительного просмотра.

Simulation mesh (Моделируемый меш) :

Если вы хотите использовать отдельный Simulation mesh, выберите его в Simulation mesh menu (меню моделирования мешей). Альфа-канал этого меша также должен быть окрашен, потому что это фактически моделируемый меш. В этом случае альфа-канал Preview mesh (предварительного просмотра  мешей) используется для определения того, будет ли вершина отображена в меше моделирования или она будет визуализирована с исходными данными скининга (rendered with original skinning data).
Альфа-значения больше нуля означают, что вершина должна быть сопоставлена с моделируемым мешем.
Вершины с нулевыми альфа-значениями будут использовать исходные данные скининга.
Поскольку моделируемый меш (Simulation mesh) имеет меньшее количество полигонов, чем оригинальный меш, это может быть использовано для повышения качества скиннинга (skinning) оригинального меша для non-simulated parts (немоделированных деталей).

Helper mesh (Вспомогательный меш) :

Вы можете выбрать вспомогательный меш для предварительного просмотра фактического моделируемого меша с произвольным мешем. Хорошим примером является выбор меша лошади для моделирования меша гривы коня.

Preview skeleton (Предварительный просмотр скелета) :

Если вы хотите работать с skinned mesh и просматривать оболочки коллизий и анимации, вы должны выбрать соответствующий скелет.

Preview body (Предварительный просмотр тела) :

Вы можете назначить уже имеющееся collision body в меню Preview body. Модифицированная collision bodies может быть выполнена из Cloth Bodies panel.

Preview animation name (Предварительный просмотр анимации) :

Вы можете потестить свою ткань с помощью анимации.
Вы должны будете написать его имя в папке asset, а не в animations*.xml, а также его начальные и конечные номера кадров и продолжительность.
Вы можете запускать и останавливать анимацию с помощью кнопки Toggle Animation (переключения анимации).

Scene update coef (Коэффициент обновления сцены) :

Замедленное движение можно смоделировать, уменьшив это значение. Значение по умолчанию равно 1, что означает, что все моделирования выполняются с нормальной скоростью.

Render mesh cloth properties (Рендеринг свойств мешей ткани) :

Вы можете выбрать, какие submeshes будут моделироваться, установив флажок рядом с каждой submesh. Различные материалы ткани могут быть назначены каждой submesh  в графе Cloth material.
Коэффициент максимального расстояния (Max distance multiplier) используется для масштабирования вершин мешей (scale vertex color paintings), которая контролирует, сколько вершин может отойти от своей первоначальной позиции.
Значение 0.5 вершины альфа (vertex alpha) с максимальное значение коэффициента расстояния 3.0 означает, что вершина сдвинется на 1,5 единицы от своей первоначальной позиции.
Если вы используете раздельный моделируемый меш, то максимальное значение расстояния и материал ткани моделируемого меша отменяют эти настройки. Все сабмеши (submeshes) будут использовать один и тот же материал, назначенный для моделируемого меша.

Simulation mesh cloth properties (Свойства ткани моделируемого меша) :

Если вы используете отдельный моделируеый меш, вы можете настроить его параметры здесь так же, как и свойства мешей рендеринга (render mesh properties), упомянутые выше. Выбранный здесь материал ткани и максимальное значение расстояния будут использоваться для всех submeshes рендеринга.

ВАЖНО ! вы должны сохранить свои настройки, нажав кнопку Save mesh settings (Сохранить настройки мешей).

                                 Collision Bodies (Коллизии) :

Коллизии можно создавать и изменять в окне Collision bodies. Его можно открыть через Edit > Edit collision bodies.



Оболочка\капсула (capsule) состоит из двух конечных точек. С ними можно работать отдельно, назначив кости и вес. Одна точка оболочки\капсулы затрагивает не более чем две кости. Как и при скиннинге мешей, вес (weights) используются для определения влияния этой кости на выбранную капсулу.

                              Cloth materials (Материал ткани) :

Все параметры моделирования для настройки поведения ткани поставляются вместе с материалами тканей. Пресеты\настройки материалов ткани можно создавать и изменять в окне Material templates (Шаблоны материалов).



Это окно можно открыть в меню Edit (Правка) > Edit merial templates (Правка шаблонов материала). Материалы, показанные в этом окне, являются пресетами, поэтому изменение этих пресетов не влияет на конфигурацию существующих мешей ткани. Чтобы изменить параметры существующего меша ткани, вы можете нажать кнопку Change parameters (Изменить параметры) на панелях Simulation/Render mesh cloth properties (Моделирование/рендеринг свойств мешей) и настроить все параметры в окне Mesh specific parameters (конкретных параметров меша).





Эти конкретные параметры меша следующие :
Bending (Изгиб)
Stretching (Растяжение)
Shearing (Смещение)
Stiffness (Жесткость)

Они определяет, насколько ограничение материала будет противостоять соответствующему на него внешнему воздействию в игре.

Anchor Stiffness (Жесткость) :

Этот параметр строго ограничивает свободу вершины (vertex). Он пытается поддерживать постоянные расстояния между моделируемыми и фиксированными вершинами. Вы можете попытаться увеличить это значение, если ваша сетка растягивается слишком сильно.

Damping (Затухание) :

Значения амортизации для вершин. Определяет долю скорости текущего кадра (frame) для перехода к следующему кадру.

Linear Inertia (Линейная инерция) :

Поскольку ваша моделируемая ткань выполняется в локальном пространстве, глобальные изменения кадра переносятся на ткань виртуально. Это значение определяет, какая часть ускорения объекта будет перенесена на ткань. Вы можете проверить это, добавив меш ткани в сцену и случайным образом потрясти ее сущность.

Air drag (Сопротивление воздуха) :

Для меша ткани, движущегося с постоянной скоростью, это значение определяет, насколько сильно сила сопротивления воздуха будет воздействовать на ее вершины.

Wind (Ветер) :

Вы можете контролировать, сколько силы ветра будет использовать ткань. Это значение является множителем для фактической силы ветра сцены. Если в сцене нет ветра, то увеличение этого значения не будет иметь никакого эффекта.

Gravity (Гравитация) :

Постоянная сила тяжести, действующая на каждую моделируемую вершину. Вы можете уменьшить это значение, чтобы добиться шелковистого поведения ткани.

Iteration Frequency (Частота повторения) :

Определяет сколько раз меш ткани будет смоделирован за секунду. Вы можете оставить этот параметр со значением по умолчанию, если только ваш меш не имеет больших треугольников или он не движется так быстро, что капсулы коллизий (collision capsules) не смогут поймать смоделированные вершины. Увеличение этого значения приводит к более стабильному поведению при коллизиях, но производительность удара также линейно возрастает.

Precise Simulation (Точность моделированя) :

Мы меняем качество на производительность в игре, делая некоторые сжатия во время моделирования. В результате моделируемый меш может немного перейти в другое состояние, чем был в состоянии покоя. Если эта точность важна для вашего меша, вы можете включить эту опцию, чтобы получить более правильные качественные результаты.

Dummy Collision Particles (Фиктивные частицы коллизий) :

Если моделируемый меш имеет большие размеры треугольников по отношению к капсулам коллизий (collision capsules), капсулы могут не сталкиваться с мешем ткани должным образом. Чтобы преодолеть это, мы помещаем фиктивные вершины (dummy vertices) в каждый треугольник меша. Эти вершины не моделируются, а используются только на стадии коллизии. Эта опция наносит большой удар по производительности вашей системы компьютера, поэтому вам следует стараться избегать ее включения.

                    Cloth Content Files (Файлы контента тканей) :

Наша система моделирования генерирует два файла с расширениями *.tcc и *.tcm. Файлы .tcc содержат предварительно обработанные данные, используемые при моделировании ткани, такие как индексы ограничений (constraint indices), длины ограничений (constraint lengths) и т. д. Файлы .tcm содержат данные преобразования мешей рендеринга в моделируемые меши. Вы должны сохранить оба этих файла в Plastic SCM, чтобы гарантировать, что никто не ждет завершения процесса их приготовления на этапе загрузки сцены. 

                         Material Editor (Редактор материалов)

                         Overview (Обзор) :





Наш фирменный игровой движок использует стандартный металлический конвейер  PBR (metallic PBR pipeline) [концепция рендеринга, основанная на физических принципах] для создания материалов.

  [  От переводчика (меня ) : Я советую всем ознакомиться с интересной статьей по PBR на :
  https://habr.com/ru/company/funcorp/blog/465457/  ]

Новые материалы можно легко создать, перейдя в папку, щелкнув правой кнопкой мыши на пустом месте и выбрать из контекстного меню Create (создать) > Material (материал).

Редактор материалов можно открыть, дважды щелкнув на уже существующий материал в браузере ресурсов (resource browser).





                       Inspector (Контроль) :

Shader (Шейдеры) :





Вы можете выбрать нужный шейдер из этого виджета выбора шейдеров.
Существует несколько в основном используемых шейдеров; наиболее важными из них являются pbr_metallic и pbr_shading.

pbr_shading :

Этот шейдер широко используется и существует в игре только потому, что наш движок не использовал конвейер затенения PBR (PBR shading pipeline) в первые годы разработки, большая часть контента не была создана для конвейера PBR, поэтому этот шейдер создан для поддержки нашего уже существующего контента и используется только на переходном этапе .
Новый контент не должен использовать этот шейдер, вместо него вы должны использовать pbr_metallic.

pbr_metallic :

Это то, что вы должны использовать большую часть времени. Этот шейдер использует стандартный металлический конвейер PBR, а входные данные совместимы с большинством программ для создания текстур.

Inputs (исходные ресурсы) :

Albedo (альбедо) и Normal (нормаль) : Они довольно стандартные, можно напрямую использовать выходные данные программ для создания текстур.
[ Альбедо - это текстура, которая содержит независимую информацию о цвете.
Нормаль - это технология, используемая для имитации неровностей поверхности на объекте. ]

Specular (спекуляр) : Эта текстура использует свои 4 канала для различных целей.
Красный канал (Red channel) содержит информацию металлической поверхности.
Зеленый канал (Green channel) содержит информацию о глянцевости (обратную шероховатости).
Синий канал (Blue channel) содержит Ambient Occlusion [ Это черное-белая текстура, в ней хранятся тени от рассеянного света. Они могут подчеркнуть рельеф изображенный на основной текстуре. Данную текстуру использовать не обязательно, но материал без нее может смотреться более плоским. ].
Альфа-канал содержит информацию о полупрозрачности (только для растительных шейдеров).

grass (трава) :

Этот шейдер является производным от pbr_metallic и должен использоваться только на мешах травы. Содержит специальные эффекты, такие как анимация ветра, анимация раскачивания, плавные LOD-преобразования, умножение цвета на местности и т.д.

flora_leaf (листья) :

Этот шейдер является производным от pbr_metallic и должен использоваться только на листовых частях деревьев / кустарников. Содержит специальные эффекты, такие как анимация ветра, анимация качания, умножение цвета на местности, плавные LOD-преобразования, полупрозрачность (Альфа-канал зеркальной текстуры) и т.д.

flora_bark (кора) :

Этот шейдер является производным от pbr_metallic и должен использоваться только на частях коры деревьев / кустарников. Содержит специальные эффекты, такие как анимация ветра, плавные LOD-преобразования и т. д.


                        Textures (Текстуры) :






Эта панель используется для установки входных текстур шейдеров.
Названия текстур объясняются сами собой, но есть несколько особых случаев.

Diffuse2Map :

Эти исходные данные используется внутренним движком игры для создания специальных эффектов / блендингов (special effects / blendings), таких как Shield Banner Paintings (щит с геральдическим баннером).
Текстура баннера в этом слоте будет отображаться только там, где Diffuse 1 Texture содержит альфа-канал. Использование этой текстуры зависит от используемого шейдера.

DetailNormalMap :

Эти исходные данные используется для создания микродефектов [трещины, шрамы, выбоины и т.п. ] и дополнительных высокочастотных деталей поверх обычного нормального отображения. Масштаб этой текстуры можно настроить на панели настроек текстуры (Texture Settings panel).

HeightMap (карта высот) :

Эти исходные данные используется как при Parallax Occlusion Shading [используется для процедурного создания трёхмерного описания текстурированной поверхности с использованием карт смещения вместо непосредственного генерирования новой геометрии], так и при Displacement (смещении).

Decal(___)Map :

Эти исходные данные используются внутренним движком игры для создания визуальных эффектов на коже или на других объектах (например, кровь и грязь).



          Texture Settings (Настройки текстур) :





Эти настройки может быть использованы для большего разнообразия текстурирования. Некоторые настройки используются только для некоторых специальных шейдеров для передачи пользовательских параметров.

Areamap Scale (Масштаб карты местности) :

Используется внутренне для передачи параметров.

Specular Coef :

Металлический канал (Красный канал спекуляра) умножается на это значение в шейдере.

Gloss Coef (Коэффициент блеска) :

Глянцевый канал (Зеленый канал спекуляра) умножается на это значение в шейдере.

Ambient Occlusion Coef :

AO channel (синий канал спекуляра) умножается на это значение в шейдере.

Normal Depth (Глубина нормали) :

Нормали текстур X и Y каналов умножаются на это значение. Если вы установите значение, близкое к нулю, поверхность будет казаться более плоской, так как значения X и Y будут близки к нулю, и только направление Z будет внесено в отображение нормали.

Detail Normal Scale (Подробный масштаб нормали) :

Этот параметр задает, во сколько раз должны быть детализированы текстуры. Более высокие значения увеличивают частоту.

Parallax Mode :

Вы можете выбрать метод смещения, который будет использоваться для этого материала. Варианты - Parallax (параллакс) или Displacement (смещение). И то, и другое требует текстуры heightmap. Parallax использует метод Parallax Occlusion Mapping в шейдере, Displacement использует hardware tesselation (аппаратную тесселяцию).

Parallax Amount (Величина параллакса) :

Интенсивность эффекта вытеснения (displacement effect).

Parallax Offset (Смещение параллакса) :

Устанавливает среднее значение на желаемую высоту. (Значение 0,5 в heightmap (карте высот)).



                       Material Shader Flags :





Вы можете включать и выключать некоторые условные обозначения времени компиляции в шейдерах, чтобы включить/отключить некоторые эффекты. Это флаги во время компиляции, и шейдер материала будет скомпилирован с этими флагами.

Некоторыми важными значениями являются :

use_detailnormalmap :

Этот флаг должен быть включен для использования функции Detail Normal Map.

alpha_test :

В качестве вырезанной текстуры используются альфа-значения Diffuse 1 textures. Альфа-порог можно задать на панели Transparency (прозрачности).

use_specular :

Этот флаг должен быть включен во всех случаях.

use_procedural_wind_animation :

Можно включить для создания очень простого и малозатратного синусоидального колебания эффекта ветра. В основном используется для палаток / флагов. (Не следует путать с функцией физики ткани (cloth physics)).

self_illumination :

Включает подсветку. Текстура освещения должна быть указана в разделе Diffuse 2. Параметры яркости можно отрегулировать в панели Vector Arguments.

use_specular_from_diffuse :

Никогда этим не пользуйтесь. Он используется только в фазе перехода на конвейер PBR (pbr pipeline) и только в этой игре по устаревшим причинам. Просто оттеняет серым diffuse (диффузную) текстуру и использует ее как спекуляр.

use_double_colormap_with_mask_texture :

Используется внутренне для создания группового цветового эффекта в одежде. Специальная текстура создается, чтобы указать, какие части одежды должны быть затронуты цветами в группе. Простая красно-зеленая текстура для первичных и вторичных цветов задается в Diffuse 2 texture. Первичные (Primary) и вторичные (Secondary) цвета задаются игровым кодом в качестве Factor Colors (цветового коэффициента).


                    Transparency (Прозрачность) :






Здесь можно указать режим альфа-смешивания и пороговые значения Alpha Test (альфа-теста).
Здесь также можно включить функцию Multi Pass Alpha. Этот метод создания двойного меша с помощью альфа-теста (alpha test) и альфа-смешивания (alpha blend), чтобы создать громоздкие, но гладкие на вид меши alpha testes. (Альфа-тест в средних областях меша для плотного покрытия, но гладкие альфа смешанные градиенты по краям, такие как волосы).


                         Others (Другие) :






Эта панель обычно предназначена для технического / внутреннего использования разработчика и в основном используется для создания материалов для основных функций движка игры.


       Vector Arguments (Векторные параметры) :






Эта панель содержит два векторных аргумента. Оба содержат по 4 фактических значения, в общей сложности 8.
Эти векторные аргументы  используются в качестве параметров для некоторых специальных шейдерных эффектов, таких как настройка яркости Self Illumination (собственного освещения), скорости и направления Texture Sweep (развертки текстуры) и т. д.
То, какие изменения с каким векторным аргументом действительно происходят, зависит от эффектов, для которых он используется.


                 Factor Colors (Фактор цвета) :






Эти цвета умножаются на внутренний Factor Color на мешах, которые обычно изменяются с помощью игрового кода. Если вы действительно хотите, чтобы какая-то текстура была немного темнее, зеленее и т. д. вы можете умножить их с помощью этой панели.


                Vertex Layout (Макет вершин) :






Эта панель используется для указания Vertex Layout (макета вершин), который должен использовать Vertex Shaders.

Bump Map (карта рельефа) :

Должен быть включен в большинстве случаев (стандартный PBR требует этого).

Skinning and Skinning Precise :

Если ваш материал будет использоваться со skinned mesh, включите Skinning, если ваш skinned mesh довольно велик и имеет важные маленькие полигоны (например, глаза), включите Skinning Precise (Точный скиннинг). (Это отключает некоторые оптимизации, поэтому используйте их только в том случае, если это действительно необходимо).

Double UV :

Включите, если ваши пользовательские шейдеры требуют двойных UV каналов.

PostFX :

Используется внутри движка игры.

                        Texture Editor (Редактор текстур)

В Редактор текстур можно войти через Editor > Window > Show Resource Browser > ..Search for Texture.. > двойной клик по нужной текстуре.



В Texture Inspector (Инспекторе текстур) (правая панель) вы можете включить/отключить смешивание MipMap, установив флажок на Use Mipmap Blending. Когда вы включите смешивание MipMap, вы увидите все уровни mip выбранной текстуры рядом друг с другом в окне предварительного просмотра.



При нажатии кнопки MipMap Blend Amounts откроется новое окно, в котором вы можете настроить количество смешивания для каждого уровня mip.



Затем вы можете выбрать кнопку MipMap Blend Color (1) и нажать кнопку Recompile (2), чтобы применить смешивание. Результат будет сразу же виден в окне предварительного просмотра, а также в игре.

                Skeleton Editor (Редактор модельного скелета)

Редактор скелета можно использовать для редактирования параметров костей, суставов и ragdoll-моделей после их импорта с помощью браузера ресурсов (resource browser).




      Editing Bones and Joints (Редактирование костей и суставов) :

Чтобы отредактировать кость или сустав, вы можете выбрать нужный элемент на панели outliner.
Это откроет окно Inspector of bones/joints (инспектор костей/суставов) для редактирования.
Все параметры визуализируются, и все изменения сразу же будут видны в предварительном просмотре.




                        Joint Properties (Общие свойства) :

Axis lock (Блокировка осей) :

Блокировка оси ограничивает движение дочерней кости (child bone) в пространстве преобразования. Может настраиваться независимо для каждой оси.
None (Нет) : означает, что этот сустав не может двигаться по этой оси.
Free: (Свободно) : означает, что этому суставу позволено свободно двигаться, насколько он может двигаться по этой оси.
Limited (Ограничено) : означает, что этому суставу разрешено перемещаться на заданное расстояние по этой оси. (Axis Limit parameter (Параметр лимита оси))

Twist Lock (Блокировка закручивания) :

Блокировка закручивания ограничивает поворот дочерней кости на оси Z (оси вращения). Возможна независимая регулировка для обеих вращающихся сторон.
None (Нет) : означает, что этот сустав не может закручиваться.
Free: (Свободно) : означает, что этому суставу позволено свободно закручиваться столько, сколько он может.
Limited (Ограничено) : означает, что этому суставу разрешено закручиваться до определенного предела. (Twist Limit parameters (Параметр лимита поворота))

Swing Lock (Блокировка качания) :

Блокировка качания ограничивает вращение дочерней кости по осям X и Y. Может регулироваться независимо для обеих вращающихся сторон.
None (Нет) : означает, что этот сустав не может качаться.
Free (Свободно) : означает, что этому суставу позволено свободно качаться столько, сколько он может.
Limited (Ограничено) : означает, что этот сустав может качаться до определенного предела. (Swing Limit parameters (Параметр лимита качания))

Все эти параметры визуализируются в предварительном просмотре. Не стесняйтесь изменять их и просматривать получившийся эффект.

                          Bone Properties (Свойства костей) :

Свойства костей могут быть использованы для изменения ragdoll и collision капсул.
Визуализация капсулы может быть включена в Display panel (панели дисплея).
Вы можете изменить радиус капсулы, положение 1 (верхняя часть капсулы), Положение 2 (нижняя часть капсулы) на Properties panel (панели свойств).


(ragdoll capsule)


(collision capsule)

            Ragdoll Simulation (Ragdoll-моделирование) :

Лучший способ визуализировать ваши изменения, это включить ragdoll-моделирование и посмотреть ваши изменения в режиме реального времени.
Просто выберите скелет из outliner и нажмите кнопку Red "Simulation Enabled/Disabled". Это включит ragdoll-моделирование.
Нажатие этой кнопки снова отключит ragdoll-моделирование и сбросит скелет обратно в T-Pose.


(ragdoll enabled)

  Testing and Saving changes (Тестирование и сохранение изменений) :



(ragdoll drag)

Вы можете выбрать кости и перетащить их с помощью мыши, чтобы проверить пределы и поведение ragdoll-модели.
После завершения настройки и тестирования вы можете сохранить все свои изменения в меню File > Save (Файл > Сохранить).
Сохранение изменит соответствующие файлы .tpac для каждого измененного скелета.

          Meta Mesh Editor (Редактор мета-мешей [сложносоставных моделей])

                               

Divide Into Grid (Деление на сетки (меши) ) : делит мета-меши [сложносоставные модели] на отдельные меши и добавляет все сгенерированные секции мешей в sub-meshes.
Remove Redundant Vertices (Удаление избыточных вершин) : название подразумевает то, что оно делает.
Recompute Normals (Повторное вычисление нормалей) : при импорте мета-мешей вычисляет векторы нормалей для всех submeshes вместо того, чтобы импортировать их.
Normal Computation (Вычисление нормалей) : решает, будет ли векторное вычисление нормалей происходить в области лица (weighted (нагрузить)) или нет (default (по умолчанию)).
Recompute Tangents (Повторное вычисление касательных векторов) : при импорте мета-меша вычисляет касательные векторы (tangent vectors) для всех sub-meshes вместо того, чтобы импортировать их.
Whiten (Отбеливание) : линейная интерполяция между цветом вершины и белым цветом для каждого цветового канала.

                                             Lod Meshes (Лоды мешей) :

 [ LOD (англ. Levels Of Detail  - уровни детализации) - приём в программировании трёхмерной графики, заключающийся в создании нескольких вариантов одного объекта с различными степенями детализации, которые переключаются в зависимости от удаления объекта от виртуальной камеры для уменьшения нагрузки на ваше железо.] (от переводчика)

Все активные sub-meshes мета-меша можно увидеть здесь. Свойства материала (material properties), параметры меша и метки (tags) могут быть изменены через интерфейс.




                                 Unused Meshes (Незадействованные меши) :

Этот раздел описывает ситуацию активности sub-meshes. Если флажок игнорировать (ignore) установлен, это означает, что соответствующая sub-mesh неактивна. После изменения статуса лода меша (lod meshes), пожалуйста, нажмите кнопку “Apply Ignores” (“Применить игнорирование”), чтобы ваши изменения состоялись и были сохранены.



                                                  Save (Сохранение) :

Сохраняет все изменения, внесенные в мета-меш.

Эта статья завершает мой перевод раздела Resource Editors
http://docs.modding.bannerlord.com/editor/resource-editors/
Успехов в моделировании

Привет всем, мы на коммандо решили переводить редактор сцен. Потом можем обменяться статьями, ок?

                Раздел : Playing Sounds (Воспроизведение звука)
http://docs.modding.bannerlord.com/playing-sounds/adding-custom-sounds/

         Adding Sounds to Your Module (Добавление звуков в ваш модуль) :

Аудиосистема Bannerlord построена на фирменной аудиосистеме FMOD. Чтобы сохранить производительность звукового движка и сделать его доступным для всех, нам нужно было создать свой внутриигровой аудиопроигрыватель.

                            Key Elements (Ключевые элементы) :

В файл  ...\Modules\*ВАШ МОД*\ModuleData\module_sounds.xml вы прописываете названия своих звуковых файлов.
В папку  ...\Modules\*ВАШ МОД*\ModuleSounds вы помещаете свои новые аудиофайлы (.ogg, .wav).

В качестве примера можно посмотреть, как это реализовано у разработчиков в их модуле ‘Native’.

                             Basic Guide (Базовое руководство) :

1. Скопируйте примеры файлов и папок из модуля ‘Native’в свой собственный модуль.
2. Добавьте свои новые звуки в папку ModuleSounds
3. Откройте файл module_sounds.xml в вашем модуле.
4. Просмотрите пример записи кода звуковых файлов в файле module_sounds.xml  модуля ‘Native’.
5. Добавьте новые строки в файл module_sounds.xml своего мода.
6. Воспроизведите для проверки новое звуковые записи из кода.

                            Moving Further (Двигаемся дальше) :

Using module_sounds.xml (Помощь в создании файла module_sounds.xml) :



,где :

‘name’ : любое уникальное имя, которое вы хотите. Это идентификатор вашего звука.
             Используется во время воспроизведения звука из кода.
             Используется для воспроизведения звука анимации, добавив к анимации свойство 'sound_code'.

‘is_2d’ : (Звук является 2d) Ставится значение "true" (верно), если пространственные свойства звука не будут использоваться. 3d звуки имеют свойства, как (position) расположение в пространстве, (velocity) скорость воспроизведения и т.д.

‘sound_category’ : Все звуки должны быть отнесены к определенной категории, чтобы они правильно воспроизводились.
                                             
                              Доступные категории:

mission_ambient_bed (Звук, движущийся в игре по кругу. Напр. ветер)
mission_ambient_3d_big (Звуки, которые должны быть слышны издалека. Напр. горящий замок)
mission_ambient_3d_medium (Звуки, которые должны быть слышны со среднего расстояния. Напр. удаленный костры)
mission_ambient_3d_small (Звуки, которые должны быть слышны поблизости. Напр. костры в лагере)
mission_material_impact (Звуки физических материальных воздействий. Напр. удар металлического меча о каменную стену)
mission_combat_trivial (Звуки несущественного урона. Напр. низкий/нет урона)
mission_combat (Звуки повреждений)
mission_foley (Взмахи оружия, звук шагов, звуки движения животных)
mission_voice_shout (Звуки голоса людей/животных, которые должны быть слышны издалека. Напр. боевые крики)
mission_voice (Звуки от людей/животных. Напр. хрюканье, удары по лицу)
mission_voice_trivial (Тихие вокализации, такие как лазание, прыжки)
mission_siege_loud (Звуки больших осад, которые звучат так, словно валун врезается в стену, катапульта стреляет, дверь ломается)
mission_footstep (Стандартные шаги людей и мелких животных)
mission_footstep_run (Более громкие шаги, которые можно услышать издалека. Напр. толпы)
mission_horse_gallop (Галоп лошадей и верблюдов)
mission_horse_walk  (Мягкий шаг лошадей и верблюдов)
ui (2D звуки для пользовательского интерфейса и уведомлений)
alert (Псевдо-3d звуки для оповещения игрока со средней дистанции)
campaign_node (Позиционные звуки для карты мира, ферм, морей, водопадов)
campaign_bed (2D окружающие звуки для карты мира, порывов ветра в пустыне, ветры на травяных пастбищах и т.д.)

‘path’ : Имя звукового файла для воспроизведения [обязательно с его расширением]. Путь (Path) указывается относительно папки ModuleSounds вашего модуля. Вы можете создавать подпапки.


Playing Sound from Code Example (Пример кода в звуковм файле) :




У вас есть два способа воспроизведения звука :
One Shot (Один выстрел). Лучшая производительность и меньше контроля за управлением. Выстрелил и забыл. Хорошо подходит для звуков, связанных с боем.
Creating and holding (Создание и удержание ссылки). Худшая производительность. Контролируйте каждый параметр звука всякий раз, когда вы хотите его произвести. Обновление состояния во время паузы.

решили переводить редактор сцен

Привет. Тогда я возьму в перевод раздел Bannerlord Missions
( http://docs.modding.bannerlord.com/authoring-mission-scenes/ )

Потом можем обменяться статьями

Как же это сделать ?

Обыкновенно, запостим на обоих форумах все статьи

dimchick, Я тебе напишу проблему в личку.

                  Раздел Bannerlord Missions
    ( http://docs.modding.bannerlord.com/authoring-mission-scenes/ )


         Mission Tactical Positions (Задание Тактических позиций) :

                  TACTICAL POSITIONS AND TACTICAL REGIONS
             (ТАКТИЧЕСКИЕ ПОЗИЦИИ И ТАКТИЧЕСКИЕ РАЙОНЫ)

Это запрограммированные объекты, которые позволяют AI (искусственный интеллект) узнать об особенностях местности. Они работают не как осады, AI не всегда будет использовать тактические позиции или регионы, в которые вы можете их разместить. Они могут использовать их только в условиях, которые благоприятствуют их использованию.

В зависимости от перемещения игрока и рандомизации пути спавна (spawn) существует очень большое количество сценариев, которые могут возникнуть во время сражений. Из-за этого лучше иметь как можно больше тактических позиций и регионов, как только возможно.
Их отсутствие или отсутствие меток некоторых тактических позиций не приведет к очевидным ошибкам, как в осадах, но приведет к менее интересным сражениям, потому что AI не будет знать о них.

Типы и способы использования различных тактических позиций и регионов :

                                                                               
                  TACTICAL POSITIONS (ТАКТИЧЕСКИЕ ПОЗИЦИИ) :


High Ground, Slope facing direction (Возвышенность, чей склон направлен в какую-то сторону) :

_width : AI будет пытаться сформировать строй на всю ширину если проход слишком узкий, а у AI  слишком много войск. Или если проход слишком широк, а войск у AI недостаточно, то он может решить, что это плохо подходящая позиция.
_slope : Параметр также важен для выбора между позициями, он выражается в градусах, а максимальный наклон в 60 градусов распознается AI. Следует приблизительно оценить крутизну позиции.
_isInsurmountable : (false) Не применяется.
_tacticalPositionType : Возвышенность
_tacticalPositionMembership : Лес, ущелье или другая сложная местность.
_tacticalPositionSide : BehaviorSideNotSet (Возвышенность, у которой сторона действия противника не установлена).




Top of Hill, Defendable against all directions (Вершина холма, защищенная со всех сторон) :

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

_width : (ширина) что немаловажно, должна быть примерно равна радиусу вершины холма.
_slope : (склон) также важен для выбора между позициями, он исчисляется в градусах и его максимум наклона в 60 градусов распознается AI. AI должен примерно оценить крутизну позиции.
_isInsurmountable : Непреодолимая ни кем позиция.
_isOuterEdge : (Внешний край) false (отключенный параметр)
_tacticalPositionType : Возвышенность
_tacticalPositionMembership : Лес, ущелье или другая сложная местность.
_tacticalPositionSide : BehaviorSideNotSet (Возвышенность, у которой сторона действия противника не установлена).




Choke Points (Узкие места) :

Это для позиций с непроходимыми барьерами с обеих сторон. AI с более меньшим числом бойцов может попытаться удержать эти позиции, чтобы компенсировать их недостаток.

Направление (Direction) - самая важная часть. Позиция для защиты будет смотреть вперед позиции (зеленая стрелка в редакторе).
_width : AI будет пытаться сформировать строй на всю ширину если проход слишком узкий, а у AI  слишком много войск. Или если проход слишком широк, а войск у AI недостаточно, то он может решить, что это плохо подходящая позиция.
_slope : (склон) также важен для выбора между позициями, он исчисляется в градусах и его максимум наклона в 60 градусов распознается AI. AI должен примерно оценить крутизну позиции.
_isInsurmountable : false (Не применяется) В настоящее время этот сценарий ничего не делает для узких мест, но разработчики хотят добавить проверку как спереди, так и сзади для одной и той же узкости.
Так как если _isInsurmountable присвоить значение true, то узкость может быть использована против врагов и спереди и сзади, вместо добавления двух узких мест с противоположными направлениями.
_isOuterEdge : (Внешний край) false (отключенный параметр)
_tacticalPositionType : Chokepoints (сужение)
_tacticalPositionMembership : Лес, ущелье или другая сложная местность.
_tacticalPositionSide : BehaviorSideNotSet (Возвышенность, у которой сторона действия противника не установлена).




Cliff Positions (Позиции на скалах) :


Эти тактические позиции сами по себе бессмысленны. Они должны быть помещены в иерархию объектов за тактическими позициями узких мест. Если они размещены за узким проходом и AI применит его, то сценарий будет использоваться только до положения обрыва.

Позиции утесов должны быть позициями, которые противник не сможет достичь, когда узкость удерживается другими защитниками.
Когда они прорвутся, то стрелки и лучники переместятся в эту позицию.
Направление позиции обрыва будет определять, где группа лучников будет строиться при использовании этой позиции.
_width : AI будет пытаться сформировать строй на всю ширину если проход слишком узкий, а у AI  слишком много войск. Или если проход слишком широк, а войск у AI недостаточно, то он может решить, что это плохо подходящая позиция.
_slope : Склон не важен.
_isInsurmountable : false (Не применяется)
_isOuterEdge : (Внешний край) false (отключенный параметр)
_tacticalPositionType : Chokepoints (сужение)
_tacticalPositionMembership : Лес, ущелье или другая сложная местность.
_tacticalPositionSide : BehaviorSideNotSet (Возвышенность, у которой сторона действия противника не установлена).




                    TACTICAL REGIONS (ТАКТИЧЕСКИЕ РЕГИОНЫ) :


Они предназначены для разметки областей в сценах. Задается только радиус, и сама область имеет круглую форму. Очевидно, что сцены будут иметь регионы с полностью заданной/случайной формой лесами, сложными ландшафтами и открытыми местами. Поэтому следует определить несколько тактических регионов с различными круговыми областями, при необходимости их можно добавить. Радиус и площадь круга каждого региона могут быть приблизительными, не обязательно им быть точными.

Forest Areas (Лесистые районы) :

AI может использовать позиции в лесных районах, если противник имеет большее количество дальнобойных и кавалерийских подразделений, потому что лучники и кавалерия менее эффективны в лесах.
Любой другой регион, который является невыгодным для дальнобойных подразделений и кавалерии может быть предоставлен как лесной регион.
И он не обязательно должен быть лесом с деревьями, это может быть городской рынок с большим количеством препятствий и укрытий или что-то подобное.




Difficult Terrain (Труднопроходимая местность) :

Это включает в себя скалистую местность, а также болота, ей могут быть даже рыночные площади или какое-либо другое место с множеством препятствий на земле.
Любую область, которая не препятствует дальнему огню (например, леса), но препятствует и замедляет кавалерию, следует отмечать как труднопроходимую местность.
AI будет использовать позиции внутри труднопроходимой местности, если у противника превосходящее количество кавалерии.




Open Areas (Открытые территории) :

Позиции, позволяющие быстро двигаться кавалерии и вести сильный огонь лучникам. Этот тип региона предназначен для размещения подходящих полей боя. AI может выбрать защиту в этих открытых регионах, если у него есть большее или равное количество стрелков и кавалерии.




                  TACTICAL REGIONS AND POSITIONS COMBINATIONS
                 (КОМБИНАЦИИ ТАКТИЧЕСКИХ РАЙОНОВ И ПОЗИЦИЙ)


Тактические позиции также могут быть отнесены к объектам тактического региона. Их _tacticalRegionMembership должен быть правильно выбран. В этой ситуации, AI  поймет, что, например, узкость находится также и в лесном регионе и при правильных условиях, может предпочесть тактику Choke Points (Узких мест) тактике лесистых районов.

What Makes a Village Scene (Создание деревенской сцены)

http://docs.modding.bannerlord.com/authoring-mission-scenes/villages/

Introduction (Вступление) :

Этот список контрольных точек (checkpoints) должен помочь вам в создании деревенских сцен и дать вам представление о том, на что мы обращаем внимание при создании деревенских сцен.

    Navigation Mesh (Навигационные меши) :

Навигационный меш состоит из треугольников и четырехугольников. Он используется AI для поиска пути. Глобальная система освещения (global illumination system) также использует его для поиска видимых мест сцены.
Имейте в виду, что грани навигационного меша не должны быть слишком далеко от реальной физики для него. Расстояние должно быть не более 1,5 м.
Персонажи в деревне должны быть помечены специальными идентификаторами, которые указывают на создание точки спавна этих персонажей, и на передвижение их внутри сцены.
Чтобы заставить персонажи (agents) перемещаться по дорогам деревни, мы маркируем их идентификатором ID 2.
Обратите внимание, что все точки спауна (появления) должны быть заданы всем персонажам, имеющими ID 2 в этом навигационном меше.
Для животных нужно использовать маркировку идентификатора ID 3. Как правило, эти животные находятся в пределах отдельных островков, окруженных рвами. Тогда они будут бродить только внутри этих островков.
Все остальные персонажи должны иметь идентификатор ID 0.
Помните, что персонажи должны использовать идентификатор навигационного меша ID 1, чтобы создать реалистичный путь движения на дорогах. Дизайнер, создающий сцены, должен поместить объект с деактиватором навигационного меша (название пишется как - Navigation_Mesh_Deactivator). Его можно разместить в любом месте сцены. Его цель - отключить лица с маркировкой ID 0 в гражданских режимах. Переменная DisableFaceWithID скрипта должна быть равна 1.
Для животных переменная “DisableFaceWithIDForAnimals” в том же скрипте должна быть равна 3.
Убедитесь, что модели персонажей примерно равны по своим размерам и за пределами деревни, где будут маневрировать войска.
Убедитесь, что нет отключенных (disconnected) навигационных мешей.
Чем лучше сделан навигационный меш, тем лучше будет работать на нем AI. Всегда помните о том, что в деревне может произойти крупное сражение. Поэтому старайтесь избегать наличия большого количества закрытых помещений, таких как свинофермы, только с одним входом (например : переставьте несколько заборов, чтобы создать больше входов).
Избегайте создавать очень большие территории, доступные для игрока, но не понятные для AI. Ведь тогда игроки смогут безнаказанно расстреливать юнитов AI из-за пределов навигационного меша.
Используйте “_barrier_ai_x” , чтобы предотвратить падение юнитов AI со скал или застревание их в труднодоступных местах (например, в рыночной будке) вне навигационного меша.


(Навигационный меш)


                   Spawn Points (Точки спауна) :

Как уже отмечалось ранее, все точки спауна должны быть размещены поверх навигационного меша (ID 2) и внутри мягких (soft) границ. Помните, что некоторые сборные конструкции (например, стулья и скамейки) даются с уже прикрепленными к ним точками спауна. Если точки спауна несовместимы с деревенской миссией, они, скорее всего, приведут к сбою игры или вызовут ошибки. Одним из примеров является “sp_blacksmith_with_smithing_machine”. Самое главное в точках спауна - это их метки (tags). Они решают, какой тип NPC будет там появляться. Ради вашего же блага, не играйте с этими тегами слишком много и оставляйте их такими, какие они есть уже в сборных конструкциях.


Entry Points (Точки входа)


Player Spawnpoint (Точка спауна игрока) :

Prefab : sp_player.
Убедитесь, что она расположен в таком месте, откуда ее можно увидеть или, по крайней мере, есть четкий путь, ведущий к ней. Не ставьте ее слишком далеко.
Под точкой спауна должен находится навигационный меш.

Battle Spawnpoints (Точки спауна в бою) :

Prefab : Sp_battle_set.
Убедитесь, что точки спауна атакующих и защитников не слишком близко расположены друг к другу или, по крайней мере, не в пределах прямой видимости.
Убедитесь, что точка спауна подкреплений убрана из поля зрения врага насколько это возможно, но при этом не слишком далеко от линии фронта.
Убедитесь, что вокруг всех точек спауна есть свободное пространство для правильного появления войск.

Conversation Spawnpoints (civilian) (Точки спауна для беседующих гражданских персонажей) :

Prefab : sp_player_conversation.
Эти точки спауна определяют, где игрок и его собеседник появляются, когда вы попадаете в деревню через кнопку “Talk to Notable” ("Поговорить с ...") с карты мира.
Убедитесь, что с них открывается красивый вид, но делайте их относительно близко к центру деревни.

Animation Points (civilian) (Анимационные точки для гражданских персонажей) :

Prefab : sp_npc_x.
Они используются обычными сельскими жителями. Вы можете использовать до 40 позиций.
Они определяют точки спауна в сценах, где жители деревни будут появляться и ходить.
Убедитесь, что они удобно расположены по всей деревне и в окрестностях.
Сначала сельчане будут думать, каким путем идти.
Если тропинки слишком длинные, вы можете обнаружить, что ваши жители все время думают куда им идти, а на самом деле никто ничего не делает. Старайтесь избегать больших расстояний и ставьте точки спауна рядом с основными путями.
Размещение большего или меньшего количества точек спауна не влияет на то, сколько жителей будет населять эту сцену.

Rural Noteable Spawnpoints (Точки спауна сельской знати) :

Prefab : sp_notable_x.
Количество таких точек должно быть около 6.
Это точки спауна для знати деревни (дающих задания) и лордов.
Убедитесь, что они находятся в деревне на видном месте и, как правило, в местах, где будут болтаться старейшины / лорды.
Вы можете проверить это в Debug Window (окно отладки) (это будет в документации), чтобы убедиться, что вы правильно разместили эти точки.
Перейдите на вкладку “Scene Entity Check Tab” (“Проверка объектов сцены”), поставьте галочку в поле “NPCs” и посмотрите.

Bandit Camps (Лагеря бандитов) :

Prefab : common_area_x.
Каждая деревенская сцена имеет 3 бандитских лагеря за пределами деревни, используемых для сюжетных квестов.
Используйте те же точки спауна, что и для обычных жителей деревни (~ 15 на лагерь). Постарайтесь, чтобы они не занимались такими делами, как сельское хозяйство.
Вы также можете использовать точки спауна патрулей : sp_guard_patrol_simple, sp_guard_patrol”.
Все точки спауна в этом радиусе будут порождать бандитов вместо жителей деревни.
Вы можете увеличить радиус, масштабируя prefab общей области.
Используйте ранее рассмотренные Animation Points в качестве точек спауна бандитов, напримр : “sp_npc_wait_wall, lookout, sp_npc_argue_set, sp_npc_wait”.
Убедитесь, что есть какое-то подсказки на то, где лагеря могут быть, чтобы у игрока был шанс найти их (особенно ночью).
Не ставьте их слишком близко друг к другу.


(Bandit Camps)

Animal Spawnpoints (Точки спауна животных) :

Prefab : sp_animalName.
Используйте“DisableWandering” (“Отключить блуждание”) в скрипте AnimalSpawnSettings, чтобы животные не ходили по вашей сцене.
В целом лучше поставить его для всех больших животных, таких как коровы и свиньи.

            Tactical Region (Тактические регионы) :

Prefab : TacticalRegion.
Используется, чтобы сообщить AI, где находятся более крупные регионы (леса, холмы и т. д.).
AI будет позиционировать себя внутри этого радиуса или избегать его.
Не злоупотребляйте им, придерживайтесь ~5 (убедитесь, что есть некоторое разнообразие).

           Tactical Positions (Тактические позиции) :

Prefab : TacticalPosition.
Используется, чтобы сообщить AI, где есть соответствующие более мелкие позиции (например, узкие проходы между зданиями, скалы для лучников и так далее).
AI будет планировать свое поведение в соответствии с поворотом Prefab и шириной, заданной сценарием.
Вы можете использовать их довольно часто.
Чем больше уклон, тем “лучше” положение.


(TacticalPosition)

          Flee Positions (Позиции для отступления) :

Позиции, к которым будут отступать бегущие войска, а также кони без всадников.
Убедитесь, что они находятся внутри Soft Border и что под ними есть navmesh (навигационный меш).


(Flee Positions)

                  Debug Window (Окно отладки) :

Prefab : SpawnPointDebugView.
Существует встроенный инструмент отладки, который можно включить, добавив вышеупомянутый prefab к сцене. Поместите prefab в любом месте сцены и активируйте окно с помощью флажка в его сценарии.
Этот prefab открывает небольшое окно отладки в редакторе, которое помогает вам убедиться, что вы соответствуете требованиям для миссии (например, точки мпауна, navmesh).
На вкладке “Scene Entity Check Tab” (“Проверка объекта сцены”) вы можете подсчитать свои Entry Points (точки входа) и убедиться, что вы разместили достаточное их колличество (или же слишком много).
На вкладке “Navigation Mesh Check Tab” (“Проверка навигационной сетки”) вы можете убедиться, что все ваши точки входа правильно подключены к навигационному мешу.


(Debug Window)

               Soft Border (Мягкая Граница) :

Prefab : border_soft.
Они определяют красные границы сцены.
При размещении они образуют многоугольник, где 2 ребра соединяются между ближайшими двумя пограничными объектами (но никогда не более двух).
Чтобы проверить текущие границы, перейдите в “Visibility Window” (“окно видимости”) → “Visibility Masks” (“маски видимости”) и включите “Borders” (“границы”).
После их пересечения у игрока есть несколько секунд, чтобы вернуться обратно в границы карты. Этим нельзя злоупотреблять.


(Borders)

                      Sounds (Звуки) :

Master Ambient Sound (Основные звуки окружающей среды) :

Prefab : x_ambient_sound.
Обязательно выберите основной звуковой фон (master ambient sound).
Вы можете разместить его prefab в любом месте.
Убедитесь, что у него включен параметр “Is Master Sound”.
Убедитесь, что на нем не включен параметр “Is Triggered”.

Additional Ambient sounds (Дополнительные звуки окружающей среды) :

Применяется для больших площадей (например, лесов).
Должен быть включен параметр “Is Triggered”.
Чтобы увидеть, как далеко эти звуки распространяются, в окне “Visibility Window” (“видимость”) включите “Sound Entities” (“звуковые объекты”) в группе “Visibility Masks” (“маски видимости“).
Чтобы изменить территорию их охвата, вы можете масштабировать их, как и другие объекты редактора (используя клавишу “b” или gizmo (???)).


(Sounds)

Reverb (Реверберация) :

[Реверберация — это процесс постепенного уменьшения интенсивности звука при его многократных отражениях. Иногда под реверберацией понимается имитация данного эффекта с помощью ревербераторов. К реверберации примыкает явление акустического флаттера, или порхающего эха.]

Для каждого варианта использования существуют разный prefab : reverb_x.
Добавляет эффект реверберации к любому звуку, порожденному внутри его границы.
Обычно они используются для тесных или подземных участков местности.
Вы можете разместить их в узких переулках между высокими зданиями, скалами, в пещерах или в густых лесах.
Должен быть включен параметр “Is Triggered”.

Detail (Деталь) :

Используется для мелких деталей.
Убедитесь, что параметр “Is Triggered” отключен.
Поместите их prefab туда, где вы хотите, чтобы они играли.

Moving sounds on paths (for rivers and such) :
Звуки движения на дорогах (для рек и тому подобного)

Иногда полезно перемещать звуки вдоль всей береговой линии или на самой реке. Приведенная ниже техника более удобна для работы и более точна, чем, например, размещение нескольких звуковых объектов вдоль вашей реки.

Проложите траекторию движения прямо по реке. Дополнительные сведения см. В разделе Path Editing (Редактирование пути) :
http://docs.modding.bannerlord.com/editor/scene-editor/path_editing/
Добавьте звук в сцену.
Разместите любой дополнительный звук окружающей среды, как описано выше.
Добавьте скрипт path_converger в объект вашего звука окружающей среды.
Введите имя вашего пути к  “path_converger”.
Теперь звук будет следовать по траектории движения в соответствии с положением камеры.

Sounds in the Engine (Звуки мотора) :

Вы можете проверить файл "MODDING_TOOLS_DIRECTORY/Sounds/GUIDs.txt" для просмотра списка звуков в игре. Эти имена могут быть использованы в скрипте звуковых объектов.

                          Lights (Огни) :

Имейте хотя бы один “envmap_prop” в вашей сцене.
Для более темных областей, таких как пещеры, используйте пропсы “local_envmap_prop”.
Он будет влиять на освещение в данной области в зависимости от значений его скрипта “ReflectionCapturer” (“Захват отражения”).
Убедитесь, что деревни и бандитские лагеря хорошо освещены.
Будьте особенно внимательны в conversation points (Точки спауна для беседующих персонажей).
Используйте факелы и другие предметы.
Убедитесь, что факелы внутри зданий и других темных областей имеют включенный параметр “alwaysBurn” (“всегда гореть”) в скрипте LightCycle (Световой Цикл).
Старайтесь избегать размещения “artificial lights” (“искусственного освещения”) без модели фактического источника.
Вы можете сделать окружающее освещение в вашей сцене с помощью системы GI. Это сделает окружающее освещение гораздо более реалистичным. Для получения дополнительной информации см. GI System :
http://docs.modding.bannerlord.com/editor/scene-editor/prt/



(Lights)

                   Atmosphere (Атмосфера) :

Убедитесь, что ваша сцена работает и хорошо смотрится со всеми атмосферами “TOD_x” и во все времена года! (поскольку она будет протестирована с ними).
Выберите “Color Grade” (“класс цвета”), который подходит для вашей сцены (мы предлагаем использовать те, для которых предназначена ваша сцена, например: “color_grade_empire_soft”).


(Atmosphere)

     Destructible Component (Разрушаемый компонент)
http://docs.modding.bannerlord.com/authoring-mission-scenes/script-components/bannerlord_destructible_component/

Ниже поясняется система разрушений, которая дает художникам гораздо больше свободы в моделировании.

            Characteristics (Характеристики) :

Это ScriptComponent (компонент сценария), который может быть применен к любому объекту в сцене, если этот объект имеет collision body (коллизии).

[Коллизия (от лат. collisio — столкновение). Коллизии играют одну из первых ролей в устройстве игрового мира. Моделирование физического взаимодействия игровых объектов целиком и полностью основано на обработке коллизий. Очень часто мы сталкиваемся с проблемами определения пересечения двух объектов: если это шутер нам требуется определить, попала ли пуля во врага, если это гонка, то нас интересует взаимодействие колес автомобиля с дорогой, в бильярде мы рассматриваем столкновение шаров. Существует огромное количество различных типов коллизий, равно как и способов их обнаружения.]

Если не дать никакой дополнительной информации, script (сценарий) просто заставит объект исчезнуть после уничтожения. Он также появится снова, когда миссия будет окончена.

Скрипт может быть использован для уничтожения объектов в одном или более состояниях, с дополнительным звуком, частицами и динамическими объектами, появляющимися в каждом состоянии.

Любой существующий prefab (префаб) скрипта DestructibleComponent (осадные башни, ворота, баллисты и т. п.) будет продолжать работать, даже если вы удалите этот скрипт. Только их больше нельзя будет разрушить.

[Prefab (Префаб) - это один из типов объектов, предназначений для многократного использования, который можно вставлять несколько раз в одну и ту же сцену.]

У одного объекта может быть несколько скриптов DestructibleComponent. Например, таран разрушаем целиком, но у него также есть отдельные листы обшивки, которые тоже можно разрушить отдельно. Любой ущерб, нанесенный таким частям, также будет применен к целому объекту.

Разрушенные префабы всегда можно настроить и улучшить позже, не нарушая каких-либо сцен, потому что они не являются частью неповрежденного объекта (они создаются во время выполнения).


 Example Script of Siege Tower (Пример скрипта осадной башни) :



(Script Overview (Обзор скрипта))

DestructionStates (Состояние разрушения) могут быть одним или несколькими префабами. Разделены «,» (запятой).

DestroyedByStoneOnly (Разрушаем только камнями). Выставленное значение True (верно) означает, что только снаряды из мангонелей или требушетов могут повредить этот объект. Значение False (Ложь) означает, что этому объекту может повредить что угодно.

CanBeDestroyedInititally (Может быть уничтожен изначально), определяет, может ли этот объект быть уничтожен уже при загрузке сцены. Это контролируется с карты кампании на основе процента разрушений от бомбардировок. Обычно это верно только для настенных зубцов. Но его также можно использовать для эстетических объектов, чтобы сцена выглядела более разрушенной с самого начала. Объекты, подлежащие уничтожению, выбираются случайным образом.

MaxHitPoint (Максимальное здоровье) - это начальные очки жизни этого объекта. Каждый раз, когда миссия перезагружается, текущее количество жизни объекта также будет сброшено на максимальное количество хитпоинтов.

ReferenceEntityTag (Справочный тег объекта) - это необязательный тег, когда префаб DestructionState имеет кадр, отличный от его родительского, или для копирования состояний анимации. Вы можете добавить дополнительный объект (с помощью скрипта DestructibleComponent) с правильным фреймом и снабдить его справочным тегом, чтобы возникший префаб DestructionState использовал этот фрейм. Если ReferenceEntity отсутствует, то будет использоваться фрейм объекта со скриптом DestructibleComponent. Справочный объект (ReferenceEntity) также может быть использован в специальных сценариях, таких как castlegate (анимация открытия/закрытия), чтобы получить состояние анимации от справочного объекта (ReferenceEntity) и применить его к вновь созданному поврежденному объекту.

OriginalStateTag (Тэг исходного состояния) требуется только в том случае, если у вас есть несколько DestructionStates. Обычно, когда объект уничтожается, мы скрываем этот объект, к которому применен компонент скрипта, и порождаем новый объект из состояния DestructionState (без родителя). Но для некоторых объектов (таких как ворота) мы не хотим скрывать весь объект целиком, потому что он должен продолжать функционировать как ворота, пока не будет полностью разрушен. Используя OriginalStateTag, мы скроем только тот объект, к которому применен этот тег, а остальная часть иерархической структуры (частицы, точки опоры и т. д.) все равно будет видна. Любой DestructibleComponent, имеющий более одного destructionState, будет порождать поврежденные префабы как дочерние объекты.

HeavyHitParticlesTag (Тэг тяжело пораженных частиц) - это тег, который можно применить к любым дочерним объектам, имеющим систему частиц (particle-system). Эти частицы взорвутся один раз, когда определенное количество урона будет получено за один удар. Эта система частиц обычно используется во всех состояниях разрушения (она не является частью скрытых / порождаемых объектов).

HeavyHitParticlesThreshold (Предельное значение частиц сильного удара) - минимальный урон, который требуется получить за один удар, чтобы вызвать триггер взрыва (trigger particles) с тегом HeavyHitParticlesTag.


                   Effects (Эффекты) :

Как правило, мы стараемся, чтобы спауна префабов было как можно меньше из соображений производительности, а также во избежание дублирования объектов. У вас есть доступ к следующим функциям для добавления эффектов :

При спауне префаба повреждения : все системы частиц на каждом объекте в иерархии будут автоматически взорваны один раз.
При спауне префаба повреждения : все динамические тела на каждом объекте в иерархии автоматически получат импульс от последнего удара, который разрушил предыдущее состояние.
При спауне префаба повреждения : все остальные меши на каждом объекте в иерархии останутся на своих местах, если у них нет флажка, что это динамическое тело (dynamic body-flag).
Часть иерархии объектов : частицы сильного удара должны быть разделены между всеми состояниями разрушения и воспроизводятся всякий раз, когда DestructibleComponent получает урон HeavyHitParticlesThreshold.
Вы можете воспроизводить свои анимации на компонентах DestructibleComponents, у которых есть скелет (например, ворота замка поврежденные тараном). Прогресс анимации будет передаваться вновь созданным поврежденным объектам.
Вы можете добавить сценарий типа AmbientSoundEmitter в префаб повреждения и получить звуковое сопровождение. Оно будет автоматически воспроизводиться при спауне объекта.
Помимо использования нескольких состояний, вы также можете добавить несколько дочерних объектов с помощью DestructibleComponents (например, крыши  тарана, которую можно разрушить по отдельности). Имейте в виду, что любое повреждение, наносимое дочернему элементу DestructibleComponent, также применяется ко всем родительским элементам в иерархии. В настоящее время мы не знаем, как их большое количество в сцене влияет на производительность.

Tip (Совет) :
При любом ударе оружием уже будут воспроизводиться стандартные эффекты частиц и звуки ударов в зависимости от типа материала (дерево, камень и т. д.), Так что не сходите с ума с дополнительными эффектами.

Warning (Предупреждение) :
Любой динамический меш, летающий в воздухе после спауна поврежденного объекта, является временным и не должен иметь физического контакта с игроком! Он не должен влиять на игровой процесс, потому что мы не синхронизируем его для игроков в многопользовательской игре.

                  Examples (Примеры) :

Example 1: Wall with breakable merlons :
Пример 1: Стена с разрушающимися зубцами :

Что касается стен, то мы можем уничтожить только ее зубцы и ничего больше. Они могут быть повреждены только мангонелями/требушетами, и они получают только один удар, прежде чем будут уничтожены.

Hierarchy of WallSegment (Иерархия сегмента стены) :


(Wall Hierarchy Edited (Отредактированная иерархия стен))

Вот как выглядит наша иерархия сцен для одной стены. European_castle_wall_a_l3 - это объект со скриптом WallSegment. Ему все равно, есть у него разрушаемые дети\подобъекты или нет. Каждый зубец стены - это отдельный дочерний объект, который имеет свой собственный скрипт DestructibleComponent. Как только они будут уничтожены, все они породят один и тот же префаб разрушения. Каждый зубец имеет объект debris_holder, который является пустым объектом. Он просто содержит тег ReferenceEntityTag и правильный кадр для создания префаба разрушения (важно из-за изгиба мешей : местоположение и вращение могут измениться по сравнению с родительским).

Script example of a single merlon (Пример скрипта одиночного мерлона\зубца) :


(Wall Script (Скрипт стены))

У каждого мерлона есть точно такой же скрипт. Все они будут порождать префаб “мусора” (“debris” prefab ), когда будут уничтожены. Мы решили заставить их уничтожаться после одного попадания из мангонеля, поэтому у них очень маленькие очки жизни (hitpoints). DestroyedByStoneOnly заставляет их игнорировать урон от всех других видов оружия (стрелы, мечи, топоры и т. д.). Из-за CanBeDestroyedInititally эти мерлоны имеют шанс уже быть сломанными при входе в играемую миссию. Мерлоны нуждаются в объекте ReferenceEntity, чтобы определить фрейм спавна для сломанных префабов.

Origin of wall and merlon pieces (Создание частей стены и мерлонов) :

Каждый мерлон представляет собой уникальный меш, который имеет свою исходную точку в нижней части стены (так же, как и вся стена).


(Wall Origin Merlon Hierarchy)


(Wall Origin Merlon)

Каждый мерлон имеет один и тот же разрушенный префаб местного происхождения. debris_holder имеет ReferenceEntityTag.


(Wall Origin Debris Hierarchy)


(Wall Origin Debris)

Каждый дочерний элемент префаба мусора является объектом с флагом «dynamic» и имеет коллизию. При спауне он автоматически получит последний импульс, который получил DestructibleComponent при уничтожении.


(Debris Hierarchy)


(Debris)


Example 2: Siege Barricade :
Пример 2: Осадная баррикада :

Осадные баррикады - это очень простые объекты. Они являются статичными объектами, и их единственная функция - блокировать входящие снаряды. Однако их можно уничтожить в несколько этапов. Каждый этап будет выглядеть более разрушенным, чем предыдущий.

The different destruction states of a siege barricade (Различные состояния разрушения осадной баррикады) :



В настоящее время эти различные состояния не имеют никаких особых частиц или динамических объектов, но они могут быть легко добавлены позже. Объекты с флагом “dynamic” body (“динамического” тела) и системы частиц будут автоматически запускать триггер при спауне.

Tip (Совет) :
У каждого этапа разрушенной баррикады также есть свое уникальная коллизия. Это позволяет людям легче пускать стрелы через более поздние разрушения, а также перелезать через state_5.

Hierarchy of siege barricade in scene (Иерархия осадной баррикады в сцене) :



Siege Barricade script component (Компонент скрипта осадной баррикады) :



siege_barricade_a - это пустой меш. Он просто содержит скрипт siege_barricade_a_state1 - это фактический меш + тело и имеет тег “original_state”. Когда баррикада получит достаточный урон, siege_barricade_a_state1 станет невидимым, следующий префаб повреждения будет порожден и добавлен в siege_barricade_a как дочерний. Это важно, потому что DestructibleComponent должен быть проинформирован о попаданиях, и он может сделать это только в том случае, если у него есть (видимая) коллизия на себе или на дочернем объекте.

Последнее состояние (state_5 в данном случае) будет порождено, когда объект будет иметь 0 здоровья (т.е. полностью уничтожен). Остальные состояния будут использоваться между MaxHitPoints и 0.

Когда миссия перезагружается (здоровье сбрасывается до MaxHitPoint), исходный объект (объект с тегом «original_state») снова становится видимым.

Каждый префаб DestructionState имеет одинаковые координаты и разворот, поэтому нам не нужно использовать ReferenceEntity.

      Scene Barrier Builder (Конструктор барьеров сцены)
http://docs.modding.bannerlord.com/authoring-mission-scenes/script-components/scene_barrier_builder/

                Introduction (Вступление) :

Barrier Builder - это инструмент, который помогает художнику создавать невидимые барьеры над стенами, чтобы предотвратить падение персонажей.

         Usage (Инструкция по применению) :

Создать путь можно с помощью кнопки Add Path на панели инструментов :




Задайте свое имя пути :




Постройте свой путь так, как вы хотите :




Установите флажок “Enable Barrier Build” на панели inspector, он создаст для вас объект барьера :




Вы можете перейти к этому объекту с помощью кнопки “Go to Entity” (“Перейти к объекту”) и изменить его параметр, такой как высота (height). Объект задать с именем “path_barrier_PATHNAME” :

       Scene Spawn Point Guide (Руководство по точкам спауна на сцене)
( http://docs.modding.bannerlord.com/authoring-mission-scenes/script-components/scene_spawn_points_guide/ )

           How to design fully featured scenes in Bannerlord
   (Как создавать полнофункциональные сцены в Bannerlord)

Каждая сцена имеет свои основные необходимые параметры, чтобы работать без сбоев, и имеет дополнительные возможности, чтобы дать лучший опыт игроку. Дизайнеры могут проверить эти потребности с помощью “Spawn Point Debug Tool”, чтобы быть уверенными, что их сцена не рухнет.


                1. Town Center Scene (Сцена в центре города) :

Игрок будет спаунится на префабе «sp_player_outside», если он / она входит в город впервые.
Из-за этой функции префаб “sp_player_outside” необходимо размещать далеко от входа в город.
В противном случае игрок будет появляться на “sp_player”, и эта точка спауна может быть рядом с входными воротами.
Сцена в центре города имеет следующие обязательные персонажи :

Player Spawn Point (Точка спауна игрока) :

Когда игрок входит в центр города из верхней правой панели в сцене карты, игрок и разговаривающие с ним NPC появляются в префабе “sp_player_conversation”.
Сцена должна иметь этих префабов больше одного для увеличения вариантов мест появления.
     Warning (Предупреждение) : Масштаб префаба разговора не должен меняться.

Traders (Торговцы) :

Торговцы, такие как оружейники, кузнецы и торговцы лошадьми, обязательны для сцен в центре города. Если сцена имеет более одного рыночного места, то вполне нормально иметь более одного NPC-торговца. Торговцы на рынках могут иметь свои собственные комплекты префабов. Эти комплекты можно рассматривать как набор префабов с некоторыми точками спауна в них. Например, для оружейника в комплекте оружейника может быть 3 таких точки, но единовременно должна быть только одна точка спауна этого оружейника [что бы не двоился\троился один и тот же персонаж в данный момент времени]. Этот NPC будет обходить эти точки случайным образом, одним словом, NPC может пойти к своему торговому столу и начать торговать или пойти в заднюю часть своего магазина и посидеть на стуле в течение некоторого времени.
    Tip (Совет) : Дизайнер может изменить время ожидания между этими действиями с параметрами “MinWaitInSeconds” и “MaxWaitInSeconds” (-1: forever).

Notables (Нотабли) :

Notable Parent Prefab (Префабы нотаблей) :

В сцене должны присутствовать некоторые известные люди\нотабли. Чтобы их было легко найти, точки спауна нотаблей должны быть размещены недалеко от центра города. У каждого нотабля есть свой собственный тег точки спауна, и у каждого нотабля есть свои уникальные помощники (helper characters).



У всех нотаблей есть один родительский префаб с именем “sp_notables_parent” (, где parent - родитель). У каждого нотабля есть 1 дочерний комплект, так что родительский префаб имеет 5 дочерних комплектов.

Сценоделы должны разместить этот родительский префаб на видном месте в центре города. Кроме того, префаб должен быть легко виден игроку. После начала миссии логика игры активирует комплект нотаблей (notable set) в соответствии с нотаблями, стоящими в центре города.

В комплектах нотаблей каждый неотабль будет иметь уникального персонажа-помощника и его точку спауна. (телохранители для главаря грабителей, нотариус для торговца…).

На скриншоте ниже. В сцене имеется 2 родительских префаба (parent prefab). После начала миссии активируется один префаб для главаря грабителей и его телохранителей. Другой префаб активируется для торговца и его нотариуса.

Tip (Совет) : В каждом населенном пункте может быть не более 6, а в каждой деревне не более 3-х нотаблей. Таким образом, сценодел должен учесть это и разместить не менее 8 родительских префабов для сцен в центре города и разместить не менее 5 родительских префабов для деревенских сцен. А также в центре города есть 3 мастерских. У каждой мастерской должен быть 1 родительский префаб. Итак, для сцен в центре города необходимо добавить 8 + 3 (из мастерских) ~ 10 родительских префабов.

Warning (Предупреждение) : Все точки в комплектах нотаблей имеют повороты в соответствии с их анимацией захвата движения, поэтому не поворачивайте точки, иначе анимация не будет синхронизироваться.




Guards (Стража) :

Есть несколько праздно стоящих охранников и несколько патрулирующих. Патрулирующие охранники запрограммированы на перемещение из одной точки в другую, активируя следующую точку и деактивируя текущую.

Passages (Проходы) :

Сцена центра города должна включать в себя все проходы к другим сценам, таким как таверна, арена, зал лордов…

Battle Sets (Боевые комплекты\наборы) :

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

Townsfolk (Горожане) :

NPC постоянно перемещаются по городу. Чтобы разнообразить сцену, сценодел может захотеть использовать дополнительные префабы. Например, если в сцене есть “sp_npc_repair_set” (, где repair - ремонт), один NPC подойдет к этой точке и начнет стучать молотком, в то время как другой NPC будет жаловаться другу на ситуацию или в сцене могут быть нищие, просящие помощи у горожан.


                       2. Tavern Scene (Сцена в таверне) :

Player Spawn Point (Точка спауна игрока) :

Точка спауна игрока, “sp_player”, должна быть расположена рядом с проходом в центре города. Сцена должна включать в себя по крайней мере один префаб “sp_player_conversation” или более.

Warning (Предупреждение) : Масштаб (scale) префаба беседы не должен меняться.

Game Hosts (Gambler NPCs) :
          ( NPC игрок)

В каждой сцене таверны должен быть NPC игрок (предлагающий сыграть). Стул под таким NPC должен иметь теги “gambler_npc” и “npc_wait”. Стул, на который ГГ сядет, что бы присоединиться к игре, должен иметь теги “gambler_player” и “reserved” (“Зарезервировано”).


                  3. Lords Hall Scene (Сцена зала лордов) :

Player Spawn Point (Точка спауна игрока) :

Точка спауна игрока для сцены в зале лордов такая же, как и для сцены в таверне. Точка спауна игрока должна быть размещена рядом с проходом в центре города.


                    4. Village Scene (Деревенская сцена) :

Player Spawn Point (Точка спауна игрока) :

Деревенская сцена не имеет префаба “sp_player_outside”. Префаб “sp_player” нельзя размещать далеко от центра деревни и, в тоже время, очень близко. При спауне игрок должен издалека видеть идущих жителей деревни. Когда игрок входит в деревню через верхнюю правую панель сцены карты (меню деревни), игрок и говорящие с ним NPC будут созданы в префабе “sp_player_conversation”. Сцена должна иметь эти префабы более одного, чтобы увеличить вырианты места появления игрока.

Warning (Предупреждение) : Масштаб (scale) префаба беседы не должен меняться.

Notables (Нотабли) :

В сцене должны присутствовать некоторые нотабли. Чтобы их было легко найти, точки спауна должны быть размещены недалеко от центра деревни.

Villagers (Жители деревни) :

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

Common areas (Общие зоны) :

В каждой деревне есть 3 места общего пользования, которые не находятся в центре села. Внутри общей зоны можно использовать любой тип точек спауна. Префабы "common_area_NUMBER” должны быть размещены для указания области. К этим префабам прилагается скрипт с именем “CommonAreaScript”. У этого скрипта следующие параметры :

AreaRadius (Радиус области) : Художник может изменить этот параметр скрипта, чтобы увеличить или уменьшить площадь.
AreaIndex (Индекс площади) : Уже установлен в префабах для трех общих областей.
Type (Тип) : Тип области должен быть установлен из таблицы ниже :



Battle Spawnpoints (Точки спауна в бою) :

Если игра открывает сцену в боевым режиме. Будут инициированы Battle sets (боевые наборы\комплекты), и на каждом появятся боевые отряды. Боевые комплекты необходимо размещать далеко друг от друга и с учетом размера обороняющейся и атакующей сторон.

      Script Component Callbacks (Колбеки компонентов скрипта)
( http://docs.modding.bannerlord.com/authoring-mission-scenes/script-components/callbacks/ )

Колбеки компонентов скрипта перечислены ниже.

[Колбэк (от англ. callback) - или функция обратного вызова в программировании — передача исполняемого кода в качестве одного из параметров другого кода. Обратный вызов позволяет в функции исполнять код, который задаётся в аргументах при её вызове. Этот код может быть определён в других контекстах программного кода и быть недоступным для прямого вызова из этой функции. Некоторые алгоритмические задачи в качестве своих входных данных имеют не только числа или объекты, но и действия (алгоритмы), которые естественным образом задаются как обратные вызовы.]

Constructor (Конструктор) :

В конструкторе необходимо присвоить значения по умолчанию его общедоступным переменным (переменным, которые могут быть изменены создателем сцены). В конструкторе компонент скрипта (script component) не назначается ни объекту, ни сцене. Кроме того, вы не должны писать какую-либо логику, которая имеет побочный эффект, потому что, даже если он создан, компонент скрипта может быть удален после открытия сцены из-за обновления системы уровней (level system).

On Pre Init (При предварительной инициализации) :

Это вызывается после того, как компонент скрипта назначается его объекту-владельцу в сцене. Как только вы перейдете в этот колбэк, вы можете быть уверены,что определенные пользователем переменные из этого экземпляра скрипта установлены. Однако другие компоненты скриптов других объектов могут быть еще не назначены. Таким образом, в предварительной инициализации не должно быть никакого логического кода, который полагается на другие компоненты скрипта. Например, в pre-init ManagedObject регистрируется в массиве управляемых объектов в текущем экземпляре миссии.

On Init (При инициализации) :

Это вызывается после загрузки миссии и инициализации всех скриптовых компонентов объектов. Вы можете использовать любой тип логического кода внутри этого колбэка. Скрипты, созданные во время выполнения, также получают этот колбэк.

On Editor Init (При инициализации редактора) :

Редактированная версия на инициализации. Вызывается при загрузке сцены из редактора. Помните, что в редакторе нет ни миссии, ни игрового состояния.

On Tick (Пометка) :

Это вызывается для каждого компонента скрипта в каждом кадре миссии из одного и того же потока.

On Editor Tick (При редактировании отметки) :

Редактируемая версия помечена.

Is Only Visual (Только визуально) :

Если у вас есть компонент скрипта , который является только визуальным и не имеет никакого логического кода, который должен быть запущен на выделенном сервере, вы должны включить галочку true в этой функции. Это гарантирует, что этот тип скриптов не будет выполняться на выделенном сервере.

On Editor Variable Changed (При изменении переменной редактора) :

Это вызывается в редакторе всякий раз, когда пользователь изменяет общедоступную переменную в этом компоненте скрипта. Этот обратный вызов может использоваться для любого изменения состояния визуальной логики, если сценоделу нужна мгновенная обратная связь в редакторе сцен.

OnRemoved (При удалении) :

Вызывается при удалении объекта или компонента скрипта. Если у вас есть какие-либо выделенные объекты, которые хранятся где-то еще (например, статические контейнеры (static containers)), вы можете использовать этот колбэк, чтобы убедиться, что они не проникли в сцену.

       Spawn Point Debug Tool (Инструмент отладки точек спауна)
( http://docs.modding.bannerlord.com/authoring-mission-scenes/script-components/spawn_point_debug_tool/ )

Introduction (Вступление) :

Инструмент, который имеет префаб с именем “SpawnPointDebugView”, может быть добавлен в сцену. Prefab имеет прикрепленный скрипт “SpawnPointDebugView”, и этот инструмент можно открыть  с помощью inspector toggle (переключатель инспектора). Инструмент имеет 3 вкладки : “Scene basic information tab”, “Scene entity check tab” и “Navigation mesh check tab”.




1. Scene Basic Information Tab :
(Вкладка "Основная информация о сцене")

Эта вкладка пытается определить тип сцены, чтобы найти необходимые элементы; если обнаруженный тип неверен, сценодел может переопределить тип с помощью кнопок переключения ниже.


2. Scene Entity Check Tab
(Вкладка "Проверка объектов сцены")

Эта вкладка рассчитывает количество точек спауна и предупреждает художника, если их количество не входит в критерии сцены. Щелчок по кнопке “Count Entities”(“Подсчитать объекты”) и переключение категорий заполнит таблицу вычислений.. Переключатель “DONT USE”(“НЕ ИСПОЛЬЗОВАТЬ”) обозначит устаревшие объекты, которые сцена не должна включать. Последний столбец таблицы показывает, сколько агентов будет создано в текущих точках спауна.



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






3. Navigation Mesh Check Tab
(Вкладка "Проверка навигационных мешей")

Этот инструмент будет отмечать точки спауна, которые не находятся на навигационном меше или на навигационном меше, который будут отключен ‘Navigation Mesh Deactivator’(‘Деактиватором навигационного меша’). Если в сцене нет ‘Navigation Mesh Deactivator’, идентификатор деактивации будет равен 0, а вкладка проверки объекта сцены будет предупреждать художника о необходимости его размещения в сцене.
Нажатие кнопки “CHECK” (“Проверить”) и переключение категорий покажет отладочные линии на недопустимых точках спавна с цветом категории. Инструмент проверки навигационных мешей показывает точки спауна в соответствии с уровнем сцены. Каждый переключатель активирует 2 кнопки с именами “Previous” (“предыдущий”) и “Next” (“следующий”). Нажатие этих кнопок заставит камеру редактора фокусироваться на неуместных точках спавна одну за другой.



Эта вкладка также может проверять точки, которые не привязаны к миссии, но эта функция работает только в миссиях.

Tip (Совет) : Чтобы проверить точки, выходящие за пределы миссии, инструмент может быть активирован в миссии, если в текущей сцене есть префаб инструмента “SpawnPointDebugView” , вызываемый консольной командой “debug.mission_spawnpoint_count_and_mesh_checker_ui”.

Warning (Предупреждение) : Если вы видите несколько кнопок вкладок, значит в сцене более одного префаба “SpawnPointDebugView”. Удалите их.

Перевёл документацию по редактору сцен, скоро будет запощен на commando. Начал переводить раздел ASSET MANAGEMENT

Я на следующей неделе добью раздел Bannerlord Missions и тогда перевод конструктора будет полным.

Перевод статьи Scene Spawn Point Guide (Руководство по точкам спауна на сцене) выложен выше.

Выше выложил переводы статей :

Spawn Point Debug Tool (Инструмент отладки точек спауна)
Script Component Callbacks (Колбеки компонентов скрипта)

,за сим перевод раздела Bannerlord Missions завершен. На этом у меня все.