IDE
Материал из GTAModding.ru
Версия от 19:50, 21 мая 2015; DK22 (обсуждение | вклад)
Содержание |
Введение
Файлы Item DEfinition имеют расширение .ide и являются частью игрового движка серии GTA, поэтому присутствуют в GTA3, GTA VC, GTA SA и GTA4 в текстовом виде, в GTA LCS и GTA VCS в бинарном. В *.ide
, к каждому объекту игры присваивается свой идентификатор (тэг), измеряющийся от 0 до 19999 (лимит ID можно уменьшать/увеличивать с помощью программы Limit Adjuster). В GTA 4 - ID не используются (вместо них напрямую используется имена объектов, которые хэшируются в игровой памяти).
В свою очередь, к каждому идентификатору, прописанному в ide, присваивается уникальная модель (*.dff
), архив текстур (*.txd
), использующийся моделью, дистанция и параметры рендеринга модели.
Все записи в *.ide
объединены в специальные секции, каждая из которых отвечает за определенный параметр. Примеры секций:
OBJectS - обычные объекты карты, TimeOBJects - временные объекты карты, ANIM - анимированные объекты карты, PEDS - педы, WEAPons - оружие, CARS - транспортные средства, HIER - загрузочные слоты для кат-сцен, 2DFX - специальный 2D-эффект для объекта (более подробно о секциях IDE читай ниже).
Item Definition (кроме GTA LCS и GTA VCS) хранится в текстовом виде, может быть изменён как редакторами карты для GTA - MooMaper, MapEditor, так и любым текстовым редактором типа блокнота.
В IDE можно встретить специальные символы - "#" или ";", после которых идёт закомментированный текст - это либо комментарии разработчиков, либо закомментированные части ide, по определённым причинам убранные из загрузки игры. Любой текст, записанный после знака комментария до конца строки, игнорируется игровым движком GTA.
Структура
Файлы .ide разделены на секции. Они могут быть не обязательны, или даже могут быть пустыми. Каждая секция начинается с идентификатора секции и заканчивется ключевым словом end. Строка секции разделяется запятыми, между которыми записаны значения каждой ячейки строки. Каждая ячейка может содержать либо целое или дробное число, либо одно слово.
Пример:
objs ... end
OBJS
Обычные объекты карты.
- ModelId
- DWORD
- Уникальный идентификатор модели - целое число. Для сториесов значение вычисляется.
- ModelName
- string[24]
- Название модели (в большинстве случаев - имя соответствующего .wdr- или .wft-файла для GTA4, dff-файла для GTA3, GTA VC и GTA SA (без расширения)).
- TexDictName
- string[24]
- Название архива с текстурами (имя соответствующего wtd-файла для GTA4, txd-файла для GTA3, GTA VC и GTA SA (без разширения), NULL в случае отсутствия текстур на модели).
- ObjectCount
- DWORD
- Количество объектов в dff, отображающихся отдельно друг от друга
- DrawDist
- float
- Дистанция прорисовки объекта на карте относительно координат экрана.
- Flags
- DWORD
- Специальные параметры отображения объекта, значение по умолчанию '0'.
- FlagsAdd
- DWORD
- Дополнительные параметры объекта, значение по умолчанию '0'.
- AABB.Min.X, AABB.Min.Y, AABB.Min.Z
- float[3]
- Минимальная угловая точка Min AABB-коробки.
- AABB.Max.X, AABB.Max.Y, AABB.Max.Z
- float[3]
- Максимальная угловая точка Max AABB-коробки.
- BoundSphereCenter.X, BoundSphereCenter.Y, BoundSphereCenter.Z
- float[3]
- Центр ограничивающей сферы.
- BoundingSphereRadius
- float
- Радиус ограничивающей сферы.
- WddName
- string[24]
- Название архива моделей (wdd-файла) в котором находится модель. Если модель располагается в .wdr- или .wft-файле, то текущий параметр имеет значение 'null'.
- hashname
- hex[4]
- Хешированное имя игрового объекта по CRC-алгоритму.
- TextureID
- DWORD
- Уникальный идентификатор текстуры - целое число.
- SectionType
- BYTE
- Тип секции загруженного объекта - cars, peds, weap, objs, hier и т.д.
- 2dfxcount
- BYTE
- Количество строк из секции 2dfx, используемые для объекта.
- Co11.offset
- WORD
- Переход на модель столкновений объекта.
- 2dfxID
- WORD
- ID строки секции 2dfx, с которой начинается чтение эффектов для объекта.
- hashsecID
- DWORD
- Хэшированное имя секции по CRC-алгоритму (назначение неизвестно).
- Bully
- 0, 1, 0, 255, 0, 0, 0
- DWORD[7]
- Дополнительная часть строки OBJ и TOBJ
Флаги Объектов
Флаги объектов в GTA3, GTA VC, GTA SA и GTA4 - UInt32-Значения (Впрочем как и все другие флаги). Чтобы лучше их понять нужно представить их в двоичном виде. Вы получите битовые маски флагов. 1 означает, что параметр используется для данной модели, 0 - игнорируется
Вот список известных флагов:
0000000000000000000000000000001 = 1 - Значения прилайта делятся пополам (модель становится темнее) 0000000000000000000000000000010 = 2 - Ночной Флаг (используется на магалодах для их осветления вдалеке от игрока) 0000000000000000000000000000100 = 4 - Более точный просчёт альфа-канала (помогает избавиться от артефактов) 0000000000000000000000000001000 = 8 - Ещё более точный просчёт альфа-канала (соответственно, падает fps) * 0000000000000000000000000010000 = 16 - Дневной Флаг (используется под землёй для их затемнения вдалеке от игрока) 0000000000000000000000000100000 = 32 - Фильтр рендеринга для интерьеров ** 0000000000000000000000001000000 = 64 - Игнорирование прорисовки теней на объекте (?) 0000000000000000000000010000000 = 128 - Игнорирование свойств куллинга при попадании модели в её зону (?) 0000000000000000000000100000000 = 256 - Игнорирование дистанции прорисовки (?) 0000000000000000000001000000000 = 512 - Объект (стекло) при ударе разбивается ** 0000000000000000000010000000000 = 1024 - Объект (стекло) при ударе трескается, при повторном ударе разбивается ** 0000000000000000000100000000000 = 2048 - Дверь для гаража ** 0000000000000000001000000000000 = 4096 - Обьект использует 2 модели (например штатная и повреждённая) ** 0000000000000000010000000000000 = 8192 - Малая растительность, объект пошатывается при сильном ветре 0000000000000000100000000000000 = 16384 - Стандартная растительность ** (Пальмы в Готелях, т.д.) (?) 0000000000000001000000000000000 = 32768 - Использовать Timecycle PoleShadow флаг 0000000000000010000000000000000 = 65536 - Флаг взрыва ** 0000000000000100000000000000000 = 131072 - Неизвестно (Seems to be an SCM Flag) (?) 0000000000001000000000000000000 = 262144 - Неизвестный (Возможно используется в одном из объектов в Jizzy Club) (?) 0000000000010000000000000000000 = 524288 - Неизвестно (?) 0000000000100000000000000000000 = 1048576 - Флаг граффити 0000000001000000000000000000000 = 2097152 - Двухсторонный рендеринг треугольников модели 0000000010000000000000000000000 = 4194304 - Неизвестно (Часть статуи в Atrium) (?) ... 1000000000000000000000000000000 = 1073741824 - Неизвестно
* Если не в Интерьере, текстура позади объекта становится черной (= IPL | Interior-value) ** Объект должен быть прописан в Object.dat (?) Не известен на 100% ! Все флаги = 2^n, n є Z
Чтобы использовать несколько флагов, нужно указать их сумму, например:
01 + 10 = 11 1 + 2 = 3
GTA 3
Бит | Значение | Имя | Описание | Примеры моделей |
---|---|---|---|---|
0 | 1 | NORMAL_CULL | Рендерить данную модель, только если игрок повернут к ней лицом. Игнорируется в GTA 3. | Заборы |
1 | 2 | DO_NOT_FADE | Обьект удаляется, если игрок далеко отошёл (удаляется на меньшем расстоянии, нежели другие обьекты) | Некоторые фонари |
2 | 4 | DRAW_LAST | Модель прозрачна (или некоторые материалы/текстуры прозрачны). Такая модель будет отрендерена после всех "непрозрачных" обьектов. | Деревья |
3 | 8 | ADDITIVE | Рендерить модель с additive (цвета суммируются) альфа-смешиванием (возможно, этот эффект наблюдается только при появлении/исчезновении обьекта). Предыдущий флаг также должен быть включен. | |
4 | 16 | IS_SUBWAY | Модель - туннель. Этот флаг работает только на статических моделях. | Туннели, некоторые динамические обьекты |
5 | 32 | IGNORE_LIGHTING | Модель освещается динамически (а не статически). | Некоторые фонари, светофоры |
6 | 64 | NO_ZBUFFER_WRITE | Модель - тень. На момент рендера такой модели отключается запись в буфер глубины. | Тени |
TOBJ
Временные Объекты Карты, используется для определения объектов карты, которые видны только в определенное время суток. Например свет от окон.
Формат GTA III, VC и SA
ModelId, ModelName, TextureName, ObjectCount, DrawDist, [DrawDist2, ...], Flags, TimeOn, TimeOff
- ModelId, ModelName, TextureName, ObjectCount, DrawDist, Flags
- аналогично секции OBJS
- TimeOn
- время активации в часах (целое)
- TimeOff
- время деактивации в часах (целое)
Формат GTA LCS, VCS
В сториесах секция TOBJ перенесена в LevelZLib и применяется непосредственно для объектов внутри уровня (подробнее читай статью LVZ).
Формат GTA 4
- ModelName, TextureName, DrawDist, Flag1, Flag2, AABB.Min, AABB.Max, BoundingSphereCenter, BoundingSphereRadius, ModelsDictionary, NightFlag
- ModelName, TextureName, DrawDist,Flag1,2, AABB.Min, AABB.Max, BSC, BSR, ModelsDictionary
- Аналогично секции OBJS(формата gta 4)
- NightFlag
- Ночной флаг
ANIM
Анимированые Объекты Карты, используются для объектов, под-объекты которых анимированы.
Примечание: Модель повреждений в анимации не участвует.
формат GTA SA
ModelId, ModelName, TextureName, AnimName, DrawDist, Flags
- ModelId, ModelName, TextureName, DrawDist, Flags
- аналогично секции OBJS
- AnimName
- название .ifp-файла - архива анимаций, без раcширения (строка)
формат GTA 4
ModelName, TextureName, AnimName, DrawDist, Flags1, Flags2, AABB.Min, AABB.Max, BoundingSphereCenter, BoundingSphereRadius, ModelsDictionary
- !Эти параметры информированы в секции OBJS.
PEDS
Пешеходы - модели людей, используемые в городском трафике, а так же в скриптах. В GTA VCS туда записаны и специальные актёры (почему-то разработчики не стали экономить память ПСП и использовать для них слоты специальных актёров).
Формат GTA III и VC
ModelId, ModelName, TextureName, PedType, PedStats, Animation, CarsCanDriveMask (in hex), animFile, radio1, radio2
Формат GTA LCS и VCS:
(ModelId), 0[8], hashname[4], 0[4], SectionType[1], 2dfxcount[1], ParamRender[2], Co11.offset[4], 2dfxID or F***[2], F***[2], 0[2], TextureID[2], [65535[4]], hashsecID[4], 0[4], DrawDist[4], animgroupID[4], pedtypeID[4], pedstatID[4], pedflags[4], 0[4], unknowflags[4], [block_co1...]
WEAP
Оружие - модели оружия, включая зарезервированный ID на кулаки.
Формат GTA III и VC
ModelId, ModelName, TextureName, Animation, unused, DrawDistance, unused
- Animation
- Значения берутся из файла ped.ifp, тип анимации при использовании оружия.
Формат GTA LCS и VCS
(ModelId), 0[8], hashname[4], 0[4], SectionType[1], 2dfxcount[1], ParamRender[2], Co11.offset[4], 2dfxID or F***[2], F***[2], 0[2], TextureID[2], [65535[4]], hashsecID[4], 0[4], DrawDist[4], 0[8], 65281[4], weaponslotID[4], weapontype[4]
CARS
Авто - модели транспорта - автомобили, лодки, вертолёты, мотоциклы и т.д.
Формат GTA III, VC и SA
ModelId, ModelName, TextureName, Type, HandlingID, GameName, AnimGroup, Class, Frequency, Level, Comprules, WheelModelId, WheelScale, WheelUpgradeClass
- ModelId, ModelName, TextureName
- аналогично секции OBJS
- Type
- тип транспорта - car, boat, train, heli, plane, bike, trailer, bmx, quad, mtruck. Загрузка этих данных в игре реализована с помощью "hardcoded functions" (что по-нашему через _опу) и может быть изменена только через редактирование Gta3.exe
- HandlingID
- Имена настроек физической модели транспорта. Значения берутся из handling.cfg
- GameName
- Игровое имя транспортного средства из .gxt файла. Чувствительно к регистру и должно иметь семь символов или меньше.
- AnimGroup
- имя группы анимаций, определяющих анимации входа, выхода, вождения транспортного средства из IFP
- Class
- определяет классность транспорта
- Frequency
- частота появления транспорта в городском трафике
- Level
- ?
- Comprules
- флаг, определяющий особенности авто
HEX-значение | Эффект значения | Транспорт, на котором используется |
---|---|---|
0 | у авто нет особенностей | |
0x1f10 | На авто в игре всегда присутствует одна из двух экстра-деталей | Taxi, Cabbie, Hoods Rumpo XL, Borgnine, Zebra Cab, Kaufman Cab |
0x2ff0 | На авто в дождливую погоду всегда присутствует одна экстра-деталь | Stinger, Stallion, Sabre, Sabre Turbo, Comet, Deluxo |
0x4fff | Flatbed, Hotring A, Hotring B, Bloodring Banger A, Bloodring Banger B | |
0x30123345 | Caddy |
- WheelModelId
- Идентификатор колеса. Недоступен для типов boat и train. Для типа plane - идентификатор LOD-а модели. В GTA SA заменён на указатель масштабирования модели (-1 - колесо не масштабируется, 0 - масштабируется, коллизия колеса масштабируется всегда).
- WheelScale
- Множитель масштаба колеса. Недоступен для типов boat, train и plane. Для GTA SA состоит из двух множителей - для передних и задних колёс
- WheelUpgradeClass
- идентификаторы из carmods.dat
Формат GTA LCS
(ModelId), 0[8], hashname[4], 0[4], SectionType[1], 2dfxcount[1], ParamRender[2], Co11.offset[4], 2dfxID or F***[2], F***[2], 0[2], TextureID[2], hashsecID[4], 0[4], DrawDist[4], 0[2], gamename[14], wheelsize[4], wheelID[2], handlingID[2], dorsCount[1], ClassID[1], Level[1], 0[1], Frequency[1], 0[7], block_XYIrarXYI[5x16], 0[4], 999.(9)[4], block_unknow[200], block_co1[8], co1_total[1], unknow[15]
Формат GTA VCS
(ModelId), 0[8], hashname[4], 0[4], SectionType[1], 2dfxcount[1], ParamRender[2], Co11.offset[4], 2dfxID or F***[2], F***[2], 0[2], TextureID[2], 65535[4], hashsecID[4], 0[4], DrawDist[4], ...
PATH
В Grand Theft Auto III, система путей используется только в IDE файлах. Пути расположены по центру объекта. Точки дают направление пешеходам и автомобилям.
Лимит количества строк в одном блоке - 12. Если добавить 13, то игра зависнет.
Формат GTA III - первая секция:
Path Type, ID, Object Name
- Path Type - Тип пути для первой секций. Всего существует два типа - ped и car.
- ID - Идентификатор объекта
- ObjectName - Имя объекта, которому присвоен ID. Не используется.
// CFileLoader::LoadObjectTypes - загрузка обьекта PATH case OBJECT_PATH: if(number == -1) // чтение первой секции { objId = LoadPathInfo(lineBuf, pathType); if(!strncmp(pathType, "ped", 4) pathTypeId = PATH_TYPE_PED; else if(!strncmp(pathType, "car", 4) pathTypeId = PATH_TYPE_CAR; number = 0; } else // чтение второй секции { if(pathTypeId == PATH_TYPE_PED) SetupPedPath(lineBuf, objId, number); else if(pathTypeId == PATH_TYPE_CAR) SetupCarPath(lineBuf, objId, number); ++number; if(number == 12) number = -1; } break;
// LoadPathInfo int LoadPathInfo(const char *line, char *type) { char objName[96]; int objId; sscanf(line, "%s %d %s", type, &objId, objName); return objId; }
Формат GTA III - вторая секция:
Node Type, Link To, Unkn1, X, Y, Z, Unkn2, Lanes1, Lanes2
- Node Type - Типы точки. Всего 3 типа - None, Middle и End.
- Joins to Next Node -
- Unkn1 -
- Unkn2 -
- Lanes1 -
- Lanes2 -
HIER
Формат GTA III и VC
ID, ModelName, TextureName
Формат SA
ID, ModelName, TextureName, null, DrawDistance
TXDP
TXDP(Texture Archive Parent) - Одна из секции в IDE файле. Она используется для указания имя текстуры вне архива, где хранятся часто используемые текстуры на карте.
Структура
|
|
| |
---|---|---|---|
|
|
string | Имя .txd/.wtd child текстуры.
|
|
|
string | Имя .txd/.wtd родителя текстуры.
|
Пример использования данной секции:
txdp my_child_texture,my_parent_texture end
2DFX
2DFX используется для расстановки 2D эффектов (например: свет) и поведение педов на объектах. Если игра загружает слишком много эффектов в этой секции, то возможны некоторые артефакты, а точнее некоторые эффекты могут не появиться вообще или долго будут загружаться.
В GTA LCS и VCS данная секция хранится в двоичном виде и ничем не отличается от текстового, описанного ниже.
GTA III & Vice City
Type 0: Lights
Создаёт источник света на объект.
Типы вспышек
0 | Горит всё время |
1 | Горит всю ночь |
2 | Мерцает всё время |
3 | Мерцает всю ночь |
4 | Вспышка за одну секунду |
5 | Вспышка за одну секунду (только ночью) |
6 | Вспышка за две секунды |
7 | Вспышка за две секунды (только ночью) |
8 | Вспышка за три секунды |
9 | Вспышка за три секунды (только ночью) |
10 | Случайные мерцания |
11 | Случайные мерцания ночью |
12 | Параметры светофора |
Светофор без 12 типа в 2DFX может привести игру к вылету.
Type 1: Particles
Этим типом 2dfx можно создать эффект частиц на модели.
Идентификатор | Тип | Описание | |
---|---|---|---|
|
|
integer | ID объекта в секций OBJS или TOBJ |
|
|
float[3] | Позиция эффекта |
|
|
integer[3] | Цвет эффекта + значение альфа-канала |
|
|
integer | Тип 2DFX. Для "Particles" всегда равен единице |
|
|
integer | Типы частиц (см. ниже) |
|
|
float[3] | Направление (вектор) движения эффекта |
|
|
float | Размер частицы |
Типы частиц
|
Небольшой белый дым | |
|
Небольшой белый дым | |
|
Большой белый дым | |
|
Огонь | |
|
Чёрный дым | |
|
|
Фонтан |
|
|
Брызги воды |
Type 2: Unknown
Для чего используется этот тип - неизвестно. Используется в GTA III, но возможно работает и для GTA VC. Нажмите сюда, чтобы посмотреть расположения объектов этого типа на карте GTA III.
Type 3: Peds
Тип назначает некоторые действия педу на заданном объекте.
Идентификация | Тип | Описание | |
---|---|---|---|
|
|
integer | ID объекта в секций OBJS или TOBJ |
|
|
float[3] | X, Y, и Z координаты, центр расположения объекта |
|
|
integer[3] | Цвета |
|
|
integer | Неизвестно, всегда 0 или 200 |
|
|
integer | всегда 3 для PEDS |
|
|
integer | Тип поведения (см. ниже) |
|
|
float[3] | Неизвестно (игнорируются?) |
|
|
float[3] | Поворот педа во время проигрывания его анимации |
Типы поведения
0 | Пользование банкоматом |
1 | Сесть на некоторое время, отойти в сторону и уйти |
2 | Ожидание автобуса; дополнительные пешеходы будут выстраиваться друг за другом |
3 | Постоять некоторое время и уйти (например - поведение в магазине) |
4 | Неизвестно |
GTA: San Andreas
В данной серий игры, 2dfx используется внутри DFF модели. Подробнее об этом написано в статье - 2DFX (Секция RW)
GTA 4
В данной серий игры, 2dfx используется внутри WDR модели.
Ссылки
- Описание IDE в GTA VC – топик ODIE на форуме GTAForums.соm, детали IDE-файлов в GTA VC.
- Документация GTA3/VC – топик Opius на форуме GTAForums.соm, описание IDE- и прочих файлов III/VC.