Multi Theft Auto: Wiki - User contributions [en]

Md5

2009-01-09T10:59:46Z

Willy:

__NOTOC__
{{Server client function}}

Calculates the MD5 hash of the specified string and returns its hexadecimal representation.

Note: returns an uppercase string, so make sure you string.upper() anything else you are checking against that has been MD5'd elsewhere.

==Syntax==
<syntaxhighlight lang="lua">string md5 ( string str )</syntaxhighlight>

===Required Arguments===
*'''str:''' the string to hash.

===Returns===
Returns the MD5 hash of the input string if successful, ''false'' otherwise.

==See Also==
{{Utility functions}}

Md5

2009-01-09T10:59:33Z

Willy:

__NOTOC__
{{Server client function}}

Calculates the MD5 hash of the specified string and returns its hexadecimal representation.

Note: returns an uppercase string, so make sure you string.upper() anything else you are checking against that has been MD5'd elswhere.

==Syntax==
<syntaxhighlight lang="lua">string md5 ( string str )</syntaxhighlight>

===Required Arguments===
*'''str:''' the string to hash.

===Returns===
Returns the MD5 hash of the input string if successful, ''false'' otherwise.

==See Also==
{{Utility functions}}

Md5

2009-01-09T10:59:27Z

Willy:

__NOTOC__
{{Server client function}}

Calculates the MD5 hash of the specified string and returns its hexadecimal representation.
Note: returns an uppercase string, so make sure you string.upper() anything else you are checking against that has been MD5'd elswhere.

==Syntax==
<syntaxhighlight lang="lua">string md5 ( string str )</syntaxhighlight>

===Required Arguments===
*'''str:''' the string to hash.

===Returns===
Returns the MD5 hash of the input string if successful, ''false'' otherwise.

==See Also==
{{Utility functions}}

Talk:IsPlayerMapForced

2009-01-04T14:25:41Z

Willy: New page: this function is client and serverside - needs properly documenting.

this function is client and serverside - needs properly documenting.

GetPedAnimation

2009-01-03T12:47:49Z

Willy:

__NOTOC__
{{Client function}}

Gets the animation of a player or ped that was set using [[setPedAnimation]].

==Syntax==
<syntaxhighlight lang="lua">
string string getPedAnimation ( ped thePed )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' the player or ped you want to get the animation of.

===Returns===
Returns two ''strings'': the first is the name of the block, the second is the name of the animation. Returns ''false'' if there was an error or if the ped is not doing an animation.

==Example==

==See Also==
{{Ped_functions}}

SetPedAnimation

2008-11-30T21:31:46Z

Willy: fixed typo

__NOTOC__
{{Server client function}}

Sets the current animation of a player or ped. Not specifying the type of animation will automatically cancel the current one.

==Syntax==
<syntaxhighlight lang="lua">
bool setPedAnimation ( ped thePed, [string block=nil, string name=nil, int time=-1,bool loop=true, bool updatePosition=true, bool interruptible=true) )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' the player or ped you want to apply an animation to.

===Optional Arguments===
*'''block:''' the [[Animations|animation]] block's name.
*'''anim:''' the name of the [[Animations|animation]] within the block.
*'''time:''' the duration for the animation. Defaults to -1, which is the default time.
*'''loop:''' indicates whether or not the animation will loop.
*'''updatePosition:''' will change the actual coordinates of the ped according to the animation. Use this for e.g. walking animations.
*'''interuptable:''' Defines whether the animation can be interrupted by normal movements

===Returns===
Returns ''true'' if succesful, ''false'' otherwise.

==Example==

==See Also==
{{Ped_functions}}

SetElementRotation

2008-11-25T02:24:36Z

