RnR Wiki - Вклад участника [ru]

B3D (формат файлов)

2026-02-12T17:35:07Z

Aleko 2144: /* Блок типа 34 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

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

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int paramsCount;
<float[paramsCount]>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Светящиеся точки (34)==
Vector4 nodePosition;
int unk_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
//позиция
float x;
float y;
float z;
//цвет
uint8 B;
uint8 G;
uint8 R;
uint8 A?;
};

Хранит в себе светящиеся точки, которые всегда рисуются размером в 1 пиксель на экране. Данный функционал полноценно работает только в версиях 4.0 - 5.5. В остальных точки отображаются только чёрным цветом.

<gallery>
HT2_55_b3d_type34glow.jpg|Подсветка моста на трассе "Бухта-Нижнегорск" в версии 5.5.
</gallery>

==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Приложения =
==Типы коллизий==
Параметры типов коллизий блоков 12 и 23.

===Коэффициенты===
{| class="wikitable"
|-
! тип !! коэффициент потери угловой скорости !! коэффициент потери линейной скорости !! коэффициент трения !! комментарии
|-
| 1 || 0,05 || 0,10 || 0,60 ||
|-
| 2 || 1,50 || 0,20 || 0,55 ||
|-
| 3 || 3,00 || 0,30 || 0,30 ||
|-
| 4 || 0,60 || 0,30 || 0,30 ||
|-
| 5 || 0,05 || 0,10 || 0,45 ||
|-
| 6 || 1,00 || 0,20 || 0,45 ||
|-
| 7 || 0,60 || 0,20 || 0,30 ||
|-
| 8 || 0,60 || 0,30 || 0,45 || уничтожает грузовик
|-
| 9 || 1,00 || 0,40 || 0,20 ||
|-
| 10 || 0,05 || 0,10 || 0,60 ||
|-
| 11 || 1,50 || 0,20 || 0,45 ||
|-
| 12 || 5,00 || 5,00 || 0,00 ||
|-
| 13 || 5,00 || 5,00 || 0,00 || уничтожает шины
|}

===Эффекты===
{| class="wikitable"
|-
! тип !! следы от шин !! грязь при пробуксовке колёс !! цвет грязи !! пыль !! звук воды при движении
|-
| 1 || + || || || ||
|-
| 2 || + || + || чёрный || ||
|-
| 3 || + || || || ||
|-
| 4 || || || || || +
|-
| 5 || + || || || ||
|-
| 6 || || + || зелёный || + ||
|-
| 7 || || || || || +
|-
| 8 || || || || ||
|-
| 9 || || || || || +
|-
| 10 || || || || + ||
|-
| 11 || || || || + ||
|-
| 12 || || || || ||
|-
| 13 || || || || ||
|}

==Варианты переключателей типа 21==
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

===Объекты игрового мира===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| Faza8Key || Используется для анимаций
|-
| StartKey || неизвестно
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

===Повреждения автомобилей===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

===Переключатели светотехники===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

===Другие автомобильные переключатели===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|-
| TestKey || 5 || Используется для отладки и хранит данные для отрисовки коллизий транспорта
|-
| CollisionKey || 3 || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || 2 || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || 2 || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || 4 || Свечение сигнальных ламп радара
|}

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

Файл:HT2 55 b3d type34glow.jpg

2026-02-12T17:24:29Z

Aleko 2144:

Станции технического обслуживания

2026-01-25T12:55:43Z

Aleko 2144: Добавил информацию про форсированный мотор и присадку

[[Категория:Дальнобойщики 2]]
[[Файл:GreyStoneRepair.jpg|300px|thumb|right|СТО в Алмазном]]
'''Станции технического обслуживания (СТО)''' — авторемонтные мастерские в игре [[Дальнобойщики 2]], в которых можно отремонтировать свой транспорт, а также улучшить его.

== Общая информация ==
Всего в игре 23 СТО, между каждым населённым пунктом есть хотя бы один сервис. В игровом мире мастерские расположены довольно неравномерно, наибольшая концентрация на участке трассы [[Приозёрск]] — [[Бухта]] — 7 штук, в то время как между другими населёнными пунктами их, как правило, не больше двух.

Функции СТО - это, во-первых, восстановление повреждённых или изношенных узлов автомобиля до состояния новых, а во-вторых, установка улучшений. Техническое состояние агрегатов машины и наличие улучшений напрямую влияет на ходовые и эргономические характеристики машины.

== Ремонт автомобиля ==

=== Ремонт повреждений ===

В результате столкновений автомобиль получает повреждения, требующие ремонта. При сильных повреждениях машина начинает заметно хуже ехать, а разбитые фары не могут освещать дорогу. Тариф на ремонт на всех СТО одинаков (в отличие от стоимости топлива на разных АЗС). На СТО происходит оплата только за сам ремонт, в отличие от помощи других водителей или вызова 911, которым помимо стоимости ремонта нужно заплатить дополнительно $500 и $1000 соответственно за сам факт вызова, т.к. вызов можно совершить в любом месте карты, а на СТО нужно доехать своим ходом. В дополненном издании версий 8.х в режиме "Симулятор" для ремонта нужно остановиться под крытой частью СТО, нажать "+" и в появившемся меню выбрать, что именно отремонтировать. Во всех более ранних изданиях (7.х и ниже), а также в режиме "Аркадный" в версиях 8.х, полный ремонт при проезде под крытой частью СТО происходит автоматически на любой скорости без необходимости останавливаться - при наличии необходимой суммы денег на счету. Если средств на полный ремонт не достаточно, то в версиях 8.х можно выбрать в меню только некоторые наиболее важные агрегаты, которые нуждаются в ремонте в первую очередь; в более ранних изданиях такая возможность не предусмотрена.

=== Восстановление изношенных шин и тормозов ===

В процессе эксплуатации автомобиля происходит изнашивание шин и тормозов, что также снижает ходовые качества машины. При износе шин сильно ухудшается манёвренность автомобиля, особенно на высокой скорости, а тормозов - эффективность торможения. Причём, эффективность и износостойкость тормозов можно увеличить за счёт соответствующих улучшений, так чтобы менять их приходилось реже, а вот износостойкость шин улучшить нельзя (в отличие от 1 части "Дальнобойщиков") и изнашиваются они сами по себе быстрее. Поэтому заменять их нужно довольно часто.
Посмотреть состояние шин и тормозов можно на F3. Только эти два параметра ухудшаются сами по себе в процессе эксплуатации, а любые другие узлы автомобиля портятся только в результате столкновений (за исключением подержанных автомобилей - в них есть скрытые дефекты, которых вначале не видно, но они проявляются в процессе эксплуатации сами по себе даже без попадания в аварии). Необходимость замены шин и тормозов не сразу очевидна по той причине, что их износ не влияет на стоимость автомобиля и на общий показатель технического состояния на верхней панели. Даже при полностью стёртых протекторах или тормозных колодках никакой сигнализации о необходимости их замены не появится.
* В версиях игры до 7.х, где нет расширенных возможностей ремонта, замена шин и тормозов происходит автоматически вместе с остальным ремонтом. Причём, если другие повреждения автомобиля отсутствуют, то и изношенные шины и тормоза не заменяются сами (это могут заметить только аккуратные водители, которые могут долго ездить без столкновений и повреждений). Тогда, для их восстановления можно просто поставить и тут же снять какое-либо улучшение для шин и тормозов (в отличие от 1 части игры, где убрать улучшения было нельзя, кроме замены всей машины на новую без улучшений).

=== Восстановление подержанного автомобиля ===

Если вы купили подержанный автомобиль, то сразу после покупки он будет вести себя как новый, но через некоторое время агрегаты, имевшие скрытые дефекты, начнут ломаться, существенно ухудшая ходовые качества машины.
Автомобиль с пробегом можно восстановить (отремонтировать) до состояния нового. Причём, если это сделать сразу, до выявления скрытых дефектов, то ремонт обойдётся дешевле, чем когда скрытые дефекты уже начали проявляться.
Восстановить подержанный автомобиль сразу можно через помощь нейтральных водителей по рации. СТО и служба 911 восстанавливают автомобиль, только если скрытые дефекты уже проявились.
* В версиях 8.х добавлена возможность на СТО сразу восстанавливать автомобиль с пробегом, не дожидаясь поломок - для этого нужно выбрать "Полный ремонт" и оплатить его, даже если изначально стоимость восстановления показана не будет.

=== Установка улучшений ===

На СТО можно поставить различные улучшения, повышающие качество вашего автомобиля. Стоимость каждого улучшения одинакова на всех СТО вне зависимости от типа и марки автомобиля. Любое улучшение можно когда угодно снять с автомобиля (если в текущем СТО производят установку данной детали) и получить обратно деньги, потраченные на него в полном объеме. При продаже усовершенствованного автомобиля в его стоимость также входят всё средства, потраченные на апгрейд.
В версиях игры до 7.х при заезде на СТО автоматически высвечивается меню улучшений, установку которых данный сервис производит. В версиях игры 8.х для открытия такого меню неободимо нажать "+", ввиду того, что в этих версиях меню значительно расширено и занимает больше места.

== Список усовершенствований ==
В ранних зарубежных изданиях игры версий 4.х-5.х изначально было представлено 15 улучшений.

В российских релизных версиях игры версий 6.х-7.х был добавлен Антирадар, а стоимость некоторых улучшений увеличилась от 1.5 до 3 раз, полный пакет стал дороже почти в 1.5 раза.

В Дополненном издании версий 8.х были добавлены Воздухозаборник, Защита фар и Радар глушитель, а Антирадар был переименован в Радар детектор; стоимость большинства улучшений возросла в 2-8 раз в сравнении с версиями 7.х, полный пакет стал дороже в 3.5 раза в сравнении с 7.х и в 5 раз в сравнении с 5.х.
Подорожания полного пакета связаны не только с ростом цен, но и с добавлением новых позиций.

Ниже приведена таблица с кратким описанием и стоимостью каждого апгрейда.
<div align="left">
{| class="wikitable"
|-
! Модернизация !! Описание!! Стоимость, $ в версиях 8.х !! 7.x !! 5.x
|-
| Пневмоподвеска || Лучше сохраняет хрупкий груз || 8700 || 1000 || 1000
|-
| Вентилируемый тормоз || Увеличивает эффективность торможения || 4500 || 1500 || 1000
|-
| Тормоз двигателем || Снижает износ тормозов || 4600 || 700 || 700
|-
| Усиленная рама || Увеличивает прочность рамы и кузова || 7800 || 2500 || 2500
|-
| Бронированные стёкла || Защищает от пуль || 1000 || 500 || 500
|-
| Защита фар || Уменьшает вероятность повреждения фар || 900 || -отсутствует- || -отсутствует-
|-
| Форсированный двигатель || Увеличивает максимальный крутящий момент на 40% || 12500 || 5000 || 3000
|-
| Присадка в двигатель || Снижает расход топлива на 20% || 90 || 20 || 20
|-
| Воздухозаборник || Позволяет немного глубже заехать в воду || 500 || -отсутствует- || -отсутствует-
|-
| Шины High-way || Повышают скорость и устойчивость на шоссе, снижают проходимость по бездорожью || 2000 || 2000 || 1000
|-
| Шины Вездеход || Повышают проходимость по бездорожью, снижают скорость и устойчивость на шоссе || 1500 || 1500 || 500
|-
| Дополнительный бак || Вдвое увеличивает запас топлива || 500 || 100 || 100
|-
| АБС || Уменьшает заносы при торможении || 3000 || 1000 || 1000
|-
| Радар детектор || Предупреждает о стационарном радаре или стоящей на обочине машине милиции || 1200 || 2000 || -отсутствует-
|-
| Радар глушитель || Все радары перестают замечать вашу машину || 11500 || -отсутствует- || -отсутствует-
|-
| Сканер груза || Указывает на не новую машину или нелегальный груз. Пищит, если нелегальный груз уже загружен || 5400 || 3000 || 3000
|-
| Пожарная система || Тушит возгорание двигателя || 4200 || 800 || 800
|-
| Навигатор || Показывает направление поворота на развилках, пищит, если сбиться с маршрута || 2500 || 300 || 300
|-
| Сигнал || Непрерывный гудок, выразительнее стандартного || 550 || 150 || 150
|-
! Итого !! Установить всё !! 72940 !! 20570 !! 15070
|}
</div>

В большинстве СТО можно установить не все апгрейды, а лишь доступные в данном СТО. В следующей таблице указано, где и какие улучшения можно установить в Дополненном издании версий 8.х. В более ранних версиях ассортимент некоторых мастерских несколько отличается, ввиду иного количества апгрейдов. СТО пронумерованы в соответствии с картой<ref>[http://rnr-wiki.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:SuperCargoMap.jpg Карта скрытых грузов] — СТО пронумерованы так же, как на этой карте</ref>.
[[Файл:RepairMap.jpg|500px|thumb|left|Карта расположения СТО]]
<div align="left">
{| class="wikitable"
|-
! Модернизация/Наличие в СТО !! 00 !! 01 !! 02 !! 03 !! 04 !! 05 !! 06 !! 07 !! 08 !! 09 !! 10 !! 11 !! 12 !! 13 !! 14 !! 15 !! 16 !! 17-1 !! 17-2 !! 18 !! 19 !! 20 !! А
|-
| Пневмоподвеска || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}}
|-
| Вентилируемый тормоз || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Тормоз двигателем || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}}
|-
| Усиленная рама || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}}
|-
| Бронированные стёкла || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}}
|-
| Защита фар || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}}
|-
| Форсированный двигатель || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Присадка в двигатель || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}}
|-
| Воздухозаборник || {{No}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}}
|-
| Шины High-way || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Шины Вездеход || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Дополнительный бак || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}}
|-
| АБС || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Радар детектор || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Радар глушитель || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}}
|-
| Сканер груза || {{No}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}}
|-
| Пожарная система || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{No}}
|-
| Навигатор || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Сигнал || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{No}}
|-
! Итого, $ !! 34500 !! 72940 !! 35140 !! 52850 !! 53200 !! 41000 !! 43650 !! 54550 !! 16290 !! 54390 !! 58840 !! 72940 !! 38340 !! 20300 !! 39101 !! 53802 !! 39203 !! 55044 !! 70395 !! 50696 !! 38040 !! 62106 !! 24300
|}
</div>
Проще всего найти в ассортименте мастерских навигатор — его устанавливают в 20-ти СТО. Реже всего попадается воздухозаборник — 7 раз. Самый бедный на детали сервис — рядом с [[Алмазный|Алмазным]] — всего лишь 4 наименования. В СТО 01 (в Бухте) и 11 (слева от [[Кольцо|Кольца]]) устанавливают все апгрейды, имеющиеся в игре. Учитывая скорости передвижения по игровому миру, для того чтобы установить все улучшения на автомобиль разом лучше сразу ехать в один из этих сервисов, чем собирать полный комплект по частям.

Помимо довольно важных усовершенствований, увеличивающих скорость, управляемость и прочность транспорта, есть и не очень полезные — Воздухозаборник, Радар детектор, Навигатор и Сигнал. 
* Первый совсем немного увеличивает глубину, на которую может погрузиться автомобиль, но кардинально это мало что меняет (чуть глубже заехал - и "восстановлению не подлежит").
* Радар детектор вовремя замечает только стоящие на обочине патрули (да и за превышение те штрафуют не во всех версиях). Перед стационарным радаром детектор срабатывает слишком поздно, поэтому на высокой скорости (выше 100 км/час) притормозить и избежать штрафа почти невозможно. К тому же, у него не очень приятный звук, который будет особенно доставать в западной части региона, где очень много радаров и патрулей.
* Навигатор мало полезен по той причине, что дорогу указывает строго по полосе (коллизии), хотя по факту часто бывает можно и нужно например срезать повороты по обочине (чего навигатор не понимает и будет предлагать вернуться строго на полосу). Маршрут указывает только по официальным дорогам — даже известные игроку (и уже отмеченные на карте) срезки игнорируются.
* Сигнал же вовсе не несёт никакой функции, а лишь изменяет тон гудка автомобиля. Можно использовать для выделения машин своей компании из толпы (управляемые AI автомобили любят погудеть), если логотипа, по мнению игрока, недостаточно. 
Также довольно сомнительная польза от системы пожаротушения, ведь если ваша машина повреждена настолько, что уже загорелся двигатель, вряд ли вы сможете дальше ехать своим ходом и тем более уйти от дальнейшего обстрела, т.е. для быстрого ремонта нужно вызывать 911 (или помощь водителя). Ведь толку от просто потушенного пожара не много, если машина почти не может дальше ехать. К тому же, если даже денег на вызов помощи не достаточно, то тушение пожара при вызове происходит просто бесплатно (но уже без ремонта машины).

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

== Интересные факты ==
* Если остановиться в СТО на виду у конкурента, тот встанет сзади и будет сигналить, пока не освободить ему путь.
* На скриншотах дорелизных версий игры можно увидеть как минимум 3 различных варианта СТО (не считая финальный).
* Описание любого апгрейда при желании можно изменить в файле mess.txt, находящемся в корневой папке игры, цены — в файле [[sch-файлы#restable.sch|restable.sch]] в той же папке.
* Установленный радар детектор будет виден в салоне, сигнал — снаружи на кабине. Остальные апгрейды (даже воздухозаборник и дополнительный бак) внешний вид машины не изменяют.
* Описание апгрейдов "Вентилируемый тормоз" и "Тормоз двигателем", вероятно, перепутано, т.к. на самом деле вентилируемый тормоз уменьшает температуру тормозных дисков, что снижает износ колодок, а торможение двигателем создаёт дополнительное тормозное усилие, повышая эффективность торможения. Хотя и "перепутанное" описание отчасти тоже справедливо, т.к. эти параметры взаимосвязаны: чем меньше износ, тем выше эффективность.

== Галерея ==
<gallery>
Файл:RepairEng.jpg|СТО и меню апгрейда в версии 5.5
Файл:СТО Южный.png|Меню апгрейда в версии игры 7.4
Файл:Repair8.1.jpg|Меню апгрейда и ремонта в версии 8.1
Файл:RepairBeta1.jpg|СТО из версий 1998-1999 годов
Файл:RepairBeta2.jpg|Ещё один вариант старого СТО
Файл:RepairBeta3.jpg|Альтернативный вид СТО из версии 5.5
Файл:RepairBeta4.jpg|То же, только ночью
</gallery>

{{Игровой_регион_(Дб2)}}

== Примечания ==

Шаблон:Дб3

2026-01-07T09:32:27Z

Aleko 2144: добавил ссылку на утилиты

{| class="wikitable" width="100%"
!colspan=3 style="background-color:#C6D1D1"|[[Дальнобойщики 3: Покорение Америки]]
|-
|style="background-color:#C6D1D1; text-align:right; width: 15%"|'''''Игровое наполнение'''''
|[[Игровой регион (Дальнобойщики 3)|Игровой регион]] • [[Автопарк_(Дальнобойщики_3)|Автопарк]] • [[Побочные задания (Дальнобойщики 3)|Побочные задания]] • [[Саундтрек_(Дальнобойщики_3)|Саундтрек]]
|rowspan="3" style="width: 10%"|
[[Файл:D3_jewel_cover.jpg|160px|безрамки|центр]]
|-
|style="background-color:#C6D1D1; text-align:right"|'''''Аддоны и издания'''''
|[[Дальнобойщики_3:_Большие_Гонки|Большие Гонки]] • [[Дальнобойщики_3:_Лас-Вегас|Лас-Вегас]] • [[Gold Edition]]
|-
|style="background-color:#C6D1D1; text-align:right"|'''''Разное'''''
|[[Дальнобойщики_3:_Покорение_Америки#История_версий|История версий]] • [[Советы_и_секреты_(Дальнобойщики_3)|Советы и секреты]] • [[Модификации_(Дальнобойщики_3)|Модификации]] • [[Утилиты_(Дальнобойщики_3)|Утилиты]] • [[Авторы (Дальнобойщики 3)|Авторы]]
|}

<noinclude>
==Код для вставки==
<pre>{{Дб3}}</pre>
</noinclude>

Модификации (Дальнобойщики 3)

2025-12-13T13:00:45Z

Aleko 2144: Добавил категорию

[[Категория:Дальнобойщики_3]]
[[Категория:Моддинг (Дальнобойщики 3)]]
'''Модификации для игры "Дальнобойщики 3"''' бывают как текстурные, так и программные. Общее количество модификаций небольшое - народ неактивно занимается моддингом игры.

== Создание текстурных модификаций ==
Для начала, [https://yadi.sk/d/V3MgyWO0UhCWb скачайте] программу wdbTexture. Перед началом работы с программой рекомендуется создать резервную копию модифицируемого wdb-файла.

*Чтобы распаковать wdb-архив, создайте ярлык wdbTexture на рабочем столе, затем переместите на него нужный wdb-файл. Программа создаст папку в том же каталоге, где расположена и распакует туда текстуры.
*Для того, чтобы запаковать wdb-архив, переместите на ярлык программы нужное изображение в формате bmp.
'''Важно! Сначала убедитесь, что:'''

* '''Исходный wdb-файл расположен в одной папке с wdbTexture.exe;'''

* '''Имя и размер модифицированного изображения идентичны оригиналу;'''

* '''Модифицированное изображение 32-x битное.'''

== Готовые модификации ==

{| class="wikitable"
|-
|RnR MOD||[http://rnrmm.ru/publ/mods/rnr_mod/rnr_mod_v2_7/8-1-0-7 Скачать]
|-
|Weather MOD||[http://rnrmm.ru/publ/mod_manager_2_mods/rains_mods/weather_mod/10-1-0-9 Скачать]
|}

'''Внимание! Для установки следующих модификаций требуется ЛИЦЕНЗИОННАЯ НЕ-STEAM версия игры вместе с установленным дополнением "Большие гонки".'''

{| class="wikitable"
|-
|BgPlus 2.5||[http://rnrmm.ru/publ/mod_manager_mods/v_1_4_53_143/bgplus_2_5/2-1-0-1 Скачать]
|-
|BgPlus 3.0||[http://rnrmm.ru/publ/mod_manager_2_mods/victorsmods/bgplus_3_0/5-1-0-6 Скачать]
|-
|BgPlus 4||[http://bgplus.rnrmm.ru/index/russian/0-6 Скачать]
|}

{{Дб3}}

Категория:Моддинг (Дальнобойщики 3)

2025-12-13T13:00:08Z

Aleko 2144: Новая страница: «Категория:Дальнобойщики_3»

[[Категория:Дальнобойщики_3]]

Утилиты (Дальнобойщики 3)

2025-12-13T12:59:14Z

Aleko 2144: Новая страница: «Категория:Дальнобойщики_3 Категория:Моддинг_(Дальнобойщики_3) '''На данной странице п…»

[[Категория:Дальнобойщики_3]]
[[Категория:Моддинг_(Дальнобойщики_3)]]
'''На данной странице представлены утилиты для работы с файлами игры [[Дальнобойщики_3:_Покорение_Америки|Дальнобойщики 3]].'''

== Работа с текстурами (формат WDB) ==
{| class="wikitable" width="100%"
|-
! Название !! Замечания !! Автор !! Скачать
|-
|style="width: 15%"| wdbTexture ||style="width: 45%"| Данная программа работает только со сжатыми текстурами в wdb, импорт/экспорт в bmp. ||style="width: 15%"| K^2 || '''[https://disk.yandex.ru/d/PU2QmvCFcumzbg Скачать]'''
|-
| wdbTexture2 || Данная программа работает только со сжатыми текстурами в wdb, импорт/экспорт в dds/bmp. || K^2 || '''[https://disk.yandex.ru/d/8QZgMyrZ5xLZFQ Скачать]'''
|-
| RnR WDB Resources Tool || Поддерживаются практически все типы текстур в wdb, импорт/экспорт в png. Для конвертации текстур используется wrgen.dll из SDK от shao. || aleko2144 || '''[https://disk.yandex.ru/d/hj-zESBX26seAw Скачать]'''
|}

== Работа с 3D-моделями (формат WDB) ==
{| class="wikitable" width="100%"
|-
! Название !! Замечания !! Автор !! Скачать
|-
|style="width: 15%"| Плагин для 3dsmax 5 ||style="width: 45%"| Предназначен для экспорта файлов формата WDB/SML, а также импорта SML. Взят из SDK от shao. ||style="width: 15%"| SoftLab-NSK || '''[https://disk.yandex.ru/d/M179d5Fq62BJQQ Скачать]'''
|-
| Viewer 2005 || Просмотр игрового мира. Программа взята из SDK от shao. || SoftLab-NSK || '''[https://disk.yandex.ru/d/eV-kn0tT6WlAIw Скачать]'''
|-
| wdbObj || Конвертация некоторых моделей из wdb в obj. || K^2 || '''[https://disk.yandex.ru/d/8QZgMyrZ5xLZFQ Скачать]'''
|-
| WDB Viewer || Просмотр 3D-моделей внутри WDB-файла, его структуры, экспорт данных в формат GLTF. || aleko2144 || '''[https://github.com/aleko2144/WDB-Viewer/releases Скачать]'''
|}

== Работа с sch/cnf/pkqt-файлами ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| Скрипты для Python 3.7 ||style="width: 45%"| Шифрация/дешифрация XML-файлов Rig'n'Roll Gold Edition. ||style="width: 15%"| aleko2144 || '''[https://disk.yandex.ru/d/ckx1t4QjfC-c1w Скачать]'''
|}

== Разное ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| SDK от shao ||style="width: 45%"| Редактор квестов, wdbpp, Viewer 2005, экспортер моделей и другие утилиты к игре. Pdf-файл с инструкцией и квесты в формате htm скачаны из ТГ-чата "Дальнобойщики 3: Game & Mods". ||style="width: 15%"| SoftLab-NSK || '''[https://disk.yandex.ru/d/bePHKNx7MTGjtw Скачать]'''
|-
| wdbppGUI || Визуальный интерфейс для wdbpp из SDK от shao. Выводит структуры файлов формата ANM, PDM, WAY и WDB в текстовом виде (txt/xml).|| aleko2144 || '''[https://disk.yandex.ru/d/meq91iqzN5INzw Скачать]'''
|}
{{Дб3}}

Хронология разработки (Дальнобойщики 3)

2025-12-08T17:43:47Z

Aleko 2144: Исправил ссылки на новости второй половины 2007 года

[[Категория:Дальнобойщики 3]]
В данной статье описана примерная хронология разработки игры "Дальнобойщики 3". В основе лежат материалы со старой версии сайта www.rignroll.ru, а также en.riotpixels.com и других ресурсов.

== 2001 - 2003 годы ==
Весной 2001 года была начата разработка игры. Проект был впервые анонсирован на июньском семинаре партнеров "1С" в том же году.<ref>Источник: [http://web.archive.org/web/20080910082354/http://www.rignroll.ru/index.php?type=dev_id&publ_id=179 новости разработки игры за июль 2004 года с официального сайта игры].</ref> Примерно к 2002 году был разработан формат файлов WDB, использующийся для хранения 3D-сцен игрового мира, транспорта и иных объектов.<ref>Впрочем, это только [[Участник:Aleko_2144|моё личное]] предположение. Некоторые инструменты из SDK от shao к "Дальнобойщикам 3" датированы именно 2002 годом.</ref> Весной 2003 года "Дальнобойщики 3" были впервые широко представлены публике на Конференции Разработчиков Игр (КРИ 2003) в Москве, а затем – на выставках Е3'03 и ECTS'03, E3’04.<ref>Источник: новости разработки игры за июль 2004 года с официального сайта игры.</ref>
 Кроме того, скриншоты транспорта и игрового мира с [[Бонусный_диск#Скриншоты|бонусного диска ко второй части]] датированы весной 2003 года.
<gallery>
rignroll-dev-2003-oct-1.jpg|Предположительно, октябрь 2003 года.
rignroll-dev-old-01.jpg
rignroll-dev-old-02.jpg
rignroll-dev-old-03.jpg
</gallery>

== 2004 год ==
=== май<ref>[http://web.archive.org/web/20070825041732/http://www.rignroll.ru/index.php?type=new_id&publ_id=180 Источник]</ref> ===
"Дальнобойщики 3" были показаны на игровой выставке E3'2004 в Лос-Анджелесе.
Специально для мероприятия были подготовлены новый видеоролик и демо-версия игры. Игроки получали груз на базе в городе [[Окснард]] и везли товары на базу в [[Лос-Анджелес]] по 101-му и 110-му хайвеям через Голливуд, проезжая прямо над "Конвеншен-центром", где и проходила выставка E3.

=== июль<ref>Источник: новости разработки игры за июль 2004 года с официального сайта игры.</ref> ===
На июль 2004 года, по заявлениям авторов, разработка "Дальнобойщиков 3" шла полным ходом: были готовы или почти готовы большинство технологических решений, шёл к завершению процесс моделирования большинства крупных городов, была создана большая часть машин и персонажей. Продолжались работы над физической моделью, AI и сюжетом игры, а также активно велись переговоры по поводу лицензирования представленных в игре объектов. Выпуск игры был запланирован на 2005 год.

=== сентябрь<ref>[http://web.archive.org/web/20070825041600/http://www.rignroll.ru/index.php?type=new_id&publ_id=206 Источник]</ref> ===
"Дальнобойщики 3" были представлены на игровой выставке EGN'2004 в Лондоне.
Специально для мероприятия была подготовлена новая демо-версия игры. Игровой мир был представлен такими городами, как Окснард, Лос-Анджелес, Темикула, Сан-Клементе, Сан-Диего. Общая протяжённость дорог составляла около 70 километров.

=== ноябрь<ref>Источник: [http://web.archive.org/web/20071016085929/http://rignroll.ru/index.php?type=dev_id&publ_id=296 новости разработки игры от 17 ноября 2004 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* построена часть города Бейкерсфилд (пересечение SR99 и SR58) вдоль хайвея SR99;
* практически закончен город Мерсед (SR99);
* смоделирован город Гринфилд (US101);
* смоделирован город Мохаве (пересечение SR58 и SR14);
* смоделирован город Темекула (I15);
* построены участки дорог US101, I5, I10, I15 связавшие между собой города Окснард, Лос-Анджелес, Сан-Клементе, Сан-Диего и Темекула;
* существенно подрос Лос-Анджелес вдоль US101, I10, I5;
* практически завершен город Сан-Франциско. Смоделирована его часть вдоль I80, построены даунтаун, остров Сокровищ (Treasure Island), мост через залив (Bay Bridge), соединяющий Сан-Франциско с Окландом.
Введена новая физическая модель движения полуприцепов для тягачей, управляемых как игроком, так и NPC.
Обновлен список полуприцепов. Среди них платформы-контейнеровозы, тяжеловозы, цистерны, рефрижераторы, автовозы.
Разработаны модели нескольких новых персонажей. Среди них “секретарша”, “бармен”, “полицейский”. Разработаны анимации персонажей для ряда объектов базового мира – бара, мотеля, базы, АЗС.
<gallery>
rignroll-dev-2004-11-1.jpg
rignroll-dev-2004-11-2.jpg
rignroll-dev-2004-11-3.jpg
</gallery>

=== декабрь<ref>Источник: [http://web.archive.org/web/20071016085929/http://rignroll.ru/index.php?type=dev_id&publ_id=296 новости разработки игры от 30 декабря 2004 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Бейкерсфилд (пересечение SR99 и SR58).
* Закончено моделирование города Фресно (SR99).
* Закончено моделирование города Мерсед (SR99).
* Смоделирован город Мантека (пересечение SR99 и SR120).
* Смоделирован город Берни (SR395)
* Смоделирован город Стэндиш (SR395).
* Ведется моделирование 58-ого хайвея, связавающего между собой города Бейкерсфилд и Мохаве. Интересная деталь: в этом районе "пасут ветер". Здесь в горах Техачапи нахадится одна из трех самых больших "ветровых ферм" в мире. Она насчитывает более тысячи ветровых генераторов.

Переработана физическая модель столкновений для тягачей и полуприцепов. Появилась новая заправка. Обновлен список автомобилей: добавлены школьный автобус и грузовик бизнес-класса Freightliner FL60. Построены кабины для тягачей Freightliner Argosy и Peterbilt 387.

Разработаны модели нескольких новых персонажей. Среди них "Полицейский детектив" и "Дальнобойщик".
<gallery>
rignroll-dev-2004-dec-1.jpg
rignroll-dev-2004-dec-2.jpg
rignroll-dev-2004-dec-3.jpg
</gallery>
'''Интерьер [[Freightliner Argosy]]''' 
<gallery>
rignroll-cab-argosy-2004-1.jpg
rignroll-cab-argosy-2004-2.jpg
rignroll-cab-argosy-2004-3.jpg
</gallery>
'''Интерьер [[Hercules_Atlas|Peterbilt 387]]''' 
<gallery>
rignroll-cab-387-2004-1.jpg
rignroll-cab-387-2004-2.jpg
rignroll-cab-387-2004-3.jpg
</gallery>

== 2005 год ==
=== февраль<ref>Источник: [http://web.archive.org/web/20071212145519/http://www.rignroll.ru/index.php?type=dev_id&publ_id=324 новости разработки игры от 26 февраля 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Сан-Франциско.
* Продолжено моделирование города Рино вдоль US395 (штат Невада).
* Смоделирован город Орленд (центр Калифорнии, I5).
* Начато моделирование города Уивервилл (север Калифорнии, SR299).
* Начато моделирование города Лебек (юг Калифорнии, I5).
* Завершено моделирование участка 58-ого хайвея, связывающего между собой города Бейкерсфилд и Мохаве.
* Начато моделирование дорог I5 и SR99, на участке между городами Бейкерсфилд, Лебек и Кетлмен-Сити.

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

Обновлен список автомобилей. Полиция штата обзавелась собственным постоянным средством передвижения. Прототипом послужил легендарный герой боевиков – Ford Crown Victoria в его полицейской модификации. Один из самых популярных пикапов Chevrolet Silverado проходит последние отстройки динамических характеристик перед его вводом в игру. Построены кабины для тягачей Kenworth K100 и Kenworth T2000.

'''Интерьер [[Kenworth K100E]]''' 
<gallery>
rignroll-cab-k100e-2005-may-1.jpg
rignroll-cab-k100e-2005-may-2.jpg
rignroll-cab-k100e-2005-may-3.jpg
</gallery>
'''Интерьер [[Kenworth T2000]]''' 
<gallery>
rignroll-cab-t2000-1.jpg
rignroll-cab-t2000-2.jpg
rignroll-cab-t2000-3.jpg
</gallery>

=== март<ref>Источник: [http://web.archive.org/web/20080212002209/http://www.rignroll.ru/index.php?type=dev_id&publ_id=342 новости разработки игры от 31 марта 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Рино (штат Невада).
* Практически завершено моделирование городов Лебек (I5), Сан-Клементе (I5), Уивервилл (север Калифорнии, SR299).
* Начато моделирование города Окленд (I80, сосед Сан-Франциско)
* Ведется моделирование города Колфакс (I80, северо-восток Калифорнии)
* Завершено моделирование дорог I5 и SR99, на участке между городами Бейкерсфилд, Лебек и Кеттлмен-Сити. Этот участок находится на юге долины Сан-Хоакин, лежащей в сердце Калифорнии и ограниченной с запада Береговыми хребтами, а с востока горами Сьерра-Невады. Эту долину часто называют "Салатницей нации" в связи с тем, что здесь выращивается значительная часть всей сельскохозяйственной продукции страны. Здесь же сосредоточена и примерно половина наиболее крупных месторождений нефти и газа континентальной части США.
* Начато моделирование участка 99-ого хайвея, связывающего между собой города Бейкерсфилд и Фресно.

Обновлен список автомобилей. Построен еще один тягач (прототипом послужил [[Freightliner Century]]) и два легковых автомобиля – Ford Crown Victoria в его "гражданском" исполнении и в модификации такси, а также весьма популярный Volkswagen New Beetle.

'''Freightliner Century:''' 
<gallery>
rignroll-dev-2005-03-1.jpg
rignroll-dev-2005-03-2.jpg
</gallery>
'''Ford Crown Victoria:''' 
<gallery>
rignroll-dev-2005-03-3.jpg
rignroll-dev-2005-03-4.jpg
rignroll-dev-2005-03-5.jpg
rignroll-dev-2005-03-6.jpg
</gallery>
'''Volkswagen New Beetle:''' 
<gallery>
rignroll-dev-2005-03-7.jpg
rignroll-dev-2005-03-8.jpg
rignroll-dev-2005-03-9.jpg
rignroll-dev-2005-03-10.jpg
</gallery>

=== июнь<ref>Источник: [http://web.archive.org/web/20080906091012/http://www.rignroll.ru/index.php?type=dev_id&publ_id=358 новости разработки игры от 11 июня 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Колфакс (I80).
* Практически завершено моделирование города Окленд (I80).
* Начато моделирование города Викторвилл (I15).
* Начато моделирование города Барстоу (пересечение SR58 и I15), расположенного в пустыне Мохаве неподалеку от знаменитой по американским фильмам военно-воздушной базы "Эдвардс".
* Начато моделирование города Санта-Барбара (US101), расположенного на побережье Тихого океана и не менее знаменитого по телевизионным сериалам.
* Завершено моделирование участка дороги SR99 на участке между городами Бейкерсфилд и Фресно.
* Ведется моделирование дороги I5 на участке между городами Лос-Анджелес и Лебек;
* Ведется моделирование дороги US101, проходящей по побережью Тихого океана, на участке между городами Окснард и Санта-Барбара.
* Ведется моделирование дорог SR14, US395 на участке от Мохаве до Лон-Пайна. Дорога проходит через красно-рыжие скалы известного своей красотой Red Rock Canyon.

Обновлен список автомобилей:
* Построен легковой автомобиль представительского класса (прототипом послужил Lincoln Town Car).
* Разработан интерьер кабины для седельного тягача [[Freightliner_FLD_120_Classic_XL|Freightliner FLD120 Classic XL]].
* Разработан интерьер кабины для седельного тягача [[Freightliner Coronado]].
* Разработан интерьер кабины для седельного тягача [[Freightliner Century]].

'''Lincoln Town Car:''' 
<gallery>
rignroll-dev-2005-06-01.jpg
rignroll-dev-2005-06-02.jpg
rignroll-dev-2005-06-03.jpg
rignroll-dev-2005-06-04.jpg
</gallery>
'''Интерьер тягача [[Freightliner_FLD_120_Classic_XL|Freightliner FLD120 Classic XL]]:''' 
<gallery>
rignroll-dev-2005-06-05.jpg
rignroll-dev-2005-06-06.jpg
rignroll-dev-2005-06-07.jpg
</gallery>
'''Интерьер тягача [[Freightliner Century]]:''' 
<gallery>
rignroll-dev-2005-06-08.jpg
rignroll-dev-2005-06-09.jpg
rignroll-dev-2005-06-10.jpg
</gallery>
'''Интерьер тягача [[Freightliner Coronado]]:''' 
<gallery>
rignroll-dev-2005-06-11.jpg
rignroll-dev-2005-06-12.jpg
rignroll-dev-2005-06-13.jpg
</gallery>

=== август<ref>Источник: [http://web.archive.org/web/20080906091018/http://www.rignroll.ru/index.php?type=dev_id&publ_id=367 новости разработки игры от 25 августа 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Санта-Барбара (US101);
* Практически завершено моделирование города Барстоу (пересечение SR58 и I15);
* Практически завершено моделирование города Викторвилл (I15);
* Начато моделирование города Паттерсон (I5);
* Начато моделирование практически слившихся в один городов-соседей: Ланкастера и знаменитого Палмдейла (SR14) – аэрокосмической столицы Америки. В Палмдейле расположены такие гиганты индустрии, как "Локхид-Мартин", "Нортоп-Груммэн", "Рокуэлл", "Боинг", "МакДонелл-Дуглас", "Бритиш Аэроспейс". Именно здесь проходили предстартовую подготовку американские космические "челноки".
* Завершено моделирование участка дорог SR14 и US395 от Мохаве до Лон-Пайна;
* Завершено моделирование участка дороги I5 от Лос-Анджелеса до Лебека;
* Завершено моделирование участка дороги US101 от Окснарда до Санта-Барбары;
* Ведется моделирование дороги I15 на участке между городами Барстоу и Викторвилла;
* Ведется моделирование дороги SR58 на участке между городами Мохаве и Барстоу;

Обновлен список автомобилей:
* Построен легковой автомобиль Chrysler Voyager;
* Разработан интерьер кабины для седельного тягача [[Peterbilt 379]];
* Разработан интерьер кабины для седельного тягача [[Titan_Ventura|Kenworth W900L]];
* Разработан интерьер кабины для седельного тягача [[Volvo VNL770]].

'''Chrysler Voyager:''' 
<gallery>
rignroll-dev-2005-08-01.jpg
rignroll-dev-2005-08-02.jpg
rignroll-dev-2005-08-03.jpg
rignroll-dev-2005-08-04.jpg
</gallery>
'''Интерьер [[Peterbilt 379]]:''' 
<gallery>
rignroll-dev-2005-08-05.jpg
rignroll-dev-2005-08-06.jpg
rignroll-dev-2005-08-07.jpg
</gallery>
'''Интерьер [[Titan_Ventura|Kenworth W900L]]:''' 
<gallery>
rignroll-dev-2005-08-09.jpg
rignroll-dev-2005-08-10.jpg
rignroll-dev-2005-08-11.jpg
</gallery>
'''Интерьер [[Volvo VNL770]]:''' 
<gallery>
VNL770int3.jpg
VNL770int1.jpg
VNL770int2.jpg
</gallery>

=== ноябрь<ref>Источник: [http://web.archive.org/web/20080906091135/http://www.rignroll.ru/index.php?type=dev_id&publ_id=379 новости разработки игры от 3 ноября 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Палмдейл (SR14);
* Продолжается моделирование города Ланкастер (SR14);
* Практически завершено моделирование города Паттерсон (I5);
* Начато моделирование столицы Силиконовой долины города Сан-Хосе (US101);
* Завершено моделирование участка дорог I15 от Барстоу до Викторвилла;
* Завершено моделирование участка дороги SR58 от Мохаве до Барстоу;
* Ведется моделирование дорог I10, I15 на участке Лос-Анджелес – Викторвилл;
* Ведется моделирование дороги SR14 на участке Лос-Анджелес – Палмдейл;
* Ведется моделирование дороги SR14 на участке Палмдейл – Мохаве;
* Ведется моделирование дороги US395 на участке Лон-Пайн – Бишоп;
* Ведется моделирование дороги US101 на участке Санта-Барбара – Атаскадеро.

Обновлен список автомобилей:
* Разработаны модели экстерьера и интерьера седельного тягача [[Sterling A9500S]];
* Построены модели полуприцепов типа "Самосвал";
* Построены модели полуприцепов типа "Зерновоз";
* Построены модели полуприцепов типа "Скотовоз".

'''Интерьер [[Sterling A9500S]]:''' 
<gallery>
rignroll-dev-2005-11-01.jpg
rignroll-dev-2005-11-02.jpg
rignroll-dev-2005-11-03.jpg
</gallery>

'''Полуприцепы:''' 
<gallery>
rignroll-dev-2005-11-04.jpg
rignroll-dev-2005-11-05.jpg
rignroll-dev-2005-11-06.jpg
rignroll-dev-2005-11-07.jpg
</gallery>

=== декабрь<ref>Источник: [http://web.archive.org/web/20080906091023/http://www.rignroll.ru/index.php?type=dev_id&publ_id=385 новости разработки игры от 22 декабря 2005 года с официального сайта игры]</ref> ===
Расширилась территория игрового мира:
* Практически завершено моделирование города Сан-Хосе (US101);
* Практически завершено моделирование города Ланкастер (SR14);
* Начато моделирование города Юкайа (US101);
* Завершено моделирование дорог I10, I15 на участке Лос-Анджелес – Мохаве;
* Завершено моделирование дороги SR14 на участке Лос-Анджелес – Палмдейл;
* Завершено моделирование дороги SR14 на участке Палмдейл – Мохаве;
* Завершено моделирование дороги US395 на участке Лон-Пайн – Бишоп;
* Завершено моделирование дороги US101 на участке Санта-Барбара – Атаскадеро;
* Ведется моделирование дороги US101 на участке Атаскадеро – Гринфилд;
* Ведется моделирование дороги US101 на участке Гринфилд – Сан-Хосе;
* Ведется моделирование дороги SR99 на участке Фресно – Мерсед;
* Ведется моделирование дороги US395 на участке Бишоп – Бриджпорт.

Обновлен список автомобилей:
* Разработана модель интерьера седельного тягача [[Navistar 9300|International 9300 Classic Eagle]];
* Разработана модель интерьера седельного тягача [[Навистар_Игл#Грузовик_в_Дальнобойщиках_3|International 9900ix]];
* Разработана модель пикапа Chevrolet Avalanche.

'''Интерьер [[Navistar 9300|International 9300 Classic Eagle]]:''' 
<gallery>
I9300-salon-0.jpg
I9300-salon-1.jpg
I9300-salon-2.jpg
</gallery>

'''Интерьер [[Навистар_Игл#Грузовик_в_Дальнобойщиках_3|International 9900ix]]:''' 
<gallery>
I9900ix-interior-0.jpg
I9900ix-interior-2.jpg
I9900ix-interior-1.jpg
</gallery>

== 2006 год ==
=== март<ref>Источник: [http://web.archive.org/web/20080906091028/http://www.rignroll.ru/index.php?type=dev_id&publ_id=394 новости разработки игры от 24 марта 2006 года с официального сайта игры]</ref> ===
Продолжилось развитие сети дорог на территории игрового мира:
* Завершено моделирование дороги US101 на участке Атаскадеро – Гринфилд;
* Завершено моделирование дороги US101 на участке Гринфилд – Сан-Хосе;
* Завершено моделирование дороги SR99 на участке Фресно – Мерсед;
* Завершено моделирование дороги US395 на участке Бишоп – Бриджпорт;
* Завершено моделирование дороги I80 на участке Сан-Франциско – Окленд, проходящей по знаменитому двухъярусному мосту Bay Bridge через залив Сан-Франциско и "Остров сокровищ" (Treasure Island);
* Ведется моделирование дороги I80 на участке, соединяющем Окленд со столицей штата Калифорния – городом Сакраменто;
* Ведется моделирование дороги SR41 на участке Атаскадеро – Кеттлмен-Сити;
* Ведется моделирование дороги SR41 на участке Кеттлмен-Сити – Фресно;
* Ведется моделирование дороги US101 на участке Юкайа – Легетт;
* Ведется моделирование дороги US101 на участке Легетт – Юрика через горный массив Redwood, покрытый величественными гигантскими секвоями. Именно здесь находится так называемая "Алея Гигантов".

Обновлен список автомобилей:
* Разработана модель интерьера седельного тягача [[Mack CH603]];
* Разработана модель интерьера седельного тягача [[Titan_El_Dorado|Kenworth T600]];
* Разработана модель микроавтобуса Chevrolet Express;
* Разработана модель полуприцепа с тентом (Curtainsider).

'''Интерьер [[Mack CH603]]:''' 
<gallery>
MackCH603salon.jpg
MackCH603salon2.jpg
MackCH603salon3.jpg
</gallery>

'''Интерьер [[Titan_El_Dorado|Kenworth T600]]:''' 
<gallery>
rignroll-dev-2006-03-01.jpg
rignroll-dev-2006-03-02.jpg
rignroll-dev-2006-03-03.jpg
</gallery>

=== июнь<ref>Источник: [http://web.archive.org/web/20080906091034/http://www.rignroll.ru/index.php?type=dev_id&publ_id=403 новости разработки игры от 29 июня 2006 года с официального сайта игры]</ref> ===
Завершено моделирование самого большого города Калифорнии – Лос-Анджелеса. Таким образом, завершено моделирование всех городов игрового мирa. Практически закончено моделирование Южной и Центральной Калифорнии. Оставшиеся дороги Северной Калифорнии находятся в активной фазе разработки.

Ведутся работы по дизайну искусственного ночного освещения городов:
Альтурас, Атаскадеро, Барстоу, Бишоп, Бриджпорт, Колфакс, Гринфилд, Кетлмен-Сити, Ланкастер, Лон-Пайн, Мантика, Окснард, Палмдейл, Паттерсон, Реддинг, Рино, Сакраменто, Сан-Франциско, Санта-Барбара, Темекула, Юкайа, Викторвилл, Уивервилл.

Продолжено расширение сети дорог на территории игрового мира:
* Завершено моделирование дороги I80 на участке Окленд – Сакраменто;
* Завершено моделирование дороги SR41 на участке Атаскадеро – Кетлмен-Сити;
* Завершено моделирование дороги на участке Кетлмен-Сити – Фресно;
* Завершено моделирование дороги US101 на участке Юкайа – Легетт;
* Завершено моделирование дороги US101 на участке Легетт – Юрика;
* Построена дорога US101 на участке Сан-Хосе – Сан-Франциско;
* Построена дорога US101 на участке Сан-Франциско – Юкайа;
* Построена дорога I5 на участке Кетлмен-Сити – Паттерсон;
* Построена дорога I5 на участке Паттерсон – Мантика;
* Построена дорога I5 на участке Паттерсон – Сакраменто;
* Построена дорога I580, I205, SR120 на участке Окленд – Мантика;
* Построена дорога SR99 на участке Мерсед – Мантика.

Обновлен список автомобилей:
* Разработана модель интерьера седельного тягача [[Mack_CX603|Mack CX603 Vision]];
* Разработана модель интерьера седельного тягача [[Titan_Inyo|Kenworth T800]];
* Построены модели экстерьера и интерьера седельного тягача [[Western Star 4900EX LowMax]];
* Разработана модель минивена Dodge Grand Caravan;
* Разработана модель пикапа Ford F-350 Lariat;
* Построены модели полуприцепов для сыпучих грузов;
* Построены модели полуприцепов для перевозки напитков.
* Расширен список перевозимой тяжелой спецтехники, в числе которой появились трактора, дорожные катки, бульдозеры.
Завершаются работы над глобальной картой погоды и погодными эффектами.

'''Интерьер [[Mack_CX603|Mack CX603 Vision]]:''' 
<gallery>
MackCX603salon.jpg
MackCX603salon2.jpg
MackCX603salon3.jpg
</gallery>

'''Интерьер [[Titan_Inyo|Kenworth T800]]:''' 
<gallery>
rignroll-dev-2006-06-01.jpg
rignroll-dev-2006-06-02.jpg
rignroll-dev-2006-06-03.jpg
</gallery>

'''Интерьер [[Western Star 4900EX LowMax]]:''' 
<gallery>
rignroll-dev-2006-06-04.jpg
rignroll-dev-2006-06-05.jpg
rignroll-dev-2006-06-06.jpg
</gallery>

'''Ford F-350:''' 
<gallery>
rignroll-dev-2006-06-07.jpg
rignroll-dev-2006-06-08.jpg
rignroll-dev-2006-06-09.jpg
</gallery>

=== декабрь<ref>Источник: [http://web.archive.org/web/20080906091038/http://www.rignroll.ru/index.php?type=dev_id&publ_id=453 новости разработки игры от 29 декабря 2006 года с официального сайта игры]</ref> ===
Расширена сеть дорог:
* Завершено моделирование дороги I80 на участке Сакраменто – Колфакс;
* Завершено моделирование дороги I80 на участке Колфакс – Рино;
* Завершено моделирование дороги I5 на участке Сакраменто – Орленд;
* Завершено моделирование дороги I5 на участке Орленд – Реддинг;
* Завершено моделирование дороги SR299 на участке Юрика – Уивервилл;
* Завершено моделирование дороги SR299 на участке Уивервилл – Реддинг;
* Завершено моделирование дороги SR299 на участке Реддинг – Барни;
* Завершено моделирование дороги SR299 на участке Барни – Альтурас;
* Завершено моделирование дороги US395 на участке Бриджпорт – Минден;
* Завершено моделирование дороги US395 на участке Минден – Рино;
* Завершено моделирование дороги US395 на участке Рино – Стандиш;
* Завершено моделирование дороги US395 на участке Стандиш – Альтурас;
Таким образом, закончено моделирование городов и дорог игрового мира. 
Завершен дизайн искусственного ночного освещения городов. Ведется активное тестирование и исправление ошибок на всей огромной территории игры.

Обновлен список автомобилей:
* Разработана модель седельного тягача Peterbilt 378;
* Разработана модель грузовика Peterbilt 378 в кузовном исполнении;
* Разработана модель автомобиля Chevrolet Cavalier с кузовом купе;
* Разработана модель среднего грузовика GMC Topkick C4500;
* Разработана модель среднего грузовика GMC Topkick C8500;
* Построены новые модели полуприцепов для сыпучих грузов;
* Построены модели полуприцепов для перевозки бруса, бревен и труб.

Расширен список перевозимой тяжелой спецтехники, в числе которой появились комбайн, бойлер, газовая турбина.
Введены специальные типы раскрасок машин – "хамелеон" и "металлик".
Полностью введена в игру система повреждений и ремонтов машин.
Разработаны и введены в игру спортивные состязания водителей-дальнобойщиков.
Разработано главное меню игры.
Завершаются работы по сохранению/восстановлению сеансов игры.
<gallery>
rignroll-dev-2006-12-01.jpg
rignroll-dev-2006-12-02.jpg
rignroll-dev-2006-12-03.jpg
rignroll-dev-2006-12-04.jpg
rignroll-dev-2006-12-05.jpg
rignroll-dev-2006-12-06.jpg
rignroll-dev-2006-12-07.jpg
rignroll-dev-2006-12-08.jpg
rignroll-dev-2006-12-09.jpg
</gallery>

=== без конкретной даты ===
* Из игры удалён тягач [[Kenworth K100E]]<ref>Это лишь предположение, основанное на копиях сайта с сервиса Web Archive. Тягач пропал с сайта в промежутке между сентябрём 2005 и февралём 2007 года. Возможно, Sterling A9500S был введён в игру как раз вместо Kenworth K100E.</ref>.

== 2007 год ==
=== сентябрь<ref>Источник: [http://web.archive.org/web/20080906091043/http://www.rignroll.ru/index.php?type=dev_id&publ_id=469 новости разработки игры от 8 сентября 2007 года с официального сайта игры]</ref> ===
* Игровой мир прошел стадию технического тестирования (тестирование на непротиворечивость объектов территории), в настоящий момент ведется перекрестное художественное тестирование игрового мира.
* Ведется тестирование всего парка машин и одновременно с этим ведется доработка системы апгрейдов для каждой из машин и системы их территориального распределения по станциям технического обслуживания.
* Завершена разработка системы миссий. Ведется ее тестирование, исправление ошибок и наполнение контентом.
* Завершена разработка инсталлятора игры. Ведется тестирование на разных платформах.
* Ведется разработка системы автоматических тестов на непротиворечивость различных подсистем игры заданным параметрам.
* Завершены работы по оптимизации игры под мультипроцессорные платформы.
* Ведутся работы по масштабированию возможностей игры под различные аппаратные конфигурации.
* На стадии завершения подготовка персонажей игры под различные типы освещения.
* Ведется разработка сценарийной подсистемы игры.
<gallery>
rignroll-dev-2007-sep-1.jpg
rignroll-dev-2007-sep-2.jpg
rignroll-dev-2007-sep-3.jpg
rignroll-dev-2007-sep-4.jpg
rignroll-dev-2007-sep-5.jpg
rignroll-dev-2007-sep-6.jpg
</gallery>

=== ноябрь<ref>Источник: [http://web.archive.org/web/20080622070430/http://www.rignroll.ru/index.php?type=dev_id&publ_id=479 новости разработки игры от 13 ноября 2007 года с официального сайта игры]</ref> ===
* Продолжено художественное тестирование игрового мира и исправление художественных недочетов, допущенных при моделировании территории.
* Продолжено тестирование парка машин и введение системы индивидуальных апгрейдов для различных марок грузовиков.
* Введен механизм территориального распределения ассортимента станций технического обслуживания в соответствии с наличием реальных представительств компаний-производителей на имитируемой территории.
* Завершены работы по тестированию, отладке и оптимизации игры под мультипроцессорные платформы.
* Демонстрационная версия игры отправлена в лабораторию корпорации Intel для проведения тестов на производительность.
* Продолжена разработка сценарийной подсистемы игры.
* Завершена разработка дополнительного режима игры – "Одиночный заказ". Обладая определенной сумой денег, игрок должен будет выполнить один заказ для выбранной им торговой базы на выбранном тягаче. Этот режим демонстрировался на выставке "Игромир–2007" в Москве. После выхода игры разработчики планировали ввести и поддерживать таблицу лучших результатов на официальном сайте игры. Планировалось, что лучшие результаты режима будут отражены в виде "Горячей десятки" по трем номинациям: "Лучший дальнобойщик" – игрок, добившийся максимальной прибыли; "Лучший гонщик" – игрок, показавший максимальную среднюю скорость; и "Лучший доставщик" – самый аккуратный водитель.
<gallery>
rignroll-dev-2007-nov-1.jpg
rignroll-dev-2007-nov-2.jpg
rignroll-dev-2007-nov-3.jpg
rignroll-dev-2007-nov-4.jpg
rignroll-dev-2007-nov-5.jpg
rignroll-dev-2007-nov-6.jpg
</gallery>
'''Некоторые фотографии с выставки "Игромир-2007":'''<ref>Источник: [https://web.archive.org/web/20130413052225/http://forum.1cpublishing.eu/showthread.php?t=2225 форум 1C Publishing]</ref> 
<gallery>
rignroll-dev-2007-igromir-8.jpg
rignroll-dev-2007-igromir-1.jpg
rignroll-dev-2007-igromir-2.jpg
rignroll-dev-2007-igromir-3.jpg
rignroll-dev-2007-igromir-4.jpg
rignroll-dev-2007-igromir-7.jpg
rignroll-dev-2007-igromir-6.jpg
rignroll-dev-2007-igromir-5.jpg
rignroll-dev-2007-igromir-9.jpg
</gallery>

=== декабрь<ref>Источник: [http://web.archive.org/web/20080706001723/http://www.rignroll.ru/index.php?type=dev_id&publ_id=484 новости разработки игры от 28 декабря 2007 года с официального сайта игры]</ref> ===
* Ведется тестирование экономической системы игры и балансировка основных экономических параметров объектов игрового мира (торговых баз, транспортных компаний, автодилеров, кадровых агентств, наемных водителей и т.д.).
* Ведется тестирование, отладка и балансировка спортивной подсистемы игры (чемпионат Калифорнии среди дальнобойщиков).
* Проверяются и балансируются маршруты и параметры конкретных серий гонок, параметры рейтинговой системы продвижения игрока, уточняются ходовые параметры машин различных моделей и влияние на эти параметры устанавливаемых апгрейдов.
* Демонстрационная версия игры проверена в лаборатории корпорации Intel на предмет оптимизации под мультипроцессорные платформы. Подтверждено увеличение производительности игры до 70–80% на многоядерных системах.
* Продолжается тестирование и отладка территории игрового мира и парка машин.
<gallery>
rignroll-dev-2007-dec-1.jpg
rignroll-dev-2007-dec-2.jpg
rignroll-dev-2007-dec-3.jpg
rignroll-dev-2007-dec-4.jpg
rignroll-dev-2007-dec-5.jpg
rignroll-dev-2007-dec-6.jpg
rignroll-dev-2007-dec-7.jpg
rignroll-dev-2007-dec-8.jpg
</gallery>

== 2008 год ==
=== ноябрь<ref>[http://web.archive.org/web/20090121220007/http://rignroll.ru/index.php?type=new_id&publ_id=502 Источник]</ref> ===
6–9 ноября 2008 года "Дальнобойщики 3" демонстрировались на крупнейшей российской выставке "Игромир". В качестве выставочной версии использовалась практически полная версия игры, из которой в целях безопасности была убрана некоторая часть возможностей.

== 2009 год ==
=== ноябрь ===
18 ноября 2009 - выход игры.

{{Дб3}}

== Примечания ==

Советы и секреты (Дальнобойщики 3)

2025-12-05T12:38:43Z

Aleko 2144: Добавил немного про скрытые функции игры - свободную камеру и работу в окне

[[Категория:Дальнобойщики_3]]
==Геймплейные советы==
=== Как открыть филиал? ===

Количество филиалов, которые вы можете открыть, зависит от оборота вашей компании.
Изначально вы можете открыть только один филиал (дополнительно к центральному офису
в Окснарде). Филиалы открываются в офисе на вкладке "Управление филиалами".

'''Замечание:''' Если вы не можете открыть ни один филиал (кроме филиала в Окснарде) или при нажатии на кнопку "Применить" на вкладке "Управление филиалами" не происходит ничего, то у вас контрафактный диск. Подробнее об этом читайте [https://vk.com/page-6026467_16502300 здесь]. Единственный возможный способ устранить эту проблему - купить лицензию.

=== Как поднять оборот компании? ===

Поднять оборот компании можно двумя способами:

1. '''Нанимать побольше водителей.''' При таком подходе вам придётся нанять не менее 15 водителей для открытия всех баз в Калифорнии.

2. '''Правильно настроить нанятых водителей.''' При таком подходе вам придётся нанять не менее 9 водителей для открытия всех баз в Калифорнии. Как правильно настраивать нанятых водителей поговорится в следующих разделах.

=== Как правильно настроить нанятых водителей? ===

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

[[Файл:d3_setup_truck_driver.jpg|512px]]

1. Выберете водителя в списке (1).

2. Отключите для него автоматическую настройку предпочитаемых заказов. Для этого отключите переключатель (2).

3. Передвигайте ползунок типа заказа (3) так, чтобы в зарплата $/день (6) достигла своего наибольшего значения из возможных.

4. Передвигайте ползунок хрупкости груза (4) так, чтобы в зарплата $/день (6) достигла своего наибольшего значения из возможных (зарплата суммируется, поэтому её начальное значение - то, что вы достигли в предыдущем пункте, поэтому старайтесь не уменьшить показатель).

5. Передвигайте ползунок дальности рейсов (5) так, чтобы в зарплата $/день (6) достигла своего наибольшего значения из возможных (зарплата суммируется, поэтому её начальное значение - то, что вы достигли в предыдущем пункте, поэтому старайтесь не уменьшить показатель).

6. Обязательно нажмите "Применить всё"!

7. Проделайте пункты 1 - 6 для всех своих водителей.

8. Настройка завершена.

=== Как получить груз? ===

Грузы можно получить на складе или по СВ-рации. Если вы видите где-то полуприцеп, но задания по СВ-рации вы на него не получали, взять его будет невозможно!

=== Где находится склад? ===

Склады на карте отмечены зелёными крючками', чтобы до них добраться следуйте по указателю "<имя города> Warehouse".
' - Если крючки серые, то взять заказ на этой базе невозможно, так как она не входит в область покрытия филиалов. Открывайте побольше филиалов для расширения зоны влияния.

==Скрытые функции игры==
=== Свободная камера ===

Чтобы активировать свободную камеру, нужно:
1) В папке MonsterCup (если игра с DLC) или GameWorld (если игра без DLC) создать файл wdb.ini со следующим содержимым:
[debug]
enableConsole = 1

2) Сохранить файл, запустить игру в любом режиме. После загрузки включить режим внешней камеры, настроить фокусное расстояние по желанию.
3) Нажать на клавишу '~', активируется консоль.
4) Ввести команду "freecam" (без кавычек). Активируется режим свободной камеры.

Управление:
* E/D - вперёд/назад
* F/S - вправо/влево
* Если зажать <Shift> до нажатия на E/D/F/S, то движение будет ускоренным.
* Для возвращения в обычный режим нужно нажать кнопку переключения режима камеры (работает только в том случае, если камера недалеко от грузовика игрока).

=== Оконный режим ===

Чтобы запустить игру в оконном режиме, нужно в папке MonsterCup (если игра с DLC) или GameWorld (если игра без DLC) создать файл wdb.ini со следующим содержимым:
[env]
fullscreen = 0

Важно! В таком режиме игра работает нестабильно и даже может '''вызвать аварийное завершение работы системы с BSOD'''. Использовать на свой страх и риск!

== Краткое руководство по американским правилам дорожного движения ==
Информация с [http://rignroll.ru официального сайта игры]
=== Предисловие ===
[[Файл:D3 tips p1.jpg|справа]]
Американские правила дорожного движения несколько отличаются от российских. Прежде всего нужно отметить, что не существует "общеамериканских" правил. В каждом штате США действуют свои правила дорожного движения – построенные на основе общих принципов, но тем не менее – свои собственные, в чем-то отличающиеся от правил, которые приняты в других штатах. Поэтому то, что разрешено в Калифорнии, может оказаться под запретом где-нибудь в Неваде или Орегоне, и наоборот.

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

Скажем, вопрос о праве преимущественного проезда через нерегулируемые перекрестки в общем случае решается по принципу: "Первым приехал – первым уехал". На четырехстопном перекрестке это выглядит забавно: машины поочередно останавливаются на стоп-линиях, а затем в той же последовательности трогаются и проезжают перекресток. Если есть необходимость, то приоритеты для транспортных средств определяются знаками, "уступи дорогу" – "STOP" или "YIELD".
[[Файл:D3 tips school bus.jpg|центр]]
В Калифорнии (в отличие от России) в общем случае разрешается выполнение поворота направо на красный, то есть запрещающий (!), сигнал светофора, а на пересечении дорог с односторонним движением – и выполнение поворота налево. От водителя, совершающего поворот, требуется лишь соблюдение разумных мер предосторожности – он должен пропустить транспортные средства и пешеходов, находящихся на его пути. Да еще можно увидеть красный мигающий сигнал светофора, который по своему значению аналогичен знаку "STOP".

Из нашей практики можно сказать, что ограничения скоростного режима в США часто кажутся более естественными, чем в России. Видимо, срабатывает тот же принцип – пропустить по дороге как можно больше машин, не создавая помех для их движения. Например, на горных серпантинах в условиях ограниченной видимости можно было смело придерживаться рекомендованной скорости (знаки там стоят перед каждым крутым поворотом), а в случае превышения всего на 10–15% уже терялась уверенность в том, что удастся удержать машину на дороге.

Логика основных скоростных ограничений в американских и российских ПДД примерно одна и та же, хотя формально это не так. Разрешенная скорость по умолчанию – 65 миль/час (~105 км/час), на двухполосных дорогах без разделительной полосы и при движении с прицепом – 55 миль/час (~89 км/час). Аналогом российской автомагистрали является фривей, на котором чаще всего действует ограничение скорости 65 миль/час. Для водителя – это участок дороги, ограниченный специальными знаками: "FREEWAY ENTRANCE" и "FREEWAY ENDS HERE". Фривей может проходить прямо через населенный пункт, не ужесточая ограничений в скорости. Ближайшей аналогией "населенного пункта" являются "business district" или "residence district". Если нет дополнительных знаков, то скорость в нем должна быть ограничена до 25 миль/час (~40 км/час). Ближайшим аналогом дорог в "жилых зонах" или прилегающих территорий являются "alley", где действует ограничение – 15 миль/час (~24 км/час).

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

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

===Главные заповеди водителя===
[[Файл:D3 tips p2.jpg|справа]]
Для безопасного управления транспортными средствами водитель должен подчиняться Правилам дорожного движения. Эти правила определяют, где и когда можно передвигаться на автомобиле. Чтобы не нарушать правила движения, водитель обязан знать сигналы светофора, а также значение дорожных знаков и разметки. Водитель должен понимать законы и правила, определяющие право преимущественного проезда (right-of-way) и порядок использования полос движения на дорогах. Водитель должен знать правила, регулирующие порядок остановки и стоянки транспортных средств, и следовать этим правилам.

'''Главные заповеди водителя'''
Вождение – это привилегия, а не право.

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

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

Не рассчитывайте на то, что другой водитель "поделится" с вами пространством на дороге.

Никогда не настаивайте на своем праве преимущественного проезда.

Прежде чем сесть за руль, подумайте об экономии топлива.

Бдительность на дороге поможет вам избежать дорожно-транспортных происшествий.

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

===Сигналы светофора===
[[Файл:D3 tips p3.gif|справа]]
Сигналы светофора, дорожные знаки и правила преимущественного проезда определяют порядок движения на перекрестках улиц и пересечениях дорог.

[[Файл:D3 tips red.gif|слева]]
'''Красный''' – запрещает движение кроме поворота направо. На пересечении дорог с односторонним движением разрешается поворот налево. Выполнение поворотов на красный сигнал светофора может быть запрещено специальными знаками, установленными на перекрестке (пересечении) дорог. Перед выполнением поворота водитель должен остановиться и пропустить пешеходов и транспортные средства, находящиеся на его пути.

[[Файл:D3 tips red arrow.gif|слева]]
'''Красная стрелка''' – запрещает движение (выполнение поворота) по направлению указателя при любом сигнале основного светофора.

[[Файл:D3 tips red blink.gif|слева]]
'''Красный мигающий''' – требует остановки, после которой водитель может продолжить безопасное движение в соответствии с правилами преимущественного проезда. По своему значению аналогичен знаку STOP.

Мигающие желтые или красные сигнальные огни школьного автобуса, которые включаются при посадке и высадке пассажиров, для всех остальных участников движения равнозначны по своему действию сигналам светофора: требуют повышенного внимания и готовности остановиться (желтый) или немедленной остановки (красный). В Калифорнии за нарушение данного пункта ПДД провинившегося водителя ждет весьма строгое наказание - штраф в тысячу долларов или лишение водительских прав сроком на 1 год.
[[Файл:D3 tips sb lights.gif|центр]]

[[Файл:D3 tips yellow.gif|слева]]
'''Желтый''' – предупреждает о том, что скоро должен загореться красный свет. На желтый сигнал светофора следует остановиться, если это можно сделать безопасным образом. Если вы не можете остановиться, будьте предельно внимательны при проезде через перекресток.

[[Файл:D3 tips yellow blink.gif|слева]]
'''Желтый мигающий''' – призывает водителя быть осмотрительным. Нужно снизить скорость и повысить внимание.

[[Файл:D3 tips yellow arrow.gif|слева]]
'''Желтая стрелка''' – предупреждает о завершении времени для выполнения безопасного поворота и предстоящей смене сигнала.

[[Файл:D3 tips green.gif|слева]]
'''Зеленый''' – разрешает движение. Предварительно водитель должен убедиться в возможности беспрепятственного проезда через перекресток: водитель обязан уступить дорогу транспортным средствам, завершающим движение через перекресток и пешеходам, не закончившим переход проезжей части данного направления. Поворот налево разрешен при условии достаточного пространства для его выполнения и отсутствии встречного движения.

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

[[Файл:D3 tips green arrow.gif|слева]]
'''Зеленая стрелка''' – разрешает движение по направлению указателя. Позволяет выполнить безопасный поворот во время действия запрещающего сигнала для встречного транспорта. Предварительно водитель должен пропустить других участников движения, уже находящихся на перекрестке и препятствующих выполнению поворота.

[[Файл:D3 tips non lights.gif|слева]]
'''Отсутствие сигнала''' – при неработающем светофоре водитель обязан остановиться у перекрестка или пересечения проезжих частей. Водитель может продолжить движение лишь убедившись в его безопасности, то есть дождавшись остановки транспортных средств и пешеходов, двигающихся в поперечном направлении. При отсутствии сигнала светофора действуют правила проезда через нерегулируемый перекресток, по всем направлениям которого установлен знак STOP.

===Дорожные знаки===
[[Файл:D3 tips p4.jpg|справа]]
'''Знаки приоритета'''

[[Файл:D3_tips_sign stop.gif|слева]]
Знак STOP требует полной остановки транспортного средства перед выездом на пешеходный переход или за ограничительную линию. Остановившись у перекрестка или специальной обозначенной ограничительной линии белого цвета, убедитесь в возможности безопасного проезда через перекресток, после чего продолжайте движение.

[[Файл:D3_tips_sign yeld.gif|слева]]
Знак YIELD предписывает снизить скорость и быть готовым к полной остановке транспортного средства. Пропустив участников движения, пересекающих ваш путь, и убедившись в безопасности, можете продолжать движение.

'''Запрещающие знаки'''
[[Файл:D3_tips_sign dne.gif|слева]]
[[Файл:D3_tips_sign ww.gif|слева]]
Знак DO NOT ENTER запрещает движение вперед. Может устанавливаться вместе со знаком WRONG WAY. Если вы увидите один из этих знаков или оба, вы должны съехать на обочину дороги и остановиться. Скорее всего, вы двигаетесь навстречу транспортному потоку. Убедившись в возможности безопасного разворота, развернитесь и продолжайте движение по дороге в разрешенном направлении.

'''Предупреждающие знаки'''
Знаки этого типа информируют водителя об изменении типа дороги и приближении к потенциально опасным участкам, при проезде по которым необходимо уменьшить скорость движения.
Пример: окончание участка дороги с разделенными полосами и начало участка с двухсторонним движением.
<gallery>
D3_tips_sign road1.gif|
D3_tips_sign road2.gif|
D3_tips_sign road3.gif|
</gallery>

'''Регулирующие знаки''' (черно-белые) информируют водителя о том, что ему можно и нужно делать. Водитель должен подчиняться указаниям регулирующих знаков.
[[Файл:D3_tips_sign regul.gif|центр]]

'''Дорожные указатели''' зеленого, голубого или коричневого цвета служат ориентирами для водителя, информируют о наличии по ходу движения тех или иных сервисов, публичных учреждений, достопримечательностей.
[[Файл:D3_tips_signs guide1.gif|центр]]
[[Файл:D3_tips_signs guide2.gif|центр]]

===Правила преимущественного проезда===
[[Файл:D3 tips p5.gif|справа]]
Соблюдение правил преимущественного проезда необходимо для обеспечения безопасности движения. Эти правила формулируются исходя из соображений здравого смысла и обязательны для выполнения всеми участниками дорожного движения.

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

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

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

'''Будьте внимательны по отношению к другим водителям.''' Приближаясь к нерегулируемым перекресткам и при отсутствии знаков STOP и YIELD, сбавьте скорость и будьте готовы остановиться. Уступите дорогу транспортным средствам, которые уже пересекают ваш путь или приблизились к перекрестку с правой стороны одновременно с вами. При движении через Т-образное пересечение дорог правом преимущественного проезда обладают транспортные средства, двигающиеся по прямой.

Если знаки STOP установлены по всем сторонам перекрестка, остановитесь первым, а затем продолжайте движение в соответствии с вышеизложенными правилами.

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

'''Не меняйте своих решений!''' Если, приближаясь к перекрестку, вы приняли какое-то решение (двигаться прямо или совершить поворот) доводите его до конца. Пытаясь изменить свое решение в последнюю секунду, вы можете создать аварийную ситуацию. Если вы пропустили нужный поворот, продолжайте движение до следующего перекрестка или зоны, где разрешен разворот.

===Ограничения скорости===
[[Файл:D3 tips p6.gif|справа]]
Правилами регулирования скорости движения в штате Калифорния установлено, что вы не имеете права двигаться со скоростью, превышающей безопасную для текущих дорожных условий, независимо от того, что указано на знаках ограничения скорости.

'''Максимальная разрешенная скорость.''' На большинстве калифорнийских дорог установлен предел скорости в 65 миль/час (~105 км/час). На некоторых дорогах разрешено движение со скорость до 70 миль/час (~113 км/час), что подтверждается установкой соответствующих знаков. На узких дорогах с двусторонним движением без разделительной полосы разрешенная скорость ограничивается 55 миль/час (~89 км/час). Помните, что все формальные ограничения скорости установлены применительно к идеальным дорожным условиям.

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

'''Слишком малая скорость.''' Движение с необоснованно малой скоростью, препятствующей нормальному транспортному потоку, считается нарушением правил.

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

'''Специальные ограничения.''' Разрешенная скорость движения вблизи школ, детских игровых площадок и парков ограничивается 25 миль/час (~40 км/час). Такой же предел скорости установлен при движении по большинству городских улиц в деловых и жилых кварталах.

По подъездным дорожкам, ведущим от основных дорог к прилегающим строениям, разрешается движение со скоростью не более 15 миль/час (~24 км/час).

При подъезде к "слепым" перекресткам, где видимость ограничена 100 футами (примерно 30 м) на дистанции в 100 футов от пересечения дорог или улиц, рекомендуется придерживаться скорости не более 15 миль/час. Вы можете двигаться быстрее, если на перекрестке для поперечного направления установлены знаки STOP или YIELD, дающие вам право преимущественного проезда.

'''Скорость и экономия топлива.''' Постоянно следите за скоростью движения, и этим вы сэкономите свои деньги. Минимальный расход топлива достигается при движении с постоянной средней скоростью. Не "дергайте" с места, разгоняйтесь плавно.

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

=== Разделительные линии. Движение по полосам ===
[[Файл:D3 tips p7.jpg|справа]]
'''Белые линии''' – обозначают границы полос движения при наличии двух и более полос, предназначенных для движения в одном направлении.

'''Желтые линии''' – разделяют транспортные потоки противоположных направлений на дорогах с двусторонним движением. Сплошная желтая линия запрещает выезд на встречную полосу для обгона или разворота.
<gallery>
D3_tips_lines1.jpg|Выезд на встречную полосу для обгона ЗАПРЕЩЕН
D3_tips_lines2.jpg|Выезд на встречную полосу для обгона ЗАПРЕЩЕН
D3_tips_lines3.jpg|Выезд на встречную полосу для обгона РАЗРЕШЕН
</gallery>

'''Пересечение двойной сплошной желтой линии разрешается только в случае:'''

* выполнения поворота налево на перекрестке, въезде или выезде с фривея на подъездную дорожку;
* или если правая полоса заблокирована, закрыта для движения.
[[Файл:D3 tips lines4.gif|центр]]

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

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

'''Полосы для выполнения поворотов.''' При повороте налево придерживайтесь как можно ближе к центральной разделительной линии, при повороте направо "прижимайтесь" к правому краю проезжей части. Не "срезайте угол" при выполнении левого поворота и не увеличивайте чересчур радиус при повороте направо, чтобы не выехать на полосу встречного движения.
[[Файл:D3 tips lines5.gif|центр]]
[[Файл:D3 tips lines6.gif|центр]]
'''Полосы для обгона.''' Никогда не выезжайте за пределы основной проезжей части дороги, которая обозначена белой линией, нанесенной на дорожное покрытие. Не занимайте без необходимости левую полосу (# 1), предназначенную для обгона.
[[Файл:D3 tips lines7.gif|центр]]
При обгоне попутных транспортных средств придерживайтесь левой стороны. Обгон справа разрешен только:

* на многополосных дорогах при условии хорошей видимости и достаточном пространстве для выполнения маневра;
* если водитель обгоняемого транспортного средства намеревается повернуть налево.

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

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

'''Центральная полоса для выполнения поворота налево.''' Если проезжая часть оборудована специальной центральной полосой, маркированной с обеих сторон двойной желтой линией – прерывистой и сплошной, при выполнении поворота налево вы должны использовать эту полосу. Разрешенная дальность движения по центральной полосе при выполнении поворота составляет не более 200 футов (примерно 60 м). Использовать центральную полосу для обгона других транспортных средств запрещается.
[[Файл:D3 tips lines8.gif|центр]]

=== Правила остановки и стоянки ===
[[Файл:D3 tips p8.jpg|справа]]
'''Правила остановки и стоянки на дороге с уклоном.''' Совершая остановку при движении под уклон, необходимо повернуть передние колеса автомобиля в сторону бордюра или края дороги, а затем поставить автомобиль на стояночный тормоз. Совершая остановку на подъеме, необходимо повернуть передние колеса автомобиля в сторону от бордюра, дать автомобилю возможность откатиться назад на несколько дюймов, чтобы краем переднего (правого) колеса коснуться бордюра, а затем поставить машину на стояночный тормоз. При отсутствии бордюров необходимо повернуть передние колеса автомобиля в направлении обочины с тем, чтобы исключить возможность самопроизвольного выезда автомобиля на середину дороги из-за неисправности стояночного тормоза.
<gallery>
D3_tips_parking1.jpg|Уклон с бордюром
D3_tips_parking2.jpg|Подъем с бордюром
D3_tips_parking3.jpg|Подъем/уклон без бордюра
</gallery>

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

'''Белая разметка''' – разрешена кратковременная остановка для посадки-высадки пассажиров, приема-выгрузки почты.

'''Зеленая разметка''' – разрешена остановка на ограниченное время, которое обычно указывается на информирующем знаке или наносится непосредственно на дорожное покрытие "зеленой зоны".

'''Желтая разметка''' – остановка разрешена на время, необходимое для выполнения погрузо-разгрузочных операций. Разрешенный лимит времени для выполнения указанных операций устанавливается местным дорожным законодательством.

'''Красная разметка''' – остановка запрещена.

'''Голубая разметка''' – разрешена только стоянка транспортных средств, принадлежащих людям с ограниченными физическими возможностями. Обычно оборудуется специальным дорожным знаком.
[[Файл:D3 tips parking4.gif|центр]]
'''Специальные правила стоянки.''' Постановка транспортных средств на стоянку должна производиться на расстоянии не более 18 дюймов (примерно 45 см) от обочины дороги (линий, обозначающих границы стояночной зоны).

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

'''Запрещается совершать остановку и покидать автомобиль:'''

* на перекрестках, пешеходных переходах и тротуарах;
* ближе, чем в 15 футах (4,5 м) от пожарных гидрантов или подъездов к пожарным станциям;
* на проезжей части дороги кроме особых случаев (аварийная остановка, остановка по требованию патруля или установленного дорожного знака);
* в тоннелях и на мостах кроме особых случаев (см. выше);
* в любых местах, оборудованных знаком "NO PARKING".
[[Файл:D3 tips parking5.jpg|центр]]
'''В общем случае остановка и стоянка транспортных средств запрещается,''' если таковые действия могут воспрепятствовать дорожному движению.

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

=== Внешние световые приборы и сигналы ===
[[Файл:D3 tips p9.jpg|справа]]
'''Звуковой сигнал применяется:'''

* в случаях, когда это необходимо для предотвращения ДТП;
* при попытке установить зрительный контакт с другим водителем, находящимся перед вами и намеревающимся выполнить какой-либо маневр;
* на узких горных дорогах при ограниченной видимости – не более 200 футов (примерно 60 м) по ходу движения.

'''Не нужно применять звуковой сигнал:'''

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

'''Включайте фары:'''

* в условиях неблагоприятной погоды (облачность, дождь, снег, туман);
* в условиях ограниченной видимости при любой погоде – если вы не можете увидеть других участников движения на дороге, то и они, вероятно, не могут видеть вас;
* на узких сельских и горных дорогах – это поможет другим водителям увидеть вас и избежать лобового столкновения;
* для привлечения внимания других водителей, которые могут не видеть вас. Помигайте фарами, если это необходимо для обеспечения безопасности движения.

Не забывайте выключать свет фар во время стоянки.

'''Используйте аварийную сигнализацию:'''

* в случае аварии вашего автомобиля и невозможности продолжить движение (совершая аварийную остановку, постарайтесь съехать на обочину и остановиться там, где ваш автомобиль будет хорошо виден сзади);
* чтобы предупредить водителей, следующих за вами, об опасности или ДТП по ходу вашего движения – особенно, если вам придется сделать вынужденную остановку.

'''Сигналы поворота.'''

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

При смене направления движения включайте соответствующий сигнал, по крайней мере, за 100 футов (30 метров) до места выполнения поворота. При смене полосы движения на многополосных дорогах постарайтесь включить сигнал поворота не позднее, чем за 5 секунд до совершения маневра.

'''Сигналы в случае вынужденного торможения или остановки.'''

При виде ДТП по ходу движения предупредите водителей, следующих за вами, о возможности вынужденной остановки – включите аварийную сигнализацию или 3–4 раза кратковременно нажмите на педаль тормоза.

=== Выбор безопасной дистанции ===
[[Файл:D3 tips p10.gif|справа]]
Помните, что выбор правильной дистанции от окружающих транспортных средств позволит вам уменьшить риск ДТП. Следите за дистанцией самостоятельно. '''Никогда не надейтесь на то, что другие водители "поделятся" с вами пространством на дороге!'''

Большинство столкновений с впереди идущими транспортными средствами вызваны несоблюдением безопасной дистанции. Чтобы не "въехать" в бампер машины, которая находится перед вами, руководствуйтесь "правилом 3-х секунд".

'''В тот момент, когда находящийся перед вами автомобиль проедет мимо какой-либо приметной точки (например, дорожного знака), начинайте отсчет: "одна-тысяча-один, одна-тысяча-два, одна-тысяча-три". Это займет как раз примерно 3 секунды. Если вы проследуете мимо выбранной отметки до завершения счета, значит дистанция от впереди идущей машины недостаточна и не соответствует требованиям безопасности движения.'''

'''При движении с большой скоростью или в сложных дорожных условиях желательно придерживаться "4-х секундной дистанции".'''

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

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

=== Движение в транспортном потоке ===
[[Файл:D3 tips p11.jpg|справа]]
При въезде на фривей постарайтесь придерживаться скорости, близкой к скорости основного транспортного потока. '''Никогда не делайте остановку перед присоединением к основному транспортному потоку кроме случаев крайней необходимости.''' Основному транспортному потоку принадлежит право преимущественного проезда. Чтобы пользоваться этим правом, старайтесь не "выпадать" из потока.

При перестроениях на фривее, въезде и выезде постарайтесь пользоваться "правилом 4-х секунд", чтобы сохранить безопасную дистанцию по ходу движения.

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

'''Тяжелые грузовики'''

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

Обычно требуется 10–12 секунд, чтобы водитель смог оценить ситуацию и при необходимости остановить свою машину. За это время трехосный грузовик с трейлером, двигающийся со скоростью 55 миль в час (около 90 км/час), в зависимости от дорожных условий сможет пройти расстояние почти в 800 футов (более 240 м).

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

У водителя грузовика существуют обширные "слепые зоны", находиться в которых опасно для других участников движения. В общем случае, если вы не видите лицо водителя грузовика в боковом зеркале его машины, значит, и он не может видеть вас.
[[Файл:D3 tips stream.gif|центр]]

Наиболее распространенные ошибки водителей при движении по соседству с грузовиком:

* "подрезка" при межрядных перестроениях и выезде с дороги – эти маневры нужно выполнять находясь позади грузовика, а не перед его "носом";
* задержки при обгоне – не нужно медлить при обгоне грузовика, находясь в "слепой зоне". Постарайтесь как можно скорее оказаться перед грузовиком, чтобы его водитель мог видеть вас;
* слишком малая дистанция от заднего борта грузовика (трейлера) – водитель грузовика не может видеть вас, а у вас не будет возможности совершить маневр, если грузовик резко затормозит;
* недооценка габаритов и скорости движения автопоезда – из-за больших габаритов скорость движения грузовика с трейлером кажется меньшей, чем она есть на самом деле. Подобные ошибки в оценке габаритов и скорости часто приводят к ДТП при проезде через перекрестки.

=== Совершение обгона ===
[[Файл:D3 tips p12.gif|справа]]
Постарайтесь не обгонять другие транспортные средства при движении по двухрядным дорогам. В этом случае обгон сопряжен с выездом на встречную полосу движения, '''что может быть очень опасно.'''

Перед совершением обгона вам нужно оценить безопасное пространство с учетом:

встречного транспортного потока (безопасное пространство – 1600 футов / около 500 м при скорости 55 миль/час);
ограниченной видимости на поворотах и подъемах (безопасное пространство – примерно 1/3 мили или 530 м);
приближения к пересечению дорог на пути следования;
текущих дорожных условий.

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

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

=== Движение и заторы ===
[[Файл:D3 tips p13.gif|справа]]
'''Предупреждение заторов на дороге.'''
Хронические "пробки" и заторы представляют собой одну из самых серьезных проблем при движении по дорогам Калифорнии.

Основные причины возникновения заторов:

* излишнее любопытство – водители слишком часто сбрасывают скорость, чтобы получше разглядеть сценки ДТП или какие-то другие необычные вещи, которые можно увидеть в пути;
* несоблюдение безопасной дистанции – служит причиной ДТП и лишает водителей возможности объехать препятствия, неожиданно возникающие на дороге;
* неоправданно частая смена полос при движении по многорядным дорогам – "виляние" в поисках свободных участков дороги обычно приводит к замедлению общей скорости транспортного потока;
* невнимательность – водители во время движения слишком часто отвлекаются на посторонние дела.

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

'''Конфликтные ситуации.''' Конфликты на дорогах могут возникнуть, когда кто-либо из водителей агрессивно реагирует на действия других водителей.

Чтобы не спровоцировать конфликты, последуйте этим советам:

* избегайте "подрезок" – присоединяясь к движению в том или ином ряду, сохраняйте безопасную дистанцию и предупреждайте других водителей сигналами;
* двигаясь с малой скоростью, не занимайте левую (скоростную) полосу дороги – это всегда раздражает других водителей;
* сохраняйте безопасную дистанцию по ходу движения – многие водители злятся, когда кто-нибудь висит у них на "хвосте";
* не жестикулируйте в адрес других водителей – держите руки на "баранке" и помните, что любой обидный жест может спровоцировать другого водителя на ответную агрессию;
* используйте звуковой сигнал только в крайнем случае – даже если вы посигналите из вежливости, это может быть неправильно понято другим водителем;
* избегайте зрительного контакта с раздраженным водителем – некоторые люди могут воспринять зрительный контакт как вызов с вашей стороны;
* держитесь подальше от агрессивного водителя – если во время движения вы совершите какую-нибудь (даже непреднамеренную) ошибку, для агрессивного человека это может послужить поводом, чтобы затеять драку.

=== Как избежать ДТП ===
[[Файл:D3 tips p14.gif|справа]]
Ведите себя так, чтобы другие участники движения могли понять, что вы собираетесь делать. Постарайтесь следовать приведенным ниже рекомендациям.

'''Не задерживайтесь в "слепых зонах"''' транспортных средств, движущихся с вами в одном направлении.

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

Учитывая формальные ограничения, '''не забывайте о здравом смысле''' – следите не только за знаками, но и состоянием дороги.

'''Аккуратно и внимательно совершайте повороты''' – вам следует уменьшить скорость и притормозить перед поворотом, а не во время поворота.

'''Будьте осторожны при движении по мокрой и скользкой дороге''' – на мокрой дороге "потеря контакта" между колесом автомобиля и дорожным покрытием возможна уже при скорости около 50 миль/час (80 км/час).

В сложных дорожных условиях рекомендуется уменьшить скорость по сравнению с обычной:

* на мокрой дороге – на 5–10 миль/час (8–15 км/час);
* на заснеженной дороге – примерно вдвое;
* при гололеде – перейти на "малый ход".
При '''движении в транспортном потоке''' старайтесь придерживаться общей для всех скорости. ДТП чаще всего происходят, когда кто-либо из водителей движется быстрее или медленнее других участников движения.

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

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

=== Вождение и алкоголь (наркотики) ===
[[Файл:D3 tips p15.gif|справа]]
Управление автомобилем в состоянии алкогольного или наркотического опьянения является опасным правонарушением. Под действием алкоголя или наркотиков человек, прежде всего, утрачивает то, что называется здравым смыслом. Находясь "под хмельком", водитель обычно не может правильно оценивать изменения дорожной ситуации и адекватным образом на них реагировать, чем подвергает большой опасности самого себя и других участников движения.

Лучшее, что можно сделать – это не садиться за руль даже после "глотка" спиртного. В среднестатистическом случае человеческому организму требуется примерно по 1-му часу для восстановления после каждой стандартной (0,33 мл) бутылки пива, бокала вина (140 мл) или рюмки (40 мл) более крепкого напитка.
Для водителей '''в возрасте 21 года и старше''' установлены следующие предельно допустимые концентрации (ПДК) алкоголя в крови:

* не более 0,08% – при управлении обычными транспортными средствами;
* не более 0,04% – при управлении коммерческими транспортными средствами.

Для водителей '''младше 21 года''' ПДК алкоголя в крови – не более 0,01%.

Однако не следует забывать: даже если содержание алкоголя в крови у водителя будет ниже установленного уровня ПДК – это еще не гарантия, что он сможет безопасно управлять своим автомобилем.

За управление транспортным средством в нетрезвом состоянии (превышение ПДК алкоголя в крови) к провинившемуся водителю, которому исполнился 21 год и в случае первого нарушения, по решению суда могут быть применены следующие санкции:

* тюремное заключение сроком от 48 часов до 6 месяцев;
* денежный штраф в размере от 390 до 1000 долларов;
* лишение водительских прав сроком на 6 месяцев;
* изъятие транспортного средства, если оно зарегистрировано на имя нарушителя, сроком на 6 месяцев с оплатой хранения на штрафной стоянке за счет нарушителя.

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

Статистика показывает, что 38% дорожно-транспортных происшествий, имеющих трагические последствия, происходит по вине нетрезвых водителей. За участие в ДТП, повлекшем тяжкие последствия для здоровья и жизни людей, нарушитель "правил трезвого вождения" может быть подвергнут не только административному, но и уголовному наказанию.

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

'''Перевозка алкогольных напитков и наркотических веществ.'''
Закон очень строг в отношении перевозки алкогольных напитков и наркотических веществ в автомобилях. Емкости с алкогольными напитками (пивом, вином, крепкими напитками), находящиеся в салоне автомобиля, должны быть полными и нераспечатанными. В противном случае их следует поместить в багажник или другое место, недоступное для пассажиров. Помните, что запрет на употребление алкогольных напитков в автомобиле распространяется не только на водителя, но и на пассажиров. Хранение распечатанной емкости с алкоголем в "бардачке" является противозаконным.

=== Здоровье и безопасность движения ===
[[Файл:D3 tips p16.gif|справа]]

'''Зрение'''

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

'''Слух'''

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

'''Внимательность'''

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

'''Последствия применения медикаментов'''

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

'''Самочувствие и эмоции.'''

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

=== Некоторые важные "мелочи" ===
[[Файл:D3 tips p17.gif|справа]]
'''Не садитесь за руль, если вы нездоровы или выведены из душевного равновесия.'''
'''Отрицательные эмоции – злость, грусть, обида и проч. – опасны для водителя.'''
'''Безрассудное вождение – не лучший способ дать выход своим эмоциям.'''
'''Не садитесь за руль после употребления алкоголя или наркотических веществ.'''
'''Не устраивайте гонки с "лихачами" или подвыпившими водителями.'''
'''Управление автомобилем в неадекватном физическом состоянии запрещено законом.'''
'''Водитель может быть признан нетрезвым (неспособным управлять автомобилем) даже после одной выпитой им бутылки пива.'''

{{Дб3}}

==Примечания==
[https://vk.com/pages?oid=-6026467&p=FAQ Источник]

Игровой регион (Дальнобойщики 2)

2025-12-05T12:15:14Z

Aleko 2144: Добавил обновлённую топографическую карту от Αίυαη Κεηοβί

[[Категория:Дальнобойщики 2]]
[[Файл:D2_topo_map.jpg|500px|thumb|right|Топографическая карта региона]]
'''Игровой регион''' в [[Дальнобойщики 2|Дальнобойщиках 2]] — вымышленная местность, прототипом которой частично являются Новосибирская область и Горный Алтай. Регион в первую очередь представлен одиннадцатью населёнными пунктами и соединяющими их дорогами (кроме участка [[Горный]] — [[Алмазный]]), а также спортивной трассой [[Кольцо|«Кольцо»]].

== География региона ==
Пейзажи игровой карты весьма разнообразны, несмотря на небольшие размеры по сравнению с другими подобными играми. Помимо лесов, занимающих значительную часть региона, на севере карты можно увидеть море ([[Бухта|порт прилагается]]), южнее — болота, с помощью которых удастся неплохо [[Секретные дороги|сократить путь]] при доставке грузов. На юго-востоке, по пути в Алмазный игрок обязательно встретит заснеженные горы, а окрестности самого Алмазного ни что иное как полупустыня. Кроме того, по некоторым местам проходят реки.

== Населённые пункты ==
Большинство населённых пунктов в игре выглядят довольно условно — в некоторых кроме [[База|базы]], стоянки и [[База#Диспетчерская|диспетчерской]] больше ничего может не быть. Другие же имеют хотя бы одну полноценную улицу с домами.

Всего в игре 11 населённых пунктов:
* '''[[Южный]]''' — город с аэропортом, центр округа Южный. Стартовая точка в игре. Окружающий ландшафт — лесостепь.
* '''[[Залесск]]''' — крупный по игровым меркам населенный пункт с расположенной неподалёку гоночной трассой «[[Кольцо|Кольцо]]». Окружающая природа — лиственные леса.
* '''[[Ельнино]]''' — населённый пункт, окружённый хвойными лесами.
* '''[[Ключи]]''' — населённый пункт сельского типа, проезд к которому осуществляется по грунтовой дороге.
* '''[[Бухта]]''' — город-порт, находящийся на севере игрового региона, центр округа Бухта.
* '''[[Приозёрск]]''' — крупный населённый пункт и транспортный узел, центр округа Приозёрск.
* '''[[Шахты]]''' — посёлок, расположенный недалеко от заброшенных шахт, в которых добывались ископаемые для [[Алмазный|алмазного комбината]].
* '''[[Боровое]]''' — посёлок, центр округа Боровое. Широкие дороги, окружающий ландшафт — хвойные леса.
* '''[[Нижнегорск]]''' — посёлок на берегу реки, в низовьях гор. Окружён густыми лесами.
* '''[[Горный]]''' — крупный населённый пункт, находящийся на самой высокой географической позиции в горах, на перевале. Центр округа Горный.
* '''[[Алмазный]]''' — промышленный город, причём закрытый. Окружающая местность — полупустыня, множество холмов и водоёмов.

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

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

Залесск и Ельнино в западной части региона хоть и по населению довольно крупные, но не настолько важные в деловом плане: в них течёт спокойная размеренная жизнь, местные жители промышляют продажей б/у автомобилей, из Залесска ездят в аэропорт Южного или на гоночное Кольцо на соревнования, а из Ельнино - в морской порт Бухты по отдельному скоростному шоссе.

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

Остальные населённые пункты совсем небольшие и мало чем выделяющиеся. Нижнегорск - маленький посёлок на берегу реки среди окружающих лесов. Шахты - совсем небольшой посёлок в предгорье, возле заброшенных промышленных шахт. Боровое - небольшой транзитный посёлок между севером и югом региона, имеет отдельный проезд на парковку через хвойный лес.

== Дороги ==
[[Файл:Нижнегорск-Горный.jpg|мини|Вид на трассу Нижнегорск — Горный]]
Дороги в игре можно условно разделить на несколько типов:
* '''Шоссе''' — занимает большую часть карты, преимущественно четырёхполосная асфальтированная трасса.
* '''Автомагистрали''' — высокоскоростные широкие участки дороги, полосы которых, как правило, разделены дорожными ограждениями. Ими же трассы отделяются от окружающей местности.
* '''Грунтовые дороги''' — таких участков трассы в игре три: подъезд к Ключам с обеих сторон, небольшой участок грунтовки на Кольце, и небольшой объездной путь на трассе Ельнино-Приозёрск рядом с нефтебазой.
* '''Бездорожье''' — все срезы, что есть в игре, а также существенная часть пути из Горного в Алмазный.

=== Дорожные работы ===
[[Файл:Tpmap_roadwork.jpg|300px|thumb|right|Карта дорожных работ [https://rnr-wiki.ru/images/9/97/Tpmap_roadwork.jpg (полный размер)] <ref>[http://truckpol.5v.pl/hard_truck_king_of_the_road.html Источник основы карты]</ref>]]
Как и в реальной жизни, дороги в игре иногда закрываются на ремонт. Правда, здесь такие ситуации случаются гораздо чаще, чем в отдельно взятой области реального мира. Некоторые участки дорог затапливаются, их заваливает камнями, а может и вовсе обвалиться мост. Все такие места изначально предопределены - это может быть, например, участок трассы Ельнино — Приозёрск, шахты, ведущие в Алмазный, или одна из сторон моста возле Бухты. Всего в игре 16 мест, где могут случиться дорожные работы; большая их часть связана с шахтами, которые иногда обваливаются в одном из восьми участков.

Все перекрытые из-за дорожных работ участки дорог можно объехать. Тот же закрытый мост возле Бухты можно преодолеть по соседней полосе; затопленные дороги тоже объезжаются неподалёку. Этим бывает очень выгодно пользоваться, так как за доставку грузов через закрытые на ремонт дороги выплачивается намного более высокая награда, а соперники об объездах не знают. К тому же, если при подъезде к перекрытому участку сохранить игру, а затем загрузить её, ремонтные работы пропадут.

== Объекты игрового мира ==
Чтобы разнообразить, на первый взгляд, крайне простой геймплей игры, разработчики ввели в неё много дополнительных элементов, одними из которых также являются '''объекты игрового мира'''. Их можно встретить в самых разных уголках карты.

=== Находятся только в пределах населённых пунктов ===
* '''[[База|Базы]]''' — главный элемент каждого населённого пункта — места, где происходит погрузка\разгрузка товаров. В них иногда встречаются нелегальные грузы (после достижения определённого процента грузоперевозок в регионе).

=== Находятся за пределами населённых пунктов ===
[[Файл:Наливная.png|250px|thumb|справа|Нефтебаза ]]
* '''[[База#Нефтебаза|Нефтебазы]]''' — рядом с каждой есть [[Полуприцепы|прицепы-цистерны]], с помощью которых можно перевозить топливо. Перевозка горючего приносит несколько более высокий доход по сравнению с обычными грузами, но при этом вам не даются лицензии на найм. Соперники отсутствуют.
* '''Заправочные цистерны''' — как правило, находятся на [[Секретные дороги|скрытых дорогах]]. Позволяют заправить автомобиль, если поблизости нет АЗС, или в случае выхода из строя ближайшей официальной АЗС вследствие подрыва игроком или NPC.
[[Файл:Вормашина.png|250px|thumb|справа|Ворованный [[Навистар Игл|International Eagle]]]]
* '''Ворованные автомобили''' — спрятаны недалеко от трассы за деревьями или холмами. Встречаются только в западной части карты на участках Залесск-Ельнино-Бухта и Южный-Приозёрск-Ельнино, всего 5 мест продажи таких автомобилей. Отсутствуют в восточной части карты на участках Шахты-Нижнегорск, Ключи-Алмазный и трассе Бухта-Приозёрск. У каждого ворованного автомобиля тоже есть свой продавец, с которым можно связаться по рации.

=== Встречаются везде ===
* '''[[АЗС]]''' — позволяют заправить своё транспортное средство. В Залесске и Приозёрске расположены внутри города. В Ельнино и Горном присутствуют непосредственно возле городской черты на подъезде с южной стороны. Все остальные АЗС расположены на трассах.
* '''[[СТО]]''' — предназначены для ремонта и апгрейда транспорта. В Бухте и Алмазном присутствуют внутри города, а также в непосредственной близости от городской черты есть на южном подъезде к Нижнегорску и с западной стороны от Шахт и Южного. Все остальные СТО расположены на трассах.
* '''[[Секретные грузы]]''' — контейнеры с грузами, спрятанные обычно в стороне от дороги - на бездорожье или скрытых путях. Внутри населённых пунктов бывают только в Приозёрске и Алмазном.
* '''[[База#Диспетчерская|Диспетчерские]]''' — справочные киоски, предоставляющие информацию о грузах, местах доставки и оставшемся времени присутствия грузов на базе. В населённых пунктах, как правило 2 диспетчерских — на въезде и на выезде.
* '''Стоянки''' — на них можно взять на работу наёмника, купить новый автомобиль, уже стоящий на стоянке, либо связавшись с помощью [[Рация|рации]] с продавцом, заказать любой понравившийся автомобиль, имеющийся у него в продаже, который он за отдельную плату доставит в соседний населённый пункт. У каждой продаваемой машины есть свой продавец, у которого свой выбор доступных к заказу машин. Также каждого продавца можно попросить о помощи с ремонтом автомобиля. Но если на стоянке нет автомобилей на продажу (или есть только водители, ищущие работу), то вызвать продавца не получится.
* '''Радары''' - или, если точнее, камеры фотовидеофиксации. Моментально штрафуют за превышение скорости от 5 км/ч и выше с соответствующим визуальным уведомлением. При получении штрафа если не снижаете скорость - может тут же прилететь повторный и даже третий штраф от того же самого радара. Радар может сработать, даже если вы его уже немного проехали (на совсем небольшое расстояние). Радары-камеры присутствуют только в области Южный-Залесск-Ельнино-Приозёрск, а также в Горном и на подвесном мосту Бухты. Отсутствуют на трассах Бухта-Приозёрск (до въезда в Приозёрск, там в версиях 8.х обычно бывает мусорно, т.е. есть патрули с радарами), Бухта-Ельнино (до въезда в Ельнино), Залесск-Шахты-Боровое-Нижнегорск-Горный(кроме городской черты Горного)-Алмазный, и от Бухтинского моста до Нижнегорска. В городской черте Залесска хоть радар и отсутствует, но есть ограничение скорости, так что в версиях игры 8.х превышение может быть зафиксировано милицейским патрулём.
* '''Стоячие патрули''' - милицейские машины, припаркованные на обочине, которые следят за тем, чтобы только вы не нарушали правопорядок. В версиях игры 8.х могут фиксировать, помимо остальных нарушений, ещё и превышение скорости. Радары патрульных машин действуют на намного большем расстоянии, чем стационарные радары на столбах.
* '''[[Полуприцепы]]''' — необходимы для перевозки грузов на седельных тягачах. Бывают 3 видов: фургоны (для перевозки грузов на любом тягаче кроме Шторма), цистерны (для перевозки топлива на любом тягаче кроме Шторма), а также специализированные фургоны для тягача Шторм (не подходящие больше ни к каким другим машинам). Возле складов обычно стоят пустые полуприцепы-фургоны обоих видов (для Шторма и для остальных тягачей), а возле нефтебаз - полуприцепы-цистерны (для всех тягачей кроме Шторма, т.к. для Шторма перевозка топлива не предусмотрена). А на трассах могут встречаться уже загруженные полуприцепы всех трёх видов, товар в которых предназначен для разовой доставки без конкурентов в какой-либо пункт назначения. На карте полуприцепы с грузом обозначены жёлтыми вагончиками, их обычно 10шт во всём регионе.
* '''Подержанные автомобили''' — можно встретить на обочине возле дороги в населённых пунктах или рядом с СТО, всего 5 мест продажи таких автомобилей. Встречаются только в западной части региона на участках Южный-Ельнино и Южный-Приозёрск. Отсутствуют в восточной части карты на участках Шахты-Нижнегорск, Ключи-Алмазный и трассе Бухта-Приозёрск (до въезда в сам Приозёрск). У каждого подержанного автомобиля, как и у ворованного, есть свой продавец, выполняющий те же функции.
* '''Церкви''' - христианские заведения с латинским крестом, т.е. католические или протестантские (видимо, из-за ориентированности игры на западную аудиторию), присутствуют по сути в качестве бутафории, не влияя на игровой процесс. Одна церковь находится в южной части Ельнино, другая - на северном подъезде к Залесску, и один, судя по удалённому расположению, монастырь - на подъезде к Горному с севера, на холме.

== Игровой регион в версиях 4.0-5.5 ==
В первых версиях игры, предназначенных для запада, игровой мир хоть и повторяет своими очертаниями вариант из российского релиза (вышедшего, к слову, только через год после западного), но всё-таки очень сильно отличается во многих местах:
* Первое и самое значительное отличие в карте — выезд с Южного с обеих сторон. В 4.0-5.5 эти участки имеют совсем другой маршрут; отсутствуют дамба, мост, река, СТО. «Перемычка», соединяющая их, выглядит как простая дорога в лесу; отсутствует лесное хозяйство вдоль объездной дороги Южного, которое в финальных версиях игры ограждено забором и имеет два закрытых въезда (в которые проехать не возможно);
* АЗС на повороте к Южному расположена прям на перекрёстке, по другую сторону дороги чем в финальной версии;
* Отсутствует стоянка (соответственно и подъезд к ней) возле Борового; в Ключах наоборот, присутствует официальная стоянка на два машиноместа - по одному с противоположных сторон от базы;
* Въезд на трассу Ельнино — Приозёрск расположен несколько дальше от населённого пункта - напротив АЗС-30 (по нумерации более новых версий);
* Стоянка на трассе Ельнино-Приозёрск сильнее удалена от Приозёрска, и находится ближе к середине трассы; стоянка в самом Приозёрске расположена напротив базы (т.е. на внешней кольцевой дороге), а не на внутреннем малом кольце в спальном районе, а также есть ещё одна стоянка на выезде в сторону Бухты;
* В западной части мира используется намного менее яркая текстура травы, что делает игру несколько мрачной. Исключение - трасса Ельнино — Приозёрск, где наоборот, трава чрезмерно зелёная;
* В целом, очень много текстур выглядят иначе и имеют меньшее в 2 раза разрешение;
* На трассе Шахты — Боровое СТО и заправка отнесены на некоторое расстояние от дороги и имеют отдельный подъезд к себе;
* Ландшафт и дорога в значительной части мира менее полигональны;
* Помимо привычных, встречаются большие СТО в виде ангаров со сквозным проездом;
* Отсутствуют нефтебазы, следовательно, АЗС не имеют нумерации;
* Отсутствуют какие-либо скоростные ограничения и радары (соответственно, нет улучшения «Антирадар»);
* Отсутствуют светофоры;
* Населённые пункты обставлены значительно беднее. Также, на трассах гораздо меньше декоративных объектов и знаков, отсутствуют статичные люди и животные.
* Во многих местах отсутствуют ограждения (заборы) вдоль трассы, особенно на трассе Ельнино-Залесск и Ельнино-Приозёрск (но и на других дорогах тоже). Вокруг дороги намного меньше одиночных деревьев, так что ощущение простора вокруг дороги больше.

== Интересные факты ==
* Размеры игрового мира составляют примерно 9550x11030 м<ref>Данные получены исходя из файлов aa.b3d, ap.b3d и bb.b3d. Цифры приблизительные, так как настоящий размер пустыни в Алмазном [[Участник:Aleko_2144|мне]] неизвестен.</ref>.
* При самом быстром масштабе времени одни игровые сутки проходят за 72 секунды, и в таком случае 1 секунда реального времени равна 20 игровым минутам. При самом длинном масштабе одни игровые сутки проходят примерно за 1872 секунды (31 минута 12 секунд), и тогда за 1 секунду реального времени пройдут около 46 игровых секунд<ref>Данные актуальны для версии 8.2.</ref>.

== Галерея ==
<gallery>
Файл:Map.gif|Оригинал топографической карты от SoftLab-NSK
Файл:New_topo_map_DB2.jpg|Обновленная топографическая карта с учётом реальных игровых дорог за авторством Αίυαη Κεηοβί
Файл:Карта дб2.png|Карта с прозрачным фоном
Файл:SuperCargoMap.jpg|Карта с отмеченными скрытыми грузами и дорогами
Файл:Maps color comment.png|Карта версии 7.4 в 3Ds Max
Файл:RepairMap.jpg|Карта расположения СТО
Файл:FuelMap.jpg|Карта расположения АЗС и топливных цистерн
Файл:EnvMap.jpeg|Карта с обозначением регионов в игровых файлах
</gallery>

{{Игровой_регион_(Дб2)}}
{{Дб2}}

== Примечания ==

Файл:New topo map DB2.jpg

2025-12-05T12:14:03Z

Aleko 2144: Aleko 2144 загрузил новую версию Файл:New topo map DB2.jpg

== Краткое описание ==
Обновленная топографическая карта за авторством Αίυαη Κεηοβί. Дороги взяты из игры, а всё остальное перерисовано с оригинальной топографической карты. Добавлены значения высот для изобат и рек. Многие дороги находятся как бы в "ущелье", поэтому лежат ниже изобат.

Файл:New topo map DB2.jpg

2025-12-05T12:08:06Z

Aleko 2144: Обновленная топографическая карта за авторством Αίυαη Κεηοβί. Дороги взяты из игры, а всё остальное перерисовано с оригинальной топогра…

История версий (Дальнобойщики 2)

2025-11-08T09:56:03Z

Aleko 2144:

[[Категория:Дальнобойщики 2]]
В этой статье описана хронология разработки и все известные версии '''"Дальнобойщиков 2"'''.

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

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

[[Image:button_01_dev.jpg|link=История_версий_(Дальнобойщики_2)#Разработка_игры]][[Image:button_02_ht2.jpg|link=История_версий_(Дальнобойщики_2)#Hard_Truck_2]][[Image:button_03_rnr.jpg|link=История_версий_(Дальнобойщики_2)#Дальнобойщики_2]]

[[Image:button_04_kotr.jpg|link=История_версий_(Дальнобойщики_2)#King_of_the_Road]][[Image:button_05_kotr_ru.jpg|link=История_версий_(Дальнобойщики_2)#Дальнобойщики_2_Издание_второе,_дополненное]][[Image:button_06_loc.jpg|link=История_версий_(Дальнобойщики_2)#Прочие локализации]]

<div class="mw-customtoggle-TOC" style="background:#e0e8ff">'''Развернуть полное содержание'''</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-TOC">
<div class="mw-collapsible-content">__TOC__</div>
</div>

== Разработка игры ==
=== 1998 год ===
Разработка игры началась в мае 1998 года.<ref>[http://web.archive.org/web/20000610020212/http://www.ga-source.com/interviews/hardtruck2.shtml Согласно интервью]</ref>. На самых ранних скриншотах с неизвестной датой<ref>Источник - [https://archive.org/details/Game.EXE_07_1999/page/n75/mode/2up журнал Game.EXE за июль 1999 г.], но эти скриншоты явно старше любых других</ref> можно увидеть ЗиЛ из [[Дальнобойщики: Путь к победе|первой части]] с полуприцепом на трассе [[Игровой регион (Дальнобойщики 1)#Кольцо|"Кольцо"]] оттуда же, а также ранний [[Залесск]].
<gallery>
ht2_1998_01.jpg
ht2_1998_02.jpg
</gallery>

В самом раннем [https://archive.org/stream/GameWorldNavigator_1998-07-015#page/n103/mode/2up превью игры] из журнала "Навигатор игрового мира" за июнь 1998 упоминаются следующие особенности:
*По изначальной задумке мы не только должны были вывозить технические алмазы с комбината, но и привозить на него породу для переработки из ближайшего посёлка, в котором она добывалась. Добраться до посёлка можно было по нескольким перекрытым блок-постами дорогам и по одной скрытой.
*Товар загружался по тому же принципу, что и в первой части - его необходимо было покупать на собственные деньги.
*Товар на базах должен был постепенно заканчиваться. При нехватке определённого товара на одной базе, можно было получить заказ на доставку этого товара с другой, где этот товар есть с излишком. В финальной реализации каждая база имеет предопределённый список возможных товаров, которые можно загрузить, и никакой системы потребностей в товаре нет - пункты назначения выбираются случайно.
*Из связи с внешним миром предполагался только порт (в который должны были переправляться алмазы). В финальной версии к нему присоединился аэропорт.
*Предполагалось разделение топлива на дизельное и бензин.
*Мафия могла бы отобрать не только деньги и груз, но и грузовик.

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

К концу 1998 года игра всё ещё использует некоторый контент из первой части: большую часть транспорта (среди которого из нового появляется только [[Газель]]), текстуры дорог и принцип нанесения разметки на некоторые из них. На скриншотах уже демонстрируется смена дня и ночи. Из нестандартных объектов можно увидеть ранний вариант [[СТО]].
 

Скриншоты, кроме последних пяти, датированы 2-3 декабря 1998 г.
<gallery>
Файл:photo_03.jpg|Как и в первой части серии, из кабины не видно капот грузовика
Файл:photo_06.jpg|
Файл:photo_07.jpg|
Файл:photo_10.jpg|
Файл:photo_13.jpg|
Файл:photo_14.jpg|В ранних версиях горы имели заснеженный вид
Файл:photo_21.jpg|
Файл:photo_22.jpg|Для текстуры гор частично заимствован фон трассы "Горный" из первой части.
Файл:photo_23.jpg|
Файл:photo_34.jpg|
Файл:photo_36.jpg|
Файл:photo_48.jpg|
Файл:photo_53.jpg|
Файл:photo_50.jpg|
Файл:PHOTO309.jpg|
Файл:X_a3de8ef4.jpg|Здесь и далее - иллюстрации из справки к Hard Truck 2
Файл:RepairBeta1.jpg|Первый вариант СТО
Файл:ht2_help_bm41.png|
Файл:ht2_help_bm42.png|
Файл:ht2_help_bm44.png|
</gallery>

=== 1999 год ===
К середине года игра всё ещё имеет текстуры дороги с полностью белой разметкой. На скриншотах можно увидеть большую часть релизного транспорта, встречаются также и необычные экземпляры в виде [[Газель#ГАЗель Милиция |милицейской Газели]] и [[Неизвестный спорткар|спорткара]]. К слову, идентификатор милицейской ГАЗели присутствует во всех релизных версиях игры в файле [[Sch-файлы#vd.sch | vd.sch]].
 

Скриншоты, кроме последних двух, датированы 25-26 августа 1999 г. На скриншотах демонстрируются [[Ельнино]] и маршруты до [[Залесск]]а и [[Приозёрск]]а.
<gallery>
Файл:photo020.jpg|Ранняя застройка Ельнино
Файл:photo023.jpg|
Файл:photo003.jpg|Стоянка в Ельнино
Файл:photo005.jpg|
Файл:photo000.jpg|
Файл:photo026.jpg|
Файл:photo055.jpg|
Файл:photo001.jpg|Дорога на Ельнино
Файл:photo002.jpg|
Файл:photo004.jpg|
Файл:photo006.jpg|
Файл:photo007.jpg|[[АЗС|Заправка]] у поворота на Приозерск
Файл:photo051.jpg|
Файл:photo052.jpg|
Файл:photo038.jpg|Синяя Газель у заправки
Файл:photo010.jpg|Поворот на Приозерск
Файл:photo011.jpg|
Файл:photo013.jpg|
Файл:photo014.jpg|
Файл:photo009.jpg|
Файл:photo015.jpg|Возле старого варианта [[СТО]] неподалёку от Ельнино
Файл:photo018.jpg|
Файл:photo068.jpg|
Файл:photo090.jpg|
Файл:photo100.jpg|
Файл:photo108.jpg|
Файл:photo126.jpg|
Файл:RepairBeta2.jpg|Ранний вариант СТО на трассе Залесск-Ельнино
Файл:photo012.jpg|Диспетчерская в Залесске
Файл:photo016.jpg|
Файл:photo021.jpg|
Файл:photo027.jpg|
Файл:photo053.jpg|
Файл:photo101.jpg|
Файл:photo104.jpg|
Файл:photo106.jpg|
Файл:photo110.jpg|
Файл:photo120.jpg|
Файл:Шторм дорелизная кабина.jpg|
Файл:ht2_help_bm56.png|Иллюстрация из справки к Hard Truck 2
</gallery>

=== Конец 1999 года ===
Игра уже во многом похожа на релизную версию 4.0. Из весомых отличий можно отметить совершенно другой эффект мокрого асфальта и отличающуюся реализацию воды. Также можно заметить, что на тот момент ещё не была проработана до конца панель состояния - на всех скриншотах на ней не меняются позиция игрока, оставшееся время, состояние прицепа и направление навигатора.
<gallery>
ht2_prerelease2000_01.jpg|Ранний вариант СТО на трассе Приозерск - Ельнино
ht2_prerelease2000_02.jpg|
ht2_prerelease2000_03.jpg|
ht2_prerelease2000_04.jpg|Мосты всё ещё имеют белую разметку
ht2_prerelease2000_05.jpg|
ht2_prerelease2000_06.jpg|
ht2_magazines_01.jpg|
ht2_magazines_02.jpg|
ht2_prerelease2000_07.jpg|Мокрая дорога очень напоминает свою реализацию в третьей части
ht2_prerelease2000_08.jpg|
ht2_prerelease2000_09.jpg|
ht2_prerelease2000_10.jpg|
ht2_prerelease2000_11.jpg|Старые указатели
ht2_prerelease2000_12.jpg|Ранняя панель информации об игроке
ht2_prerelease2000_24.jpg|
ht2_prerelease2000_25.jpg|В Шахтах ещё не поставили блоки, перекрывающие дорогу
ht2_prerelease2000_13.jpg|
ht2_prerelease2000_14.jpg|
ht2_magazines_03.jpg|
ht2_magazines_04.jpg|
ht2_prerelease2000_15.jpg|
ht2_prerelease2000_16.jpg|
ht2_prerelease2000_17.jpg|
ht2_prerelease2000_18.jpg|
ht2_prerelease2000_19.jpg|
ht2_magazines_05.jpg|
ht2_prerelease2000_20.jpg|
ht2_magazines_06.jpg|
ht2_prerelease2000_26.jpg|Подъезд к Бухте со стороны моря не имеет ограждения
ht2_magazines_07.jpg|
ht2_magazines_08.jpg|
ht2_magazines_09.jpg|
</gallery>

=== Ранний 2000 год ===
Панель состояния уже полноценно работоспособна, вода обрела эффекты ряби и волн (использующие Environment-Mapped Bump Mapping), которые сильно изменятся к выходу игры. Одна из сборок того периода разработки использовалась для снятия демо-ролика<ref>Дата создания ролика предположительно не позже февраля 2000.</ref>, вошедшего в релиз Hard Truck 2.
<gallery>
ht2_prerelease2000_21.jpg|Первые демонстрации воды с EMBM
ht2_prerelease2000_22.jpg|Renaul Magnum с текстурой кузова из первой части
ht2_seaday.jpg|
ht2_seaday_m.jpg|
ht2_seanightM.jpg|
ht2_prerelease2000_23.jpg|
ht2_prerelease2000_27.jpg|
ht2_prerelease2000_28.jpg|
ht2_prerelease2000_29.jpg|
ht2_prerelease2000_30.jpg|
ht2_prerelease2000_31.jpg|
ht2_prerelease2000_32.jpg|
HTruck2demo_1.png|На развязке отсутствуют указатели
HTruck2demo_2.png|Наличие разметки на перекрёстке по трассе Приозерск - Южный
HTruck2demo_3.png|Сообщение о занятом месте приходит на пейджер
HTruck2demo_4.png|Ранняя расцветка кузова Скании
HTruck2demo_5.png|Мост на трассе Приозёрск - Южный. Отсутствует ограждение
V5.png|Посторонний трафик и полиция в шахтах
</gallery>

== Hard Truck 2 ==
Игра выпущена в Северной Америке под названием '''Hard Truck 2''' 15 мая<ref>[https://www.eurogamer.net/articles/article_27244 Источник]. 25 апреля игра ушла "на золото", 1 мая 2000 датирован пиратский релиз от группы [https://defacto2.net/f/ad21cd4 MYTH TEAM], по всей видимости украденной, либо слитой копии игры</ref> 2000-го года силами издательства ValuSoft. Ввиду того, что игра сильно, и в основном в худшую сторону отличается от более позднего российского релиза, в русскоязычном сообществе игру иногда называют ''бета'' или ''демо'' версией.

=== Версия 4.0 ===
[[Файл:ht2ico4.0-5.5.jpg|Иконка начиная c версии 4.0|64px|right]]
[[Файл:Ht4.0enlogo.jpg|Заставка версии 4.0|безрамки]]

Особенности по сравнению с более поздним российским релизом игры в 2001 году:

'''Игровой процесс''' 
* Ватная управляемость и заносы;
* Отсутствует [[рация]] и все связанные с ней возможности;
* Нет светофоров, ограничений скорости и радаров - соответственно, нет штрафов за эти виды нарушений, и нет улучшения «Антирадар»;
* Отсутствуют нефтебазы и, соответственно, цистерны для перевозки топлива;
* Нельзя взрывать [[АЗС|заправки]];
* Отсутствует дальний свет Ctrl+L;
* Нет большинства легковых автомобилей — в том числе и в роли трафика и декораций;
* Возможность поставить игру на паузу только клавишей Pause, т.к. клавиши F1-F4 и Esc не останавливают игровой процесс, но на Esc и F4 пропадает возможность контролировать машину (потому что стрелки служат для навигации по этим разделам),что сильно усложняет возможность сохраниться во время гонки или посмотреть количество наличных денег;
* Нет быстрого сохранения/загрузки;
* В меню Esc отсуствует пункт "Загрузить игру" (чтобы загрузить другое сохранение, нужно выходить в Главное меню);
* Нельзя вернуться на только что проданный автомобиль, т.к. после продажи он уезжает, а не остаётся на перепродажу;
* Присутствует возможность поворачивать камеру мышью при виде из кабины;
* Отсутствует монитор заднего вида;
* Трафик часто ведёт себя неадекватно;
* Встречные машины на поворотах часто заносит с дрифтом боком, в том числе с вылетом на вашу полосу;
* Трафик можно встретить на скрытых путях;
* NPC умеют совершать обгон по обочине на полном ходу, не задевая обгоняемую машину;
* При загрузке сохранённой игры техническое состояние машины и количество топлива автоматически поднимаются до 100%, так что при частых сохранениях и загрузках можно вообще не ремонтировать и заправлять машину;
* Немного отличаются характеристики скоростей некоторых машин, например, у Зила-фургона всего 5 передач а не 6, так что по ровной дороге без уклона его максимальная скорость составляет около 110-120 км/ч, а у Зила-тягача 85-90 км/ч; аналогично Reno-фургон выдаёт всего 95 км/ч;
* В целом практически все машины медленнее набирают скорость (будто дефорсированы с завода) и менее устойчивы в управлении, несмотря на совпадение технических характеристик с таковыми в более новых версиях;
* Более низкая стоимость заправки (полный бак Зила стоит чуть больше 100 долларов, что по игровым меркам пренебрежимо мало);
* Более низкая стоимость от 1.5 до 3 раз у некоторых улучшений на СТО (форсированный двигатель, вентилируемый тормоз, шины);
* Немного отличается цена некоторых автомобилей, например, стартовый Зил-фургон стоит $25500 (против $22000 в версиях от 6.х и выше);
* На кольцевых гонках за победу дают 5000 долларов (против 20000 в версиях 6.х - 7.х);
* У контрабандных грузов хрупкость не занижена до 0%;
* Отсутствуют в продаже подержаные и ворованые машины;
* Более существенная тряска и потеря скорости машины при съезде с проезжей части на грунт (что усложняет объезд, например, бухтинской мостовой развязки-клевера, и преодоление других грунтовых срезов);
* На срезах между Боровым и Приозёрском машина не застревает в проездах через болото, так что можно использовать любой срез а не только самый верхний;
* Перепад высоты асфальта на въезде на СТО и АЗС, на котором машину может сильно подкинуть вверх (особенно легковую), так что въезжать нужно на небольшой скорости (что ближе к реальной жизни, но усложняет гонку с соперниками);
* За доставку контейнеров дают лицензии (по крайней мере иногда);
* При обмене местами с вашим наёмником вы всегда первый в гонке, т.к. соперники начинают появляться и выезжать со склада отправления только после совершения этого обмена (таким образом, можно всегда выигрывать гонки и получать лицензии не напрягаясь, при этом быстро оказываясь в разных местах карты на разных парковках).

'''Графика''' 
* Лучистый свет от фар, капли дождя на стекле;
* Многие текстуры отличаются прорисовкой или оттенком, либо меньшего разрешения; в целом тона зелени менее насыщенные и напоминают позднюю осень;
* Меньше детализация ландшафта и дорог;
* Зеркала у всех машин расположены выше, от чего будто висят в воздухе;
* Не поддерживается разрешение экрана 1600х1200;
* Пыль из под колёс на грунтовых дорогах практически полностью лишает обзора из кабины;
* Отсутствуют летаюшие опавшие листья и пылевые вихри в воздухе;
* Отсутствует звук работы пневмоклапанов при торможении.

'''Интерфейс''' 
* Спидометр показывает мили<ref>Можно изменить на километры в файле ''truck.ini'', так же и в более поздних версиях можно сделать мили вместо километров</ref> и работает без задержек;
* На панели состояния не отображается количество лицензий на найм и срок их истечения;
* Количество наличных денег и лицензий можно посмотреть только на F4, а оставшийся срок действия лицензий посмотреть не возможно; на F3 показывает не количество наличных денег, а суммарный капитал вместе со стоимостью транспорта (дублируя эти сведения из F4, что по сути бесполезно);
* Отсутствуют аватары водителей;
* Карта имеет только один масштаб, показывающий весь мир целиком; вместо стрелки, указывающей местоположение и направление игрока, используется значок грузовика; не подсвечивается пункт назначения (посмотреть его можно только на F3);
* Секретные дороги не указываются (даже с чит-кодом); не отображаются места аварийного ремонта дорог (узнать о закрытой трассе можно только по сообщениям на пейджере);
* Сообщения о неустойках и штрафах приходят на пейджер;
* Другая иконка exe-файла игры; квадратная заставка при запуске;
* Разделы главного меню оформлены иначе;
* Кнопки меню не подсвечиваются при наведении курсора;
* Курсор прорисовывается очень медленно.

'''Игровой мир''' 
* Небольшие отличия в ландшафте местности [[Игровой регион (Дальнобойщики 2)|игрового мира]] и участков дорог, немного смещены некоторые АЗС, СТО, парковки, с сохранением общей схемы и глобальной планировки карты;
* Меньшая насыщенность местности деревьями и прочими декоративными объектами и зданиями, во многих местах трассы отсутствуют ограждения (где в более поздних версиях они появились);
* Американские дорожные знаки;
* Мины на дорогах с самого начала игры;
* Отсутствует декоративный транспорт на стоянках.

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

=== Версии 4.4-5.3 ===

<div class="mw-customtoggle-htpatches" style="background:#e3f1da">Нажмите на эту строку, чтобы узнать подробнее о промежуточных патчах к Hard Truck 2.</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-htpatches">
<div class="mw-collapsible-content">
<big>'''Версия 4.4'''</big> 
[[Файл:Ht4.4enlogo.jpg|Сплэшскрин версии 4.4|безрамки]]

Вышла 16-го мая 2000 года. Исправляет некоторые проблемы с Direct3D на видеокартах Voodoo<ref>Здесь и до версии 5.3 включительно изменения указаны согласно документации.</ref>.

<big>'''Версия 4.5'''</big> 
[[Файл:Ht4.5enlogo.jpg|Сплэшскрин версии 4.5|безрамки]]

Патч от 25-го мая 2000 года.

<big>'''Версия 4.7'''</big> 
[[Файл:Ht4.7enlogo.jpg|Сплэшскрин версии 4.7|безрамки]]

Версия от 2-го июня 2000 года. Устраняет некоторые проблемы с Direct3D на видеокартах Voodoo, а также решает проблемы с джойстиками.

<big>'''Версия 5.0'''</big> 
[[Файл:Ht5.0enlogo.png|Сплэшскрин версии 5.0|безрамки]]

Версия игры 5.0 издавалась на дисках и не выходила в виде патча. Исполняемый файл датирован 11 июня 2000 года.

<big>'''Версия 5.1'''</big> 
[[Файл:Ht5.1enlogo.jpg|Сплэшскрин версии 5.1|безрамки]]

Патч вышел 24-го июня. Изменения аналогичны предыдущей версии.

<big>'''Версия 5.3'''</big> 
[[Файл:Ht5.3enlogo.jpg|Сплэшскрин версии 5.3|безрамки]]

Версия, датированная 23 августа. Изменения аналогичны предыдущим версиям.
</div></div>

=== Версия 5.5 ===
[[Файл:Ht5.5enlogo.jpg|Сплэшскрин версии 5.5|безрамки]]

Версия 5.5 появилась 5-го октября 2000 года. Изменения по сравнению с версией 4.0<ref>Возможно, что некоторые изменения появились в предыдущих версиях.</ref>:
* Мины на дорогах теперь появляются только при достижении 30% грузоперевозок (но остаются постоянно, а не только когда на вас охотится мафия как в более поздних версиях);
* Существенно уменьшена ватность управления;
* Эффекты дождя и тумана были несколько изменены;
* Километры вместо миль на спидометре и работа спидометра с небольшой задержкой;
* Заменена иконка Кольца на более заметную.
Кроме того, согласно документации, обновление игры до версии 5.5:
* Делает игру более стабильной;
* Исправляет проблему с отсутствием звука в Windows Me;
* Исправляет проблему с пропаданием окружения на ускорителях Voodoo;
* Исправляет проблемы с некоторыми моделями ускорителей, имеющими 8 мегабайт памяти;
* Исправляет проблему с пропаданием дороги;
* Делает ИИ более осторожным;
* Вводит в игру чит-код «MINESOFF», убирающий мины.

=== Версия 5.8 ===
''См. раздел [[История версий (Дальнобойщики 2)#Truck Racing 2001 — Os Gigantes da Estrada|Truck Racing 2001 — Os Gigantes da Estrada]]''

=== Галерея версий 4.0-5.5 ===

'''Оформление коробочного издания'''
<gallery>
Файл:ht2_bigbox_cover.jpg|Обложка коробки
</gallery>

'''Оформление издания в картонном рукаве''' 
<gallery>
Файл:ht2_sleeve.jpg|Рукав спереди
Файл:ht2_sleeve_back.jpg|Рукав сзади
Файл:ht2_jewel_back.jpg|Задняя сторона Jewel-box с игрой
Файл:ht2_manual1.jpg|Вкладыш с кратким руководством. Сторона 1
Файл:ht2_manual2.jpg|Вкладыш с кратким руководством. Сторона 2
Файл:ht2cd.jpg|Оформление диска.
</gallery>

'''Оформление Jewel-box издания''' 
<gallery>
Файл:ht2box.jpg|Изображение с Jewel-box с игрой.
Файл:ht2boxrearside.jpg|Задняя сторона Jewel-box.
Файл:ht2cd_alt.jpg|Оформление диска.
</gallery>

'''Оформление установщика и меню''' 
<gallery>
Файл:autorun5.jpg|Меню автозапуска диска.
Файл:setup5.jpg|Фон установщика.
Файл:ht2menu1.jpg|Главное меню.
Файл:ht2menu2.jpg|Главное меню. Игра.
Файл:ht2menu3.jpg|Главное меню. Сетевая игра.
Файл:ht2menu4.jpg|Главное меню. Сменить водителя.
Файл:ht2menu5.jpg|Главное меню. Выход из игры.
Файл:ht2menu6.jpg|Главное меню. Графика.
Файл:ht2menu7.jpg|Главное меню. Управление.
Файл:ht2menu8.jpg|Главное меню. Видеоплеер.
Файл:ht2enloading.jpg|Загрузочный экран.
</gallery>
'''Скриншоты с отличиями''' 
<gallery>
Файл:Interior zil4.0.jpg|Кабина грузовиков "[[ЗиЛ]]" в старых версиях.
Файл:RepairEng.jpg|Меню апгрейда и строка состояния.
Файл:RepairBeta3.jpg|Вариант [[СТО]].
Файл:ht2rain.jpg|Другие эффекты дождя на стекле. Автомобиль стоит на месте.
Файл:ht2rain2.jpg|То же, но автомобиль в движении.
</gallery>

=== Русская версия<ref>За предоставленный образ большое спасибо пользователю Пикабу '''spirtozaurus'''.</ref> ===
Несмотря на то, что в России официально игра вышла на целый год позже в сильно измененном виде, версии 4.0 и 5.5 существуют и в русском переводе, выполненном пиратами, распространявшими игру в постсоветских странах в 2000 году. В целом перевод выполнен довольно небрежно и местами является слишком буквальным. Названия автомобилей и населённых пунктов оставлены на английском языке.
 Также, оригинальный HT2 можно частично русифицировать, изменив параметр ''langv'' на ''rus'' в файле ''[[truck.ini]]''. Кроме того, существует качественный фанатский [https://mega.nz/folder/rY0kTDaY#CPtx6cEzE-1YrAgD4f7FxA перевод версии 5.8], выпущенный в 2020 году.

'''Галерея русской версии 4.0''' 
<gallery>
Файл:ht2rus_autorun.png|Меню автозапуска диска.
Файл:ht2rus_setup.png|Фон установщика.
Файл:ht4.0-5.5rulogo.jpg|Сплэшскрин русской версии 4.0.
Файл:ht2rus_menu1.png|Главное меню.
Файл:ht2rus_menu2.png|Главное меню. Игра.
Файл:ht2rus_menu3.png|Главное меню. Сетевая игра.
Файл:ht2rus_menu4.png|Главное меню. Сменить водителя.
Файл:ht2rus_menu5.png|Главное меню. Выход из игры.
Файл:ht2rus_menu6.png|Главное меню. Графика.
Файл:ht2rus_menu7.png|Главное меню. Управление.
Файл:ht2rus_menu8.png|Главное меню. Видеоплеер.
Файл:ht2rus_loading.png|Загрузочный экран.
</gallery>

== Дальнобойщики 2 ==
Первый релиз игры на русском языке состоялся 17 апреля 2001-го года. Данный этап развития характеризуется значительно доработанным [[Игровой регион (Дальнобойщики 2)|игровым миром]] и появлением множества новых возможностей, благодаря которым игра так полюбилась игрокам. 

Условное англоязычное наименование '''Rig&Roll''' (в другом варианте '''Rig'n'Roll''') произошло, в первую очередь, от названия папки установки игры<ref>Также оно упоминается непосредственно в игре, а именно в видеоплеере и на текстуре антирадара</ref>, так как на английском языке версии диапазона 6.5-7.4 никогда официально не выходили<ref>Во всяком случае, достоверных данных о таких изданиях нет, несмотря на существование промо-скриншотов английской версии.</ref>. Название появилось после отказа от торговой марки Hard Truck, принадлежавшей Буке, и должно было использоваться в зарубежных версиях игры, но еще до российского релиза (анонс зарубежного издания от Ascaron под новым названием '''King of the Road''' состоялся ещё 14 марта 2001<ref>[http://web.archive.org/web/20010216115234fw_/http://www.ascaron.com/englisch/index.html Текст анонса] (на странице нужно нажать кнопку News, чтобы анонс отобразился)</ref>) было принято решение изменить название игры.
=== Предрелизные промо-скриншоты ===
Скриншоты были опубликованы на сайте 1С 20 декабря 2000 года.
<gallery>
d2rnr_pre_01.jpg|
d2rnr_pre_02.jpg|
d2rnr_pre_03.jpg|Русские надписи нанесены поверх скриншотов английской версии.
d2rnr_pre_04.jpg|
d2rnr_pre_05.jpg|Портрет водителя имеет другой фон
d2rnr_pre_06.jpg|Ранние варианты окна штрафа за превышение и зеркала заднего вида.
d2rnr_pre_07.jpg|
d2rnr_pre_08.jpg|
d2rnr_pre_09.jpg|
</gallery>

=== Зарубежные промо-скриншоты King of the Road ===
Скриншоты были приурочены к европейскому релизу Дальнобойщиков 2 (King of the Road) в 2002 году, но сняты в англоязычной версии поколения Rig'n'Roll<ref>Судя по раннему дизайну окна штрафа за превышение, использовался внутренний билд игры версии ниже, чем 6.5)</ref>.
<gallery>
d2rnr_pre_10.jpg|
d2rnr_pre_11.jpg|
d2rnr_pre_12.jpg|
d2rnr_pre_13.jpg|
</gallery>

=== Общие отличия от версий 4.0-5.8 ===
*Значительно переработан [[Игровой_регион_(Дальнобойщики_2)|игровой мир]]: общие маршруты те же, но во многих местах повысилась детализация ландшафта и дорог, появилось большее разнообразие в декоративном оформлении маршрутов, а новые текстуры некоторых трасс придали игре более позитивную атмосферу;
*Повышено удобство интерфейса, курсор больше не тормозит;
*Карта теперь имеет два масштаба и показывает направление автомобиля игрока;
*Появилась [[Рация|рация]], что принесло возможность общаться с другими водителями, милицией и бандитами (с озвученными репликами);
*Появилась механика перевозки цистерн с горючим и сопутствующая инфраструктура в виде [[Нефтебаза|нефтебаз]];
*Появились светофоры и радары, милиция теперь следит за проездом на красный свет;
*Некоторые сообщения пейджера заменены на наглядное изображение результата действий игрока;
*Появились новые легковые автомобили;
*Изменено поведение автомобилей в более аркадную сторону: практически все машины стали быстрее и устойчивее (несмотря на отствие отличий в технических параметрах от таковых в более ранних версиях), будто форсированы с завода; у машин с 5-ступенчатой КПП (наприпер, Зила) появилась 6-я передача, а с 9-ступенчатой (например, Mercedes Actions) - 10-я передача, так что существенно повышена их максимальная скорость;
*Немного увеличен расход топлива, а также существенно (чуть более чем в 10 раз) увеличена стоимость заправки;
*Появился монитор заднего вида (клавиша M);
*NPC обрели портреты;
*Удалена возможность поворачивать камеру мышью в кабине;
*Новые эффекты дождя;
*Появились летаюшие опавшие листья и пылевые вихри в воздухе;
*Появился звук работы пневмоклапанов при торможении;
*Появилась поддержка разрешения 1600х1200;
*Сохранения больше не имеют ограничения по слотам;
*Появилась быстрая загрузка/сохранение;
*В Главном меню для сохранённых игр теперь показывает скриншот с местом сохранения, дату и время сохранения, так что теперь не нужно вспоминать наугад, какое из сохранений запускать;
*Новое улучшение автомобиля - Антирадар;
*Появилось больше внутриигровых роликов;
*Более мягкая езда машин по грунту с меньшей тряской и подкидыванием;
*Устранено вырвиглазное мерцание пыли при езде по грунтовой дороге, эффект пылевого следа от машины стал прорисовываться намного мягче;
*Обновленный вступительный ролик, новый демо-ролик;
*Новые чит-коды.
Больше отличий между версиями можно узнать из раздела о [[История_версий_(Дальнобойщики_2)#Hard Truck 2|Hard Truck 2]].

=== Версия 6.2 ===
Использовалась для отснятия демо-ролика (rignrolldemo, kotrDemo). Возможно, последняя версия со «свободной» камерой в кабине (то есть управляемой мышкой). Версия не предполагала широкого распространения, поэтому отсутствует в открытом доступе.

=== Версия 6.5 ===
Релизная версия игры<ref>Одно из свидетельств, что игра вышла в версии 6.5 на сайте [http://web.archive.org/web/20100310065954/http://rus-trucksims.narod.ru/db2.htm Русский TRUCKSIMS]. К тому же, первая распространённая версия 6.6 доступна в виде [ftp://ftp.softlab-nsk.com/pub/rignroll/ патча (rnrp0422.exe)] и датирована более поздней датой выхода.</ref>, вышедшая 17-го апреля 2001-го года. Судя по всему, тираж версии был невелик<ref>Хотя патч до версии 6.6 и выпущен 22 апреля, его исполняемый файл датирован 10 апреля, что на неделю раньше официального выхода игры. Но с учетом вышесказанного, это может говорить о том, что версию 6.5 сменили на конвейере довольно быстро.</ref>, поэтому на данный момент её нет в открытом доступе.

=== Версии 6.6-7.4 ===
<div class="mw-customtoggle-rnrpatches" style="background:#e3f1da">Нажмите на эту строку, чтобы узнать подробнее о патчах к Дальнобойщикам 2.</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-rnrpatches">
<div class="mw-collapsible-content">

<big>'''Версия 6.6'''</big> 
[[Файл:rnrico6.6hd.jpg|Значок версии 6.6|64px|right]]
[[Файл:Rnr6.6ru.jpg|безрамки|Заставка версии 6.6]]

Версия вышла 22-го апреля 2001-го года. Одна из версий, выпускавшихся на дисках.

<big>'''Версия 6.7'''</big> 
[[Файл:rnrico7.2-7.4hd.jpg|Значок начиная c версии 6.7|64px|right]]
[[Файл:Rnr6.7ru.jpg|безрамки|Стандартная заставка версии 6.7]]
[[Файл:RnR67_title.png|безрамки|Нестандартная заставка версии 6.7]]

Патч от 7-го мая. На FTP-сервере SoftLab-NSK он представлен в двух вариантах: в [ftp://ftp.softlab-nsk.com/pub/rignroll/rnrp0507.exe.1 первом] присутствует нестандартный логотип игры, который планировался для английской версии игры, когда рабочим названием еще было Rig&Roll, и баг, связанный с отсутствием капель воды на лобовом стекле во время дождя. В связи с этим, на следующий день был выпущен [ftp://ftp.softlab-nsk.com/pub/rignroll/rnrp0507.exe второй] вариант патча, в котором используется обычная заставка и исправлен баг с дождём.

Патч имеет официальный список исправлений:
* Устранены падения при сохранении и загрузке игр
* Уменьшены лаги
* Улучшена работа навигатора

<big>'''Версия 6.9'''</big> 
[[Файл:Rnr6.9ru.jpg|безрамки|Заставка версии 6.9]]

Патч, вышедший 3-го июня 2001-го.

<big>'''Версия 7.0'''</big> 
[[Файл:Rnr7.0ru.jpg|безрамки|Заставка версии 7.0]]

Версия от 18-го июня. В отличие от предыдущих версий, игра ставится на паузу при нажатии на F1-F3.

<big>'''Версия 7.1'''</big> 
[[Файл:Rnr7.1ru.jpg|безрамки|Заставка версии 7.1]]

Версия, вышедшая 29-го июня.
Официальный список исправлений:
* Устранены падения при сохранении и загрузке игр
* Уменьшены лаги
* Улучшена работа навигатора
* Ускорена загрузка игры
* Устранены падения в игре

<big>'''Версия 7.2'''</big> 
[[Файл:Rnr7.2ru.jpg|безрамки|Заставка версии 7.2]]

Версия за июль 2001-го. В виде патча не выходила, выпускалась во всех последующих после версии 6.6 тиражах игры на дисках (за исключением литовской версии). Даже наиболее поздние известные переиздания этого поколения игры на дисках 2009 года имеют версию 7.2.

'''<big>Версия 7.3</big>''' 
[[Файл:Rnr7.3ru.jpg|безрамки|Заставка версии 7.3]]

Патч, датированный 11 сентября 2001-го, описание совпадает с версией 7.1:
* Устранены падения при сохранении и загрузке игр
* Уменьшены лаги
* Улучшена работа навигатора
* Ускорена загрузка игры
* Устранены падения в игре
Также, заметное отличие по сравнению с версией 7.2:
* Исправлены некоторые ошибки ИИ, в частности, NPC теперь более корректно объезжают остановившийся на дороге автомобиль, а не врезаются в него.
Кроме того, начиная с данной версии в игре имеется ошибка, из-за которого автомобили "залипают" друг в друге при столкновениях.

На дисках эта версия издавалась [[История версий (Дальнобойщики 2)#Kelyje-II|в Литве]].

<big>'''Версия 7.4'''</big> 
[[Файл:Rnr7.4ru.jpg|безрамки|Заставка версии 7.4]]

Последний патч для поколения, вышедший в марте 2004-го.

Основные заметные изменения по сравнению с 7.3:
* Улучшен скилл соперников, выиграть гонку стало существенно сложнее;
* Более сложное управление при манёврах с грузом (больше вероятность перевернуться);
* Исправлены проблемы, которые могут проявится при использовании Windows XP.

</div></div>

=== Галерея версий 6.5-7.4 ===
'''Big-box 2001 года''' 
<gallery>
Файл:Rnr_bigbox_promo.jpeg|Обложка (промо)
Файл:Rnr_bigbox_cover.jpg|Обложка (скан)
Файл:Rnr_bigbox_back.jpg|Задняя сторона коробки
Файл:Rnr_bigbox_manual.jpg|Обложка руководства пользователя
Файл:rnrcd0.jpg|Внешний вид диска
</gallery>
'''Оригинальное оформление Jewel-box и диска с 2001 года''' 
<gallery>
Файл:Дб2t.jpg|Обложка
Файл:rnrboxrearside.jpg|Задняя сторона коробки
Файл:rnrcd0.jpg|Внешний вид диска
</gallery>
'''Диск-приложение к журналу "Домашний компьютер" №2'2002''' 
<gallery>
Rnrcdmagazine2.jpg|
</gallery>
'''Издание с рекламой журнала "Домашний компьютер"''' 
Ориентировочно появилось в 2004 году.
<gallery>
Файл:Дб2t.jpg|Обложка
Файл:rnrboxrearsidemagazine.jpg|Задняя сторона коробки
Файл:rnrcdmagazine.jpg|Внешний вид диска
</gallery>
'''Оформление дисков в переиздании от 6 ноября 2009 года<ref>[https://web.archive.org/web/20100313150123/http://games.1c.ru/kotr_2/ Страница на сайте 1С]</ref>''' 
<gallery>
Файл:rnr_jewel_2009.jpg|Обложка (промо)
Файл:rnr_jewel_2009_scan.jpg|Обложка (скан)
Файл:rnr_jewel_2009_rearside.jpg|Скан задней стороны обложки
Файл:rnrcd.jpg|Внешний вид диска
</gallery>
'''Оформление установщика и меню''' 
<gallery>
Файл:autorun6-7.jpg|Меню автозапуска диска.
Файл:setup6-7.jpg|Фон установщика.
Файл:rnrmenu1.jpg|Главное меню.
Файл:rnrmenu2.jpg|Главное меню. Игра.
Файл:rnrmenu3.jpg|Главное меню. Сетевая игра.
Файл:rnrmenu4.jpg|Главное меню. Сменить водителя.
Файл:rnrmenu5.jpg|Главное меню. Выход из игры.
Файл:rnrmenu6.jpg|Главное меню. Графика.
Файл:rnrmenu7.jpg|Главное меню. Управление.
Файл:rnrmenu8.jpg|Главное меню. Видеоплеер.
Файл:rnrloading.jpg|Загрузочный экран.
</gallery>
'''Скриншоты с отличиями''' 
<gallery>
Файл:rnrrain.jpg|Новый, относительно предыдущих версий, эффект мокрого стекла.
</gallery>

=== Прочее ===
Каждая версия имеет альтернативную неиспользуемую англоязычную заставку. Какого-то практического смысла они не несут и остались только в качестве рудимента из первой части серии и старых версий Дальнобойщиков 2, когда локализацию игры можно было сменить (в случае с Hard Truck 2 только частично) через файл ''[[truck.ini]]''.

Наибольший интерес представляет заставка, которую можно найти в версии 6.6. На ней изображен ранний логотип '''King of the Road''' в виде короны. Этот логотип также можно было заметить на значке версии 6.6 (а вместе с ней, наверняка, и в версии 6.5). Позже логотип был заменён на стилизованные буквы ''KR'' по аналогии с буквами ''RNR'' в русской версии.
<gallery>
Файл:rnr6.6eng_splash.png|Альтернативная заставка версии 6.6
Файл:rnr6.7eng_splash.png|Альтернативная заставка версии 6.7
Файл:kotr1.0_splash.png|Альтернативная заставка версии 6.9
Файл:kotr1.1.jpg|Альтернативная заставка версий 7.0-7.3
Файл:kotr1.3.jpg|Альтернативная заставка версии 7.4

</gallery>

== King of the Road ==
Поколение игры, известное в России под названием «Дальнобойщики 2 - Издание второе, дополненное», началось ещё в 2001-м году, с выходом игры в Германии буквально через 2 месяца после релиза в России версии 6.5.

=== Общие отличия от русской версии 2003-го года ===
* Каждая локализация игры полностью озвучена на соответствующий язык;
* Чёрные полицейские [[BMW M5]];
* Другие [https://rnr-wiki.ru/index.php/Файл:NPC_EN.jpg аватары игрока и NPC];
* Другой шрифт названия игры (Formal436 BT).

Отличия этого поколения от предыдущих см. далее, [[История версий (Дальнобойщики 2)#Дальнобойщики 2 Издание второе, дополненное|в разделе о русской версии]].

Данные издания имеют новую нумерацию версий, начинающуюся с 1.0.

=== Версия 1.0 ===
[[Файл:kotrico8.0-8.2hd.jpg|Значок начиная c версии 1.0|64px|right]]
[[Файл:Kotr1.0 splash.png|безрамки|Заставка версии 1.0]]

Анонс зарубежных версий Дальнобойщиков 2 издательством Ascaron состоялся 14 марта 2001. Версия 1.0 вышла исключительно на немецком языке 26 июня 2001 года под названием '''King of the Road: Das Gesetz der Straße'''. 
Оригинальная немецкая версия имеет нестандартную для игры систему защиты SafeDisc - игра проверяет наличие диска непосредственно перед запуском игры, а не после, как в прочих изданиях и локализациях.

=== Версия 1.1 ===
[[Файл:Kotr1.1.jpg|безрамки|Заставка версии 1.1]]

Первый и единственный патч для немецкой версии игры вышел 19 октября 2001.

Включает в себя следующие изменения:
* Улучшен ИИ
* Трафик реже блокирует дорогу
* Количество машин трафика теперь может быть увеличено на 50%
* Корректировка денежной награды за победу на Кольце
* Улучшение производительности
* Исправлены случайные сбои при использовании видеокарты GeForce 3
* Исправление прочих сбоев
* Исправление Force Feedback для рулей от Microsoft
* Устранены графические проблемы с видеокартами Kyro II

Сохранения совместимы с последующей версией 1.3 и её русскоязычным аналогом 8.0.

В январе 2002-го года стало известно, что издательство Ascaron не будет издавать английскую версию King of the Road.

=== Галерея версий 1.0-1.1 ===
<gallery>
Файл:King-of-the-Road-Ascaron.jpg|Обложка издания
Файл:kotr_ascaron_cover.jpg|Скан обложки
Файл:kotr_ascaron_inner.jpg|Внутренняя сторона
Файл:kotr_ascaron_cd.jpg|Диск с игрой
Файл:kotr_ascaron_manual.jpg|Руководство пользователя ([https://archive.org/details/kingoftheroad-manual-german/mode/2up ссылка])
</gallery>

=== Версия 1.3 ===
[[Файл:kotr1.3.jpg|безрамки|Заставка версии 1.3]]

Данная версия выходила в Европе на нескольких языках. Известны локализации на английский, немецкий, французский и испанский языки. Также, планировалась польская версия от издательства '''CD Project''', но она так и не увидела свет.

==== Английская версия ====
Выпущена 7 июня 2002 года силами издательства '''JoWood'''. Эта же версия выпущена в цифровом магазине '''GOG.com''' в 2019 году (при скачивании англоязычного дистрибутива)

'''Галерея английской версии игры''' 

'''Обложки''' 
<gallery>
Файл:King-of-the-Road-Eur.jpg|Обложка игры.
</gallery>
'''Издание с [[Бонусный_диск#Бонусный диск от JoWood|бонусным диском]]''' 
<gallery>
kotr_with_bonus1.jpg
kotr_with_bonus2.jpg
</gallery>
'''Оформление''' 
<gallery>
Файл:kotr_autorun_eng.png|Меню автозапуска диска.
Файл:kotr_setup_eng.png|Фон установщика.
Файл:kotrenmenu1.jpg|Главное меню.
Файл:kotrenmenu2.jpg|Главное меню. Игра.
Файл:kotrenmenu3.jpg|Главное меню. Сетевая игра.
Файл:kotrenmenu4.jpg|Главное меню. Сменить водителя.
Файл:kotrenmenu5.jpg|Главное меню. Выход из игры.
Файл:kotrenmenu6.jpg|Главное меню. Графика.
Файл:kotrenmenu7.jpg|Главное меню. Управление.
Файл:kotrenmenu8.jpg|Главное меню. Видеоплеер.
Файл:kotrenloading.jpg|Загрузочный экран.
</gallery>

==== Другие локализации ====
<div class="mw-customtoggle-kotrlocal" style="background:#e3f1da">Нажмите на эту строку, чтобы узнать подробнее о локализациях King of the Road.</div>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-kotrlocal">
<div class="mw-collapsible-content">
'''Немецкая версия''' 

Немецкая версия была переиздана издательством '''Jowood''' в 2002 году. Обновления для версии 1.1 от Ascaron не выходило.

'''Французская версия''' 

Французская версия игры, выпущенная '''JoWood''' в 2002 году.

'''Галерея французской версии''' 

'''Обложки''' 
<gallery>
kotr_gg_cover_fr.jpg|Обложка диска из состава сборника 15 Giant Games Vol.1
kotr_gg_cd_fr.jpg|Диск из сборника
</gallery>
'''Оформление установщика и меню''' 
<gallery>
Файл:kotr_autorun_fr.png|Меню автозапуска.
Файл:kotr_setup_fr.png|Фон установщика игры.
Файл:kotr_menu1_fr.png|Главное меню.
Файл:kotr_menu2_fr.png|Главное меню. Игра.
Файл:kotr_menu3_fr.png|Главное меню. Сетевая игра.
Файл:kotr_menu4_fr.png|Главное меню. Сменить водителя.
Файл:kotr_menu5_fr.png|Главное меню. Выход из игры.
Файл:kotr_menu6_fr.png|Главное меню. Графика.
Файл:kotr_menu7_fr.png|Главное меню. Управление.
Файл:kotr_menu8_fr.png|Главное меню. Видеоплеер.
Файл:kotr_loading_fr.png|Загрузочный экран.
</gallery>

'''Испанская версия''' 
[[Файл:kotr_sp_splashscreen.jpg|безрамки|Заставка испанской версии 1.3]]

Испанская версия игры, выпущенная '''ZetaGames''' 19 февраля 2004 года.

'''Галерея испанской версии''' 

'''Оформление установщика и меню''' 
<gallery>
Файл:sp_autorun.jpg|Меню автозапуска.
Файл:sp_setup.jpg|Фон установщика игры.
Файл:kotr_menu1_sp.png|Главное меню.
Файл:kotr_menu8_sp.png|Главное меню. Игра.
Файл:kotr_menu2_sp.png|Главное меню. Сетевая игра.
Файл:kotr_menu3_sp.png|Главное меню. Сменить водителя.
Файл:kotr_menu4_sp.png|Главное меню. Выход из игры.
Файл:kotr_menu5_sp.png|Главное меню. Графика.
Файл:kotr_menu6_sp.png|Главное меню. Управление.
Файл:kotr_menu7_sp.png|Главное меню. Видеоплеер.
Файл:sp_loadpix.jpg|Загрузочный экран.
</gallery>

</div></div>

== Дальнобойщики 2 Издание второе, дополненное ==
'''"Издание второе, дополненное"''' было выпущено 16 мая 2003 года. Издание является русской локализацией вышедшей в 2002 году европейской версии игры под названием King of the Road. При этом история включенных изменений начинается ещё с выхода [[King of the Road|немецкой версии игры]] в 2001 году.

Самые главные отличия от прежних изданий, повлиявшие на геймплей - это расширенные возможности для легковушек (возможность начать игру сразу на легковушке, специфичные грузы на складах только для легковушек, доступность части легковушек с самого начала игры, как для покупки, так и для найма), а также расширенные возможности на СТО и АЗС (необходимость останавливаться в режиме "Симулятор", возможность выбирать какие системы автомобиля ремонтировать и сколько топлива заливать, несколько новых улучшенных запчастей). Также имеется множество более мелких измерений (полный список см. далее).

=== Версия 8.0 ===
[[Файл:kotrico8.0-8.2hd.jpg|Значок начиная c версии 8.0|64px|right]]
[[Файл:Kotr8.0.jpg|безрамки|Заставка версии 8.0]]

Отличия от версий 6.х-7.х:
* В режиме "Симулятор" для заправки и ремонта машины появилась необходимость останавливаться, а на АЗС и СТО для игрока добавлен расширенный интерфейс, позволяющий выбрать, сколько топлива залить или какие именно узлы машины ремонтировать; показана стоимость топлива за литр и стоимость ремонта каждого отдельного узла автомобиля; процесс заливки топлива теперь занимает некоторое время (при этом, в режиме "Аркадный" сохранилась возможность как в предыдущих версиях игры мгновенной полной заправки и ремонта на ходу, без необходимости останавливаться);
* На СТО увеличена стоимость большинства улучшений (в среднем в 3 раза) и добавлены некоторые новые [[СТО|улучшения]];
* Изменено расположение скрытых [[АЗС]];
* Появилась возможность в начале игры покупать некоторые легковые автомобили ([[Газель|Газель Люкс]], [[Джип]], [[Пикап]], [[Сафари]], [[Кайман]], [[BMW M5]]) и даже начать игру сразу на легковом автомобиле [[Джип]];
* Добавлено больше мелких декоративных элементов игрового мира: бочки (особенно возле АЗС и СТО), ограждения, небольшие башни и постройки на пути в [[Алмазный]];
* Появилось разделение игрового региона на 5 административных округов (добавлены соответствующие дорожные таблички), при пересечении границ которых прекращается погоня милиции за игроком;
* Убран завал в тоннеле [[Шахты]]-[[Боровое]], который раньше перекрывал треть ширины дороги;
* Появилась возможность сбивать светофоры, радары, небольшие деревья;
* Превышение скорости могут фиксировать не только радары, но и милицейские патрули;
* Увеличен штраф за езду на ворованном автомобиле (с 36% до 80% от стоимости новой машины);
* Новые виды грузов, в том числе специфичные грузы, предназначенные для перевозки только на легковых автомобилях (например, "Зарплата");
* На [[Кольцо|Кольце]] за победу дают $5000 вместо $20000;
* Изменена раскраска некоторых прицепов;
* Добавлена возможность удалять сохранённые игры;
* Допущена ошибка, в результате которой вид из кабин грузовых автомобилей стал значительно ниже (водитель Шторма находится чуть выше, чем водитель Джипа);
* Увеличена громкость двигателя легковушек;
* Добавлены более отчётливые звуки повреждений;
* Улучшен ИИ соперников;
* Удалён ролик начала новой игры;
* Уменьшена максимальная скорость DAF до ~200 км/ч (в версии 7.х можно было выжать порядка 240 км/ч);
* Исправлено довольно большое количество мелких неполадок. Игра теперь корректно работает в Windows XP и её даже можно сворачивать, хотя и не без проблем.

=== Версия 8.1 ===
[[Файл:Kotr8.1.jpg|безрамки|Заставка версии 8.1]]

Версия датирована 15-м января 2004-го года.
Основные отличия от версии 8.0:
* Исправлены проблемы, которые могут проявиться при запуске игры на Windows XP;
* Исправлены возможные потери фокуса при использовании других операционных систем.

=== Версия 8.2 ===
[[Файл:Kotr8.2.jpg|безрамки|Заставка версии 8.2]]

Версия появилась в 2008 году с очередным тиражом "Издания второго, дополненного". Отдельным патчем официально не выпускалась, но распространялась фанатами в виде единственного файла - King.exe. Единственное заметное отличие от предыдущих версий - убрана проверка на наличие диска в приводе.

=== Галерея версий 8.0-8.2 ===
'''Оригинальное оформление Jewel-box и дисков с 2003 года''' 
<gallery>
Файл:Kotr jewel 2003.jpg|Обложка.
Файл:kotrcd.jpg|Диск с игрой
Файл:kotrcd2.jpg|Бонусный диск
Файл:kotr_jewel_rear_side 2003.jpg|Задняя сторона Jewel-box.
</gallery>
'''Оформление c 2004 года''' 
<gallery>
Файл:kotrbox.jpg|Обложка. Появилось указание количества дисков.
Файл:kotrcd.jpg|Диск с игрой
Файл:kotrcd2.jpg|Бонусный диск
Файл:Kotr jewel rear side 2004.jpg|Задняя сторона Jewel-box с игрой версии 8.1 (c 2004 г.)
Файл:kotr_jewel_rear_side.jpg|Задняя сторона Jewel-box с игрой версии 8.2 (2008 г.). Отличается текстом внизу.
</gallery>
'''Оформление дисков в переиздании от 21 сентября 2009 года<ref>[https://web.archive.org/web/20240301143139/https://softclub.ru/games/pc/278-dalnobojshhiki-2-izdanie-vtoroe-dopolnennoe Страница на сайте СофтКлаб]</ref>''' 
<gallery>
Файл:KotrJewel2007.jpg|Обложка (промо)
Файл:Kotr Jewel 2009.jpg|Обложка (скан)
Файл:Kotr2009 cd1.jpg|Диск с игрой
Файл:Kotr2009 cd2.jpg|Бонусный диск
Файл:Kotr2009 jewel back.jpg|Задняя сторона Jewel-box
</gallery>
'''Оформление дисков в переиздании от 17 марта 2010 года<ref>[https://web.archive.org/web/20240301143419/https://softclub.ru/games/pc/20364-dalnobojshhiki-2-izdanie-vtoroe-dopolnennoe Страница издания на сайте SoftClub]</ref>''' 
<gallery>
Файл:Kotr2010sleeve.jpg|Картонный рукав спереди (промо)
Файл:kotr2010sleeve_scan.jpg|Скан рукава
Файл:kotr2010sleeve_back.jpg|Рукав сзади
Файл:kotr2010_jewel.jpg|Обложка Jewel-box
Файл:kotr2010_dvd.jpg|DVD с игрой
Файл:kotr2010_jewel_back.jpg|Задняя сторона Jewel-box
</gallery>
'''Оформление переиздания 2012 года''' 
<gallery>
Файл:Kotr Jewel 2012.jpg|Обложка Jewel-box
Файл:Kotr2012 dvd.jpg|DVD с игрой
Файл:Kotr2012 jewel back.jpg|Задняя сторона Jewel-box
</gallery>
'''Оформление установщика и меню''' 
<gallery>
Файл:autorun8.jpg|Меню автозапуска диска.
Файл:setup8.jpg|Фон установщика.
Файл:kotrrumenu1.jpg|Главное меню.
Файл:kotrrumenu2.jpg|Главное меню. Игра.
Файл:kotrrumenu3.jpg|Главное меню. Сетевая игра.
Файл:kotrrumenu4.jpg|Главное меню. Сменить водителя.
Файл:kotrrumenu5.jpg|Главное меню. Выход из игры.
Файл:kotrrumenu6.jpg|Главное меню. Графика.
Файл:kotrrumenu7.jpg|Главное меню. Управление.
Файл:kotrrumenu8.jpg|Главное меню. Видеоплеер.
Файл:kotrruloading.jpg|Загрузочный экран.
</gallery>
'''Скриншоты с отличиями''' 
<gallery>
Файл:Repair8.1.jpg|Новое меню СТО.
Файл:kotrfueling.jpg|Меню заправки.
</gallery>

== Прочие локализации ==
''О локализациях '''King of the Road''' см. в [[История_версий_(Дальнобойщики_2)#Другие локализации|этой части статьи]] ''
=== Truck Racing 2001 — Os Gigantes da Estrada ===
[[Файл:truck_racing_2001_splashscreen.jpg|безрамки|Заставка португальской версии 5.8]]

Португальская локализация '''Hard Truck 2'''. Имеет версию 5.8, точная дата выхода неизвестна, но исполняемый файл датирован '''5 июня 2001 года''', что даже позже даты выпуска версии 6.9 на русском языке. Заметные изменения:
*Полный перевод на португальский язык (кроме названий населенных пунктов);
*Некоторые технические доработки по сравнению в предыдущими версиями;
*Значок Кольца из первых версий (4.0+);
*Установочный дистрибутив включает в себя демо-ролик с португальским логотипом и в более высоком качестве, чем тот, что входит в состав Hard Truck 2, но он не используется игрой и даже не копируется при установке. Вместо него воспроизводится оригинальный ролик.

====Галерея португальской версии 5.8====
'''Оформление DVD-box с игрой''' 
<gallery>
файл:Pc_truck_racing_2001.png|Обложка игры.
файл:Pc_truck_racing_2001_cd.jpg|Внешний вид диска.
</gallery>
'''Оформление установщика и меню''' 
<gallery>
Файл:pt_autorun.jpg|Меню автозапуска.
Файл:pt_setup.jpg|Фон установщика игры.
Файл:kotr_menu1_pt.png|Главное меню.
Файл:kotr_menu2_pt.png|Главное меню. Игра.
Файл:kotr_menu3_pt.png|Главное меню. Сетевая игра.
Файл:kotr_menu4_pt.png|Главное меню. Сменить водителя.
Файл:kotr_menu5_pt.png|Главное меню. Выход из игры.
Файл:kotr_menu6_pt.png|Главное меню. Графика.
Файл:kotr_menu7_pt.png|Главное меню. Управление.
Файл:kotr_menu8_pt.png|Главное меню. Видеоплеер.
Файл:pt_loadpix.jpg|Загрузочный экран.
</gallery>

=== Kelyje-II ===
[[Файл:Kelyje2 splashscreen.jpg|безрамки|Заставка литовской версии 7.3]]

Литовская версия игры, изданная '''Akelotė ir Ko.''' и '''1С''' в 2001-м году. Относится к поколению версий Rig&Roll, полностью локализована на литовский язык.

==== Галерея литовской версии 7.3 ====
'''Оформление Jewel-box с игрой''' 
<gallery>
Файл:kelyje-2_cover_2.jpg|Обложка
Файл:kelyje-2_inner_1.jpg|Разворот обложки
Файл:kelyje-2_inner_2.jpg|Регистрационная карточка
Файл:kelyje-2_cd.jpg|Диск
Файл:kelyje-2_inner_3.jpg|Задняя сторона обложки изнутри
Файл:kelyje-2_back_2.jpg|Задняя сторона обложки
</gallery>
'''Другой вариант обложки''' 
<gallery>
Файл:kelyje-2_cover.jpg|Обложка с рекламой магазинов Maxima
Файл:kelyje-2_back.jpg|Задняя сторона обложки с рекламой магазинов Maxima
</gallery>
'''Фото третьего варианта''' 
<gallery>
Файл:kelyje2cover.jpg|Фото Jewel-box с игрой
Файл:kelyje2back.jpg|
Файл:kelyje2cd.jpg|
</gallery>
'''Оформление установщика и меню''' 
<gallery>
Файл:lt-autorun.jpg|Меню автозапуска.
Файл:lt_setup.jpg|Фон установщика игры.
Файл:lt_mainmenu.png|Главное меню.
Файл:lt-newgame.jpg|Главное меню. Игра.
Файл:lt-networkgame.jpg|Главное меню. Сетевая игра.
Файл:lt-player.jpg|Главное меню. Сменить водителя.
Файл:lt-exitgame.jpg|Главное меню. Выход из игры.
Файл:lt-graphics.jpg|Главное меню. Графика.
Файл:lt-gamecontrols.jpg|Главное меню. Управление.
Файл:lt-videoplayer.jpg|Главное меню. Видеоплеер.
Файл:lt_loadpix.jpg|Загрузочный экран.
</gallery>
'''Скриншоты с отличиями''' 
<gallery>
Файл:lt_ddphoto0006.jpg|Меню покупки автомобиля.
Файл:lt_ddphoto0015.jpg|Меню установки апгрейдов.
Файл:lt_ddphoto0011.jpg|Боковое меню.
Файл:lt_ddphoto0010.jpg|Обратите внимание - в литовской версии машины и вертолёт полиции имеют такой же окрас, как и в российской версии игры.
</gallery>

{{Дб2}}

== Примечания ==

B3D (формат файлов)

2025-11-03T13:34:43Z

Aleko 2144: /* Контейнер-переключатель (21) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

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

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int paramsCount;
<float[paramsCount]>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Приложения =
==Типы коллизий==
Параметры типов коллизий блоков 12 и 23.

===Коэффициенты===
{| class="wikitable"
|-
! тип !! коэффициент потери угловой скорости !! коэффициент потери линейной скорости !! коэффициент трения !! комментарии
|-
| 1 || 0,05 || 0,10 || 0,60 ||
|-
| 2 || 1,50 || 0,20 || 0,55 ||
|-
| 3 || 3,00 || 0,30 || 0,30 ||
|-
| 4 || 0,60 || 0,30 || 0,30 ||
|-
| 5 || 0,05 || 0,10 || 0,45 ||
|-
| 6 || 1,00 || 0,20 || 0,45 ||
|-
| 7 || 0,60 || 0,20 || 0,30 ||
|-
| 8 || 0,60 || 0,30 || 0,45 || уничтожает грузовик
|-
| 9 || 1,00 || 0,40 || 0,20 ||
|-
| 10 || 0,05 || 0,10 || 0,60 ||
|-
| 11 || 1,50 || 0,20 || 0,45 ||
|-
| 12 || 5,00 || 5,00 || 0,00 ||
|-
| 13 || 5,00 || 5,00 || 0,00 || уничтожает шины
|}

===Эффекты===
{| class="wikitable"
|-
! тип !! следы от шин !! грязь при пробуксовке колёс !! цвет грязи !! пыль !! звук воды при движении
|-
| 1 || + || || || ||
|-
| 2 || + || + || чёрный || ||
|-
| 3 || + || || || ||
|-
| 4 || || || || || +
|-
| 5 || + || || || ||
|-
| 6 || || + || зелёный || + ||
|-
| 7 || || || || || +
|-
| 8 || || || || ||
|-
| 9 || || || || || +
|-
| 10 || || || || + ||
|-
| 11 || || || || + ||
|-
| 12 || || || || ||
|-
| 13 || || || || ||
|}

==Варианты переключателей типа 21==
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

===Объекты игрового мира===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| Faza8Key || Используется для анимаций
|-
| StartKey || неизвестно
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

===Повреждения автомобилей===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

===Переключатели светотехники===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

===Другие автомобильные переключатели===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|-
| TestKey || 5 || Используется для отладки и хранит данные для отрисовки коллизий транспорта
|-
| CollisionKey || 3 || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || 2 || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || 2 || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || 4 || Свечение сигнальных ламп радара
|}

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-11-02T15:00:32Z

Aleko 2144:

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int paramsCount;
<float[paramsCount]>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Приложения =
==Типы коллизий==
Параметры типов коллизий блоков 12 и 23.

===Коэффициенты===
{| class="wikitable"
|-
! тип !! коэффициент потери угловой скорости !! коэффициент потери линейной скорости !! коэффициент трения !! комментарии
|-
| 1 || 0,05 || 0,10 || 0,60 ||
|-
| 2 || 1,50 || 0,20 || 0,55 ||
|-
| 3 || 3,00 || 0,30 || 0,30 ||
|-
| 4 || 0,60 || 0,30 || 0,30 ||
|-
| 5 || 0,05 || 0,10 || 0,45 ||
|-
| 6 || 1,00 || 0,20 || 0,45 ||
|-
| 7 || 0,60 || 0,20 || 0,30 ||
|-
| 8 || 0,60 || 0,30 || 0,45 || уничтожает грузовик
|-
| 9 || 1,00 || 0,40 || 0,20 ||
|-
| 10 || 0,05 || 0,10 || 0,60 ||
|-
| 11 || 1,50 || 0,20 || 0,45 ||
|-
| 12 || 5,00 || 5,00 || 0,00 ||
|-
| 13 || 5,00 || 5,00 || 0,00 || уничтожает шины
|}

===Эффекты===
{| class="wikitable"
|-
! тип !! следы от шин !! грязь при пробуксовке колёс !! цвет грязи !! пыль !! звук воды при движении
|-
| 1 || + || || || ||
|-
| 2 || + || + || чёрный || ||
|-
| 3 || + || || || ||
|-
| 4 || || || || || +
|-
| 5 || + || || || ||
|-
| 6 || || + || зелёный || + ||
|-
| 7 || || || || || +
|-
| 8 || || || || ||
|-
| 9 || || || || || +
|-
| 10 || || || || + ||
|-
| 11 || || || || + ||
|-
| 12 || || || || ||
|-
| 13 || || || || ||
|}

==Варианты переключателей типа 21==
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

===Объекты игрового мира===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| Faza8Key || Используется для анимаций
|-
| StartKey || неизвестно
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

===Повреждения автомобилей===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

===Переключатели светотехники===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

===Другие автомобильные переключатели===
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|-
| TestKey || 5 || Используется для отладки и хранит данные для отрисовки коллизий транспорта
|-
| CollisionKey || 3 || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || 2 || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || 2 || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || 4 || Свечение сигнальных ламп радара
|}

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-11-02T14:37:55Z

Aleko 2144: /* Геометрия коллизии (23) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int paramsCount;
<float[paramsCount]>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Приложения =
==Типы коллизий==
Параметры типов коллизий блоков 12 и 23.

===Коэффициенты===
{| class="wikitable"
|-
! тип !! коэффициент потери угловой скорости !! коэффициент потери линейной скорости !! коэффициент трения !! комментарии
|-
| 1 || 0,05 || 0,10 || 0,60 ||
|-
| 2 || 1,50 || 0,20 || 0,55 ||
|-
| 3 || 3,00 || 0,30 || 0,30 ||
|-
| 4 || 0,60 || 0,30 || 0,30 ||
|-
| 5 || 0,05 || 0,10 || 0,45 ||
|-
| 6 || 1,00 || 0,20 || 0,45 ||
|-
| 7 || 0,60 || 0,20 || 0,30 ||
|-
| 8 || 0,60 || 0,30 || 0,45 || уничтожает грузовик
|-
| 9 || 1,00 || 0,40 || 0,20 ||
|-
| 10 || 0,05 || 0,10 || 0,60 ||
|-
| 11 || 1,50 || 0,20 || 0,45 ||
|-
| 12 || 5,00 || 5,00 || 0,00 ||
|-
| 13 || 5,00 || 5,00 || 0,00 || уничтожает шины
|}

===Эффекты===
{| class="wikitable"
|-
! тип !! следы от шин !! грязь при пробуксовке колёс !! цвет грязи !! пыль !! звук воды при движении
|-
| 1 || + || || || ||
|-
| 2 || + || + || чёрный || ||
|-
| 3 || + || || || ||
|-
| 4 || || || || || +
|-
| 5 || + || || || ||
|-
| 6 || || + || зелёный || + ||
|-
| 7 || || || || || +
|-
| 8 || || || || ||
|-
| 9 || || || || || +
|-
| 10 || || || || + ||
|-
| 11 || || || || + ||
|-
| 12 || || || || ||
|-
| 13 || || || || ||
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-11-02T14:37:16Z

Aleko 2144: типы коллизий

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Приложения =
==Типы коллизий==
Параметры типов коллизий блоков 12 и 23.

===Коэффициенты===
{| class="wikitable"
|-
! тип !! коэффициент потери угловой скорости !! коэффициент потери линейной скорости !! коэффициент трения !! комментарии
|-
| 1 || 0,05 || 0,10 || 0,60 ||
|-
| 2 || 1,50 || 0,20 || 0,55 ||
|-
| 3 || 3,00 || 0,30 || 0,30 ||
|-
| 4 || 0,60 || 0,30 || 0,30 ||
|-
| 5 || 0,05 || 0,10 || 0,45 ||
|-
| 6 || 1,00 || 0,20 || 0,45 ||
|-
| 7 || 0,60 || 0,20 || 0,30 ||
|-
| 8 || 0,60 || 0,30 || 0,45 || уничтожает грузовик
|-
| 9 || 1,00 || 0,40 || 0,20 ||
|-
| 10 || 0,05 || 0,10 || 0,60 ||
|-
| 11 || 1,50 || 0,20 || 0,45 ||
|-
| 12 || 5,00 || 5,00 || 0,00 ||
|-
| 13 || 5,00 || 5,00 || 0,00 || уничтожает шины
|}

===Эффекты===
{| class="wikitable"
|-
! тип !! следы от шин !! грязь при пробуксовке колёс !! цвет грязи !! пыль !! звук воды при движении
|-
| 1 || + || || || ||
|-
| 2 || + || + || чёрный || ||
|-
| 3 || + || || || ||
|-
| 4 || || || || || +
|-
| 5 || + || || || ||
|-
| 6 || || + || зелёный || + ||
|-
| 7 || || || || || +
|-
| 8 || || || || ||
|-
| 9 || || || || || +
|-
| 10 || || || || + ||
|-
| 11 || || || || + ||
|-
| 12 || || || || ||
|-
| 13 || || || || ||
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-11-02T14:35:12Z

Aleko 2144: /* Плоскость коллизии (12) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int paramsCount;
<float[paramsCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.

==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

Sch-файлы

2025-10-26T22:00:43Z

Aleko 2144: /* etrashboxes.sch */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Страница с кратким описанием sch-файлов. 

