GTAMods Wiki - User contributions [en]

Main Page

2008-08-25T15:29:20Z

Fred: news feed plugin not finished yet, removing outdated titles from page

__NOTOC__
{{MainPageIntro}}

The goal of this site is to have all GTA modding related knowledge in one convenient place. At the moment this will consist of guides and tutorials for modding as well as modding related documentation. All GTANet members can contribute their knowledge and are invited to write articles for the site (see [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for an introduction into the world of Wiki).

To get started, see a [[Special:Newpages|list of new articles]], or just browse our main categories below.

<table width="100%" border="0" cellpadding="10">
<tr><td colspan="2" width="33%">
==[[:Category:Tutorials|Tutorials and Guides]]==
* [[:Category:Mapping|Mapping]]
* [[:Category:Mission Scripting|Mission Scripting]]
* [[:Category:Mod Installation|Mod Installation]]
** [[San Andreas v2.0 Modding]]
* [[:Category:Modelling|Modelling]]
** [[:Category:Character Modelling|Character Modelling]]
** [[:Category:Map Object Modelling|Map Object Modelling]]
** [[:Category:Vehicle Modelling|Vehicle Modelling]]
</td><td colspan="2" width="33%">
==[[:Category:Documentation|Documentation]]==
* [[:Category:File Formats|File Formats]]
* [[:Category:Memory Addresses|Memory Addresses]]
* [[:Category:Mission Script|Mission Script]]
* [[:Category:Tools|Tools]]
* [[:Category:Modifications|Modifications]]
** [[:Category:Multiplayer|Multiplayer]]
* [[:Category:Troubleshooting|Troubleshooting]]
** [[Frequently Asked Questions]]
</td><td colspan="2" width="33%">

== Version specific ==
* [[:Category:GTA 4|Grand Theft Auto IV]]
* [[:Category:GTA VCS|GTA Vice City Stories]]
* [[:Category:GTA LCS|GTA Liberty City Stories]]
* [[:Category:GTA SA|GTA San Andreas]]
* [[:Category:GTA VC|GTA Vice City]]
* [[:Category:GTA 3|Grand Theft Auto III]]
* [[:Category:GTA 2|Grand Theft Auto 2]]
* [[:Category:GTA 1|Grand Theft Auto]]
</td></tr>

</table>

ZONE

2008-08-25T15:27:36Z

Fred: 1 revision

Cutscene

2008-08-25T15:27:36Z

Fred: 1 revision

Cutscenes are short sequences between, after or in front of missions.

=San Andreas Cutscenes=

In San Andreas cutscenes are only loaded using SCM. You cannot control the camera movement in via SCM. They are usually stored externally in the <code>anim\cuts.img</code> archive. Each cutscene consists of 3 files with the same name and a different extension. These extensions are: <code>.cut</code>, <code>.ifp</code> and <code>.dat</code>. Whilst modification of existing cutscenes is possible through the files detailed below, new cutscenes cannot be added to the game unless they have a filename that already exists. This is due to the presence of an internally hardcoded table which links each cutscene (the .cut, .ifp and .dat files) to its audio stream and it does so by cutscene filename.

==Cutscene data==

===The CUT File===

The <code>.cut</code> file is loaded first. It contains the important data of the cutscene like its offset and the loaded models. The models of an cutscene are usually stored in the <code>models\cutscene.img</code> archive. It's split up into certain sections. Not every cut-file requires all sections, but it is better to include all sections into a cut-file and leave unused sections empty.

====INFO====

The info section contains information to the offset. It describes the 3D-coords of a point to which all other coords in the rest of the files are relative. Its format is

info
offset X Y Z
end

The offset parameter can also be set using opcode [[0244]].

====MODEL====

The model section contains information about models the cutscene uses. The models don't need to be defined in the IDEs. But the texture name must be the same as the model's one. The model section also attaches models to animations in the IFP-animation archive. Its format is:

model
?, name, animation
end

Where the name is without extension, and the animation describes an entry in the IFP file. The unknown value is a number, which is always 1 and actually is ignored by the game. 
'''There is a Limit to 50 entries here!'''

====EXTRACOL====

Extracol stands for ''"Extracolor"'' and sets the active interior's color. It corresponds to the opcode [[04F9]].

extracol
Number
end

Extracolours can be edited in the [[TimeCyc_Definition]] file

====TEXT====

The text section displays a GXT Entry at an certain point of time relative to the cutscene start.

text
starttime, length, gxt
end

Where the numbers are integer and define the time in milliseconds.

====UNCOMPRESS====

the uncompress-section uncompresses the IFP animations.

uncompress
Animation
end

====PEFFECT====

stands for the particle effect and sets an particle effect from the [[Particle (SA) | effects.fxp]].

peffect
effectname, starttime, endtime, unknown_number, bone, X, Y, Z, ?, ?, ?
end

The bone is a number of the body part the particle effect is attached to.

====REMOVE====

Removes an static (IPL-mapped) object being placed at specified coord.

remove
Objectname, X, Y, Z
end

====ATTACH====

Actually the content and use of this section is unknown. It is rarely used.

attach
Number, Number, Number
end

====MOTION====

''This section is ignored by the game!''

===The DAT-File===

The <code>dat</code>-file contains information about the camera movements during the cutscene.

It consists of 4 blocks:

* Block1: Rotation
* Block2: Zoom
* Block3: CameraPositions
* Block4: CameraTargetPoints

Each block starts with an integer number being the number of entries in this block, followed by its content and ended by a semicolon. The whole file is also marked as finished with an additional semicolon. Each line is marked as finished by an simple comma.
The file describes 3 lanes, where the last 2 ones are ignored. So those 3 lines could be set identically by editors. This gives a general format:

TimeOffset,Lane1,Lane2,Lane3,

The TimeOffset is an floating value which defines the time of the event in seconds. The game interpolates the curve between the 2 points.

====Block1 - Rotation====

TimeOffset,Rotation(Lane_1),Rotation(Lane_2),Rotation(Lane_3),

Describes the rotation around the vector towards the target point in euler angles (degree).

====Block2 - Zoom====

TimeOffset,Zoom(Lane_1),Zoom(Lane_2),Zoom(Lane_3),

Defines the focal of the camera for each lane.

====Block3 - Cameraposition====

TimeOffset,X(Lane_1),Y(Lane_1),Z(Lane_1),X(Lane_2),Y(Lane_2),Z(Lane_2),X(Lane_3),Y(Lane_3),Z(Lane_3),

Defines the position of the camera relative to the offset point.

====Block4 - Target====

TimeOffset,X(Lane_1),Y(Lane_1),Z(Lane_1),X(Lane_2),Y(Lane_2),Z(Lane_2),X(Lane_3),Y(Lane_3),Z(Lane_3),

Defines the position of the target of the camera relative to the offset-point.

===The IFP animation archive===

This is an ANPK (Animation Package v1 | GTA III/VC) IFP file including the animations used for the cutscene. For the file specification look here: [[IFP|IFP Animations]]. The positions of the bones and animated objects in the animation are relative to the offset defined in the INFO section of the .cut file.

==List of Cutscenes in San Andreas==

''Comming soon''

==SCM (OpCodes)==

* [[0244|0244]] - SetsCutscenePosition
* [[02E4|02E4]] - LoadsCutsceneData
* [[02E7|02E7]] - StartsCutscene
* [[02E8|02E8]] - GetsCutsceneTime
* [[02E9|02E9]] - HasCutsceneReachedEnd
* [[02EA|02EA]] - EndsCutscene
* [[03B7|03B7]] - ProcessCutsceneOnly
* [[06B9|06B9]] - IsCutsceneDataLoaded
* [[08D0|08D0]] - IsCutsceneSkipped
* [[08F0|08F0]] - SetsCutsceneModelTexture

=External Links=

* [http://sannybuilder.com/forums/viewtopic.php?id=115 Cutscene decoding Thread in SannyBuilder Forums (SA)]

[[Category:File Formats]] [[Category:GTA SA]]

IFP

2008-08-25T15:27:35Z

Fred: 5 revisions

IFP is the animation format of the Grand Theft Auto series since [[Category:GTA_3|GTA III]]. With [[Category:GTA_SA|GTA San Andreas]] there came a new version of the file format, but it still supports animations with the old version. IFP files can contain several single animations which are split up to objects and linked to the animated object or actor in that way. Each object contains a certain number of frames including a time key. Two frames are interpolated by the game.

==File Specification==

===Version 1===
Version 1 packages are split up as usual into several data structures. The values of those structures are identified by 4 byte information markers. Those are 4 characters describing the following value(s). Note that the only markers which are realy used are "DGAN" and "NAME". All others are simply waste of space. Do not search for them in your code, because not all animations got information markers where they are expected. Sometimes they are also simply zero.

Offsets are always relative to the current file position. To convert a relative offset to an absolute one just add the number of read bytes.
Strings are always padded to 4 byte bounds. The "AnimNameLength" string after the "NAME" information marker descripes the string including the terminating zero-byte. You have to round up this value until the number is able to be divided by 4 without any rest, to get the number of bytes you have to write.

====Header====
4b - FourCC - "ANPK" (Animation Package, Version identifier)
4b - Int32 - Offset to the end of the file
4b - FourCC - "INFO"
4b - Int32 - Offset to end of header
4b - Int32 - Number of animations
Xb - Char[X] - Null-terminated string (internal file name used in the script)

====Animation====
4b - FourCC - "NAME"
4b - Int32 - Length of the name of the animation (X)
Xb - char[X] - Animation name (null-terminated string)
4b - FourCC - "DGAN"
4b - Int32 - Offset to the end of the animation (including it's content)
4b - FourCC - "INFO"
4b - Int32 - Offset to first object (usually 0x08)
4b - Int32 - Number of objects in the animation
4b - Int32 - NULL

====Object====
4b - FourCC - "CPAN"
4b - Int32 - Offset to end of object
4b - FourCC - "ANIM"
4b - Int32 - Offset to the start of frames (usually 0x2C)
28b - Char[28] - Object name (null-terminated string)
4b - Int32 - Number of frames
4b - Int32 - NULL
4b - Int32 - Next sibling
4b - Int32 - Previous sibling

====Frame Info====
4b - FourCC - Type
4b - Int32 - End of frame data

=====Frametypes=====
Frametypes define the size and the content of a frame. Actually there are 3 known types. Each frametype identifier starts with K which corresponds to "Keyframe". The following 3 bytes define the order and the content of the data. They are ASCII encoded characters

R - Rotation
T - Translation
S - Scale
0 - None

Translation is a vector which points to an offset in the world. For [[Cutscene|cutscenes]] it is relative to an offset given in a special file. Usually just the root object contains translated frames.

====Frame Data====

Each type has a different structure. They can be combined and are read by the game in the order they are written in the type value.

// Rotation
4b - Float - Quarternion X
4b - Float - Quarternion Y
4b - Float - Quarternion Z
4b - Float - Quarternion W

// Translation
4b - Float - Position X
4b - Float - Position Y
4b - Float - Position Z

// Scale
4b - Float - Scale X
4b - Float - Scale Y
4b - Float - Scale Z

Every frame got one last floating value at the end describing the time in seconds.

4b - Float - Time

===Version 2===
Version 2 archives got basically the same hierarchy as above, but the structures are a bit different. In version 2 all strings are Null-terminated, but they got a constant size of 24 bytes.

====Header====
4b - FourCC - 'ANP3' (Animation Package 3, Version identifier. However there is no pack with ANP2)
4b - Int32 - Offset to end of file
24b - Char[24] - internal file name used in the script
4b - Int32 - Number of Animations

====Animation====
24b - Char[24] - Animation Name
4b - Int32 - Number of Objects
4b - Int32 - Size of frame data
4b - Int32 - Unknown, always 1

The size of data value is a number of bytes which corresponds to the exact size of the frame's usable data, including the compressed coordinates and rotation info.

====Object====
24b - Char[24] - Object Name
4b - Int32 - Frame type: Child = 3, Root = 4
4b - Int32 - Number of Frames
4b - Int32 - Bone ID

====Frame====
Root frames always follow the following structure:

2b - Int16 - Quaterion X
2b - Int16 - Quaterion Y
2b - Int16 - Quaterion Z
2b - Int16 - Quaterion W
2b - Int16 - Time (in seconds)
2b - Int16 - Translation X
2b - Int16 - Translation Y
2b - Int16 - Translation Z

Child sections have no translation values.

2b - Int16 - Quaterion X
2b - Int16 - Quaterion Y
2b - Int16 - Quaterion Z
2b - Int16 - Quaterion W
2b - Int16 - Time (in seconds)

To convert quaternion and translation values to floating values divide them by 4096.

==External Link==
*[http://public.sannybuilder.com/anim/ List of San Andreas' Animations] Seemann's website
*[http://www.pawfectfilms.com/mods/VCSA_AnimList.zip List of Vice CIty's and San Andreas' Animations] Ceedj's website

01F9

2008-08-25T15:27:35Z

Fred: 2 revisions

<code>01F9=9,%1g% %2d% %3d% %4d% %5d% %6d% %7d% %8d% %9d%</code> 
'''Description''': Initiates a rampage 
'''Parameter 1''': [[GXT]] string similar to [[00BA]] style 1 
'''Parameter 2''': [[Weapon]] ID number 
'''Parameter 3''': Time in ms allowed for the rampage 
'''Parameter 4''': Number of targets required to pass rampage 
'''Parameter 5''': Allowed target #1 model ID as defined in peds.ide or vehicles.ide 
'''Parameter 6''': Allowed target #2 model ID as defined in peds.ide or vehicles.ide 
'''Parameter 7''': Allowed target #3 model ID as defined in peds.ide or vehicles.ide 
'''Parameter 8''': Allowed target #4 model ID as defined in peds.ide or vehicles.ide 
'''Parameter 9''': Flag which indicates whether (1) or not (0) to display styled text when the rampage is passed. Hardcoded to display the 'KILLPA' entry from the MAIN table of the [[GXT]] file. 
'''Supports''': GTA3, Vice City, San Andreas 

This opcode starts rampage mode. You have to kill or destroy a certain amount of peds or vehicles within the time limit. Using this opcode requires [[0247]] or else the weapon would not be visible and the game can crash. Parameter 5 can have an integer of -1 for any peds or -2 for any vehicles.

In San Andreas, while on a rampage you are stuck with your weapon and you can't pick up other weapons.

==Keywords==
rampage, kill frenzy

[[Category:OpCodes]]

Template:NetworkProfile

2008-08-20T13:15:39Z

Fred: Links to GTAG & GTAF profiles

{| {{prettytable}}
! Profile Links
|-
| [http://www.gtaforums.com/index.php?showuser={{{1}}} Find this user on GTAForums]
|-
| [http://www.gtagarage.com/users/profile.php?M={{{1}}} Find this user on GTAGarage]
|}

MediaWiki:Sidebar

2008-08-19T18:02:45Z

Fred:

MediaWiki:Sidebar

2008-08-19T18:01:47Z

Fred: New page: * navigation ** Main Page ** Category:Tutorials|Tutorials and guides ** Category:Documentation ** Special:RecentChanges|Recent changes ** Special:Random|Random page ** Help:Contents|Help ...

Template talk:Prettytable

2006-01-18T18:09:31Z

Fred:

== Usage ==

You can use the <nowiki>{{prettytable}}</nowiki> template instead of typing out all the HTML attributes every time.

'''Wiki code:'''

<nowiki>{| {{prettytable}}
! Column
! Column
! Column
|-
| Value
| Value
| Value
|-
| 2nd row
| 2nd row
| 2nd row
|}</nowiki>

(<nowiki><pre></nowiki> tags not parsing properly, edit to see source)

'''Displays as:'''
{| {{prettytable}}
! Column
! Column
! Column
|-
| Value
| Value
| Value
|-
| 2nd row
| 2nd row
| 2nd row
|}

== Comments ==
Another page created by someone simply to play around. Stuff like this should be done in the sandbox or in the user's personal page.
--[[User:Cerbera|Cerbera]] 07:34, 18 Jan 2006 (Central Standard Time)

Template talk:Prettytable

2006-01-18T18:07:49Z

Fred: /* Usage */ <pre> tags not working

== Usage ==

You can use the <nowiki>{{prettytable}}</nowiki> template instead of typing out all the HTML attributes every time.

'''Wiki code:'''

<nowiki>{| {{prettytable}}
! Column
! Column
! Column
|-
| Value
| Value
| Value
|-
| 2nd row
| 2nd row
| 2nd row
|}</nowiki>

(<nowiki><pre></nowiki> tags not parsing properly, edit to see source)

'''Displays as:'''
{| {{prettytable}}
! Column
! Column
! Column
|-
| Value
| Value
| Value
|-
| 2nd row
| 2nd row
| 2nd row
|}
----
Another page created by someone simply to play around. Stuff like this should be done in the sandbox or in the user's personal page.
--[[User:Cerbera|Cerbera]] 07:34, 18 Jan 2006 (Central Standard Time)

Template talk:Prettytable

2006-01-18T18:01:48Z

Fred:

== Usage ==

You can use the <nowiki>{{prettytable}}</nowiki> template instead of typing out all the HTML attributes every time.

'''Wiki code:'''
NaodW29-pre6f1df7a31ed704fe00000001
'''Displays as:'''
{| {{prettytable}}
! Column
! Column
! Column
|-
| Value
| Value
| Value
|-
| 2nd row
| 2nd row
| 2nd row
|}
----
Another page created by someone simply to play around. Stuff like this should be done in the sandbox or in the user's personal page.
--[[User:Cerbera|Cerbera]] 07:34, 18 Jan 2006 (Central Standard Time)

Main Page

2005-11-27T13:41:14Z

Fred:

__NOTOC__
{{MainPageIntro}}
{| width="100%" border="0" cellpadding="10"
= Welcome to GTAModding.com =

The goal of this site is to have all GTA modding related knowledge in one convenient place. At the moment this will consist of guides and tutorials for modding as well as modding related documentation. All GTANet members can contribute their knowledge and are invited to write articles for the site (see [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide User's Guide] for an introduction into the world of Wiki).
|-
|width="33%" valign="top"|
==[[:Category:Tutorials|Tutorials and Guides]]==
* [[:Category:Vehicle Modelling|Vehicle Modelling]]
* [[:Category:Map Object Modelling|Map Object Modelling]]
* [[:Category:Character Modelling|Character Modelling]]
* [[:Category:Mapping|Mapping]]
* [[:Category:Mission Scripting|Mission Scripting]]
|width="33%" valign="top"|
==[[:Category:Documentation|Documentation]]==
* '''[[FAQ|Problems and FAQ]]'''
* [[:Category:Tools|Tools]]
* [[:Category:File Formats|File Formats]]
** [[:Category:Map Formats|Maps]]
** [[:Category:3D File Formats|3D Files]]
** [[:Category:Other Formats|Others]]
* [[:Category:Mission Script|Mission Script]]
** [[:Category:OpCodes|OpCodes]]
** [[:Category:Algorithms|Algorithms]]
** [[:Category:Code Snippets|Code Snippets]]
* [[:Category:Memory Addresses|Memory Addresses]]
|width="33%" valign="top"|
== Version specific ==
* [[:Category:GTA 1|GTA 1]]
* [[:Category:GTA 2|GTA 2]]
* [[:Category:GTA 3|GTA III]]
* [[:Category:GTA VC|GTA Vice City]]
* [[:Category:GTA SA|GTA San Andreas]]
* [[:Category:GTA LCS|GTA Liberty City Stories]]
* [[:Category:GTA 4|GTA IV]]
|-
{|width="100%" border="0" cellpadding="0"
|width="50%" valign="top"|
== [[Special:News|Modding News]] ==
{{MediaWiki:Newstitles}}
|width="50%" valign="top"|

== [http://www.gtanet.com/news/ Network News] ==
{{MediaWiki:Networktitles}}
|}
|}

2005-09-05T11:58:25Z

Fred:

There are '''$1''' active accounts used on GTAModding.
'''$2''' are administrators (see $3).

MediaWiki:Userlogin

2005-09-05T11:52:15Z

Fred:

MediaWiki:Nosuchuser

2005-09-05T11:40:53Z

Fred:

There is no user by the name "$1". If you are not registered you can create an account at <a href="http://www.gtaforums.com/?act=Register">GTAForums.com</a> to use on all the GTANet sites.

MediaWiki:Userlogin

2005-09-05T11:37:30Z

Fred:

MediaWiki:News

2005-09-05T10:14:04Z

Fred:

News