IDE

Введение

Файлы 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

Обычные объекты карты.

OBJS

Версия GTA	Код строки
Billy	ModelId, ModelName, TexDictName, ObjectCount, DrawDist [,DrawDist2, ... ], Flags (, 0, 1, 0, 255, 0, 0, 0)
	ModelId, ModelName, TexDictName, DrawDist, Flags
	(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], parametrs[16]
	ModelName, TexDictName, DrawDist, Flags [, FlagsAdd, AABB.Min.X, AABB.Min.Y, AABB.Min.Z, AABB.Max.X, AABB.Max.Y, AABB.Max.Z, BoundSphereCenter.X, BoundSphereCenter.Y, BoundSphereCenter.Z, BoundSphereRadius, WddName]

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	IS_THIN	Рендерить данную модель, только если игрок повернут к ней лицом. Игнорируется в GTA 3.	Заборы
1	2	DYNAMIC	Обьект удаляется, если игрок далеко отошёл (удаляется на меньшем расстоянии, нежели другие обьекты)	Некоторые фонари
2	4	TRANSPARENT	Модель прозрачна (или некоторые материалы/текстуры прозрачны). Такая модель будет отрендерена после всех "непрозрачных" обьектов.	Деревья
3	8	ADDITIVE_BLENDING	Рендерить модель с additive (цвета суммируются) альфа-смешиванием (возможно, этот эффект наблюдается только при появлении/исчезновении обьекта). Предыдущий флаг также должен быть включен.
4	16	IS_TUNNEL	Модель - туннель. Этот флаг работает только на статических моделях.	Туннели, некоторые динамические обьекты
5	32	DYNAMIC_LIGHTING	Модель освещается динамически (а не статически).	Некоторые фонари, светофоры
6	64	IS_SHADOW	Модель - тень. На момент рендера такой модели отключается запись в буфер глубины.	Тени

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

ModelId, ModelName, TextureName, Type, HandlingID, GXTEntry, PedDrivingAnimation, 
Class, Frequency, Level, SpecificType, WheelID, WheelSize

HandlingID

Значения берутся из handling.cfg

PedDrivingAnimation

из ped.ifp, тип анимации входа, выхода, вождения транспортного средства

WheelID

Идентификатор колеса. Недоступен для типа boat(катера)

WheelSize

Размер колеса. недоступен для типа boat(катера)

Формат 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], Comprules[2], Lvl[2], Frq[2], 0[6], 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 файле. Она используется для указания имя текстуры вне архива, где хранятся часто используемые текстуры на карте.

Структура

	Имя	Тип	Описание
A	TextureName	string	Имя .txd/.wtd child текстуры.
B	TextureParentName	string	Имя .txd/.wtd родителя текстуры.

Пример использования данной секции:

txdp
my_child_texture,my_parent_texture
end

2DFX

2DFX используется для расстановки 2D эффектов (например: свет) и поведение педов на объектах. Если игра загружает слишком много эффектов в этой секции, то возможны некоторые артефакты, а точнее некоторые эффекты могут не появиться вообще или долго будут загружаться.

В GTA LCS и VCS данная секция хранится в двоичном виде и ничем не отличается от текстового, описанного ниже.

GTA III & Vice City

Type 0: Lights

Создаёт источник света на объект.

	Идентификатор	Тип	Описание
A	ID	integer	ID объекта в секций OBJS или TOBJ
B,C,D	X, Y, Z	float	Центр света по координатам X, Y, Z
E,F,G,H	R, G, B, A	integer	Цвет света + значение альфа-канала
I	2DFX Type	integer	Тип 2DFX. Для "Lights" всегда равен нулю
J	Corona	string	Текстура короны. Все текстуры короны расположены в файле particle.txd
K	Shadow	string	Текстура для отбрасывания тени от света. Текстуры хранятся в файле particle.txd. Чаще всего используется "shad_exp"
L	Distance	float	Дальность света (максимальное расстояние, на котором виден этот источник света)
M	Outer range	float	Диапазон света, который падает на динамические объекты, пешеходов и автомобили
N	Size	Integer/float	Размер короны. Тип значения может быть целым числом или числом с точкой. Если значение будет 0, то корона будет незаметна, но эффект освещения всё равно можно заметить
O	Inner range	float	Размер тени (проекция на земле)
P	Shadow intensity	integer	Интенсивность тени (проекции на земле), значение от 0 до 255. Обычно используется 40
Q	Flash	integer	Тип вспышки
R	Wet	integer	sets the particle to be "reflective" on wet grounds, will only work if the ground around the light is set to wet when raining 0 - not reflective when wet, 1 - reflective when wet
S	Flare	integer	Устанавливает эффект бликов на экране. 0 - отсутствие бликов, 1 - желтые блики, 2 - белые блики
T	Flags	integer	Флаги источника света. Бит 0 - отключить Z-тест для короны, биты 1-2 - тип "пыли", которая создается под источником света.

Типы вспышек

0	Горит всё время
1	Горит всю ночь
2	Мерцает всё время
3	Мерцает всю ночь
4	Вспышка за одну секунду
5	Вспышка за одну секунду (только ночью)
6	Вспышка за две секунды
7	Вспышка за две секунды (только ночью)
8	Вспышка за три секунды
9	Вспышка за три секунды (только ночью)
10	Случайные мерцания
11	Случайные мерцания ночью
12	Параметры светофора

Светофор без 12 типа в 2DFX может привести игру к вылету.

Type 1: Particles

Этим типом 2dfx можно создать эффект частиц на модели.

	Идентификатор	Тип	Описание
A	ID	integer	ID объекта в секций OBJS или TOBJ
B,C,D	X, Y, Z	float[3]	Позиция эффекта
E,F,G,H	R, G, B	integer[3]	Цвет эффекта + значение альфа-канала
I	2DFX type	integer	Тип 2DFX. Для "Particles" всегда равен единице
J	Particle	integer	Типы частиц (см. ниже)
K,L,M	X2, Y2, Z2	float[3]	Направление (вектор) движения эффекта
N	Size	float	Размер частицы

Типы частиц

0		Небольшой белый дым
1		Небольшой белый дым
2		Большой белый дым
3		Огонь
4		Чёрный дым
-	5	Фонтан
-	6	Брызги воды

Type 2: Unknown

Для чего используется этот тип - неизвестно. Используется в GTA III, но возможно работает и для GTA VC. Нажмите сюда, чтобы посмотреть расположения объектов этого типа на карте GTA III.

	Идентификатор	Тип	Описание
A	ID	integer
B,C,D	X, Y, Z	float[3]
E,F,G	R, G, B	integer[3]
H	unknown	integer	Обычно 63 или 200
I	2DFX type	integer	Всегда 2
J	unknown	integer
K,L,M	unknown	float[3]
N	unknown	integer

Type 3: Peds

Тип назначает некоторые действия педу на заданном объекте.

	Идентификация	Тип	Описание
A	ID	integer	ID объекта в секций OBJS или TOBJ
B,C,D	X, Y, Z	float[3]	X, Y, и Z координаты, центр расположения объекта
E,F,G	R, G, B	integer[3]	Цвета
H	unknown	integer	Неизвестно, всегда 0 или 200
I	2DFX type	integer	всегда 3 для PEDS
J	Behavior	integer	Тип поведения (см. ниже)
K,L,M	unk1, unk2, unk3	float[3]	Неизвестно (игнорируются?)
N,O,P	RotX, RotY, RotZ	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.