CreatePed: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added the bSynced argument)
No edit summary
(14 intermediate revisions by 10 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server client function}}
{{Server client function}}
{{Needs_Checking|Please check if I'm right with the bSynced argument. I've been testing two different peds and discovered the effect written below --[[User:OpenIDUser28|Sniper]] 03:12, 4 September 2011 (CEST)}}
Creates a Ped in the GTA world.
Creates a Ped in the GTA world.


==Syntax==  
==Syntax==
<syntaxhighlight lang="lua">ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0, bool bSynced = true ] )</syntaxhighlight>  
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0, bool synced = true ] )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
Line 12: Line 12:
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.
==Optional Arguments==
{{OptionalArg}}
*'''rot:''' A floating point number representing the rotation in degrees.  
*'''rot:''' A floating point number representing the rotation in degrees.  
*'''bSynced:''' A boolean value representing whether or not the ped will be fully synchronized even for players that are not within the syncing range. If disabled a player that is more than 100 units away from the ped won't receive new information about its state and position. This will cause a desync of the ped (useful for frozen/static peds to increase the server perfomance).
*'''synced:''' A boolean value representing whether or not the ped will be synced. Disabling the sync might be useful for frozen or static peds to increase the server performance.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0 ] )</syntaxhighlight>
 
===Required Arguments===
*'''modelid:''' A whole integer specifying the [[Character_Skins|GTASA skin ID]].
*'''x:''' A floating point number representing the X coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.
 
==Optional Arguments==
{{OptionalArg}}
*'''rot:''' A floating point number representing the rotation in degrees.
</section>


===Returns===
===Returns===
Returns a ped element if it was successfully created, ''nil'' if an invalid element is passed.
Returns a ped element if it was successfully created.


==Example==  
==Example==  
Line 26: Line 43:
   createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
   createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
end
addEventHandler ( "onResourceStart", getRootElement(), pedLoad )
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
<section name="Client" class="client" show="true">
This example creates a ped, and makes it damage proof:
<syntaxhighlight lang="lua">
thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creates a ped
function cancelPedDamage()
cancelEvent() -- Cancels the onClientPedDamage event
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- When thePed is damaged, cancelPedDamage is called
</syntaxhighlight>
</section>
==Issues==
{{Issues|
{{Issue|7371|Network troubled players can ruin ped sync}}
{{Issue|5113|setPedControlState doesn't work on the control "enter_exit"}}
{{Issue|6287|Sync distance of unoccupied vehicles and peds should match stream distance}}
{{Issue|8790|Using setElementHealth on a dead ped makes it invincible}}
{{Issue|5725|Ped fireing Projectiles doesn't work}}
{{Issue|4921|Improve ped synchronization}}
{{Issue|5840|ped position not synced to server after falling through the ground}}
{{Issue|6682|Server doesnt update ped position after warping it to vehicle}}
{{Issue|6506|Ped animation is only visible if it was set while player was in stream distance from source ped}}
{{Issue|4596|Serverside peds have their animations not applied for joining players}}
{{Issue|4504|Peds shooting incorrectly}}
{{Issue|4008|Can't use giveWeapon() directly after createPed()}}
}}


==See Also==
==See Also==
{{Ped functions}}
{{Ped functions}}
[[hu:createPed]]
[[pl:createPed]]
[[ru:createPed]]
[[ru:createPed]]

Revision as of 19:21, 24 September 2018

Creates a Ped in the GTA world.

Syntax

Click to collapse [-]
Server
ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0, bool synced = true ] )

Required Arguments

  • modelid: A whole integer specifying the GTASA skin ID.
  • x: A floating point number representing the X coordinate on the map.
  • y: A floating point number representing the Y coordinate on the map.
  • z: A floating point number representing the Z coordinate on the map.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • rot: A floating point number representing the rotation in degrees.
  • synced: A boolean value representing whether or not the ped will be synced. Disabling the sync might be useful for frozen or static peds to increase the server performance.
Click to collapse [-]
Client
ped createPed ( int modelid, float x, float y, float z [, float rot = 0.0 ] )

Required Arguments

  • modelid: A whole integer specifying the GTASA skin ID.
  • x: A floating point number representing the X coordinate on the map.
  • y: A floating point number representing the Y coordinate on the map.
  • z: A floating point number representing the Z coordinate on the map.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • rot: A floating point number representing the rotation in degrees.

Returns

Returns a ped element if it was successfully created.

Example

Click to collapse [-]
Server

This example creates an ped when the resource starts:

function pedLoad ( name )
   createPed ( 120, 5540.6654, 1020.55122, 1240.545 )
end
addEventHandler ( "onResourceStart", getResourceRootElement(), pedLoad )
Click to collapse [-]
Client

This example creates a ped, and makes it damage proof:

thePed = createPed(120, 5540.6654, 1020.55122, 1240.545) -- Creates a ped
function cancelPedDamage()
	cancelEvent() -- Cancels the onClientPedDamage event
end
addEventHandler("onClientPedDamage", thePed, cancelPedDamage) -- When thePed is damaged, cancelPedDamage is called

Issues

Issue ID Description
#7371 Network troubled players can ruin ped sync
#5113 setPedControlState doesn't work on the control "enter_exit"
#6287 Sync distance of unoccupied vehicles and peds should match stream distance
#8790 Using setElementHealth on a dead ped makes it invincible
#5725 Ped fireing Projectiles doesn't work
#4921 Improve ped synchronization
#5840 ped position not synced to server after falling through the ground
#6682 Server doesnt update ped position after warping it to vehicle
#6506 Ped animation is only visible if it was set while player was in stream distance from source ped
#4596 Serverside peds have their animations not applied for joining players
#4504 Peds shooting incorrectly
#4008 Can't use giveWeapon() directly after createPed()


See Also