Интеграция грузовиков и аддонов. Часть 4
This guide describes the integration of Trucks and Addons. Part #4 of this guide covers tags and attributes used for description of Suspensions, Engines, Gearboxes, Wheels, and Addons (Chapters 9-14).
Гайд сообщества, переведённый на русский с mod.io.
Upd: ===========================================================
К сожалению, у нас возникли проблемы с обновлением веб-версии этого руководства из-за большого размера наших руководств (мы достигли максимального предела изображений для учетной записи и т. д.). Извините за это.
На платформе ПК те же руководства доступны в папке *установленной игры* в каталоге «...\en_us\Sources\BinEditor\Guides».
Или вы можете открыть папку с пакетом документации прямо из редактора SnowRunner™, выбрав «Справка» > «Руководства» в его главном меню.
Please refer to:
- Часть №1 этого руководства — общая информация о файлах моддинга (главы 1–4).
- Часть №2, посвященная общим аспектам структуры XML (главы 5–6).
- Часть №3 — описание тегов и атрибутов, используемых для сеток и грузовиков (главы 7–8).
В этой части описаны конкретные теги и атрибуты, используемые для подвесок, двигателей, коробок передач, колес и дополнений. Иерархия разделов ниже соответствует иерархии тегов.
ПРИМЕЧАНИЕ. При описании атрибутов мы будем отмечать обязательные атрибуты знаком *.
Если вам нужна автономная копия, вы можете скачать это полное руководство в формате PDF отсюда (на английском или русском языке).
9.
Корневой тег файла класса приостановок.
9.1.
Раздел, содержащий подвески. В этом разделе собран набор подвесок для всех осей грузовика.
- Name="ank_mk38_suspension_default" * Имя набора подвесок.
- UiName="ank_mk38_suspension_default" Имя пользовательского интерфейса приостановки. По умолчанию: "".
- DamageCapacity="200" Сумма допустимого урона. По умолчанию: 0. Диапазон значений: [0; 64000].
- CriticalDamageThreshold="0.4" Порог критического урона. По умолчанию: 0,7. Диапазон значений: [0; 0,999].
- BrokenWheelDamageMultiplier="2" Этот коэффициент отвечает за увеличение повреждения подвески при поломке колеса (спущенной шине). По умолчанию: 1. Диапазон значений: [0; 100]. Когда удар приходится на конкретное колесо и оно становится Сломанным, повреждение подвески умножается на этот коэффициент.
9.1.1.
Приостановка. Определяет взаимодействие колеса с грузовиком.
- WheelType="rear" * Тип колеса. Допустимые значения: спереди и сзади. В XML-файле грузовика он описывается атрибутом Location тега Wheel. См. раздел «8.1.2.1. <Колесо>».
- Высота="0,15" * Высота подвески. Смещение колеса по оси -OY относительно положения, заданного атрибутом Pos тега Wheel (в описании грузовика). См. раздел «8.1.2.1. <Колесо>». Диапазон значений: [-1000;1000].
- Strength="0,15" * Жёсткость подвески. Диапазон значений: [0; 1000].
- Damping="0.3" Damping.
- SuspensionMin="0.3" * Минимальный ход подвески. (Положение, которое может принять колесо при полном опускании подвески.). Диапазон значений: [-1000; 1000].
- SuspensionMax="0,3" Максимальный ход подвески. (Положение, которое может принять колесо, если подвеска находится в рабочем состоянии и ее жесткость равна нулю, когда колесо висит в воздухе). Значение по умолчанию: 1. Диапазон значений: [-1000; 1000].
- BrokenSuspensionMax="0.25" * Максимальный ход подвески при сломанной подвеске. Диапазон значений: [-1000; 1000].
9.1.1.1.
Информация о взаимодействии подвески с окружающей средой.
- Price="4200" Price.
- UnlockByExploration="false" Разблокируется ли объект при исследовании. То есть, если для этого параметра установлено значение «истина», подвеска будет заблокирована в Магазине, пока вы не найдете ее на карте. Значения: правда, ложь
- UnlockByRank="1" Разблокировка по рангу.
9.1.1.1.1.
- UiDesc="UI_SUSPENSION_DEFAULT_DESC" Описание приостановки. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
- UiName="UI_SUSPENSION_DEFAULT_NAME" Имя приостановки. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
10.
Корневой тег файла класса двигателей.
10.1.
- Name="ru_scout_old_engine_2" * Название движка.
- FuelConsumption="0,6" Расход топлива. По умолчанию: 0,5. Диапазон значений: [0; 100].
- DamageCapacity="120" Сумма допустимого урона. По умолчанию: 0. Диапазон значений: [0; 64000].
- CriticalDamageThreshold="0.9" Порог критического урона. По умолчанию: 0,7. Диапазон значений: [0; 0,999]. После этого порога изменяются расход топлива и мощность двигателя.
- DamagedConsumptionModifier="1.3" Максимальное значение изменения расхода топлива после отказа двигателя. По умолчанию: 1. Диапазон значений: [0,1; 32]. Если повреждение двигателя превысило DamageCapacity*CriticalDamageThreshold, то расход топлива начинает увеличиваться линейно, от FuelConsumption до FuelConsumption*DamagedConsumptionModifier (последнее значение соответствует ситуации, когда двигатель полностью сломан).
- EngineResponsiveness="0.04" Отзывчивость двигателя (скорость увеличения оборотов двигателя). По умолчанию: 0,04. Диапазон значений: [0,01; 1].
- Крутящий момент="40000" * Крутящий момент. По умолчанию: 0. Диапазон значений: [0; 1000000].
- DamagedMinTorqueMultiplier="1.0" Множитель крутящего момента, когда повреждение двигателя достигло порога CriticalDamageThresold. По умолчанию: 0. Диапазон значений: [0; 1].
- DamagedMaxTorqueMultiplier="0,7" Множитель крутящего момента, когда двигатель близок к полному выходу из строя. По умолчанию: 0. Диапазон значений: [0; 1]. После прохождения порога значение множителя линейно меняется с DamagedMinTorqueMultiplier на DamagedMaxTorqueMultiplier.
- BrakesDelay="0,5" Задержка торможения. По умолчанию: 0. Диапазон значений: [0; 1].
- MaxDeltaAngVel="0.01" * Ограничитель максимального углового ускорения колес. Чем он меньше, тем медленнее разгоняется автомобиль. По умолчанию: 0. Диапазон значений: [0; 1000000].
10.1.1.
Информация о взаимодействии двигателя с окружающей средой.
- Price="4200" Price.
- UnlockByExploration="false" Разблокируется ли объект при исследовании. То есть, если для этой опции установлено значение «истина», двигатель будет заблокирован в Магазине, пока вы не найдете его на карте. Значения: истина, ложь.
- UnlockByRank="1" Разблокировка по рангу.
10.1.1.1.
- UiDesc="UI_SUSPENSION_DEFAULT_DESC" Описание движка. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
- UiName="UI_SUSPENSION_DEFAULT_NAME" Имя движка. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
11.
Корневой тег файла класса коробки передач.
11.1.
- AWDConsumptionModifier="1.1" Коэффициент изменения расхода топлива при использовании полного привода. Значение по умолчанию: 1. Диапазон значений: [0; 32].
- CriticalDamageThreshold="0.5" Процент повреждения, после которого коробка начинает проявлять признаки неисправности: автомобиль время от времени начинает переключаться с определенных передач на нейтральную (см. MinBreakFreq и MaxBreakFreq ниже) и увеличивается расход топлива. Значение по умолчанию: 0,7. Диапазон значений: [0; 0,999].
- DamageCapacity="120" Сумма допустимого урона. Значение по умолчанию: 0. Диапазон значений: [0; 64000].
- DamagedConsumptionModifier="1.4" Модификатор максимального расхода топлива. Этот множитель используется для расчета расхода топлива при полной поломке коробки передач. Значение по умолчанию: 1. Диапазон значений: [0; 32].
- FuelConsumption="1.8" Базовый расход топлива коробки передач. Значение по умолчанию: 0,1. Диапазон значений: [0; 10].
- IdleFuelModifier="0.2" Множитель расхода топлива, когда автомобиль стоит на месте с работающим двигателем. Значение по умолчанию: 0,3. Диапазон значений: [0; 10].
- Name="g_scout_default" Имя коробки передач.
- MinBreakFreq="0.0" Минимальная частота переключения на нейтральную передачу в момент, когда прочность достигла CriticalDamageThreshold. См. CriticalDamageThreshold выше. Значение по умолчанию: 0. Диапазон значений: [0; 60].
- MaxBreakFreq="15.0" Максимальная частота переключения на нейтральную передачу, в момент, когда долговечность приближается к нулю. См. CriticalDamageThreshold выше. Значение по умолчанию: 0. Диапазон значений: [0; 60].
11.1.1.
Reverse Gear.
- AngVel ="2.0" Максимальная угловая скорость колеса при включенной передаче. Значение по умолчанию: 0. Диапазон значений: [0,1; 32].
- FuelModifier = "0.9" Множитель расхода топлива, когда эта передача активна. Значение по умолчанию: 1. Диапазон значений: [0; 10].
11.1.2.
High Gear. The “H” gear.
- AngVel ="2.0" Максимальная угловая скорость колеса при включенной передаче. Значение по умолчанию: 0. Диапазон значений: [0,1; 32].
- FuelModifier = "0.9" Множитель расхода топлива, когда эта передача активна. Значение по умолчанию: 1. Диапазон значений: [0; 10].
11.1.3.
Механизм. Этих меток столько, сколько передач имеет коробка передач.
- AngVel ="2.0" Максимальная угловая скорость колеса при включенной передаче. Значение по умолчанию: 0. Диапазон значений: [0,1; 32].
- FuelModifier = "0.9" Множитель расхода топлива, когда эта передача активна. Значение по умолчанию: 1. Диапазон значений: [0; 10].
11.1.4.
Информация о взаимодействии коробки передач с окружающей средой.
- Price="4200" Price.
- UnlockByExploration="false" Разблокируется ли объект при исследовании. То есть, если для этого параметра установлено значение «истина», коробка передач будет заблокирована в Магазине, пока вы не найдете ее на карте. Значения: истина, ложь.
- UnlockByRank="1" Разблокировка по рангу.
11.1.4.1.
Наличие шестерен в коробке передач.


