Difference between revisions of "00A5"
Jump to navigation
Jump to search
| Line 1: | Line 1: | ||
| − | {{Icon| | + | {{OpCode |
| − | + | | games = {{Icon|t}} | |
| − | + | | command = CREATE_CAR | |
| − | + | | description = Creates a vehicle at the coordinates point | |
| − | + | | syntax1 = 00A5: [''var''] = create_car [''int''] at [''flt1''] [''flt2''] [''flt3''] | |
| − | + | | syntax2 = Car.Create( [''var''], [''int''], [''flt1''], [''flt2''], [''flt3''] ) | |
| − | + | | p1t = [''var''] | |
| − | + | | p1d = Variable to store the handle of the vehicle | |
| − | + | | p2t = [''int''] | |
| − | + | | p2d = Valid vehicle model ID number as defined in the [[CARS (IDE Section)|CARS section]] of the [[IDE]] file; also acceptable is model's [[DFF]] name with a hash character | |
| − | + | | p3t = [''flt1''] | |
| − | + | | p3d = X-coordinate | |
| − | + | | p4t = [''flt2''] | |
| − | + | | p4d = Y-coordinate | |
| − | + | | p5t = [''flt3''] | |
| − | + | | p5d = Z-coordinate (or <''-100.0'' for [[02CE|ground z]]) | |
| − | + | | native = [[CREATE_CAR]] | |
| − | + | }} | |
| − | |||
| − | |||
| − | This creates a vehicle at | + | This opcode creates a vehicle at the coordinates point. Using this opcode requires the model to be already loaded, usually through opcode [[0247]], or else the game might crash. The major script editors like [[Sanny Builder]] support using the vehicle's DFF model name and automatically converts those values into integers upon compilation. The Enforcer, Police, and Rhino are locked initially (lock state 5) when spawned; they can be unlocked using opcode [[020A]] or if any driver exits the vehicle. All vehicles created by this opcode outside a [[Create a mission|mission]] will become near-permanent in the game until opcode [[01C3]] is used to mark it as no longer needed. |
==Example== | ==Example== | ||
Revision as of 15:10, 13 January 2016
CREATE_CAR
- Description
- Creates a vehicle at the coordinates point
- Syntax
- 00A5: [var] = create_car [int] at [flt1] [flt2] [flt3]
- Car.Create( [var], [int], [flt1], [flt2], [flt3] )
- Parameter
- [var]
- Variable to store the handle of the vehicle
- [int]
- Valid vehicle model ID number as defined in the CARS section of the IDE file; also acceptable is model's DFF name with a hash character
- [flt1]
- X-coordinate
- [flt2]
- Y-coordinate
- [flt3]
- Z-coordinate (or <-100.0 for ground z)
- Native analog
- CREATE_CAR
This opcode creates a vehicle at the coordinates point. Using this opcode requires the model to be already loaded, usually through opcode 0247, or else the game might crash. The major script editors like Sanny Builder support using the vehicle's DFF model name and automatically converts those values into integers upon compilation. The Enforcer, Police, and Rhino are locked initially (lock state 5) when spawned; they can be unlocked using opcode 020A or if any driver exits the vehicle. All vehicles created by this opcode outside a mission will become near-permanent in the game until opcode 01C3 is used to mark it as no longer needed.
Example
- See also: Spawn a vehicle
The following example, using Sanny Builder, will spawn a Pony close to the player character.
// set constants
const
SPAWNED_CAR = 0@
X_POS = 1@
Y_POS = 2@
Z_POS = 3@
CAR_MODEL = #PONY
end
// spawn pony
0247: request_model CAR_MODEL
repeat
wait 0
if
0248: model CAR_MODEL available
then
break
end
until false
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
X_POS += 4.0
00A5: SPAWNED_CAR = create_car CAR_MODEL at X_POS Y_POS Z_POS
0249: release_model CAR_MODEL
01C3: remove_references_to_car SPAWNED_CARKeywords
create, spawn, car, vehicle, model