Инструменты для дешифрации и шифрации доступны на странице с [[Утилиты_(Дальнобойщики_2) | утилитами]]. Игра может использовать как зашифрованные, так и расшифрованные файлы. Единственное условие - файл должен иметь расширение sch/cnf, txt читаться не будет. 
Расшифрованные sch для [[История_версий_(Дальнобойщики_2)#Дальнобойщики 2 Издание второе, дополненное | дополненного издания игры]] доступны [https://yadi.sk/d/3V2J6YkS8ltomg здесь].

==etrashboxes.sch==
Файл с данными о припаркованных автомобилях.
Имеет следующий вид:
( vehicle идентификатор "идентификатор из tech-файла" номер_окраса тип )

Идентификатор может быть любым. 
Типы:
* parked - припаркованный автомобиль;
* container - контейнер SuperCargo;
* fuel - бочка с топливом на продажу;
* roadwork - объект, устанавливаемый в точке проведения дорожных работ (по умолчанию - каток).
Примеры:
( vehicle PARKED_X "PVan" 3 parked )
( vehicle CONTAINER_X "AnmObj0231" 0 container )
( vehicle FUEL_X "AnmObj0241" 0 fuel )
( vehicle KATOK "Katok" 0 roadwork )

==evehicles.sch==
Файл данных автомобилей.
Имеет следующий вид:
( vehicle идентификатор_в_vd_sch "car_node" номер_окраса тип_автомобиля тип_владельца цена отображаемая_мощность<ref>Только для визуального отображения при покупке. Не обязательно должна соответствовать реальной из tech-файла.</ref> (идентификаторы_совместимых_полуприцепов) флаг )

Параметры:
* vehicle - начало строки параметров, одинаковое для каждого типа автомобиля;
* идентификатор_в_vd_sch - ID используемой подписи автомобиля из vd.sch;
* car_node - имя параметра car_node используемого автомобиля из vehicle.tech

Типы автомобилей (определяет доступный ассортимент грузов для данной машины):
* car - легковой автомобиль;
* lorry - грузовой автомобиль;
* tractor - тягач;
* semitrailer - полуприцеп.
Типы владельцев автомобиля:
* dumb - автомобиль будет использоваться только ai-трафиком; для покупки будет доступен только после захвата 51% рынка;
* trucker - автомобиль будет использоваться наёмными водителями; для покупки доступен с начала игры;
* police - автомобиль будет использоваться игровой милицией;
* mafia - автомобиль будет использоваться игровыми бандитами;
* none - автомобиль не будет никем использоваться в игре, при этом на нём можно будет начать игру, прописав его в файле game.cnf.
Флаг: если указано 1, то транспортное средство сможет получать груз только на '''[[База#Нефтебаза|нефтебазах]]'''.

Пример:
( vehicle FIAT_1 "Fiat" 0 car dumb 32000 408 ())
( vehicle DAF_TRACTOR1 "Daf" 0 tractor trucker 76200 355 ( SEMITRAILER1 SEMITRAILER2 ))
( vehicle SEMITANK4 "STrailerT" 3 semitrailer none 0 101 () 1 )

==merchandise.sch==
Файл с данными обо всех товарах, доступных в игре.
Имеет следующий вид:
( идентификатор тип масса объем
( неизвестное_1 неизвестное_2 неизвестное_3
( топливо тип_транспорта легальность_груза нужен_мафии ) неизвестное_4) прочность неизвестное_5 "Название" )

{| class="wikitable sortable"
|-
! Параметр !! Значения/тип данных !! Описание
|-
| идентификатор* || Уникальный идентификатор || Уникальное внутреннее обозначение груза. По этому имени на груз ссылаются другие файлы игры
|-
| тип* || CRATE CRATE20 CRATE16 PACK KILO UNIT BARREL PIECE BOX TON
|| Обозначает вид единицы груза (ящик, бочка, упаковка, штука). Влияние на игру не установлено
|-
| масса* || Число || Масса единицы груза, кг
|-
| объем* || Число || Объем единицы груза, м3 При помощи параметров массы и объема можно рассчитать, какие масса и объем груза помещаются в машину:

k = масса / объем
s = Tmax / Vmax

При k <= s:
V = Vmax * l
T = V * k

При k > s:
T = Tmax * l
V = T / k

Где:
k - плотность груза (вес на м3), кг/м3
s - индекс грузоподъемности машины<ref>Индекс грузоподъмности машины равен отношению грузоподъемности к объему кузова. Если плотность груза больше индекса грузоподъемности, такой груз считается тяжелым. Степень загрузки машины для тяжелых грузов исходит из грузоподъемности. Если же плотность груза меньше индекса, такой груз считается габаритным. Степень загрузки машины для габаритных грузов исходит из объема кузова.</ref>, кг/м3
Tmax - грузоподъемность машины, кг
Vmax - объем кузова машины, м3
l - лимит погрузки<ref>Лимит погрузки - фактическая погружаемая масса/объем груза от возможной. По какой-то причине базы всегда загружают машину не более чем на 85% от максимальной вместительности.</ref>, % (на базах всегда 0,85)
T - масса погрузки, кг
V - объем погрузки, м3

|-
| неизвестное_1* || Число || Влияние на игру не установлено
|-
| неизвестное_2* || Число|| Влияние на игру не установлено
|-
| неизвестное_3* || Число || Копирует значение параметра прочности, за исключением нелегальных и некоторых других грузов. Влияние на игру не установлено
|-
| топливо || fuel || Присутствует только в одноименном грузе. Влияние на игру не установлено
|-
| тип_транспорта* || trucks cars || Тип транспорта, который может перевозить данный груз - грузовики или легковые автомобили. Для грузов, которые могут перевозить и те, и другие, существуют записи-дубликаты с разными значениями этого параметра
|-
| легальность_груза || illegal || Присутствие параметра указывает, что груз нелегален
|-
| нужен_мафии || formafia || Присутствие параметра указывает, что за грузом охотится мафия
|-
| неизвестное_4|| Число || Параметр присутствует только у нелегальных грузов. Влияние на игру не установлено
|-
| прочность* || Число || Из прочности рассчитывается хрупкость груза:
F = (1 - прочность) * 100
|-
| неизвестное_5* || Число || Влияние на игру не установлено
|-
| название* || Строка || Название груза, отображаемое в игре
|}
<nowiki>*</nowiki> - параметры со звездочкой обязательны (присутствуют у всех грузов в игре).

Примеры:
( BREAD CRATE 25 0.1
( 25 70 0.85
( trucks )) 0.85 71 "Хлеб" ) — обычный груз для грузовика

( HEROINE KILO 1 0.0003
( 1500 441.465 0.4
( trucks illegal formafia ) 1.3 ) 1 70 "Героин" ) — нелегальный груз для грузовика, за которым охотится мафия

( C_JEWELRY BOX 100 0.1
( 0 220000 0.5
( cars formafia )) 0.6 0 "Юв. изделия" ) — груз для легкового автомобиля, за которым охотится мафия

==ms.sch==
Файл локализации сообщений пейджера. Вид записи такой же, как и в vd.sch:
( NEED_A_PETROL_SEMITRAILER . "ДЛЯ ПЕРЕВОЗКИ ТОПЛИВА ВАМ НУЖНА АВТОЦИСТЕРНА" )
( LOAD_AT_AN_OIL_TANK . "В АВТОЦИСТЕРНУ МОЖНО ТОЛЬКО ЗАЛИВАТЬ ТОПЛИВО У ГАЗГОЛЬДЕРА" )

==names.sch==
Файл с именами водителей. 
Пример записи файла:
( "COP1" male police 1 0 )
( "HOOD1" male mafia 1 )
( "ВИТАЛИЙ" male trucker 1 )

У милиции после номера записан флаг, показывающий возможность получения взятки. При 0 - принятие взяток невозможно, при 1 - возможно.

==restable.sch==
Предположительно, название происходит от англ. "'''res'''ource '''table'''" - таблица ресурсов.
Файл содержит цены и описание (на английском языке) усовершенствований транспорта на СТО.

Имеет следующий вид:
( идентификатор ( "имя стандартного объекта" нулевая цена ) ( "имя улучшенного объекта" цена усовершенствования ) )

Пример:
( PR_FORCED_ENGINE ( "Regular engine" 0 ) ( "Forced engine" 12500 ) )

==vd.sch==
Файл локализации названий игрового транспорта.
ID имеют следующий вид:
( идентификатор . "название_автомобиля" )

Пример:
( FIAT_1 . "Фиат" )

==SCH-файлы из папки ENV==

Файлы со свойствами участков игрового мира, всего их 36 — от mod_aa.sch до mod_dq.sch.
Содержат настройки объектов, находящихся на данных участках:
*Ассортимент грузов на базах (идентификаторы груза взяты из merchandise.sch)
*Ассортимент апгрейдов на СТО (идентификаторы апгрейдов взяты из restable.sch)
*Сообщения, присылаемые на пейджер при въезде в населенный пункт
*Объявления о ремонтных работах на участках
*Расположение места стоянок автомобилей милиции и мафии на обочине

Пример (фрагменты файла mod_bd.sch):
( nodeevent BASE08NORTH UNCONDITIONAL "store_08_north" NORTH "БАЗА БУХТА НАПРАВО, ЧЕРЕЗ 100 М" ) — сообщение о прибытии на базу

( PR_FORCED_ENGINE 1 )
( PR_OIL_ADDITIVE 1 )
( PR_ABS 1 )
( PR_ADJUSTABLE_SUSPENSION 1 )
( PR_BRAKES 1 )
( PR_ENGINE_BRAKE 1 )
( PR_REINFORCED_CHASSIS 1 )
( PR_BULETPROOF_GLASS 1 )
( PR_NAVIGATOR 1 )
( PR_TIRES 3 ) — ассортимент апгрейдов
( PR_CARGO_SCANNER 1 )
( PR_HORN 1 )
( PR_FIRE_PROTECTION 1 )
( PR_EXTRA_TANK 1 )
( PR_ANTI_RADAR 1 )
( PR_STEALTH_BODY_PAINT 1 )
( PR_HEADLIGHT_PROTECTION 1 )
( PR_AIR_FILTER_SNORKEL 1 )))

