Way-файлы

2026-07-26T20:12:22Z

LabVaKars1: Уточнение значения attr_a

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

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

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

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

<pre>
struct ChunkHeader {
char tag[4];
uint32_t size; // little-endian
};
</pre>

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

<pre>
padding = (4 - (size mod 4)) mod 4
</pre>

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

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

<pre>
WTWR
├── MNAM
└── GDAT
└── GROM × N
├── RNAM
├── RNOD × N
└── RSEG × N
</pre>

{| 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> состоит из трёх обязательных чанков:

<pre>
RNOD
├── NNAM
├── POSN
└── FLAG
</pre>

{| 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> описывает одну полилинию и состоит из трёх
обязательных чанков:

<pre>
RSEG
├── ATTR
├── WDTH
└── VDAT
</pre>

=== ATTR ===

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

<pre>
struct SegmentAttributes {
uint32_t path_flags;
double attr_value;
uint32_t attr_b;
}; // последовательная упаковка: <IdI
</pre>

path_flags - набор битовых флагов описывающих текущий сегмент. Приблизительные значения каждого флага:
{| class="wikitable"
! Флаг !! Описание !! Где встречается
|-
| 00000001 || Строит Bezier кривую по <b>4</b> точкам || Большинство дорог
|-
| 00000010 || Строит путь по точкам || Часто встречается в Алмазном
|-
| 00000100 || Скрывает левую полосу || Односторонние разьезды на базах
|-
| 00001000 || Скрывает правую полосу || Односторонние разьезды на базах
|-
| 00010000 || Путь, который не отображается на миникарте || Невидимые заезды на СТО, заправки
|-
| 00100000 || Путь, который скрыт по умолчанию, но заполняется во время проезда || Скрытые срезки на карте(шахты, болото и т.д.)
|-
| 01000000 || Пути, где не спавнится трафик? || Встречается только в заброшенных шахтах
|}

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

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

=== WDTH ===

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

<pre>
struct SegmentWidth {
double width_left;
double width_right;
};
</pre>

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

=== VDAT ===

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

<pre>
struct VertexData {
uint32_t count;
struct { double x, y, z; } points[count];
};
</pre>

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

<pre>
VDAT.size = 4 + count × 24
</pre>

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

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

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

<pre>
X, Y, Z
</pre>

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

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

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

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

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

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

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

* точная игровая роль полей <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)]]
[[Категория:Форматы ресурсов]]

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

Way-файлы