- IsHighGearExists="истина" «H». Если false, кнопка неактивна (тег
в этом случае не имеет смысла). Значение по умолчанию: правда.

- IsLowerPlusGearExists="true" «L+». Первая передача (первый тег
в порядке появления в XML). Если false, кнопка неактивна. Значение по умолчанию: правда.
- IsLowerGearExists="истина" «L». Максимальная угловая скорость 0,45* AngVel от первой передачи (см. атрибут IsLowerPlusGearExists выше). Если false, кнопка неактивна. Значение по умолчанию: правда.
- IsLowerMinusGearExists="true" «L-». Максимальная угловая скорость 0,2* AngVel от первой передачи (см. атрибут IsLowerPlusGearExists выше). Если false, кнопка неактивна. Значение по умолчанию: правда.
11.1.4.2.
UI block.
- UiDesc="UI_GEARBOX_SCOUT_DEFAULT_DESC" Описание коробки передач. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
- UiName="UI_GEARBOX_SCOUT_DEFAULT_NAME" Имя коробки передач. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
12.
Корневой тег файла класса колеса, если колесо представляет собой единый объект. Этот тег используется для колес, у которых шина и обод представляют собой единое целое.
- Mesh="wheels/trailer_sideboard_2" Путь к Fbx-файлу колеса.
- Mass="100" Mass of the wheel.
- Radius="0.594" Радиус колеса, который используется для создания цилиндра столкновения в Havok. Описанное таким образом колесо невозможно масштабировать. Следовательно, этот радиус должен совпадать с внешним радиусом шины в файле Fbx.
- Ширина = "0,44" Ширина. Этот параметр используется для создания цилиндра столкновения в Havok, для определения области прилипания грязи к протектору шины и для определения ширины колеи. Указанная ширина должна соответствовать ширине проступи в файле Fbx.
- DamageCapacity="50" Размер разрешенного урона. Диапазон значений: [0; 64000].
12.1.
Tracks of tires.
- TextureAlpha="tracks/default_alpha__s_d.tga" Путь к карте колеи колеса относительно папки .../textures/.
- TextureHeight="tracks/default_height__s_d.tga" Путь к карте нормалей глубины впадины относительно папки .../textures/.
12.2.
Softness of Tires.
- RadiusOffset="0.02" * Радиус объекта столкновения колеса равен разнице между радиусом колеса (параметр Radius, указанный в теге
) и этим смещением (RadiusOffset). Значение по умолчанию: 0. Диапазон значений: [0; 0,25].
- SoftForceScale="0.32" * Множитель импульса тела при столкновении с другими объектами столкновения. Значение по умолчанию: 1. Диапазон значений: [0,1; 1].
12.3.
Friction of the wheel.
- BodyFriction="3" * Трение с почвой, с голой местностью без грязи и с другими объектами столкновения. Значение по умолчанию: 1. Диапазон значений: [0,1;10].
- BodyFrictionAsphalt="1.5" Трение с дорогой. Значение по умолчанию: BodyFriction. Диапазон значений: [0,1;10].
- SubstanceFriction="1.2" * Трение о грязь. Значение по умолчанию: 1. Диапазон значений: [0;10].
- IsIgnoreIce="true" Следует ли игнорировать ледяные поверхности. Например, этот параметр используется для шин с цепями.
13.
Корневой тег файла класса типа колеса, если колесо представляет собой набор шин и дисков. Тип колеса, состоящего из нескольких взаимозаменяемых шин и дисков.
- DamageCapacity="50" * Сумма допустимого урона. Диапазон значений: [0; 64000].
- Radius="1" * Радиус колеса. Он должен соответствовать внешнему радиусу шины в файле Fbx. Это радиус объекта столкновения колеса в Havok. Рекомендуем делать колеса радиусом 1 метр. В этом случае при установке колеса на грузовик значение параметра Scale из тега
будет соответствовать желаемому радиусу колеса для конкретного грузовика. См. раздел «8.1.23. <Совместимые колеса>».
- Ширина="0,58" * Ширина колеса. Указанная ширина должна соответствовать ширине проступи в файле Fbx. Это высота ударного цилиндра колеса в Havok. Он используется для определения области прилипания грязи к протектору шины и определения ширины колеи.
- RadiusRear="1.2" Радиус заднего колеса. Он должен соответствовать радиусу сетки заднего колеса с именем «tire_back». По умолчанию то же самое, что и Радиус.
- WidthRear="1.2" Ширина заднего колеса. Она должна соответствовать ширине сетки заднего колеса с именем «tire_back». По умолчанию это то же самое, что и Ширина.
13.1.
Section that describes tires.
13.1.1.
Шина. Одна шина или пара передних и задних шин.
- Mesh="wheels/tire_medium_highway_double_1" * Путь к Fbx-файлу шины.
- Name="highway_2" * Название шины. Это имя будет отображаться в меню отладки. Он также используется для определения шин грузовика по умолчанию.
- Mass="100" * Масса колеса.
- RearMassScale="2" Масштаб массы заднего колеса. Используя этот параметр, вы можете сделать сдвоенные задние колеса тяжелее, чем одинарные передние.
13.1.1.1.
Следы колес. Колеи передних и задних шин могут быть разными. Таким образом, этот тег можно использовать дважды для одного тега
- TextureAlpha="tracks/default_alpha__s_d.tga" Путь к карте колеи колеса относительно папки .../textures/.
- TextureHeight="tracks/default_height__s_d.tga" Путь к карте нормалей глубины впадины относительно папки .../textures/.
- Rear="true" Флаг, указывающий, что гусеницы принадлежат задним колесам.
13.1.1.2.
Все атрибуты аналогичны атрибутам тега WheelSoftness колеса как единого объекта. См. раздел «12.2.
13.1.1.3.
- BodyFriction, BodyFrictionAsphalt, SubstanceFriction, IsIgnoreIce — это то же самое, что и соответствующие атрибуты тега WheelFriction колеса как единого объекта. См. раздел «12.3.
». - UiName="UI_TIRE_TYPE_OFFROAD_NAME" Название типа шин в пользовательском интерфейсе. Это поле связывает эту шину с одной из категорий шин в пользовательском интерфейсе (в Ангаре). Значение этого поля не может быть произвольным. Это должно быть одно из следующих предопределенных значений: UI_TIRE_TYPE_HIGHWAY_NAME – шоссейные шины.
- Ui_tire_type_allterrain_name – вездеходные шины
- Ui_tire_type_offroad_name – внедорожные шины
- Ui_tire_type_chains_name – шины с цепью
- Ui_tire_type_mudtires_name – грязевые шины
13.1.1.4.
Информация о взаимодействии шины с окружающей средой.
- Price="4200" Price.
- UnlockByExploration="false" Разблокируется ли объект при исследовании. То есть, если для этого параметра установлено значение «истина», эта шина будет заблокирована в Магазине, пока вы не найдете ее на карте. Значения: правда, ложь
- UnlockByRank="1" Разблокировка по рангу.
13.1.1.4.1.
UI block.
- UiDesc="UI_TIRE_HIGHWAY_DESC" Описание шины. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
- UiName="UI_TIRE_HIGHWAY_DOUBLE_1_NAME" Название шины. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
13.2.
Section that describes rims.
13.2.1.
Один обод или пара ободков.
- Mesh="wheels/rim_medium_highway_allterrain_double_1" * Путь к Fbx-файлу обода.
- Name="rim_1" * Имя обода. Это имя будет отображаться в меню отладки. Он также используется для определения колесных дисков грузовика по умолчанию.
13.2.1.1.
Информация о взаимодействии обода с окружающей средой.
- Price="4200" Price.
- UnlockByExploration="false" Разблокируется ли объект при исследовании. То есть, если для этой опции установлено значение «истина», этот обод будет заблокирован в Магазине, пока вы не найдете его на карте. Значения: истина, ложь.
- UnlockByRank="1" Разблокировка по рангу.
13.2.1.1.1.
UI block.
- UiDesc="UI_RIM_MEDIUM_DOUBLE_1_DESC" Описание обода. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
- UiName="UI_RIM_MEDIUM_DOUBLE_1_NAME" Имя обода. ПРИМЕЧАНИЕ. Вы можете просто поместить свой текст в этот атрибут XML в двойных кавычках (например, вы можете указать в качестве значения «Здесь некоторый текст»). Или вы можете использовать здесь строковый идентификатор (например, «UI_STRING_IDENTIFIER») и локализовать значение этого поля на разные языки. Подробности смотрите в руководстве «UiName & UiDesc: имена, описания и их локализация».
14.
Корневой тег файла класса дополнения.
14.1.
Обзорная секция запасных колес.
14.1.1.
Таких тегов может быть несколько.
- Frame="wheel1" Имя сетки, определенное в файле Fbx.

