IDE
Материал из GTAModding.ru
Версия от 03:36, 28 апреля 2014; XEPOMAHT007 (обсуждение | вклад)
Содержание |
Введение
Файлы 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
Обычные объекты карты.
| Версия 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
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 файле. Она используется для указания имя текстуры вне архива, где хранятся часто используемые текстуры на карте.
Структура
|
|
|
|
|
|---|---|---|---|
| |
|
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
Создаёт источник света на объект.
|
|
Идентификатор | Тип | Описание |
|---|---|---|---|
| |
|
integer | ID объекта в секций OBJS или TOBJ |
| |
|
float | Центр света по координатам X, Y, Z |
| |
|
integer | Цвет света + значение альфа-канала |
| |
|
integer | Тип 2DFX. Для "Lights" всегда равен нулю |
| |
|
string | Текстура короны. Все текстуры короны расположены в файле particle.txd
|
| |
|
string | Текстура для отбрасывания тени от света. Текстуры хранятся в файле particle.txd. Чаще всего используется "shad_exp"
|
| |
|
float | Дальность света |
| |
|
float | Диапазон света, который будет отбрасывать свет на объекты, пешеходы и автомобили |
| |
|
Integer/float | Размер короны. Тип значения может быть целым числом или числом с точкой. Если значение будет 0, то корона будет незаметна, но эффект освещения всё равно можно заметить |
| |
|
float | Диапазон света, который будет отбрасывать свет на землю |
| |
|
integer | Здесь используются флаги из IDE. Только зависящие от времени флаги могут использоваться |
| |
|
integer | Тип вспышки |
| |
|
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 |
| |
|
integer | Устанавливает эффект бликов на экране. 0 - отсутствие бликов, 1 - желтые блики, 2 - белые блики |
| |
|
integer | Интенсивность света с эффектом шума, значения от 4 до 7 делают этот эффект более интенсивным. |
Типы вспышек
| 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.
|
|
Идентификатор | Тип | Описание |
|---|---|---|---|
| |
|
integer | |
| |
|
float[3] | |
| |
|
integer[3] | |
| |
|
integer | Обычно 63 или 200 |
| |
|
integer | Всегда 2 |
| |
|
integer | |
| |
|
float[3] | |
| |
|
integer |
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.