( CHAMPAGNE 0 )
( FRESHFISH 0 )
( SALTEDFISH 0 )
( SHOES 0 )
( AUTOPARTS 0 )
( VIDEOCAMERA 0 )
( PENTIUM_III 0 )
( COMPUTER_GAMES 0 ) — ассортимент грузов
( C_CHAMPAGNE 0 )
( C_SHOES 0 )
( C_VIDEOCAMERA 0 )
( C_CAMERA 0 )
( C_COMPUTER_GAMES 0 )
( C_POSTAGE_STAMPS 0 )
( C_WAGES 0 )
( C_MAIL 0 ))

( obstacle OBST_BD_1 REGULAR "bd" "CLOSE_BD_L" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd1" ))
( obstacle OBST_BD_2 REGULAR "bd" "CLOSE_BD_R" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd0" )) — сообщения о ремонте

===Нумерация населенных пунктов===
Населенным пунктам присвоены следующие числовые обозначения:
{| class="wikitable sortable"
|-
! Населенный пункт !! Номер !! Файл *.b3d
|-
| Приозёрск || 0 || aj
|-
| Залесск || 1 || ar
|-
| Ельнино || 2 || au
|-
| Южный || 3 || ap
|-
| Ключи || 4 || bc
|-
| Шахты || 5 || am
|-
| Боровое || 6 || ad
|-
| Нижнегорск || 7 || cb
|-
| Бухта || 8 || bd
|-
| Горный || 9 || dc
|-
| Алмазный || 10 || aa
|}

===Парковки===
( parking MARKET_G "??" 6 ()
(
( node "node_car_0603" )
( node "node_car_0604" )
( node "node_car_0605" )
( node "node_car_0608" 4 "Южный" )
)
8 - число автомобилей, доступных для заказа из данной точки
)

{{Дб2}}

== Примечания ==

Sch-файлы

2025-10-26T21:50:29Z

Aleko 2144: /* etrashboxes.sch */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Страница с кратким описанием sch-файлов. 

Инструменты для дешифрации и шифрации доступны на странице с [[Утилиты_(Дальнобойщики_2) | утилитами]]. Игра может использовать как зашифрованные, так и расшифрованные файлы. Единственное условие - файл должен иметь расширение sch/cnf, txt читаться не будет. 
Расшифрованные sch для [[История_версий_(Дальнобойщики_2)#Дальнобойщики 2 Издание второе, дополненное | дополненного издания игры]] доступны [https://yadi.sk/d/3V2J6YkS8ltomg здесь].

==etrashboxes.sch==
Файл с данными о припаркованных автомобилях.
Имеет следующий вид:
( vehicle идентификатор "идентификатор из tech-файла" номер_окраса тип )

Идентификатор может быть любым. <\br>
Типы:
* parked - припаркованный автомобиль;
* container - контейнер SuperCargo;
* fuel - бочка с топливом на продажу;
* roadwork - объект, устанавливаемый в точке проведения дорожных работ (по умолчанию - каток).
Примеры:
( vehicle PARKED_X "PVan" 3 parked )
( vehicle CONTAINER_X "AnmObj0231" 0 container )
( vehicle FUEL_X "AnmObj0241" 0 fuel )
( vehicle KATOK "Katok" 0 roadwork )

==evehicles.sch==
Файл данных автомобилей.
Имеет следующий вид:
( vehicle идентификатор_в_vd_sch "car_node" номер_окраса тип_автомобиля тип_владельца цена отображаемая_мощность<ref>Только для визуального отображения при покупке. Не обязательно должна соответствовать реальной из tech-файла.</ref> (идентификаторы_совместимых_полуприцепов) флаг )

Параметры:
* vehicle - начало строки параметров, одинаковое для каждого типа автомобиля;
* идентификатор_в_vd_sch - ID используемой подписи автомобиля из vd.sch;
* car_node - имя параметра car_node используемого автомобиля из vehicle.tech

Типы автомобилей (определяет доступный ассортимент грузов для данной машины):
* car - легковой автомобиль;
* lorry - грузовой автомобиль;
* tractor - тягач;
* semitrailer - полуприцеп.
Типы владельцев автомобиля:
* dumb - автомобиль будет использоваться только ai-трафиком; для покупки будет доступен только после захвата 51% рынка;
* trucker - автомобиль будет использоваться наёмными водителями; для покупки доступен с начала игры;
* police - автомобиль будет использоваться игровой милицией;
* mafia - автомобиль будет использоваться игровыми бандитами;
* none - автомобиль не будет никем использоваться в игре, при этом на нём можно будет начать игру, прописав его в файле game.cnf.
Флаг: если указано 1, то транспортное средство сможет получать груз только на '''[[База#Нефтебаза|нефтебазах]]'''.

Пример:
( vehicle FIAT_1 "Fiat" 0 car dumb 32000 408 ())
( vehicle DAF_TRACTOR1 "Daf" 0 tractor trucker 76200 355 ( SEMITRAILER1 SEMITRAILER2 ))
( vehicle SEMITANK4 "STrailerT" 3 semitrailer none 0 101 () 1 )

==merchandise.sch==
Файл с данными обо всех товарах, доступных в игре.
Имеет следующий вид:
( идентификатор тип масса объем
( неизвестное_1 неизвестное_2 неизвестное_3
( топливо тип_транспорта легальность_груза нужен_мафии ) неизвестное_4) прочность неизвестное_5 "Название" )

{| class="wikitable sortable"
|-
! Параметр !! Значения/тип данных !! Описание
|-
| идентификатор* || Уникальный идентификатор || Уникальное внутреннее обозначение груза. По этому имени на груз ссылаются другие файлы игры
|-
| тип* || CRATE CRATE20 CRATE16 PACK KILO UNIT BARREL PIECE BOX TON
|| Обозначает вид единицы груза (ящик, бочка, упаковка, штука). Влияние на игру не установлено
|-
| масса* || Число || Масса единицы груза, кг
|-
| объем* || Число || Объем единицы груза, м3 При помощи параметров массы и объема можно рассчитать, какие масса и объем груза помещаются в машину:

k = масса / объем
s = Tmax / Vmax

При k <= s:
V = Vmax * l
T = V * k

При k > s:
T = Tmax * l
V = T / k

Где:
k - плотность груза (вес на м3), кг/м3
s - индекс грузоподъемности машины<ref>Индекс грузоподъмности машины равен отношению грузоподъемности к объему кузова. Если плотность груза больше индекса грузоподъемности, такой груз считается тяжелым. Степень загрузки машины для тяжелых грузов исходит из грузоподъемности. Если же плотность груза меньше индекса, такой груз считается габаритным. Степень загрузки машины для габаритных грузов исходит из объема кузова.</ref>, кг/м3
Tmax - грузоподъемность машины, кг
Vmax - объем кузова машины, м3
l - лимит погрузки<ref>Лимит погрузки - фактическая погружаемая масса/объем груза от возможной. По какой-то причине базы всегда загружают машину не более чем на 85% от максимальной вместительности.</ref>, % (на базах всегда 0,85)
T - масса погрузки, кг
V - объем погрузки, м3

|-
| неизвестное_1* || Число || Влияние на игру не установлено
|-
| неизвестное_2* || Число|| Влияние на игру не установлено
|-
| неизвестное_3* || Число || Копирует значение параметра прочности, за исключением нелегальных и некоторых других грузов. Влияние на игру не установлено
|-
| топливо || fuel || Присутствует только в одноименном грузе. Влияние на игру не установлено
|-
| тип_транспорта* || trucks cars || Тип транспорта, который может перевозить данный груз - грузовики или легковые автомобили. Для грузов, которые могут перевозить и те, и другие, существуют записи-дубликаты с разными значениями этого параметра
|-
| легальность_груза || illegal || Присутствие параметра указывает, что груз нелегален
|-
| нужен_мафии || formafia || Присутствие параметра указывает, что за грузом охотится мафия
|-
| неизвестное_4|| Число || Параметр присутствует только у нелегальных грузов. Влияние на игру не установлено
|-
| прочность* || Число || Из прочности рассчитывается хрупкость груза:
F = (1 - прочность) * 100
|-
| неизвестное_5* || Число || Влияние на игру не установлено
|-
| название* || Строка || Название груза, отображаемое в игре
|}
<nowiki>*</nowiki> - параметры со звездочкой обязательны (присутствуют у всех грузов в игре).

Примеры:
( BREAD CRATE 25 0.1
( 25 70 0.85
( trucks )) 0.85 71 "Хлеб" ) — обычный груз для грузовика

( HEROINE KILO 1 0.0003
( 1500 441.465 0.4
( trucks illegal formafia ) 1.3 ) 1 70 "Героин" ) — нелегальный груз для грузовика, за которым охотится мафия

( C_JEWELRY BOX 100 0.1
( 0 220000 0.5
( cars formafia )) 0.6 0 "Юв. изделия" ) — груз для легкового автомобиля, за которым охотится мафия

==ms.sch==
Файл локализации сообщений пейджера. Вид записи такой же, как и в vd.sch:
( NEED_A_PETROL_SEMITRAILER . "ДЛЯ ПЕРЕВОЗКИ ТОПЛИВА ВАМ НУЖНА АВТОЦИСТЕРНА" )
( LOAD_AT_AN_OIL_TANK . "В АВТОЦИСТЕРНУ МОЖНО ТОЛЬКО ЗАЛИВАТЬ ТОПЛИВО У ГАЗГОЛЬДЕРА" )

==names.sch==
Файл с именами водителей. 
Пример записи файла:
( "COP1" male police 1 0 )
( "HOOD1" male mafia 1 )
( "ВИТАЛИЙ" male trucker 1 )

У милиции после номера записан флаг, показывающий возможность получения взятки. При 0 - принятие взяток невозможно, при 1 - возможно.

==restable.sch==
Предположительно, название происходит от англ. "'''res'''ource '''table'''" - таблица ресурсов.
Файл содержит цены и описание (на английском языке) усовершенствований транспорта на СТО.

Имеет следующий вид:
( идентификатор ( "имя стандартного объекта" нулевая цена ) ( "имя улучшенного объекта" цена усовершенствования ) )

Пример:
( PR_FORCED_ENGINE ( "Regular engine" 0 ) ( "Forced engine" 12500 ) )

==vd.sch==
Файл локализации названий игрового транспорта.
ID имеют следующий вид:
( идентификатор . "название_автомобиля" )

Пример:
( FIAT_1 . "Фиат" )

==SCH-файлы из папки ENV==

Файлы со свойствами участков игрового мира, всего их 36 — от mod_aa.sch до mod_dq.sch.
Содержат настройки объектов, находящихся на данных участках:
*Ассортимент грузов на базах (идентификаторы груза взяты из merchandise.sch)
*Ассортимент апгрейдов на СТО (идентификаторы апгрейдов взяты из restable.sch)
*Сообщения, присылаемые на пейджер при въезде в населенный пункт
*Объявления о ремонтных работах на участках
*Расположение места стоянок автомобилей милиции и мафии на обочине

Пример (фрагменты файла mod_bd.sch):
( nodeevent BASE08NORTH UNCONDITIONAL "store_08_north" NORTH "БАЗА БУХТА НАПРАВО, ЧЕРЕЗ 100 М" ) — сообщение о прибытии на базу

( PR_FORCED_ENGINE 1 )
( PR_OIL_ADDITIVE 1 )
( PR_ABS 1 )
( PR_ADJUSTABLE_SUSPENSION 1 )
( PR_BRAKES 1 )
( PR_ENGINE_BRAKE 1 )
( PR_REINFORCED_CHASSIS 1 )
( PR_BULETPROOF_GLASS 1 )
( PR_NAVIGATOR 1 )
( PR_TIRES 3 ) — ассортимент апгрейдов
( PR_CARGO_SCANNER 1 )
( PR_HORN 1 )
( PR_FIRE_PROTECTION 1 )
( PR_EXTRA_TANK 1 )
( PR_ANTI_RADAR 1 )
( PR_STEALTH_BODY_PAINT 1 )
( PR_HEADLIGHT_PROTECTION 1 )
( PR_AIR_FILTER_SNORKEL 1 )))

( CHAMPAGNE 0 )
( FRESHFISH 0 )
( SALTEDFISH 0 )
( SHOES 0 )
( AUTOPARTS 0 )
( VIDEOCAMERA 0 )
( PENTIUM_III 0 )
( COMPUTER_GAMES 0 ) — ассортимент грузов
( C_CHAMPAGNE 0 )
( C_SHOES 0 )
( C_VIDEOCAMERA 0 )
( C_CAMERA 0 )
( C_COMPUTER_GAMES 0 )
( C_POSTAGE_STAMPS 0 )
( C_WAGES 0 )
( C_MAIL 0 ))

( obstacle OBST_BD_1 REGULAR "bd" "CLOSE_BD_L" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd1" ))
( obstacle OBST_BD_2 REGULAR "bd" "CLOSE_BD_R" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd0" )) — сообщения о ремонте

===Нумерация населенных пунктов===
Населенным пунктам присвоены следующие числовые обозначения:
{| class="wikitable sortable"
|-
! Населенный пункт !! Номер !! Файл *.b3d
|-
| Приозёрск || 0 || aj
|-
| Залесск || 1 || ar
|-
| Ельнино || 2 || au
|-
| Южный || 3 || ap
|-
| Ключи || 4 || bc
|-
| Шахты || 5 || am
|-
| Боровое || 6 || ad
|-
| Нижнегорск || 7 || cb
|-
| Бухта || 8 || bd
|-
| Горный || 9 || dc
|-
| Алмазный || 10 || aa
|}

===Парковки===
( parking MARKET_G "??" 6 ()
(
( node "node_car_0603" )
( node "node_car_0604" )
( node "node_car_0605" )
( node "node_car_0608" 4 "Южный" )
)
8 - число автомобилей, доступных для заказа из данной точки
)

{{Дб2}}

== Примечания ==

Vehicle.tech

2025-10-26T21:00:58Z

Aleko 2144:

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг_(Дальнобойщики_2)]]
[[Категория:Транспортные_средства_(Дальнобойщики_2)]]
'''vehicle.tech''' - файл, отвечающий за различные характеристики автомобилей в [[Дальнобойщики_2|Дальнобойщиках 2]].
== Как и чем редактировать vehicle.tech? ==
Существует несколько вариантов редактирования данного файла: 
# С помощью утилиты '''D2 Tech Editor'''. Автор программы - Алексей Воронов ([[Участник:BoPoH|BoPoH]]). Скачать можно [[Утилиты (Дальнобойщики 2)|со страницы с утилитами]]. 
# Через HEX-редактор. Скачать hsl-структуры для версий 6.6 и 7.2 можно [https://vk.com/wall-11599748_44108?reply=47612 здесь], для версии 8.0 - [https://vk.com/topic-157113673_39349010?post=128 тут].
# Наконец, '''наиболее правильный способ''' - собрать файл из исходных текстовых файлов. Инструкция и ссылка на загрузку доступны [https://vk.com/page-157113673_53558294 здесь].
== Переменные и их значения ==

{| class="wikitable"
|-
!Название переменной||Значение
|-
|CenterMassInB3D||Центр масс.
|-
|mass||Масса автомобиля. <ref> Также отвечает за звук двигателя. Бензиновый двигатель = 0-3000, дизель = 3000 и выше. </ref>
|-
|rwheel||Расстояние между дорогой и нижним концом пружины.
|-
|rwheel1||Толщина колеса.
|-
|tank||Объём топливного бака. <ref> Если изменить только значение объёма бака, то на дальность хода грузовика это никак не повлияет. Дело в том, что мгновенный расход топлива вычисляется в относительных единицах, а не в литрах. Т. е. используется отношение долей (процентов или промилле) от полного объёма бака к количеству совершённых оборотов коленвала.

Чтобы в этом убедиться, достаточно установить крошечный объём бака (н-р, всего 1 л) и замерить дальность хода. Она окажется такой же, как и при 100 л, и при 1000 л.

Чтобы дальность хода увеличивалась пропорционально увеличению объёма бака, необходимо увеличивать и значение переменной "fuelTimeEndurance". [https://vk.com/wall-11599748_51210?reply=51217 Источник] </ref>
|-
|fuelTimeEndurance||Относительная топливная эффективность. <ref> Данная переменная отражает относительную топливную эффективность, т. е. это некий коэффициент, указывающий насколько медленнее будет расходоваться единичный объём топлива (соответствующий объёму бака) по сравнению с некоторым эталонным двигателем, для которого значение данной переменной равно 1. [https://vk.com/wall-11599748_51210?reply=51241 Источник]</ref>
|-
|fuelConsumption||Расход топлива (количество литров на 10 км).
|-
|kilometrage||неизвестно
|-
|air_press_coeff||Давление воздуха.
|-
|air_resist_coeff||Сопротивление воздуха.
|-
|air_side_resist_coeff||Боковое сопротивление воздуха. <ref>Также влияет на блокировку вращения прицепа относительно тягача. </ref>
|-
|front_wheel_thickness||Ширина передних колёс.
|-
|rear_wheel_thickness||Ширина задних колёс.
|-
|maxrotmomentum||Максимальный крутящий момент.
|-
|breakpower||Сила торможения.
|-
|rear_axle_coeff||Передаточное число редуктора.
|-
|reverse_trans_coeff0||Передаточное число передачи заднего хода.
|-
|gear_trans_coeff1..13||Передаточные числа передач с первой по тринадцатую.
|-
|tach_with_max_power||Обороты максимального крутящего момента. Также определяют максимальные обороты двигателя вообще, примерно равные 3 * tach_with_max_power
|-
|cargo_and_body_pick_load||Грузоподъёмность.
|-
|body_mass||Масса фургона.
|-
|body_height||Высота фургона.
|-
|body_square||Объём фургона.
|-
|center_of_cargo_bottom||Позиция груза в кузове автомобиля.
|-
|driving_wheels||Колёсная формула.
|-
|sterring_wheels||Поворотные колёса.
|-
|touching_road_wheels||Показывает, какие колёса соприкасаются с поверхностью.
|-
|OV||Координаты салона.
|-
|tangViewer||Наклон камеры из салона.
|-
|I||Момент инерции.
|-
|suspension||Подвеска автомобиля. <ref>Первые 4 параметра - минимальная высота, остальные 4 - максимальная. Вообще, подвеска в tech-файле представлена в виде восьми параметров: hmin0, hmin1, hmin2, hmin3 и hmax0, hmax1, hmax2, hmax3 (см. файл carv.ini из [[Автомобильные_гонки|Car Races Demo]]). </ref>
|-
|Ks||Коэффициент жесткости пружин.
|-
|Cs||Коэффициент амортизаторов.
|-
|CollisionRadius||Радиус коллизии автомобиля.
|-
|CollisionCenter||Центр коллизии автомобиля (вместе с предыдущим параметром, по всей видимости, используется для позиционирования создаваемого дорожного трафика).
|-
|rubber_collision_coeff||Коэффициент коллизии колёс.
|-
|slide_collision_coeff||Коэффициент бокового трения.
|-
|Corner_Mark_1..11||Точки коллизии для расчёта столкновений со статичными объектами (игровым миром). Обычно совпадает с коллизией, определённой объектами CollisionPlane.
|-
|AddColPnts0...3||Нижние точки крайних передних и крайних задних колёс, автоматические определяемые игрой при сборке tech-файла.
|-
|Corner_Mark_W1...4||Нижние габаритные точки коллизии автомобиля.
|-
|CollisionPlane0...16||Плоскости коллизии для расчёта столкновений с динамическими объектами (другой транспорт, бочки). Первые три числа - нормальный вектор, задающий направление, четвёртый параметр - удаление плоскости от начала координат (0, 0, 0). Каждая плоскость перпендикулярна точке (0, 0, 0). Границы пересечений данных плоскостей образуют коллизию автомобиля.
|-
|tvCameraPosition1||Позиция левого зеркала.
|-
|tvCameraPosition2||Позиция центрального зеркала.
|-
|tvCameraPosition3||Позиция правого зеркала.
|-
|tvCameraPosition4||неизвестно
|-
|tvCameraRightConer||неизвестно
|-
|SmokePosition||Позиция выхлопа.
|-
|SmokeDirection||Направление выхлопа.
|-
|SmokePosition2||Позиция второго выхлопа.
|-
|SmokeDirection2||Направление второго выхлопа.
|-
|flame_place||Позиция огня горящего двигателя.
|-
|Fara_FL||Координаты свечения левой фары.
|-
|Fara_FR||Координаты свечения правой фары.
|-
|Fara_BLs||Координаты свечения заднего левого фонаря.
|-
|Fara_BRs||Координаты свечения заднего правого фонаря.
|-
|Fara_BL||Координаты свечения левого огня заднего хода.
|-
|Fara_BR||Координаты свечения правого огня заднего хода.
|-
|horse_power||Мощность двигателя.
|-
|price||Цена автомобиля (указанная здесь не используется, задаётся в [[Sch-файлы#evehicles.sch|evehicles.sch]]).
|-
|glowwing||неизвестно
|-
|lowSaddle||Координаты сцепки на тягаче для соединения с полуприцепом.
|-
|topSaddle||Координаты сцепки на полуприцепе для соединения с тягачом.
|-
|Towhook||Координаты сцепки на грузовике для соединения с прицепом (в игре не используется).
|-
|Coupler||Координаты сцепки на прицепе для соединения с грузовиком.
|-
|shiftSaddle||Смещение точки сцепки по оси Y относительно параметра lowSaddle.
|-
|CouplerLength||Вероятно, аналогично предыдущему, но относительно параметра Towhook.
|-
|SpeedScale||Первое число - максимальное значение скорости на шкале спидометра, второе - максимальный угол поворота стрелки спидометра.
|-
|TachScale||Аналогично SpeedScale.
|-
|FuelScale||Аналогично TachScale.
|-
|CabRWindow||неизвестно
|-
|CabLWindow||неизвестно
|-
|CabFrontWindow||неизвестно
|-
|Drivers_neck_Angles||Ограничения поворота камеры в салоне по осям (мин. Z, мин. Y, мин. X, 0, макс. X, макс. Y, макс. Z).
|-
|cockpit_space||Имя локатора кабины в trucks.b3d (<автомобиль>BoothSpace). Данный локатор используется для имитации качения кабины.
|-
|prefix||Префикс объектов автомобиля в trucks.b3d (локаторы и фары).
|-
|prefixCab||Префикс используемой кабины из cabines.b3d.
|-
|car_node||Имя блока автомобиля в trucks.b3d. Также на данный параметр ссылаются данные из evehicles.sch
|-
|trailer_type||Тип полуприцепа: 1 - стандартный, 2 - платформа, 3 - цистерна.
|-
|Fara_Dir||неизвестно
|-
|Fara_Width||неизвестно
|}
{{Дб2}}
==Примечания==

Sch-файлы

2025-10-26T20:59:52Z

Aleko 2144: /* evehicles.sch */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Страница с кратким описанием sch-файлов. 

Инструменты для дешифрации и шифрации доступны на странице с [[Утилиты_(Дальнобойщики_2) | утилитами]]. Игра может использовать как зашифрованные, так и расшифрованные файлы. Единственное условие - файл должен иметь расширение sch/cnf, txt читаться не будет. 
Расшифрованные sch для [[История_версий_(Дальнобойщики_2)#Дальнобойщики 2 Издание второе, дополненное | дополненного издания игры]] доступны [https://yadi.sk/d/3V2J6YkS8ltomg здесь].

==etrashboxes.sch==
Файл с данными о припаркованных автомобилях.
Имеет следующий вид:
( vehicle тип "идентификатор из tech-файла" номер_окраса подтип )

Типы: PARKED_X, FUEL_X, CONTAINER_X и KATOK. 
Подтипы: parked, container, fuel и roadwork. 
Примеры:
( vehicle PARKED_X "PVan" 3 parked )
( vehicle CONTAINER_X "AnmObj0231" 0 container )
( vehicle FUEL_X "AnmObj0241" 0 fuel )
( vehicle KATOK "Katok" 0 roadwork )

==evehicles.sch==
Файл данных автомобилей.
Имеет следующий вид:
( vehicle идентификатор_в_vd_sch "car_node" номер_окраса тип_автомобиля тип_владельца цена отображаемая_мощность<ref>Только для визуального отображения при покупке. Не обязательно должна соответствовать реальной из tech-файла.</ref> (идентификаторы_совместимых_полуприцепов) флаг )

Параметры:
* vehicle - начало строки параметров, одинаковое для каждого типа автомобиля;
* идентификатор_в_vd_sch - ID используемой подписи автомобиля из vd.sch;
* car_node - имя параметра car_node используемого автомобиля из vehicle.tech

Типы автомобилей (определяет доступный ассортимент грузов для данной машины):
* car - легковой автомобиль;
* lorry - грузовой автомобиль;
* tractor - тягач;
* semitrailer - полуприцеп.
Типы владельцев автомобиля:
* dumb - автомобиль будет использоваться только ai-трафиком; для покупки будет доступен только после захвата 51% рынка;
* trucker - автомобиль будет использоваться наёмными водителями; для покупки доступен с начала игры;
* police - автомобиль будет использоваться игровой милицией;
* mafia - автомобиль будет использоваться игровыми бандитами;
* none - автомобиль не будет никем использоваться в игре, при этом на нём можно будет начать игру, прописав его в файле game.cnf.
Флаг: если указано 1, то транспортное средство сможет получать груз только на '''[[База#Нефтебаза|нефтебазах]]'''.

Пример:
( vehicle FIAT_1 "Fiat" 0 car dumb 32000 408 ())
( vehicle DAF_TRACTOR1 "Daf" 0 tractor trucker 76200 355 ( SEMITRAILER1 SEMITRAILER2 ))
( vehicle SEMITANK4 "STrailerT" 3 semitrailer none 0 101 () 1 )

==merchandise.sch==
Файл с данными обо всех товарах, доступных в игре.
Имеет следующий вид:
( идентификатор тип масса объем
( неизвестное_1 неизвестное_2 неизвестное_3
( топливо тип_транспорта легальность_груза нужен_мафии ) неизвестное_4) прочность неизвестное_5 "Название" )

{| class="wikitable sortable"
|-
! Параметр !! Значения/тип данных !! Описание
|-
| идентификатор* || Уникальный идентификатор || Уникальное внутреннее обозначение груза. По этому имени на груз ссылаются другие файлы игры
|-
| тип* || CRATE CRATE20 CRATE16 PACK KILO UNIT BARREL PIECE BOX TON
|| Обозначает вид единицы груза (ящик, бочка, упаковка, штука). Влияние на игру не установлено
|-
| масса* || Число || Масса единицы груза, кг
|-
| объем* || Число || Объем единицы груза, м3 При помощи параметров массы и объема можно рассчитать, какие масса и объем груза помещаются в машину:

k = масса / объем
s = Tmax / Vmax

При k <= s:
V = Vmax * l
T = V * k

При k > s:
T = Tmax * l
V = T / k

Где:
k - плотность груза (вес на м3), кг/м3
s - индекс грузоподъемности машины<ref>Индекс грузоподъмности машины равен отношению грузоподъемности к объему кузова. Если плотность груза больше индекса грузоподъемности, такой груз считается тяжелым. Степень загрузки машины для тяжелых грузов исходит из грузоподъемности. Если же плотность груза меньше индекса, такой груз считается габаритным. Степень загрузки машины для габаритных грузов исходит из объема кузова.</ref>, кг/м3
Tmax - грузоподъемность машины, кг
Vmax - объем кузова машины, м3
l - лимит погрузки<ref>Лимит погрузки - фактическая погружаемая масса/объем груза от возможной. По какой-то причине базы всегда загружают машину не более чем на 85% от максимальной вместительности.</ref>, % (на базах всегда 0,85)
T - масса погрузки, кг
V - объем погрузки, м3

|-
| неизвестное_1* || Число || Влияние на игру не установлено
|-
| неизвестное_2* || Число|| Влияние на игру не установлено
|-
| неизвестное_3* || Число || Копирует значение параметра прочности, за исключением нелегальных и некоторых других грузов. Влияние на игру не установлено
|-
| топливо || fuel || Присутствует только в одноименном грузе. Влияние на игру не установлено
|-
| тип_транспорта* || trucks cars || Тип транспорта, который может перевозить данный груз - грузовики или легковые автомобили. Для грузов, которые могут перевозить и те, и другие, существуют записи-дубликаты с разными значениями этого параметра
|-
| легальность_груза || illegal || Присутствие параметра указывает, что груз нелегален
|-
| нужен_мафии || formafia || Присутствие параметра указывает, что за грузом охотится мафия
|-
| неизвестное_4|| Число || Параметр присутствует только у нелегальных грузов. Влияние на игру не установлено
|-
| прочность* || Число || Из прочности рассчитывается хрупкость груза:
F = (1 - прочность) * 100
|-
| неизвестное_5* || Число || Влияние на игру не установлено
|-
| название* || Строка || Название груза, отображаемое в игре
|}
<nowiki>*</nowiki> - параметры со звездочкой обязательны (присутствуют у всех грузов в игре).

Примеры:
( BREAD CRATE 25 0.1
( 25 70 0.85
( trucks )) 0.85 71 "Хлеб" ) — обычный груз для грузовика

( HEROINE KILO 1 0.0003
( 1500 441.465 0.4
( trucks illegal formafia ) 1.3 ) 1 70 "Героин" ) — нелегальный груз для грузовика, за которым охотится мафия

( C_JEWELRY BOX 100 0.1
( 0 220000 0.5
( cars formafia )) 0.6 0 "Юв. изделия" ) — груз для легкового автомобиля, за которым охотится мафия

==ms.sch==
Файл локализации сообщений пейджера. Вид записи такой же, как и в vd.sch:
( NEED_A_PETROL_SEMITRAILER . "ДЛЯ ПЕРЕВОЗКИ ТОПЛИВА ВАМ НУЖНА АВТОЦИСТЕРНА" )
( LOAD_AT_AN_OIL_TANK . "В АВТОЦИСТЕРНУ МОЖНО ТОЛЬКО ЗАЛИВАТЬ ТОПЛИВО У ГАЗГОЛЬДЕРА" )

==names.sch==
Файл с именами водителей. 
Пример записи файла:
( "COP1" male police 1 0 )
( "HOOD1" male mafia 1 )
( "ВИТАЛИЙ" male trucker 1 )

У милиции после номера записан флаг, показывающий возможность получения взятки. При 0 - принятие взяток невозможно, при 1 - возможно.

==restable.sch==
Предположительно, название происходит от англ. "'''res'''ource '''table'''" - таблица ресурсов.
Файл содержит цены и описание (на английском языке) усовершенствований транспорта на СТО.

Имеет следующий вид:
( идентификатор ( "имя стандартного объекта" нулевая цена ) ( "имя улучшенного объекта" цена усовершенствования ) )

Пример:
( PR_FORCED_ENGINE ( "Regular engine" 0 ) ( "Forced engine" 12500 ) )

==vd.sch==
Файл локализации названий игрового транспорта.
ID имеют следующий вид:
( идентификатор . "название_автомобиля" )

Пример:
( FIAT_1 . "Фиат" )

==SCH-файлы из папки ENV==

Файлы со свойствами участков игрового мира, всего их 36 — от mod_aa.sch до mod_dq.sch.
Содержат настройки объектов, находящихся на данных участках:
*Ассортимент грузов на базах (идентификаторы груза взяты из merchandise.sch)
*Ассортимент апгрейдов на СТО (идентификаторы апгрейдов взяты из restable.sch)
*Сообщения, присылаемые на пейджер при въезде в населенный пункт
*Объявления о ремонтных работах на участках
*Расположение места стоянок автомобилей милиции и мафии на обочине

Пример (фрагменты файла mod_bd.sch):
( nodeevent BASE08NORTH UNCONDITIONAL "store_08_north" NORTH "БАЗА БУХТА НАПРАВО, ЧЕРЕЗ 100 М" ) — сообщение о прибытии на базу

( PR_FORCED_ENGINE 1 )
( PR_OIL_ADDITIVE 1 )
( PR_ABS 1 )
( PR_ADJUSTABLE_SUSPENSION 1 )
( PR_BRAKES 1 )
( PR_ENGINE_BRAKE 1 )
( PR_REINFORCED_CHASSIS 1 )
( PR_BULETPROOF_GLASS 1 )
( PR_NAVIGATOR 1 )
( PR_TIRES 3 ) — ассортимент апгрейдов
( PR_CARGO_SCANNER 1 )
( PR_HORN 1 )
( PR_FIRE_PROTECTION 1 )
( PR_EXTRA_TANK 1 )
( PR_ANTI_RADAR 1 )
( PR_STEALTH_BODY_PAINT 1 )
( PR_HEADLIGHT_PROTECTION 1 )
( PR_AIR_FILTER_SNORKEL 1 )))

( CHAMPAGNE 0 )
( FRESHFISH 0 )
( SALTEDFISH 0 )
( SHOES 0 )
( AUTOPARTS 0 )
( VIDEOCAMERA 0 )
( PENTIUM_III 0 )
( COMPUTER_GAMES 0 ) — ассортимент грузов
( C_CHAMPAGNE 0 )
( C_SHOES 0 )
( C_VIDEOCAMERA 0 )
( C_CAMERA 0 )
( C_COMPUTER_GAMES 0 )
( C_POSTAGE_STAMPS 0 )
( C_WAGES 0 )
( C_MAIL 0 ))

( obstacle OBST_BD_1 REGULAR "bd" "CLOSE_BD_L" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd1" ))
( obstacle OBST_BD_2 REGULAR "bd" "CLOSE_BD_R" "" "" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК НА РЕМОНТЕ" "МОСТ НА ТРАССЕ БУХТА-НИЖНЕГОРСК ВОССТАНОВЛЕН"
( "pos_work_bd0" )) — сообщения о ремонте

===Нумерация населенных пунктов===
Населенным пунктам присвоены следующие числовые обозначения:
{| class="wikitable sortable"
|-
! Населенный пункт !! Номер !! Файл *.b3d
|-
| Приозёрск || 0 || aj
|-
| Залесск || 1 || ar
|-
| Ельнино || 2 || au
|-
| Южный || 3 || ap
|-
| Ключи || 4 || bc
|-
| Шахты || 5 || am
|-
| Боровое || 6 || ad
|-
| Нижнегорск || 7 || cb
|-
| Бухта || 8 || bd
|-
| Горный || 9 || dc
|-
| Алмазный || 10 || aa
|}

===Парковки===
( parking MARKET_G "??" 6 ()
(
( node "node_car_0603" )
( node "node_car_0604" )
( node "node_car_0605" )
( node "node_car_0608" 4 "Южный" )
)
8 - число автомобилей, доступных для заказа из данной точки
)

{{Дб2}}

== Примечания ==

Vehicle.tech

2025-10-26T17:43:31Z

Aleko 2144:

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг_(Дальнобойщики_2)]]
[[Категория:Транспортные_средства_(Дальнобойщики_2)]]
'''vehicle.tech''' - файл, отвечающий за различные характеристики автомобилей в [[Дальнобойщики_2|Дальнобойщиках 2]].
== Как и чем редактировать vehicle.tech? ==
Существует несколько вариантов редактирования данного файла: 
# С помощью утилиты '''D2 Tech Editor'''. Автор программы - Алексей Воронов ([[Участник:BoPoH|BoPoH]]). Скачать можно [[Утилиты (Дальнобойщики 2)|со страницы с утилитами]]. 
# Через HEX-редактор. Скачать hsl-структуры для версий 6.6 и 7.2 можно [https://vk.com/wall-11599748_44108?reply=47612 здесь], для версии 8.0 - [https://vk.com/topic-157113673_39349010?post=128 тут].
# Наконец, '''наиболее правильный способ''' - собрать файл из исходных текстовых файлов. Инструкция и ссылка на загрузку доступны [https://vk.com/page-157113673_53558294 здесь].
== Переменные и их значения ==

{| class="wikitable"
|-
!Название переменной||Значение
|-
|CenterMassInB3D||Центр масс.
|-
|mass||Масса автомобиля. <ref> Также отвечает за звук двигателя. Бензиновый двигатель = 0-3000, дизель = 3000 и выше. </ref>
|-
|rwheel||Расстояние между дорогой и нижним концом пружины.
|-
|rwheel1||Толщина колеса.
|-
|tank||Объём топливного бака. <ref> Если изменить только значение объёма бака, то на дальность хода грузовика это никак не повлияет. Дело в том, что мгновенный расход топлива вычисляется в относительных единицах, а не в литрах. Т. е. используется отношение долей (процентов или промилле) от полного объёма бака к количеству совершённых оборотов коленвала.

Чтобы в этом убедиться, достаточно установить крошечный объём бака (н-р, всего 1 л) и замерить дальность хода. Она окажется такой же, как и при 100 л, и при 1000 л.

Чтобы дальность хода увеличивалась пропорционально увеличению объёма бака, необходимо увеличивать и значение переменной "fuelTimeEndurance". [https://vk.com/wall-11599748_51210?reply=51217 Источник] </ref>
|-
|fuelTimeEndurance||Относительная топливная эффективность. <ref> Данная переменная отражает относительную топливную эффективность, т. е. это некий коэффициент, указывающий насколько медленнее будет расходоваться единичный объём топлива (соответствующий объёму бака) по сравнению с некоторым эталонным двигателем, для которого значение данной переменной равно 1. [https://vk.com/wall-11599748_51210?reply=51241 Источник]</ref>
|-
|fuelConsumption||Расход топлива (количество литров на 10 км).
|-
|kilometrage||неизвестно
|-
|air_press_coeff||Давление воздуха.
|-
|air_resist_coeff||Сопротивление воздуха.
|-
|air_side_resist_coeff||Боковое сопротивление воздуха. <ref>Также влияет на блокировку вращения прицепа относительно тягача. </ref>
|-
|front_wheel_thickness||Ширина передних колёс.
|-
|rear_wheel_thickness||Ширина задних колёс.
|-
|maxrotmomentum||Максимальный крутящий момент.
|-
|breakpower||Сила торможения.
|-
|rear_axle_coeff||Передаточное число редуктора.
|-
|reverse_trans_coeff0||Передаточное число передачи заднего хода.
|-
|gear_trans_coeff1..13||Передаточные числа передач с первой по тринадцатую.
|-
|tach_with_max_power||Обороты максимального крутящего момента. Также определяют максимальные обороты двигателя вообще, примерно равные 3 * tach_with_max_power
|-
|cargo_and_body_pick_load||Грузоподъёмность.
|-
|body_mass||Масса фургона.
|-
|body_height||Высота фургона.
|-
|body_square||Объём фургона.
|-
|center_of_cargo_bottom||Позиция груза в кузове автомобиля.
|-
|driving_wheels||Колёсная формула.
|-
|sterring_wheels||Поворотные колёса.
|-
|touching_road_wheels||Показывает, какие колёса соприкасаются с поверхностью.
|-
|OV||Координаты салона.
|-
|tangViewer||Наклон камеры из салона.
|-
|I||Момент инерции.
|-
|suspension||Подвеска автомобиля. <ref>Первые 4 параметра - минимальная высота, остальные 4 - максимальная. Вообще, подвеска в tech-файле представлена в виде восьми параметров: hmin0, hmin1, hmin2, hmin3 и hmax0, hmax1, hmax2, hmax3 (см. файл carv.ini из [[Автомобильные_гонки|Car Races Demo]]). </ref>
|-
|Ks||Коэффициент жесткости пружин.
|-
|Cs||Коэффициент амортизаторов.
|-
|CollisionRadius||Радиус коллизии автомобиля.
|-
|CollisionCenter||Центр коллизии автомобиля (вместе с предыдущим параметром, по всей видимости, используется для позиционирования создаваемого дорожного трафика).
|-
|rubber_collision_coeff||Коэффициент коллизии колёс.
|-
|slide_collision_coeff||Коэффициент бокового трения.
|-
|Corner_Mark_1..11||Точки коллизии для расчёта столкновений со статичными объектами (игровым миром). Обычно совпадает с коллизией, определённой объектами CollisionPlane.
|-
|AddColPnts0...3||Нижние точки крайних передних и крайних задних колёс, автоматические определяемые игрой при сборке tech-файла.
|-
|Corner_Mark_W1...4||Нижние габаритные точки коллизии автомобиля.
|-
|CollisionPlane0...16||Плоскости коллизии для расчёта столкновений с динамическими объектами (другой транспорт, бочки). Первые три числа - нормальный вектор, задающий направление, четвёртый параметр - удаление плоскости от начала координат (0, 0, 0). Каждая плоскость перпендикулярна точке (0, 0, 0). Границы пересечений данных плоскостей образуют коллизию автомобиля.
|-
|tvCameraPosition1||Позиция левого зеркала.
|-
|tvCameraPosition2||Позиция центрального зеркала.
|-
|tvCameraPosition3||Позиция правого зеркала.
|-
|tvCameraPosition4||неизвестно
|-
|tvCameraRightConer||неизвестно
|-
|SmokePosition||Позиция выхлопа.
|-
|SmokeDirection||Направление выхлопа.
|-
|SmokePosition2||Позиция второго выхлопа.
|-
|SmokeDirection2||Направление второго выхлопа.
|-
|flame_place||Позиция огня горящего двигателя.
|-
|Fara_FL||Координаты свечения левой фары.
|-
|Fara_FR||Координаты свечения правой фары.
|-
|Fara_BLs||Координаты свечения заднего левого фонаря.
|-
|Fara_BRs||Координаты свечения заднего правого фонаря.
|-
|Fara_BL||Координаты свечения левого огня заднего хода.
|-
|Fara_BR||Координаты свечения правого огня заднего хода.
|-
|horse_power||Мощность двигателя.
|-
|price||Цена автомобиля (указанная здесь не используется, задаётся в [[Sch-файлы#evehicles.sch|evehicles.sch]]).
|-
|glowwing||неизвестно
|-
|lowSaddle||Координаты сцепки на тягаче для соединения с полуприцепом.
|-
|topSaddle||Координаты сцепки на полуприцепе для соединения с тягачом.
|-
|Towhook||Координаты сцепки на грузовике для соединения с прицепом (в игре не используется).
|-
|Coupler||Координаты сцепки на прицепе для соединения с грузовиком.
|-
|shiftSaddle||Смещение точки сцепки по оси Y относительно параметра lowSaddle.
|-
|CouplerLength||Вероятно, аналогично предыдущему, но относительно параметра Towhook.
|-
|SpeedScale||Первое число - максимальное значение скорости на шкале спидометра, второе - максимальный угол поворота стрелки спидометра.
|-
|TachScale||Аналогично SpeedScale.
|-
|FuelScale||Аналогично TachScale.
|-
|CabRWindow||неизвестно
|-
|CabLWindow||неизвестно
|-
|CabFrontWindow||неизвестно
|-
|Drivers_neck_Angles||Ограничения поворота камеры в салоне по осям (мин. Z, мин. Y, мин. X, 0, макс. X, макс. Y, макс. Z).
|-
|cockpit_space||Имя локатора геометрии кабины в trucks.b3d (<автомобиль>BoothSpace). Данный локатор используется для имитации качения кабины.
|-
|prefix||Префикс объектов автомобиля в trucks.b3d (локаторы и фары).
|-
|prefixCab||Префикс используемой кабины из cabines.b3d.
|-
|car_node||Имя блока автомобиля в trucks.b3d.
|-
|trailer_type||Тип полуприцепа: 1 - стандартный, 2 - платформа, 3 - цистерна.
|-
|Fara_Dir||неизвестно
|-
|Fara_Width||неизвестно
|}
{{Дб2}}
==Примечания==

B3D (формат файлов)

2025-10-23T14:54:43Z

Aleko 2144: /* Источник света (33) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-22T23:28:20Z

Aleko 2144: /* Контейнер комнаты (41) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-22T23:27:16Z

Aleko 2144: /* Замечания по структурам */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 35 типов объектов (1 - 33, 41 и 42). К выходу «Дальнобойщиков 2» их количество было увеличено до 41.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-22T23:08:45Z

Aleko 2144: /* Контейнер комнаты (41) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-22T23:05:03Z

Aleko 2144: добавил типы 15, 22, 26 и 41

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 15==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Предположительно, структура аналогична блоку типа 16. Не встречается в файлах игры.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Контейнер типа 22==
Vector4 nodePosition;
Vector4 some_vector;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Контейнер типа 26==
Vector4 nodePosition;
Vector3 some_vector1;
Vector3 some_vector2;
Vector3 some_vector3;
int childCount;
<блоки[childCount]>

Назначение неизвестно.

==Блок типа 27==
Vector4 nodePosition;
Vector3 some_vector1;
int some_value1;
Vector3 some_vector2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

==Контейнер комнаты (41)==
Vector4 nodePosition;
int paramsCount;
<int[paramsCount] params>
int childCount;
<блоки[childCount]>

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

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-20T18:30:38Z

Aleko 2144: /* Спрайт (31) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Набор спрайтов (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-20T18:30:22Z

Aleko 2144: /* Блок типа 31 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Спрайт (31)==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 spritePosition?;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Трёхмерный спрайт. Использует маску формата MSK, в отличие от типа 28. В Type31Data указаны разные варианты масок, в порядке возрастания разрешения текстуры. Судя по всему, переключение отображаемой маски происходит в зависимости от расстояния до наблюдателя.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-20T18:28:20Z

Aleko 2144: /* Спрайт (28) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт. Использует материал с текстурой формата TXR.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-19T18:21:31Z

Aleko 2144: /* Технические ограничения (Дальнобойщики II) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.
* На каждую вершину 3D-модели на данном слое UV-развёртки в блоке вершин может приходиться только одна пара UV-координат. Иными словами, недопускается, чтобы одна и та же вершина, используемая в разных треугольниках, имела разные UV-координаты. На каждый островок UV должен приходиться свой набор вершин. Впрочем, данное ограничение можно обойти, указывая индивидуальные координаты вершин каждого треугольника в блоке геометрии. Но в таком случае отражения (см. параметр "env" в [[RES_(формат_файлов)|RES]]) будут рассчитываться не для всей модели, а для каждого треугольника.

{{Дб2}}

= Примечания =

Шаблон:Дб2

2025-10-12T14:54:06Z

Aleko 2144: добавил раздел про форматы ресурсов игры

{| class="wikitable" width="100%"
!colspan=3 style="background-color:#D1CCA7"|[[Дальнобойщики 2]]
|-
|style="background-color:#D1CCA7; text-align:right; width: 15%"|'''''Игровое наполнение'''''
|[[Игровой регион (Дальнобойщики 2)|Игровой регион]] • [[Автопарк_(Дальнобойщики_2)|Автопарк]] • [[Саундтрек_(Дальнобойщики_2)|Саундтрек]] • [[Вступительный_ролик_(Дальнобойщики_2)|Вступительный ролик]] • [[Рация]] • [[Милиция]] • [[КА-50|Вертолёт]]
|rowspan="3" style="width: 10%"|
[[Файл:Дб2t.jpg|160px|безрамки|центр]]
|-
|style="background-color:#D1CCA7; text-align:right"|'''''Моддинг'''''
|[[Модификации_(Дальнобойщики_2)|Модификации]] • [[Утилиты_(Дальнобойщики_2)|Утилиты]] • [[Truck.ini_(Дальнобойщики_2)|truck.ini]]
|-
|style="background-color:#D1CCA7; text-align:right"|'''''Форматы ресурсов'''''
|[[B3D_(формат_файлов)|B3D]] • [[OVL_(формат_файлов)|OVL]] • [[RES_(формат_файлов)|RES]] • [[game.cnf]] • [[sch-файлы]] • [[vehicle.tech]]
|-
|style="background-color:#D1CCA7; text-align:right"|'''''Разное'''''
|[[История_версий_(Дальнобойщики_2)|История версий]] • [[Советы_и_секреты_(Дальнобойщики_2)|Советы и секреты]] • [[Бонусный диск]] • [[Управление_(Дальнобойщики_2)|Управление]] • [[Авторы (Дальнобойщики 2)|Авторы]]
|}

<noinclude>
==Код для вставки==
<pre>{{Дб2}}</pre>
</noinclude>

Утилиты (Дальнобойщики 2)

2025-10-12T14:46:47Z

Aleko 2144: добавил ссылку на плагины от LabVaKars

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг_(Дальнобойщики_2)]]
'''На данной странице представлены утилиты для работы с игровыми форматами игры [[Дальнобойщики 2]].'''

== Работа с архивами ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| D2Archiver ||style="width: 45%"| Распаковка и запаковка RES-архивов (за исключением load.res) ||style="width: 15%"| Maxus || '''[https://drive.google.com/open?id=10fYCDQWoJ0KtBC8tbMDxKK8ioN9W6dkm Скачать (Google Drive, 160KB, EXE)]''' Ссылка обновлена! '''[https://drive.google.com/open?id=10w4xqr5KASfQ7DlVQMQ39XJ4kyjXM027 Другая версия]''' ''Для работы требует Распространяемый пакет Visual C++ для Visual Studio 2012, [http://www.microsoft.com/ru-ru/download/details.aspx?id=30679 можно скачать здесь]. Если даже после установки пакета программа требует библиотеку msvcr71.dll, можно попробовать воспользоваться [https://mega.nz/file/uUE1waqC#JW6cxKR5fmkWpejEOHgLeVpsx_xGPqmgoNyXZbi_8W0 данной версией]''
|-
| D2 Resource Manager || Просмотр и экспорт содержимого RES и B3D архивов. Положить EXE файл программы в директорию с B3D файлами и перетащить один из файлов на иконку программы. || [[Участник:BoPoH|BoPoH]] || '''[https://yadi.sk/d/EUhVwZ0f-djqJw Скачать]''' '''[https://drive.google.com/open?id=10rN_Wb57yM8w2r5QSv2dVbRH3Iuy5fH5 Зеркало]'''
|-
| HT2-ResHack || Просмотр и экспорт содержимого RES архивов || 600fpt / Bokehlicia / Unstruckt || '''[https://drive.google.com/open?id=11-x8Snarl1j2AxhXJ0PSQUogJLIU86Pq Скачать]'''
|-
| Плагины для Noesis || Просмотр [[Алмазный#Ландшафт_пустыни_при_Алмазном | карты высот]], запаковка/распаковка .res/.rmp, импорт/экспорт текстур (.txr и .msk) || AlexKimov || '''[https://www.moddb.com/games/hard-truck-2/downloads/hard-truck-2-ktr-plugins-for-noesis-v02 moddb.com]'''
|-
| RnR RES Editor || Извлечение текстур из RES-файлов || BoPoH || '''[https://drive.google.com/file/d/1-ErsOfBaV0T_rtqDSfRoivxPKAvjs2RA/view Google Drive]'''
|}

== Редактирование моделей ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| B3D Block Editor||style="width: 45%"| Просмотр структуры b3d, работа с его содержимым ||style="width: 15%"| Duude92 и aleko2144, https://vk.com/rnr_mods || '''[https://vk.com/wall-157113673_4880 Описание и ссылки для скачивания]''' '''[https://onedrive.live.com/?authkey=%21AIn-JFCfVUVjuDQ&id=A771E0923FBA1E05%216133&cid=A771E0923FBA1E05 Старые версии]'''
|-
| Плагины для Blender 2.79 || Экспорт [[B3D_(формат_файлов)|b3d]] и way, частичный импорт файлов указанного формата || Duude92 и aleko2144 || '''[https://github.com/aleko2144/Hard-Truck-1-2-Blender-plugins Скачать]'''
|-
| Плагины для Blender 3.6 || Полноценный импорт/экспорт [[B3D_(формат_файлов)|b3d]], [[RES_(формат_файлов)|res]] и way || LabVaKars, Duude92, aleko2144 || '''[https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins Скачать]'''
|}

== Редактирование sch/cnf-файлов ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| RnRSchExtractor ||style="width: 45%"| Программа для дешифрации и шифрации [[Sch-файлы|sch]] и cnf-файлов. ||style="width: 15%"| [[Участник:BoPoH|BoPoH]] || '''[https://yadi.sk/d/Qxm4wylWoPXJFw Скачать]''' Антивирус может блокировать работу программы - добавьте её в исключения [https://www.virustotal.com/ru/file/0f1b7ab1456b2c1b29b8a24c738ffc36b5be4cfd4cd65f33084a17df07ce5218/analysis/ (данные VirusTotal)].
|-
| Дешифратор/шифратор sch || Программа для дешифрации и шифрации sch и cnf-файлов. || Duude92 и aleko2144 || '''[https://vk.com/page-157113673_53285850 Инструкция по применению и ссылка на скачивание]''' ''Для работы требуется среда Python 3.6, [https://www.python.org/ftp/python/3.6.0/python-3.6.0-amd64.exe можно скачать здесь (x86-64)]''.
|-
| sch tool || Программа для дешифрации и шифрации sch и cnf-файлов. || Duude92, AlexKimov, aleko2144 || '''[https://vk.com/rnr_mods?w=page-157113673_54190358 Инструкция по применению и ссылка на скачивание]'''.
|}

== Разное ==
{| class="wikitable" width="100%"
|-
! Название !! Предназначение !! Автор !! Скачать
|-
|style="width: 15%"| D2 Tech Editor ||style="width: 45%"| Программа для редактирования [[vehicle.tech]] ||style="width: 15%"|[[Участник:BoPoH|BoPoH]] || '''[https://yadi.sk/d/XMX_CYh2L-7R2w Скачать]'''
|-
| Tools || Описание форматов файлов игр Дальнобойщики 1, Дальнобойщики 2 и Дальнобойщики 3, скрипты для работы с форматами || AlexKimov || '''[https://github.com/AlexKimov/HardTruck-RignRoll-file-formats Github]'''
|-
| KOTRunity || Загрузчик ресурсов игры для Unity || Duude92, aleko2144|| '''[https://github.com/Duude92/KOTRunity Github]''' '''[https://vk.com/wall-157113673_1163 vk.com]'''
|}
{{Дб2}}

B3D (формат файлов)

2025-10-08T18:50:54Z

Aleko 2144: /* Контейнер (09) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 border;
int childCount;
<блоки[childCount]>

Контейнер. Плоскость border задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09.

Данный контейнер может:
# Использоваться в качестве ограничителя зоны отрисовки объекта (повсеместно применяется в "Дальнобойщиках 2" в контейнерах коллизии игрового мира). В таком случае отрисовка происходит относительно тангенса, перпендикулярного указанному вектору ''border''<ref>За информацию благодарность LabVaKars</ref>.
# Задавать границы события. В таком случае границей события будет сумма всех ''border'' родительских контейнеров по отношению к триггеру типа 13.

<gallery>
b3d_type09_render_tree.jpg|Визуализация зон отрисовки коллизии дорог файла ap.b3d в программе Blender 3.6.23 при помощи плагинов от LabVaKars.
</gallery>

==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

Файл:B3d type09 render tree.jpg

2025-10-08T18:49:54Z

Aleko 2144:

B3D (формат файлов)

2025-10-07T17:01:47Z

Aleko 2144: /* Некоторые общие используемые структуры */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

Структура vertsStruct:
//В блоке-хранилище вершин переменную vertsStructType следует читать как четыре uint8, тогда:
int normals_type = vertsStructType[0]
int num_UV = vertsStructType[1]
int some_data1 = vertsStructType[2]
int some_data1 = vertsStructType[3]
//
struct vertsStruct{
Vector3 position;
Vector2 UV;
Vector2 additionalUV[num_UV];

if (normals_type == 1 || normals_type == 2){
Vector3 normal; //обычная нормаль
} else if (normals_type == 3){
float normal; //а в таком случае модель не будет затеняться
}
}

Структура faceStruct:
struct faceStruct{
int format;
float num_1;
int num_32767;
int mtlIndex;
int indexCount;
<faceIndex[indexCount] indexes>
}

int inter_format = format ^ 1
struct faceIndex{
int vertexIndex;
if (inter_format & 2){
Vector2 UV; //индивидуальная UV для данного полигона
}
if (inter_format & 0x10){
if (inter_format & 0x1){
Vector3 intensity_vector; //нормаль
} else if (inter_format & 0x20){
float intensity_float; //если есть, то затенение не будет использоваться
}
}
}

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:40:06Z

Aleko 2144: добавил структуры 28-го типа

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

struct spriteData{
int format;
float var1;
int num_32767;
int mtlIndex;
int vertsCount;
<spriteVertex[vertsCount] verts>
}

int inter_format = format ^ 1
struct spriteVertex{
Vector2 position;
if (inter_format & 2){
Vector2 UV;
}
}

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:32:12Z

Aleko 2144:

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

struct collisionPolygon {
int vertsCount;
<Vector3[vertsCount] data>;
};

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

struct Type31data {
float blendValue;
int maskID;
};

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Type34Data[dataCount]>

struct Type34Data{
float x;
float y;
float z;
int var;
};

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:29:25Z

Aleko 2144: /* Некоторые используемые структуры */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые общие используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:28:50Z

Aleko 2144: /* Геометрия коллизии (23) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};
struct Type31data {
float blendValue;
int maskID;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
int some_value1;
int collisionType;
int dataCount;
<float[dataCount] someData>
int polyCount;
<collisionPolygon[polyCount] polygons>

Трёхмерная коллизия.

==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:25:24Z

Aleko 2144: /* Звуковой объект (25) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};
struct Type31data {
float blendValue;
int maskID;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Источник звука (25)==
int num32767;
int num2;
int num256;
char[32] soundName;
Vector3 soundPosition;
float some_value4;
float some_value5;
float some_value6;
float _2xPI;
float _PI;
float some_value9;
float soundRadius;
float soundVolume;

Источник трёхмерного звука.

==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:20:02Z

Aleko 2144:

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};
struct Type31data {
float blendValue;
int maskID;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)<ref>https://github.com/LabVaKars/Hard-Truck-1-2-Blender-plugins/blob/master/src/addons/b3d_tools/b3d/import_b3d.py</ref>==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:18:38Z

Aleko 2144: /* Блок типа 31 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
Vector4 nodePosition;
int dataCount;
Vector4 objectPosition
int some_int;
Vector3 some_vector;
<Type31Data [dataCount]>

Назначение неизвестно. Предположительно, используется для отрисовки деревьев, заданных набором msk-файлов.

==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:08:52Z

Aleko 2144: /* Блок типа 29 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Контейнер-переключатель LOD (29)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
<float[groupsCount] groups_render_distances>
int childCount;
<блоки[childCount]>

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

==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T16:03:51Z

Aleko 2144: /* Блок типа 28 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Спрайт (28)==
Vector4 nodePosition;
Vector3 some_vector;
int data_count;
<spriteData[data_count]>

Трёхмерный спрайт.

==Блок типа 29==
==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T15:59:02Z

Aleko 2144: /* Блок типа 27 */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
Vector4 nodePosition;
int some_value1;
Vector3 some_vector;
int some_value2;

Назначение неизвестно.

==Блок типа 28==
==Блок типа 29==
==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T15:56:03Z

Aleko 2144: /* Ломанная линия коллизии (20) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
==Блок типа 28==
==Блок типа 29==
==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T15:55:30Z

Aleko 2144: /* Ломанная линия коллизии (20) */

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
Vector4 nodePosition;
int pointsCount;
int some_value1;
int some_value2;
int some_value3;
<float[some_value3]>
<vertsSimple[pointsCount]>

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

==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
==Блок типа 28==
==Блок типа 29==
==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =

B3D (формат файлов)

2025-10-07T15:50:46Z

Aleko 2144: добавил 16 и 17 блоки (знать бы ещё, что это такое)

[[Категория:Дальнобойщики_2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
Описание формата *.b3d игр [[Дальнобойщики: Путь к победе]] и [[Дальнобойщики 2]].
Данный формат представляет собой трёхмерную сцену с различными типами объектов: контейнерами, переключателями, триггерами, источниками освещения, геометрией и т.п.<ref>https://github.com/AlexKimov/HardTruck-RignRoll-file-formats/wiki/b3D-File-Format-Rus</ref>. Инструменты для работы с B3D представлены на странице с [[Утилиты_(Дальнобойщики_2) |утилитами]].
Сам формат, предположительно, создан в первой половине 90-х годов ХХ века.

=Общее описание структуры файла=
Формат b3d разделен на 3 основные секции:
<заголовок>
<список материалов>
<блоки данных>

==Общее описание блока данных==
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || Идентификатор начала блока
|-
| char[32] || Имя блока
|-
| int32 || Тип блока
|-
| <данные> || Данные блока
|-
| int32 || Идентификатор конца блока
|}

==Числовые идентификаторы==
Располагаются в начале и конце каждого экземпляра блока, а также в начале и конце блока данных b3d-файла (см. общее описание структуры файла). Представляют собой int32. При редактировании файлов в hex-редакторе удобно знать строковое представление данных идентификаторов.
{| class="wikitable"
|-
! значение int32 !! строковый вид в кодировке 1251 !! описание
|-
| 111 || "o..." || Начало секции с блоками данных
|-
| 222 || "Ю..." || Конец секции с блоками данных
|-
| 333 || "M .." || Начало одного блока
|-
| 444 || "j .." || Разделитель переключаемых блоков (маркер окончания переключаемой группы)
|-
| 555 || "+_.." || Конец одного блока
|}

==Заголовок==
{| class="wikitable"
|-
! тип данных !! описание !! значение по умолчанию
|-
| char[4] || сигнатура файла || "b3d"
|-
| int32 || [ Размер файла в байтах ] / 4 ||
|-
| int32 || [ Смещение секции со списком используемых материалов ] / 4 || 6
|-
| int32 || [ Размер секции со списком материалов (1ая секция) ] / 4 ||
|-
| int32 || [ Смещение секции с блоками данных (третья секция) ] / 4 ||
|-
| int32 || [ Размер секции с блоками данных (третья секция) в байтах ] / 4 ||
|}
==Список материалов==
Представляет собой массив имён материалов из [[RES_(формат_файлов)|RES-файла]]. Порядок и имена должны соответствовать RES.
{| class="wikitable"
|-
! тип данных !! описание
|-
| int32 || количество материалов
|-
| массив char[32] || имя материала
|}

=Структуры и описания объектов=
Структуры даны в синтаксисе C++.
==Некоторые используемые структуры==
struct Vector3{
float x;
float y;
float z;
};
struct Vector3fi{
float x;
float y;
float z;
int var;
};
struct Vector4{
float x;
float y;
float z;
float w;
};
struct vertsSimple{
float x;
float y;
float z;
float u;
float v;
};

==Терминология и пояснения==
=== Группа переключаемого контейнера ===
Переключаемые группы - это дочерние объекты у переключаемого контейнера, разделённые идентификатором int32=444 (в текстовом виде - "j .."). Например, в некотором контейнере в B3D записаны следующие объекты:
object0_0
object0_1
<j ..>
object1_0
<j ..>
object2_0
В таком случае, первой переключаемой группой будут object0_0 и object0_1, второй группой object1_0, а третьей группой object2_0.
* В конце последней группы идентификатор 333 не ставится. Кроме того, группы могут быть пустыми, то есть не содержать никаких объектов.
* Переключаемые группы есть только у объектов типа 10, 21 и (возможно) 24.

==Замечания по структурам==
* Параметр nodePosition у объектов никак не влияет на их позицию! Скорее всего, он нужен лишь для оптимизации отрисовки.
* Поиск объектов, указанных в текстовых полях (linkedObject, spaceObject и т.п.) происходит во всех загруженных в память b3d-файлах. То есть допускается давать в одном b3d-файле ссылки на объекты из другого b3d.
* В игре «Дальнобойщики: Путь к победе» было только 30 типов объектов. К выходу «Дальнобойщиков 2» их количество было увеличено до 40.

==Блок (00)==
char[32] some_name
Vector3 some_position

Назначение неизвестно. Обычно расположен сразу после списка материалов в любом b3d-файле.
==Обозреватель (01)==
char[32] start_space
char[32] start_room

Обозреватель (Viewer).

{| class="wikitable"
|-
! параметр !! описание
|-
| start_space || имя локатора типа 24, задаёт начальные позицию и вращение обозревателя
|-
| start_room || имя комнаты типа 19, в которой будет создан обозреватель
|}

==Контейнер (02)==
Vector4 nodePosition;
Vector4 unknown;
int childCount;
<блоки[childCount]>

Контейнер с неизвестными параметрами.
==Контейнер (03)==
Vector4 nodePosition;
int childCount;
<блоки[childCount]>

Простой контейнер.
==Контейнер (04)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер с возможностью его прямой привязки к другому объекту: в spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер (05)==
Vector4 nodePosition;
char[32] linkedObject;
int childCount;
<блоки[childCount]>

Контейнер. Параметр linkedObject аналогично типу 04.
==Контейнер-блок вершин (06)==
Vector4 nodePosition;
char[32] eventObject?;
char[32] parentObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Скорее всего, как-то используется в связке с блоками событий.
==Контейнер-блок вершин (07)==
Vector4 nodePosition;
char[32] spaceObject;
int vertexCount;
<vertsSimple[vertexCount]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе простые вершины (XYZ+UV). Параметр spaceObject задаёт локатор, к которому привязан данный 3D-объект.
==Блок геометрии (08)==
Vector4 nodePosition;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 08, при отрисовке имеет плоское затенение ("flat shading").
==Контейнер (09)==
Vector4 nodePosition;
Vector4 eventBorder;
int childCount;
<блоки[childCount]>

Контейнер события. Плоскость eventBorder задаётся нормальным вектором и его длиной (она может быть отрицательной). Внутри контейнера данного типа могут быть и другие объекты типа 09. Границей события является сумма всех границ eventBorder родительских контейнеров по отношению к триггеру типа 13.
==Контейнер-переключатель LOD (10)==
Vector4 nodePosition;
Vector4 LOD_xyzw;
int childCount;
<блоки[childCount]>

Контейнер LOD. Имеет две переключаемые группы. В первой расположены объекты, отрисовываемые в том случае, когда расстояние от LOD_xyz до наблюдателя меньше w. В противном случае будет отображаться вторая группа.
==Контейнер (11)==
Vector4 nodePosition;
Vector4 some_vector1;
Vector4 some_vector2;
int childCount;
<блоки[childCount]>

Контейнер неизвестного назначения. Встречается в старых b3d, например, в MirDemo.
==Плоскость коллизии (12)==
Vector4 nodePosition;
Vector4 collisionPlane;
int unknown;
int collisionType;
int childCount;
<блоки[childCount]>

Плоскость коллизии (аналогична CollisionPlane из tech-файла). Определяется нормальным вектором и его длиной (она может быть отрицательной). Границей данной коллизии являются точки пересечений с другими объектами коллизии.
==Триггер (13)==
Vector4 nodePosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Блок-триггер.

===Типы триггера===
====no_rain_no_sun (22)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 22
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====weather_change (23)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 23
|-
| eventValue || индекс варианта погоды из weather.ini
|-
| paramsNum || 4
|}
Параметры события: плоскость, заданная нормальным вектором и длиной, определяющая границу смены погоды.
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| Vector3 || direction || нормальный вектор
|-
| float || length || длина вектора
|}
====Загрузка модуля (4095)====
Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 4095
|-
| eventValue || 0
|-
| paramsNum || 1
|}
Параметры события:
{| class="wikitable"
|-
! тип !! параметр !! значение
|-
| char[2] || moduleName || имя модуля из папки ENV
|-
| byte || нулевой байт || 0x00
|-
| byte || закрывающий байт || 0xCD
|}
==Событие (14)==
Vector4 nodePosition;
Vector4 eventPosition;
int eventType;
int eventValue;
int paramsNum;
<данные_события[paramsNum]>

Обработчик событий.

===Типы событий===
====sell_<vehicle> (18)====
Как-то связан с продажей автомобиля. Имеется только у автомобилей, доступных для заказа по рации(?)
Расположен внутри главного контейнера автомобиля. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 18
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
====Nek_<vehicle> (25)====
Без него сцепка полуприцепа неработоспособна. Значение eventPosition должно соответствовать параметру topSaddle данного полуприцепа в vehicle.tech!
Расположен внутри главного контейнера полуприцепа. Параметры блока:
{| class="wikitable"
|-
! параметр !! значение
|-
| eventType || 25
|-
| eventValue || 0
|-
| paramsNum || 0
|}
Параметры события: отсутствуют.
==Блок типа 16==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 17.
==Блок типа 17==
Vector4 nodePosition;
Vector3 some_data[3];
int some_value1;
int some_value2;

Назначение неизвестно. Структура аналогична блоку типа 16.
==Блок-связка (18)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;

Используется для добавления копий объектов. В spaceObject указывается имя блока-локатора типа 24, в linkedObject - имя подключаемого объекта. После загрузки сцены копия linkedObject будет расположена в позиции spaceObject, причём эта связь не единоразовая - при изменении позиции spaceObject изменится и позиция копии linkedObject.
==Контейнер комнаты (19)==
int childCount;
<блоки[childCount]>

Используется для хранения комнат игрового мира.
==Ломанная линия коллизии (20)==
==Контейнер-переключатель (21)==
Vector4 nodePosition;
int groupsCount;
int defaultGroupIndex;
int childCount;
<блоки[childCount]>

Контейнер с переключаемым содержимым. По умолчанию отображается группа под индексом defaultGroupIndex (если состояние переключателя не задаётся постоянно кодом игры).
Если у контейнера есть префикс "refer_" в названии, то значение активной группы привязывается к такому же контейнеру, у которого нет такого префикса в имени. Например, отображаемая группа контейнера "refer_DashboardGlowKey" будет зависеть от состояния контейнера "DashboardGlowKey".

===Некоторые переключатели, используемые на моделях транспорта===
Данные приведены для игры "Дальнобойщики 2" версии 8.2.

====Повреждения====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| Damage1Key || 5 || Повреждения бампера.
|-
| DamageFCKey || 3 || Повреждения капота.
|-
| DamageFRKey || 4 || Повреждения переднего правого крыла.
|-
| DamageFLKey || 4 || Повреждения переднего левого крыла.
|-
| DamageRKey || 3 || Повреждения правой боковины кузова.
|-
| DamageLKey || 3 || Повреждения левой боковины кузова.
|-
| DamageBRKey || 4 || Повреждения заднего правого крыла.
|-
| DamageBLKey || 4 || Повреждения заднего левого крыла.
|-
| DamageBCKey || 3 || Повреждения багажника и/или заднего бампера.
|-
| DamageWheel0Key || 4 || Повреждения I колеса.
|-
| DamageWheel1Key || 4 || Повреждения II колеса.
|-
| DamageWheel2Key || 4 || Повреждения III колеса.
|-
| DamageWheel3Key || 4 || Повреждения IV колеса.
|-
| DamageWheel4Key || 4 || Повреждения V колеса.
|-
| DamageWheel5Key || 4 || Повреждения VI колеса.
|-
| DamageWheel6Key || 4 || Повреждения VII колеса.
|-
| DamageWheel7Key || 4 || Повреждения VIII колеса.
|}
Нумерация колёс транспорта ведётся слева-направо от передних к задним. Например, I колесо - это переднее левое, II - это переднее правое, и т.д.

====Переключатели светотехники====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| HeadLightKey || 2 || Фары головного света автомобиля.
|-
| BackFaraKeyR, BackFaraKeyL || 2 || Свечение огня заднего хода.
|-
| StopFaraKeyR, StopFaraKeyL || 3 || Задний фонарь. Группа II хранит свечение стоп-сигнала, группа III хранит свечение габаритного огня.
|}

====Другие переключатели====
{| class="wikitable"
|-
! имя блока !! количество групп по умолчанию !! описание
|-
| SizeLightKey || 2 || Габаритные огни кузова грузовика; I группа пустая, II хранит модели огней; в настройках блока группой по умолчанию должна быть II.
|-
| HornKey || 2 || Модель гудка, отображаемая при его установке на СТО.
|-
| SupportKey || 2 || Опоры полуприцепа.
|-
| IconKey || 9 || Логотипы компаний, отображаемые на бортах грузовиков.
|-
| CopSirenKey || 2 || Звуковая сирена автомобиля милиции.
|-
| CopLightKey || 8 || Мигалки автомобиля милиции.
|}

===Другие переключатели===
{| class="wikitable"
|-
! имя блока !! описание
|-
| GeometryKey || Переключает отображение вариантов моделей разной детализации в зависимости от настроек игры
|-
| CollisionKey || Коллизия автомобиля (но неизвестно, как именно она используется)
|-
| GlassKey || Лобовое стекло автомобиля, отображаемое в салоне во время дождя
|-
| RD_Key || Улучшение "радар", устанавливаемое на СТО
|-
| RD_LampKey || Свечение сигнальных ламп радара
|-
| RedSvetKey || неизвестно
|-
| GreenSvetKey || неизвестно
|-
| TrafficLightKey0 || Светофор для дорожного трафика
|-
| TrafficLightKey1 || Светофор для дорожного трафика
|}

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

<gallery>
b3d_wheel_groups_v2.jpg|Группы в DamageWheelKey
b3d_illum_key_time_hours.png|Время работы ILLUM_LEVEL в часах
b3d_illum_key_time_dbl.png|Время работы ILLUM_LEVEL в double
</gallery>

==Геометрия коллизии (23)==
==Локатор-контейнер (24)==
Vector3 matrix0;
Vector3 matrix1;
Vector3 matrix2;
Vector3 position;
int caseState?;
int childCount;
<блоки[childCount]>

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

==Звуковой объект (25)==
==Блок типа 27==
==Блок типа 28==
==Блок типа 29==
==Портал (30)==
Vector4 doorPosition;
char[32] targetRoom;
Vector3 doorLowVertex;
Vector3 doorTopVertex;

Портал (дверь) между комнатами.
{| class="wikitable"
|-
! параметр !! описание
|-
| doorPosition || позиция портала
|-
| targetRoom || имя комнаты, в которую ведёт портал. Если комната находится в другом модуле, то имя задаётся в формате <модуль>:<комната>
|-
| doorLowVertex|| крайняя нижняя левая точка портала
|-
| doorTopVertex|| крайняя верхняя правая точка портала
|}

'''Важно!'''
* Если портал ведёт в комнату другого модуля, то в одной комнате с этим порталом обязательно должен быть загрузчик модуля (блок типа 13)
* Порталы соседних комнат должны иметь одинаковую позицию (doorPosition) и границы, в противном случае запрошенная комната не будет отображена
==Блок типа 31==
==Источник света (33)==
Vector4 nodePosition;
int is_enabled;
int unknown_var;
int lightType;
Vector3 lightPosition;
Vector3 lightDirection;
float falloff;
float attenuation0;
float attenuation1;
float attenuation1;
float theta;
float phi;
float R;
float G;
float B;
int childCount;
<блоки[childCount]>

Источник света DirectX 8.
{| class="wikitable"
|-
! параметр !! описание<ref>https://firststeps.ru/mfc/directx/dxhelp/r.php?59</ref>
|-
| lightType || тип источника света: 1 - направленный (directional), 2 - точечный (point), 3 - зональный (spot)
|-
| lightPosition || позиция источника света
|-
| lightDirection || направление освещения (нормальный вектор)
|-
| falloff || уменьшение освещения между внутренним конусом (theta) и внешним конусом (phi) источника света
|-
| attenuation0 || постоянное затухание
|-
| attenuation1 || линейное затухание
|-
| attenuation2 || квадратичное затухание
|-
| theta || угол внутреннего конуса в радианах, для нацеленного источника света. Это значение может принимать от 0 до значения Phi
|-
| phi || угол внешнего конуса источника света. Т.е. вне этого конуса свет уже не освещает. Может принимать значения между 0 и числом Пи.
|}

==Блок типа 34==
Vector4 nodePosition;
int some_value;
int dataCount;
<Vector3fi[dataCount]>

Назначение неизвестно.
==Блок геометрии (35)==
Vector4 nodePosition;
int faceStructType;
int materialIndex;
int faceStructsNum;
<faceStruct[faceStructsNum]>

Блок, хранящий в себе информацию о треугольниках 3D-модели. Вся геометрия, образованная блоком типа 35, при отрисовке имеет затенение по Гуро ("Gourand shading"). В отличие от типа 08, может иметь только один используемый материал и один тип faceStruct. Индекс материала, заданный внутри faceStruct, игнорируется.
==Контейнер-блок вершин (36)==
Vector4 nodePosition;
char[32] spaceObject;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные). В spaceObject можно задать имя локатора типа 24, и тогда данный контейнер будет привязан к позиции локатора. В linkedObject задаётся подключенный объект (например, коллизия).
==Контейнер-блок вершин (37)==
Vector4 nodePosition;
char[32] linkedObject;
int vertsStructType;
int vertsStructsNum;
<vertsStruct[vertsStructsNum]>
int childCount;
<блоки[childCount]>

Блок-контейнер вершин. Хранит в себе сложные вершины (тип определяется vertsStructType - могут быть и нормали, и несколько слоёв UV, и другие данные).
==Контейнер-блок типа 39==
Vector4 nodePosition;
Vector4 some_vector;
int some_value;
int childCount;
<блоки[childCount]>

Назначение неизвестно.
==Генератор объектов (40)==
Vector4 nodePosition;
char[32] some_string;
char[32] generatorClass;
int generatorType;
int some_value;
int paramsNum;
<данные_генератора[paramsNum]>

Генератор объектов. До конца не изучен.

===Типы генераторов===
{| class="wikitable"
|-
! generatorClass !! описание
|-
| $$TreeGenerator || Генератор деревьев. Использовался в версиях 4.0 - 5.5. Использование в более поздних версиях игры возможно, но приводит к сообщениям в warn.log.
|-
| $$TreeGenerator1 || Генератор сбиваемых деревьев. Используется в версиях игры, начиная с 6.6.
|-
| $$People || Создаёт модели людей и животных в определённое время суток в указанных локациях.
|-
| $$GeneratorOfTerrain || Генератор ландшафта в Алмазном.
|-
| $$CollisionOfTerrain || Генератор коллизии в Алмазном.
|-
| $$StaticGlow || неизвестно, не встречается в игре
|-
| $$DynamicGlow || Создаёт блики от источников света, изменяющиеся от расстояния до наблюдателя. Есть во многих b3d-файлах игрового мира.
|-
| $$WeldingSparkles || Излучатель искр. Используется в bb.b3d.
|-
| $$SeaGenerator || неизвестно, не встречается в игре
|}

= Технические ограничения (Дальнобойщики II) =
* На одну отрисовываемую 3D-модель должно приходиться не более 1023 вершин;
* Число одновременно активных источников света не должно быть более 8 (?), в противном случае игра будет их отключать, пока количество сократится до допустимого.

{{Дб2}}

= Примечания =