ParkanPlayground/NResLib/README.md

Библиотека для работы с NRes архивом

Реализация на C# под .NET 8

кросс-платформенная, можно запустить на любой ОС

Что такое NRes

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

Примерами NRes файлов являются:

• lightmap.lib
• voices.lib
• Textures.lib
• Material.lib
• Data/Maps/*/Land.map
• Data/Maps/*/Land.msh

Структура NRes файла

Внимание, все числа кодируются как Little-Endian, то есть 0x00_01 - это на самом деле 0x01_00

1. Первые 16 байт это заголовок архива.

• [0..4] ASCII NRes
• [4..8] Версия кодировщика (должно быть всегда 0x100)
• [8..12] Количество файлов
• [12..16] Общая длина всего файла в байтах

2. Далее идут сами файлы в архиве.

3. В конце файла есть метаданные. Поскольку NRes это по сути архив, длина метаданных у каждого файла разная и считается как Количество файлов * 64, каждый элемент метаданных - 64 байта.

   • [0..4] ASCII описание типа файла, например TEXM или MAT0
   • [4..8] Количество элементов в файле (если файл составной, например .trf)
   • [8..12] Неизвестное число
   • [12..16] Длина файла в байтах
   • [16..20] Размер элемента в файле (если файл составной, например .trf)
   • [20..40] ASCII имя файла
   • [40..44] Неизвестное число
   • [44..48] Неизвестное число
   • [48..52] Неизвестное число
   • [52..56] Неизвестное число
   • [56..60] Смещение подфайла от начала NRes (именно самого NRes) в байтах
   • [60..64] Индекс в файле (от 0, не больше чем кол-во файлов)