- HideThreshold="0.4" Порог скрытия. В процентах. Использование: Учтите, что количество запасных колес в теге TruckData равно двум (WheelRepairsCapacity="2"). В этом случае, чтобы скрыть два колеса по мере их расходования, вам потребуется: -- для одного Mesh-тега указать любое значение HideThreshold в полуинтервале [0.5; 1). -- для второго тега Mesh укажите значение в полуинтервале [0; 0,5). Если в этом примере вы укажете значение 0,4, то сетка Wheel1 будет скрыта, когда оба запасных колеса израсходованы.
14.2.
Секция видимости ремонтного комплекта.
14.2.1.
Похоже на: WheelRepairsHide. См. 14.1.1. выше.
14.3.
Секция для обзора съемных топливных баков.
14.3.1.
Похоже на: WheelRepairsHide. См. 14.1.1. выше.
14.4.
Свойства самого аддона (не связанные с поведением костей).
- FuelCapacity="100" Запас топлива.
- RepairsCapacity="150" Количество ремонтного комплекта.
- WheelRepairsCapacity="3" Количество запасных колес.
14.4.1.
См. раздел «8.1.10. <Шейкеры>» части №3 настоящего руководства.
14.4.2.
См. раздел «8.1.15. <Всасывание>» части №3 настоящего руководства.
14.4.3.
См. раздел «8.1.14.
14.4.4.
Изменение параметров урона грузовика при установке аддона.
14.4.4.1.
Damage multiplier.
- Множитель="0,8" Множитель. Значение по умолчанию: 1. Диапазон значений: [0; 10].
- Тип="Тип двигателя". Значения: Двигатель, Топливный бак.
14.5.
См. раздел «8.2. <Шноркель>» в части №3 данного руководства.
14.6.
См. раздел «8.3. <Ротатор>» в части №3 данного руководства.
Описание тегов и атрибутов, используемых для создания пользовательских скинов и раскрашивания, см. в части №5 данного руководства.