Way-файлы - История изменений

AdministratorWiki в 12:32, 19 июля 2026

2026-07-19T12:32:45Z

AdministratorWiki в 12:30, 19 июля 2026

2026-07-19T12:30:43Z

AdministratorWiki в 12:29, 19 июля 2026

2026-07-19T12:29:00Z

AdministratorWiki: Новая страница: «'''WAY-файлы''' — бинарные файлы дорожной и маршрутной сети в игре ''Дальнобойщики 2 / Hard Truck 2:…»

2026-07-19T12:26:57Z

Новая страница: «'''WAY-файлы''' — бинарные файлы дорожной и маршрутной сети в игре ''Дальнобойщики 2 / Hard Truck 2:…»

Новая страница

'''WAY-файлы''' — бинарные файлы дорожной и маршрутной сети в игре
''Дальнобойщики 2 / Hard Truck 2: King of the Road''. Обычно находятся в папке
''ENV\dec'' и имеют имена, соответствующие участкам карты: например,
''aa.way'', ''ab.way'' или ''da.way''.

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

== Общая структура ==

Файл состоит из вложенных чанков. Каждый чанк имеет четырёхсимвольный ASCII-тег
и размер полезной нагрузки в байтах:

<syntaxhighlight lang="c">
struct ChunkHeader {
char tag[4];
uint32_t size; // little-endian
};
</syntaxhighlight>

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

<syntaxhighlight lang="text">
padding = (4 - (size mod 4)) mod 4
</syntaxhighlight>

Все числа записываются в порядке байтов ''little-endian''.

Подтверждённое дерево чанков имеет следующий вид:

<syntaxhighlight lang="text">
WTWR
├── MNAM
└── GDAT
└── GROM × N
├── RNAM
├── RNOD × N
└── RSEG × N
</syntaxhighlight>

{| class="wikitable"
! Чанк !! Назначение !! Тип
|-
| <code>WTWR</code> || Корневой контейнер файла || контейнер
|-
| <code>MNAM</code> || Короткое имя карты, например <code>aa</code> || строка с NUL в конце
|-
| <code>GDAT</code> || Данные дорожного графа || контейнер
|-
| <code>GROM</code> || Дорожная комната/группа сегментов || контейнер
|-
| <code>RNAM</code> || Имя комнаты || строка с NUL в конце
|-
| <code>RNOD</code> || Именованный служебный узел || контейнер
|-
| <code>RSEG</code> || Сегмент маршрута || контейнер
|}

Строки в исследованных файлах совместимы с ASCII и Windows-1251; при чтении
строка заканчивается на первом байте <code>00</code>.

== Узлы RNOD ==

Контейнер <code>RNOD</code> состоит из трёх обязательных чанков:

<syntaxhighlight lang="text">
RNOD
├── NNAM
├── POSN
└── FLAG
</syntaxhighlight>

{| class="wikitable"
! Чанк !! Размер !! Содержимое
|-
| <code>NNAM</code> || переменный || имя узла или служебной позиции
|-
| <code>POSN</code> || 24 байта || <code>double x, double y, double z</code>
|-
| <code>FLAG</code> || 4 байта || <code>uint32 flag</code>
|}

Примеры имён: <code>node_store_1000</code>, <code>pos_hidden_0100</code>,
<code>STO_AA</code>. Встречаются значения <code>FLAG</code> 0 и 1, но их точное
значение для игровой логики не подтверждено.

== Сегменты RSEG ==

Контейнер <code>RSEG</code> описывает одну полилинию и состоит из трёх
обязательных чанков:

<syntaxhighlight lang="text">
RSEG
├── ATTR
├── WDTH
└── VDAT
</syntaxhighlight>

=== ATTR ===

<code>ATTR</code> всегда имеет размер 16 байт:

<syntaxhighlight lang="c">
struct SegmentAttributes {
uint32_t attr_a;
double attr_value;
uint32_t attr_b;
}; // последовательная упаковка: <IdI
</syntaxhighlight>

В исследованных файлах встречаются <code>attr_a</code> со значениями 1, 2, 6,
22, 34, 53, 57, 97 и 98; <code>attr_b</code> — 1, 2 и 3. Это наблюдаемые
значения, а не расшифрованные типы дороги.

В частности, <code>attr_a = 98</code> нельзя однозначно считать тупиком:
в разных картах он встречается как на коротких соединителях, так и на длинных
цепочках. Автоматически менять этот атрибут без проверки в игре небезопасно.

=== WDTH ===

<code>WDTH</code> имеет размер 16 байт:

<syntaxhighlight lang="c">
struct SegmentWidth {
double width_left;
double width_right;
};
</syntaxhighlight>

Обычно оба значения одинаковы: например, <code>3.0 / 3.0</code>,
<code>4.0 / 4.0</code> или <code>8.0 / 8.0</code>. Вероятнее всего, это ширина
слева и справа от осевой линии сегмента, однако это ещё не подтверждено
исходным кодом игры.

=== VDAT ===

<code>VDAT</code> содержит вершины полилинии:

<syntaxhighlight lang="c">
struct VertexData {
uint32_t count;
struct { double x, y, z; } points[count];
};
</syntaxhighlight>

Размер полезной нагрузки должен соответствовать формуле:

<syntaxhighlight lang="text">
VDAT.size = 4 + count × 24
</syntaxhighlight>

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

== Координаты ==

Координаты точек и узлов хранятся как три <code>float64</code>:

<syntaxhighlight lang="text">
X, Y, Z
</syntaxhighlight>

Для двумерного отображения обычно используются <code>X</code> и
<code>-Y</code>, поскольку в SVG и на экране ось Y направлена вниз. Координата
<code>Z</code> соответствует высоте.

