Multi Theft Auto: Wiki - User contributions [en]

SetWorldSpecialPropertyEnabled

2015-07-09T19:11:13Z

Platin: /* Required Arguments */

__NOTOC__
{{Client function}}

Enables or disables a special world property (cheat).

==Syntax==
<syntaxhighlight lang="lua">bool setWorldSpecialPropertyEnabled ( string propname, bool enable )</syntaxhighlight>

===Required Arguments===
*'''propname:''' the name of the property to set. Possible values are:
**'''hovercars''' - equivalent of the JBGVNB cheat. The cars can be drived in the water.
**'''aircars''' - equivalent of the RIPAZHA cheat, and allows cars to fly.
**'''extrabunny''' - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher.
**'''extrajump''' - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher.
*'''enable:''' whether or not to enable the property.

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

==Example==

Function which allow cars to fly.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addEventHandler( "onClientResourceStart", resourceRoot,
function()
setWorldSpecialPropertyEnabled("aircars", true)
end
)
</syntaxhighlight>
</section>

'''Example 2:'''
Allow cars to drive on water.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addEventHandler( "onClientResourceStart", resourceRoot,
function()
setWorldSpecialPropertyEnabled("hovercars", true)
end
)</syntaxhighlight>
</section>

==See Also==
{{Client world functions}}

GetWeaponOwner

2015-05-20T16:16:12Z

Platin:

__NOTOC__
{{Client function}}
{{Needs_Example}}
This function gets the owner of a [[Element/Weapon|custom weapon]]. Weapon ownership system was, however, disabled, so this function always returns ''false''. Please refer to [[setWeaponOwner]] for details.

==Syntax==
<syntaxhighlight lang="lua">bool getWeaponOwner ( weapon theWeapon )</syntaxhighlight>
{{OOP|Pair is completely disabled at the moment (its value is ''[[nil]]'').|[[Element/Weapon|weapon]]:getOwner|owner|setWeaponOwner}}

===Required Arguments===
* '''theWeapon:''' The weapon to get the owner of.

===Returns===
This function was intended to return the [[player]] which owns the [[Element/Weapon|custom weapon]], and ''false'' if an error occured. However, at the moment it always returns ''false''.

==Example==
<syntaxhighlight lang="lua">function arma()
minigun = createWeapon("minigun", 1, 1, 3)--Create the weapon
setWeaponClipAmmo(minigun, 99999)
setWeaponState(minigun, "firing")
setWeaponProperty(minigun, "fire_rotation", 0, -30, 0)
dueno = getWeaponOwner(minigun)--This gets the owner
outputChatBox(tostring(dueno))--And this say it in the chatbox
end
addCommandHandler("weapon", arma)--CommandHandler</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3.0-9.04555|}}

==See also==
{{Client weapon creation functions}}

PlaySound

2015-05-18T08:07:50Z

Platin:

__NOTOC__
{{Client function}}
Crea un sonido (elemento) y lo reproduce inmediatamente después de la creación para el jugador local.<br />
<br />
'''Nota:''' Los únicos formatos de audio soportados son: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M y PLS(EJ: Webstream).
{{Nota|Para que los sonidos usados no den lag al usarse mucho (EJ: cuando disparas un arma), es recomendado que conviertas tu audio en 1 solo canal (mono) WAV con menos de 22050 Hz. También puede ayudar agregar un limitador de veces por X tiempo. EJ: 50ms.}}
==Syntax==
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>
{{New feature/item|3.0150|1.5||
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false, [ bool throttled = true ] ] )</syntaxhighlight>
}}
{{OOP||[[Sound]].create}}
===Required Arguments===
*'''soundPath:''' el archivo o el URL de la Radio o Sonido el cual quieres que se reproduzca. En caso de ser un archivo propio, deberá de ser marcado en [[meta.xml]]

===Argumentos Opcionales===
{{OptionalArg}}
*'''looped:''' Un [[boolean]] que representa si el sonido se repetirá infinitamente o no. Por defecto es ''false''
*'''throttled:''' a [[boolean]] representing whether the sound will be throttled. To throttle the sound, use ''true''. Sounds will be throttled per default and only for URLs.

===Returns===
Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sonidos/wasted.mp3") --Reproduce "wasted.mp3" de la carpeta de "sonidos"
setSoundVolume(sound, 0.5) -- set the sound volume to 50%
end

addEventHandler("onClientPlayerWasted", localPlayer, wasted) --añadimos el evento
</syntaxhighlight>

<syntaxhighlight lang="lua">
playSound("joinsound.mp3") -- Esto puede ser usado como bienvenida al servidor, puede ser una música o simplemente un audio diciendo "Bienvenido a nuestro servidor"
</syntaxhighlight>

==See Also==
{{Client_audio_functions}}
[[AR:playSound]]
[[DE:playSound]]

PlaySound

2015-05-18T08:04:50Z

Platin:

__NOTOC__
{{Client function}}
Crea un sonido (elemento) y lo reproduce inmediatamente después de la creación para el jugador local.<br />
<br />
'''Nota:''' Los únicos formatos de audio soportados son: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M y PLS(EJ: Webstream).
{{Nota|Para que los sonidos usados no den lag al usarse mucho (EJ: cuando disparas un arma), es recomendado que conviertas tu audio en 1 solo canal (mono) WAV con menos de 22050 Hz. También puede ayudar agregar un limitador de veces por X tiempo. EJ: 50ms.}}
==Syntax==
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>
{{New feature/item|3.0150|1.5||
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false, [ bool throttled = true ] ] )</syntaxhighlight>
}}
{{OOP||[[Sound]].create}}
===Required Arguments===
*'''soundPath:''' el archivo o el URL de la Radio o Sonido el cual quieres que se reproduzca. En caso de ser un archivo propio, deberá de ser marcado en [[meta.xml]]

===Argumentos Opcionales===
{{OptionalArg}}
*'''looped:''' Un [[boolean]] que representa si el sonido se repetirá infinitamente o no. Por defecto es ''false''
*'''throttled:''' a [[boolean]] representing whether the sound will be throttled. To throttle the sound, use ''true''. Sounds will be throttled per default and only for URLs.

===Returns===
Returns a [[sound]] [[element]] if the sound was successfully created, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
setSoundVolume(sound, 0.5) -- set the sound volume to 50%
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
</syntaxhighlight>

==See Also==
{{Client_audio_functions}}
[[AR:playSound]]
[[DE:playSound]]