Way-файлы

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

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

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

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

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

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

padding = (4 - (size mod 4)) mod 4

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

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

WTWR
├── MNAM
└── GDAT
    └── GROM × N
        ├── RNAM
        ├── RNOD × N
        └── RSEG × N

Чанк	Назначение	Тип
WTWR	Корневой контейнер файла	контейнер
MNAM	Короткое имя карты, например aa	строка с NUL в конце
GDAT	Данные дорожного графа	контейнер
GROM	Дорожная комната/группа сегментов	контейнер
RNAM	Имя комнаты	строка с NUL в конце
RNOD	Именованный служебный узел	контейнер
RSEG	Сегмент маршрута	контейнер

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

Узлы RNOD

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

RNOD
├── NNAM
├── POSN
└── FLAG

Чанк	Размер	Содержимое
NNAM	переменный	имя узла или служебной позиции
POSN	24 байта	double x, double y, double z
FLAG	4 байта	uint32 flag

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

Сегменты RSEG

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

RSEG
├── ATTR
├── WDTH
└── VDAT

ATTR

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

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

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

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

WDTH

WDTH имеет размер 16 байт:

struct SegmentWidth {
    double width_left;
    double width_right;
};

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

VDAT

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

struct VertexData {
    uint32_t count;
    struct { double x, y, z; } points[count];
};

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

VDAT.size = 4 + count × 24

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

Координаты

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

X, Y, Z

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

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

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

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

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

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

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

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

Утилиты

Для просмотра и аккуратного редактирования формата существует HT2 WAY Tool. Утилита поддерживает просмотр структуры, экспорт JSON/SVG/CSV, резервные копии и проверку сегментов с attr_a = 98.