Willy: New page: {{Client function}} __NOTOC__ Sets the rotation of elements according to the world (does not work with players that are on the ground). ==Syntax== <syntaxhighlight lang="lua"> bool setElementRotation (...

{{Client function}}
__NOTOC__
Sets the rotation of elements according to the world (does not work with players that are on the ground).

==Syntax==
<syntaxhighlight lang="lua">
bool setElementRotation ( element theElement, float rotX, float rotY, float rotZ )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element whose rotation will be set
*'''rotX:''' The element's rotation around the x axis in degrees
*'''rotY:''' The element's rotation around the y axis in degrees
*'''rotZ:''' The element's rotation around the z axis in degrees

===Returns===
Returns ''true'' if the element rotation was successfully set and ''false'' otherwise.

==Example==
When a player used the command "turn" and they are the driver of a vehicle the vehicle will rotate 10 degrees clockwise
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local localPlayer = getLocalPlayer()
function carRotate( )
if isPlayerInVehicle(localPlayer) then -- if the local client is in a vehicle
localVehicle = getPlayerOccupiedVehicle(localPlayer)
if getVehicleController(localVehicle) == localPlayer then -- if the local client is the controller (driver) of the vehicle
local rotX, rotY, rotZ = getElementRotation(localVehicle) -- get the local client's vehicle rotation
setElementRotation(localVehicle,rotX,rotY,rotZ+10) -- turn the vehicle 10 degrees clockwise
end
end
end
addCommandHandler ( "turn", carRotate )
</syntaxhighlight>
</section>

==See Also==
{{Client_element_functions}}

GetElementRotation

2008-11-25T02:22:31Z

Willy:

GetElementRotation

2008-11-25T01:56:19Z

Willy:

GetElementRotation

2008-11-25T01:55:31Z

Willy:

{{Client function}}
__NOTOC__
Retrieve the rotation of elements.

==Syntax==
<syntaxhighlight lang="lua">
float float float getElementRotation ( element theElement )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element whose rotation will be retrieved

===Returns===
Returns three ''float''s if element exists and is a valid element, ''false'' in if it's invalid.

==Example==
If a player points at a player element with a gun, its rotation will appear in the chat box.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( isElement(targetElem) and getElementType(targetElem) == "player" ) then
local x,y,z = getElementRotation ( targetElem )
outputChatBox ( "Target player rotation: " .. x .. " " .. y .. " " .. z, source )
end
end
addEventHandler ( "onPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>
</section>
<section name="Client" class="client">
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( isElement(targetElem) and getElementType (targetElem) == "player" ) then
local x,y,z = getElementRotation ( targetElem )
outputChatBox ( "Target player rotation: " .. x .. " " .. y .. " " .. z )
end
end
addEventHandler ( "onClientPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>
</section>

==See Also==
{{Element_functions}}

GetElementRotation

2008-11-25T01:50:36Z

Willy: New page: {{Server client function}} __NOTOC__ Retrieve the rotation of elements. ==Syntax== <syntaxhighlight lang="lua"> float float float getElementRotation ( element theElement ) </syntaxhighlight> ===Required ...

{{Server client function}}
__NOTOC__
Retrieve the rotation of elements.

==Syntax==
<syntaxhighlight lang="lua">
float float float getElementRotation ( element theElement )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element whose rotation will be retrieved

===Returns===
Returns three ''float''s if element exists and is a valid element, ''false'' in if it's invalid.

==Example==
If a player points at a player element with a gun, its rotation will appear in the chat box.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( isElement(targetElem) and getElementType(targetElem) == "player" ) then
local x,y,z = getElementRotation ( targetElem )
outputChatBox ( "Target player rotation: " .. x .. " " .. y .. " " .. z, source )
end
end
addEventHandler ( "onPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>
</section>
<section name="Client" class="client">
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( isElement(targetElem) and getElementType (targetElem) == "player" ) then
local x,y,z = getElementRotation ( targetElem )
outputChatBox ( "Target player rotation: " .. x .. " " .. y .. " " .. z )
end
end
addEventHandler ( "onClientPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>
</section>

==See Also==
{{Element_functions}}

GetObjectModel

2008-11-24T18:43:56Z

Willy: fixed typos

__NOTOC__
{{Server client function}}
This function retrieves the model ID of a specified object

==Syntax==
<syntaxhighlight lang="lua">
int getObjectModel ( object theObject )
</syntaxhighlight>

===Required Arguments===
*'''theObject:''' The object which you wish to retrieve the model ID of

===Returns===
Returns an ''int'' with the object model id, or ''false'' if it isn't a valid object.

==Example==
This example destroys a haystack when a player targets it.
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( getElementType ( targetElem ) == "object" ) and ( getObjectModel ( targetElem ) == 3374 ) then
destroyElement ( targetElem )
end
end
addEventHandler ( "onPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>

This example outputs the model id of objects the player is targeting.
<syntaxhighlight lang="lua">
function onPlayerTargeted ( targetElem )
if ( getElementType ( targetElem ) == "object") then
outputChatBox ( getObjectModel(targetElem) )
end
end
addEventHandler ( "onPlayerTarget", getRootElement(), onPlayerTargeted )
</syntaxhighlight>

==See Also==
{{Object functions}}

User talk:Supervoltage

2008-11-14T21:26:01Z

Willy:

Ok this is the 3rd time i say this. I get an error. It says that the meta.xml file can't be found.Could someone help?

this isn't the place to be requesting help, http://forum.mtasa.com/ is.

User:Willy

2008-11-09T02:39:04Z

Willy: New page: Image:Failed.png

[[Image:Failed.png]]