JUMP: Difference between revisions

m (clean up,)
(contributions from myself and Seemann)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{This|This article describes the usage of unique stunt jumps in plain text [[IPL]]s. For information about the jump operation in a [[SCM|script]] see [[0002]].}}
{{IplSection
{{IplSection
| game        = [[GTA SA]], [[GTA IV]]
| game        = {{Icon-square|SA}}
| description = Creates a unique stunt jump
| description = Creates a unique stunt jump
}}
}}


Unique stunt jumps are stunts the player can search and perform to complete the game, optionally in San Andreas. Usually they are created using [[SCM]] or [[SCO]], but just like the [[CARS]] section they can also be stored in plain text ipls in San Andreas and GTA IV since this is more easy to handle. Since unique stunt jumps are related to [[Saves_(GTA_SA)#Block_24:_Unique_Stunt_Jumps|savegames]], a new game must be started before changed or added entries are applied. In [[San Andreas]] it is possible to add new stunt jumps without starting a new game using [[CLEO]].
'''<code>jump</code>''' is a section in the item placement file functionally working in [[Grand Theft Auto: San Andreas]]. Unique stunt jumps are stunts the player can search and perform to complete the game, optionally in GTA San Andreas. Usually they are created using SCM or [[SCO]], but just like the <code>cars</code> section they can also be stored in plain text ipls in GTA San Andreas and GTA IV since this is more easy to handle. Since unique stunt jumps are related to [[Saves_(GTA_SA)#Block_24:_Unique_Stunt_Jumps|savegames]], a new game must be started before changed or added entries are applied. It is also possible to add new stunt jumps without starting a new game using an external scripts technology like [[CLEO]] or Alice.


==Format==
==Format==


A unique stunt jump is defined by three parameters: A plane which the player needs to pass (in a car and with a specific speed), a plane a player needs to reach and the position of the camera. If the player passes the ''start plane'' then the game enables a slow motion and sets the camera to the ''camera position''. The camera follows the player during his flight. If the player reaches the ground without passing the ''target plane'' the stunt fails. If he has crossed it and reaches the ground (even if he falls of a bike or dies due a vehicle explosion or something else) the stunt jump has been successfully passed. If the player has triggered a stunt jump (no matter if it fails or not) it is marked as ''found'' for the game and the [[Saves (GTA SA)|savegame]]. If the player has successfully passed the target plane the stunt jump gets marked as ''done''. In San Andreas, it is not required to complete these stunts in order to complete the game but required in GTA IV. These stunts are recorded in the player's statistics{{ref|1}}{{ref|2}}.
A unique stunt jump is defined by three parameters: A plane which the player needs to pass (in a car and with a specific speed), a plane a player needs to reach and the position of the camera. If the player passes the ''start plane'' then the game enables a slow motion and sets the camera to the ''camera position''. The camera follows the player during his flight. If the player reaches the ground without passing the ''target plane'' the stunt fails. If he has crossed it and reaches the ground (even if he falls of a bike or dies due a vehicle explosion or something else) the stunt jump has been successfully passed. If the player has triggered a stunt jump (no matter if it fails or not) it is marked as ''found'' for the game and the [[Saves (GTA SA)|savegame]]. If the player has successfully passed the target plane the stunt jump gets marked as ''done''. In GTA San Andreas, it is not required to complete these stunts in order to complete the game but required in GTA IV. These stunts are recorded in the player's statistics.
 
=== San Andreas ===


The planes for target and start as described above are defined by six floating point values, where three of them always represent a point in [[unit|real world coordinates]].
The planes for target and start as described above are defined by six floating point values, where three of them always represent a point in [[unit|real world coordinates]].


<pre>StartLowerX, StartLowerY, StartLowerZ, StartUpperX, StartUpperY, StartUpperZ, TargetLowerX, TargetLowerY, TargetLowerZ,
{{Pre|
TargetUpperX, TargetUpperY, TargetUpperZ, CameraX, CameraY, CameraZ, Reward</pre>
jump
''The information above is divided into two lines since it does not fit into one. If you create a stunt jump then the data needs to be written in '''1''' line (1 for each entry), just like the [[IPL]] specification sais.''
StartLowerX, StartLowerY, StartLowerZ, StartUpperX, StartUpperY, StartUpperZ, TargetLowerX, TargetLowerY, TargetLowerZ, TargetUpperX, TargetUpperY, TargetUpperZ, CameraX, CameraY, CameraZ, Reward
end
}}


{|class="prettytable" width="100%" class="collapsible"
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!width="250px"|Identifier
!style="width: 3em;" |{{Icon-square|SA}}
!style="width: 16em;" |Identifier
!style="width: 6em;" |Type
!Description
!Description
|-
|-
|<center>StartLowerX, StartLowerY, StartLowerZ</center>||These values define a point in the world as floating point values. The point represents one of the lower edge points of the plane representing the start of the unique stunt jump.
|A,B,C ||StartLowerX, StartLowerY, StartLowerZ ||float[3] ||These values define a point in the world as floating point values. The point represents one of the lower edge points of the plane representing the start of the unique stunt jump.
|-
|-
|<center>StartUpperX, StartUpperY, StartUpperZ</center>||These values are used in the same way as the first ones. They represent a point on the upper edge of the plane (diagonal opposite).
|D,E,F ||StartUpperX, StartUpperY, StartUpperZ ||float[3] ||These values are used in the same way as the first ones. They represent a point on the upper edge of the plane (diagonal opposite).
|-
|-
|<center>TargetLowerX, TargetLowerY, TargetLowerZ</center>||A point on the lower edge of the ''target plane''.
|G,H,I ||TargetLowerX, TargetLowerY, TargetLowerZ ||float[3] ||A point on the lower edge of the ''target plane''.
|-
|-
|<center>TargetUpperX, TargetUpperY, TargetUpperZ</center>||A point on the upper edge of the ''target plane'' (diagonal opposite).
|J,K,L ||TargetUpperX, TargetUpperY, TargetUpperZ ||float[3] ||A point on the upper edge of the ''target plane'' (diagonal opposite).
|-
|-
|<center>CameraX, CameraY, CameraZ</center>||The position of the camera (see [[JUMP#Format|above]]).
|M,N,O ||CameraX, CameraY, CameraZ ||float[3] ||The position of the camera.
|-
|-
|<center>Reward</center>||The amount of cash the player earns after he has finished this stunt successfully.
|P ||Reward ||integer ||The amount of cash the player earns after he has finished this stunt successfully.
|}
|}


=== GTA 4 ===
==External link==
 
* [http://www.gtaforums.com/index.php?showtopic=202532&view=findpost&p=3127018 Jump format explained]
{{Research}}
 
==Script representation==
* [[0814]] &ndash; [[SCM]] [[opcode]] defining a unique stunt jump
* [[ADD STUNT JUMP]] &ndash; [[SCO]] [[native function]] defining a unique stunt jump
* [[ALLOW STUNT JUMPS TO TRIGGER]] &ndash; SCO native function to control a stunt jump's behaviour
 
==See also==
* {{note|1}} {{Icon|4}} [[List of statistics (GTA4)]]
* {{note|2}} {{Icon|SA}} [[List of statistics (SA)]]
 
[[Category:Map Formats]]{{fdl}}
[[Category:Modifications]]

Latest revision as of 05:36, 19 July 2018

JUMP (IPL section)
Supported games:GTA San Andreas
Short description:Creates a unique stunt jump
IPL Sections:
AUZO CARS CULL ENEX GRGE INST
JUMP MULT OCCL PATH PICK TCYC

jump is a section in the item placement file functionally working in Grand Theft Auto: San Andreas. Unique stunt jumps are stunts the player can search and perform to complete the game, optionally in GTA San Andreas. Usually they are created using SCM or SCO, but just like the cars section they can also be stored in plain text ipls in GTA San Andreas and GTA IV since this is more easy to handle. Since unique stunt jumps are related to savegames, a new game must be started before changed or added entries are applied. It is also possible to add new stunt jumps without starting a new game using an external scripts technology like CLEO or Alice.

Format

A unique stunt jump is defined by three parameters: A plane which the player needs to pass (in a car and with a specific speed), a plane a player needs to reach and the position of the camera. If the player passes the start plane then the game enables a slow motion and sets the camera to the camera position. The camera follows the player during his flight. If the player reaches the ground without passing the target plane the stunt fails. If he has crossed it and reaches the ground (even if he falls of a bike or dies due a vehicle explosion or something else) the stunt jump has been successfully passed. If the player has triggered a stunt jump (no matter if it fails or not) it is marked as found for the game and the savegame. If the player has successfully passed the target plane the stunt jump gets marked as done. In GTA San Andreas, it is not required to complete these stunts in order to complete the game but required in GTA IV. These stunts are recorded in the player's statistics.

The planes for target and start as described above are defined by six floating point values, where three of them always represent a point in real world coordinates.

jump
StartLowerX, StartLowerY, StartLowerZ, StartUpperX, StartUpperY, StartUpperZ, TargetLowerX, TargetLowerY, TargetLowerZ, TargetUpperX, TargetUpperY, TargetUpperZ, CameraX, CameraY, CameraZ, Reward
end
GTA San Andreas Identifier Type Description
A,B,C StartLowerX, StartLowerY, StartLowerZ float[3] These values define a point in the world as floating point values. The point represents one of the lower edge points of the plane representing the start of the unique stunt jump.
D,E,F StartUpperX, StartUpperY, StartUpperZ float[3] These values are used in the same way as the first ones. They represent a point on the upper edge of the plane (diagonal opposite).
G,H,I TargetLowerX, TargetLowerY, TargetLowerZ float[3] A point on the lower edge of the target plane.
J,K,L TargetUpperX, TargetUpperY, TargetUpperZ float[3] A point on the upper edge of the target plane (diagonal opposite).
M,N,O CameraX, CameraY, CameraZ float[3] The position of the camera.
P Reward integer The amount of cash the player earns after he has finished this stunt successfully.

External link