Difference between revisions of "0129"

From GTAMods Wiki
Jump to navigation Jump to search
m
m
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Icon|trilogy}} '''CREATE_CHAR_INSIDE_CAR'''
+
{{OpCode
<hr />
+
| games      = {{icon|t}}
<onlyinclude>{{#ifeq:{{{transcludesection|opcode}}}|opcode|
+
| command    = CREATE_CHAR_INSIDE_CAR
'''Description'''
+
| description = Spawns a character in the driver seat of the vehicle
: Spawns a character in the driver seat of a vehicle
+
| syntax1    = 0129: [''var''] = create_actor_pedtype [''int1''] model [''int2''] in_car [''car handle''] driverseat
'''Syntax'''
+
| p1t        = [''car handle'']
: 0129: [''var''] = create_actor_pedtype [''int1''] model [''int2''] in_car [''car handle''] driverseat
+
| p1d        = The handle of the vehicle
'''Parameter'''
+
| p2t        = [''int1'']
: [''var'']
+
| p2d        = [[Ped type]]
:: Variable to store the handle of the character
+
| p3t        = [''int2'']
: [''int1'']
+
| p3d        = Valid model index as defined in the [[PEDS|PEDS section]] of the [[IDE]] file; also acceptable is model's [[DFF]] name with a hash character
:: [[Ped type]]
+
| p4t        = [''var'']
: [''int2'']
+
| p4d        = Variable to store the handle of the character
:: Valid character model ID number as defined in the [[PEDS|PEDS section]] of the [[IDE]] file; also acceptable is model's [[DFF]] name with a hash character
+
| native      = [[CREATE_CHAR_INSIDE_CAR]]
: [''car handle'']
+
}}
:: The handle of the vehicle
 
'''Native analog'''
 
: [[CREATE_CHAR_INSIDE_CAR]]
 
  
 
This opcode spawns a character in the driver seat of a vehicle. Using this opcode requires an existing vehicle and opcode [[0247]] to load the character model or else the game could crash.
 
This opcode spawns a character in the driver seat of a vehicle. Using this opcode requires an existing vehicle and opcode [[0247]] to load the character model or else the game could crash.
}}</onlyinclude>
 
  
 
== Example ==
 
== Example ==
 
:''See also: [[Spawn a ped]]''
 
:''See also: [[Spawn a ped]]''
 
The following example, using Sanny Builder, will spawn a ped in a car close to the player character.
 
The following example, using Sanny Builder, will spawn a ped in a car close to the player character.
<source lang="scm">
+
{{Pre|class=sb-code|1=
// set constants
+
<span class="k">const</span>
const
+
CHAR_MODEL = <span class="nt">#BFORI</span>  <span class="c1">// set your character model</span>
CHAR_MODEL = #BFORI
+
CAR_MODEL = <span class="nt">#PONY</span>  <span class="c1">// set your vehicle model</span>
CAR_MODEL = #PONY
+
CHAR_HANDLE = <span class="nv">0@</span>
CHAR_HANDLE = 0@
+
CAR_HANDLE = <span class="nv">1@</span>
CAR_HANDLE = 1@
+
X_POS = <span class="nv">2@</span>
X_POS = 2@
+
Y_POS = <span class="nv">3@</span>
Y_POS = 3@
+
Z_POS = <span class="nv">4@</span>
Z_POS = 4@
+
<span class="k">end</span>
end
 
  
// load model, required to prevent unnecessary crash!
+
[[0247]]: request_model CHAR_MODEL
0247: request_model CHAR_MODEL
+
[[0247]]: request_model CAR_MODEL
0247: request_model CAR_MODEL
+
[[038B]]: load_requested_models
// check if model is loaded
+
[[00A0]]: store_actor <span class="nv">$PLAYER_ACTOR</span> position_to X_POS Y_POS Z_POS
repeat
+
X_POS += <span class="m">4.0</span>
    wait 0
+
[[00A5]]: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
    if and
+
0129: CHAR_HANDLE = create_actor_pedtype <span class="m">4</span> model CHAR_MODEL in_car CAR_HANDLE driverseat
        0248:  model CHAR_MODEL available
+
[[0249]]: release_model CHAR_MODEL
        0248:   model CAR_MODEL available
+
[[0249]]: release_model CAR_MODEL
    then
+
[[01C2]]: mark_actor_as_no_longer_needed CHAR_HANDLE
        break
+
[[01C3]]: mark_car_as_no_longer_needed CAR_HANDLE
    end
+
}}
until false
 
// spawn car
 
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
 
X_POS += 4.0
 
00A5: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
 
// spawn character
 
0129: CHAR_HANDLE = create_actor_pedtype 4 model CHAR_MODEL in_car CAR_HANDLE driverseat
 
// cleanup
 
0249: release_model CHAR_MODEL
 
0249: release_model CAR_MODEL
 
01C2: remove_references_to_actor CHAR_HANDLE
 
01C3: remove_references_to_car CAR_HANDLE
 
</source>
 
  
 
== Keywords ==
 
== Keywords ==
create, spawn, actor, ped, pedestrian, character, pedtype, model, vehicle, car, driver
+
create, spawn, actor, ped, pedestrian, character, pedtype, model, inside, vehicle, car, driver
 
 
[[Category:OpCodes]]
 

Latest revision as of 05:03, 15 April 2017

GTA III Vice City San Andreas CREATE_CHAR_INSIDE_CAR


Description
Spawns a character in the driver seat of the vehicle
Syntax
0129: [var] = create_actor_pedtype [int1] model [int2] in_car [car handle] driverseat
Parameter
[car handle]
The handle of the vehicle
[int1]
Ped type
[int2]
Valid model index as defined in the PEDS section of the IDE file; also acceptable is model's DFF name with a hash character
[var]
Variable to store the handle of the character
Native analog
CREATE_CHAR_INSIDE_CAR

This opcode spawns a character in the driver seat of a vehicle. Using this opcode requires an existing vehicle and opcode 0247 to load the character model or else the game could crash.

Example

See also: Spawn a ped

The following example, using Sanny Builder, will spawn a ped in a car close to the player character.

const
CHAR_MODEL = #BFORI  // set your character model
CAR_MODEL = #PONY  // set your vehicle model
CHAR_HANDLE = 0@
CAR_HANDLE = 1@
X_POS = 2@
Y_POS = 3@
Z_POS = 4@
end

0247: request_model CHAR_MODEL
0247: request_model CAR_MODEL
038B: load_requested_models
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
X_POS += 4.0
00A5: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
0129: CHAR_HANDLE = create_actor_pedtype 4 model CHAR_MODEL in_car CAR_HANDLE driverseat
0249: release_model CHAR_MODEL
0249: release_model CAR_MODEL
01C2: mark_actor_as_no_longer_needed CHAR_HANDLE
01C3: mark_car_as_no_longer_needed CAR_HANDLE

Keywords

create, spawn, actor, ped, pedestrian, character, pedtype, model, inside, vehicle, car, driver