== Безопасное редактирование ==

При записи WAY-файла необходимо:

# сохранять порядок чанков и неизвестные чанки без изменений;
# пересчитывать размеры изменённых чанков и их контейнеров;
# сохранять выравнивание до 4 байт;
# записывать числа в little-endian;
# завершать строки нулевым байтом;
# создавать резервную копию исходного файла;
# после записи повторно разобрать файл и проверить структуру.

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

== Неизвестные части формата ==

Требуют дальнейшего исследования:

* точная игровая роль полей <code>attr_a</code>, <code>attr_value</code> и
<code>attr_b</code>;
* значение <code>FLAG</code> у разных видов RNOD;
* направление движения по массиву точек;
* односторонность, полосы движения и скрытые ссылки между сегментами;
* безопасное добавление и удаление RSEG без изменения других ресурсов игры.

== Утилиты ==

Для просмотра и аккуратного редактирования формата существует
[https://github.com/VldmrInt/HT2-WAY-Tool HT2 WAY Tool]. Утилита поддерживает
просмотр структуры, экспорт JSON/SVG/CSV, резервные копии и проверку сегментов
с <code>attr_a = 98</code>.

[[Категория:Дальнобойщики 2]]
[[Категория:Моддинг (Дальнобойщики 2)]]
[[Категория:Форматы ресурсов]]

@@ Строка 187: / Строка 187: @@
 Требуют дальнейшего исследования:
-* точная игровая роль полей <code>attr_a</code>, <code>attr_value</code> и
+* точная игровая роль полей <code>attr_a</code>, <code>attr_value</code> и <code>attr_b</code>;
 * значение <code>FLAG</code> у разных видов RNOD;
 * направление движения по массиву точек;

@@ Строка 13: / Строка 13: @@
 и размер полезной нагрузки в байтах:
-<syntaxhighlight lang="c">
+<pre>
 struct ChunkHeader {
      char     tag[4];
      uint32_t size; // little-endian
 };
-</syntaxhighlight>
+</pre>
 После полезной нагрузки добавляются нулевые байты до границы 4 байт. Размер
 чанка в заголовке не включает ни сам заголовок, ни это выравнивание.
-<syntaxhighlight lang="text">
+<pre>
 padding = (4 - (size mod 4)) mod 4
-</syntaxhighlight>
+</pre>
 Все числа записываются в порядке байтов ''little-endian''.
@@ Строка 31: / Строка 31: @@
 Подтверждённое дерево чанков имеет следующий вид:
-<syntaxhighlight lang="text">
+<pre>
 WTWR
 ├── MNAM
@@ Строка 39: / Строка 39: @@
          ├── RNOD × N
          └── RSEG × N
-</syntaxhighlight>
+</pre>
 {| class="wikitable"
@@ Строка 66: / Строка 66: @@
 Контейнер <code>RNOD</code> состоит из трёх обязательных чанков:
-<syntaxhighlight lang="text">
+<pre>
 RNOD
 ├── NNAM
 ├── POSN
 └── FLAG
-</syntaxhighlight>
+</pre>
 {| class="wikitable"
@@ Строка 92: / Строка 92: @@
 обязательных чанков:
-<syntaxhighlight lang="text">
+<pre>
 RSEG
 ├── ATTR
 ├── WDTH
 └── VDAT
-</syntaxhighlight>
+</pre>
 === ATTR ===
@@ Строка 103: / Строка 103: @@
 <code>ATTR</code> всегда имеет размер 16 байт:
-<syntaxhighlight lang="c">
+<pre>
 struct SegmentAttributes {
      uint32_t attr_a;
@@ Строка 109: / Строка 109: @@
      uint32_t attr_b;
 }; // последовательная упаковка: <IdI
-</syntaxhighlight>
+</pre>
 В исследованных файлах встречаются <code>attr_a</code> со значениями 1, 2, 6,
@@ Строка 123: / Строка 123: @@
 <code>WDTH</code> имеет размер 16 байт:
-<syntaxhighlight lang="c">
+<pre>
 struct SegmentWidth {
      double width_left;
      double width_right;
 };
-</syntaxhighlight>
+</pre>
 Обычно оба значения одинаковы: например, <code>3.0 / 3.0</code>,
@@ Строка 139: / Строка 139: @@
 <code>VDAT</code> содержит вершины полилинии:
-<syntaxhighlight lang="c">
+<pre>
 struct VertexData {
      uint32_t count;
      struct { double x, y, z; } points[count];
 };
-</syntaxhighlight>
+</pre>
 Размер полезной нагрузки должен соответствовать формуле:
-<syntaxhighlight lang="text">
+<pre>
 VDAT.size = 4 + count × 24
-</syntaxhighlight>
+</pre>
 Начальная и конечная вершины часто совпадают с концами других сегментов и тем
@@ Строка 160: / Строка 160: @@
 Координаты точек и узлов хранятся как три <code>float64</code>:
-<syntaxhighlight lang="text">
+<pre>
 X, Y, Z
-</syntaxhighlight>
+</pre>
 Для двумерного отображения обычно используются <code>X</code> и

@@ Строка 1: / Строка 1: @@
 '''WAY-файлы''' — бинарные файлы дорожной и маршрутной сети в игре
 ''Дальнобойщики 2 / Hard Truck 2: King of the Road''. Обычно находятся в папке
-''ENV\dec'' и имеют имена, соответствующие участкам карты: например,
+''ENV'' и имеют имена, соответствующие участкам карты: например,
 ''aa.way'', ''ab.way'' или ''da.way''.