Multi Theft Auto: Wiki - User contributions [en]

Timer

2012-05-27T05:26:44Z

Kzman: Added note

A [[timer]] object refers to a timer set to execute a function a certain number of times with a specified delay.

Note that after a timer has completed all its iterations, it is destroyed and any stored pointers to it become invalid. Also timers are not under the ''resource'' hierarchy, becouse they are not elements, for instance, if you create a timer, it will not be destroyed when the resource in which it was created is stopped, so in this case you should kill the timer manually.

==Related scripting functions==
* [[getTimers]]
* [[killTimer]]
* [[setTimer]]
* [[getTimerDetails]]

Database

2012-05-24T03:04:28Z

Kzman: Page about db files created. Please expand it

MTA uses a database system based on files. This system is sqlite, an embedded relational database management system.
==Files==
There are two main database files for storing data:
*'''internal.db:''' this contains user account data (usernames, passwords and account data stored by using the [[setAccountData]] and [[getAccountData]] functions.
*'''regystry.db:''' this is the main database file, all the executeSQL* scrtipting functions work with this file.
==Functions==
{{SQL_functions}}

How to repair the database files

2012-05-24T02:44:11Z

Kzman: Formatted

==You might be OK==
There might be nothing to worry about. Check these points:
* Did you come to this page because of a message you saw in the server console or logs?
* Is the following text at the start of the error message block?
ERROR: near "3": syntax error
* If so, then everything is OK. You don't have to do anything written below and you can safely ignore the error message.

==Warnings==
'''Backup all files before attempting a repair!'''
<br>
'''Shutdown the server before attempting a repair!'''

==Windows server==

===Easy way===
*Download [http://updatesa.mtasa.com/sa/files/sqlite/mtasa-db-repair-win.zip this]
*Unzip and put the files into ''server/mods/deathmatch/''
*Double click on ''sqlite_repair_internal_db.bat'' to repair internal.db
*Double click on ''sqlite_repair_registry_db.bat'' to repair registry.db

===Hard way===

*Download sqlite-shell-win32 from [http://www.sqlite.org/sqlite-shell-win32-x86-3070700.zip here]. If that link fails, the main download page is [http://www.sqlite.org/download.html here].
*Unzip and put sqlite3.exe into ''server/mods/deathmatch/''
*Open command prompt the change directory to ''server/mods/deathmatch/''
*To repair internal.db:
**Copy '''internal.db''' to '''internal_original.db'''
**Do this command: '''sqlite3.exe internal_original.db .dump | sqlite3.exe internal_repaired.db'''
**Copy '''internal_repaired.db''' to '''internal.db'''

*To repair registry.db:
**Copy '''registry.db''' to '''registry_original.db'''
**Do this command: '''sqlite3.exe registry_original.db .dump | sqlite3.exe registry_repaired.db'''
**Copy '''registry_repaired.db''' to '''registry.db'''

==Linux server==

===Only way===

*Download sqlite-shell-linux from [http://www.sqlite.org/sqlite-shell-linux-x86-3070700.zip here]. If that link fails, the main download page is [http://www.sqlite.org/download.html here].
*Unzip and put sqlite3 into ''server/mods/deathmatch/''
*To repair internal.db:
**Copy '''internal.db''' to '''internal_original.db'''
**Do this command: '''./sqlite3 internal_original.db .dump | ./sqlite3 internal_repaired.db'''
**Copy '''internal_repaired.db''' to '''internal.db'''

*To repair registry.db:
**Copy '''registry.db''' to '''registry_original.db'''
**Do this command: '''./sqlite3 registry_original.db .dump | ./sqlite3 registry_repaired.db'''
**Copy '''registry_repaired.db''' to '''registry.db'''

[[ru:How to repair the database files]]

ES/Manual del Servidor

2012-05-23T22:05:50Z

Kzman: /* Configurando un servidor web externo */

__TOC__

==Introducción==
Es mucho más fácil de lo que parece tener un servidor funcionando en Internet o en LAN. Lee este artículo y estarás listo para hospedar tu propio servidor de MTA:SA en poco tiempo.

==Instalando el servidor==
El servidor dedicado está disponible en diferentes distribuciones, dependiendo de la plataforma del equipo.
Si no seleccionaste "Dedicated Server" durante la instalación de MTA San Andreas, sigue estos pasos según tu sistema operativo:

===Linux===
*Opción 1: [[Building MTASA Server on GNU Linux|Compilar el servidor en Linux]]. [[Image:flag_us.png|En Inglés]]
*Opción 2: [http://linux.mtasa.com/ Usar un paquete ya compilado].

===Windows===
*Dirígete a la [http://mtasa.com/ página de MTA] y selecciona "Download".
*Abre el instalador una vez que se haya descargado.
*Sigue los pasos según se te indiquen, hasta que llegues al punto donde seleccionas los elementos a instalar.
*Asegúrate de que "Dedicated Server" está seleccionado.
*Por último, haz click en Install.

==Configuración==
El servidor Multi Theft Auto se puede configurar a través de la consola, desde el juego o desde una aplicación web. Para hacer uso de estos dos últimos, es necesario añadir un administrador en el archivo de configuración (acl.xml).

===General===
Todas las opciones de configuración están en el archivo ''mods/deathmatch/mtaserver.conf'' y puede ser abierto con cualquier editor de texto.

Cada variable tiene su propia descripción por lo que te será muy fácil configurar tu servidor.

===Redireccionamiento de puertos===
Si tienes tu servidor en tu propio computador, y tienes acceso a internet mediante un '''Router''', entonces necesitarás redireccionar 3 puertos.

Primero que todo, abre el archivo ''mods/deathmatch/mtaserver.conf'' y busca las siguientes líneas:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Los puertos son necesarios para configurar bien tu servidor. Explicaremos más adelante cómo configurarlos, pero primero, si quieres que tu servidor aparezca en la lista de servidores, necesitaremos otro puerto adicional; el ''puerto ASE''. Para habilitarlo, hay que usar esta línea:
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Ahora vamos a redireccionar los puertos del Router, (paso que no es necesario si tienes todos los puertos abiertos, o si no tienes un router con ''firewall''. Si es así, ignora esta parte).

Si no sabes cómo funciona el redireccionamiento de puertos en tu router, visita [http://www.portforward.com/ Port Forward], encuentra tu router y sigue las instrucciones en esa página.

En casi todos los routers puedes seleccionar el tipo de puerto: UDP o TCP.
La siguiente lista explica qué tipo de puerto se necesita y para qué:

Puerto principal del servidor: UDP

Puerto HTTP: TCP

Puerto ASE: UDP (es necesario si quieres que tu servidor aparezca en la lista de servidores)

El puerto ASE debe ser de la siguiente manera:

Puerto ASE = Puerto principal del servidor + 123

De esta manera, si el puerto principal de tu servidor es 22003, entonces el puerto ASE deberá ser 22126 (22003+123 = 22126).

Buena suerte!

===Comprobación de Cliente===

El servidor MTA se puede configurar para que sea deshabilitado el anti-cheat. También se puede permitir modificar archivos en especifico o todos los archivos (ej. carmods.dat), y asegura que los clientes tienen la versión mínima.

Toda esta configuración se encuentra dentro del archivo 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]'. Vea la [[Anti-cheat_guide|Guía Anti-cheat]] [[Image:flag_us.png|En Inglés|24px]] Para más detalles.<br/>

Si deseas obligar una versión mínima de cliente, busqua la siguiente linea:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Los valores aceptados tienen el siguiente formato: 1.1.1-9.02320

===Añadiendo administradores===
Es muy recomendable añadir por lo menos un administrador a tu servidor, para hacer uso de la aplicación web, donde se puede mantener y configurar tu servidor. Este administrador podrá también controlar el servidor desde el juego.

Para añadir un administrador al servidor, sigue los siguientes pasos:
<br>
<ol>
<li>Abre el archivo 'mods/deathmatch/'acl.xml'''' con cualquier editor de texto</li>
<li>Agrega la cuenta que creaste anteriormente al grupo ''Admin'' de la siguiente manera:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<ACL>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.NOMBRE" />
</group>
...
</ACL>
</syntaxhighlight>
</div>

Puedes agregar los usuarios a cualquier grupo. Cada grupo está relacionado con el ACL ([[Access Control List]]). Cada grupo de ACL tiene permisos específicos para realizar tareas. El grupo ''Everyone' apunta al ACL ''Default'', que impide a los jugadores normales ejecutar comandos de administradores, como bannear, kickear o mutear.
</li>
<li>
Si quieres, puedes agregar cuantos administradores y usuarios quieras, repitiendo estos pasos. También puedes revisar los otros grupos y ACL's. Se puede acceder al ACL también mediante el [[Access_Control_List#See_Also|Motor de Scripting de Lua]].
<br>

Se recomienda revisar también la interfaz web, más abajo en este artículo.
</li>
</ol>
'''Nota''': También se puede editar, agregar y crear cuentas mientras el servidor está prendido. "addaccount <user> <password>" es un comando interno que permite agregar cuentas, pero para relacionar esta cuenta con algún grupo del ACL debes usar la interfaz web.<br />

===Usando la interfaz web===
El servidor dedicado viene con unos resources que permiten tener una pequeña interfaz web para administrar el servidor. Se puede usar para agregar usuarios (cuentas), iniciar/detener resources y mucho más.

Los resources de interfaz web están activados por defecto y son servidos mediante el servidor web HTTP. Para asegurarte de que el servidor web HTTP corre en el puerto que quieres (22005 por defecto), sigue estos pasos:
<ol>
<li>Asegúrate de que tu servidor está apagado.
<li>Abre el archivo '''mods/deathmatch/mtaserver.conf''' con cualquier editor de texto.</li>
<li>Verifica que el servidor HTTP está activado:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Cambia el puerto HTTP al que quieras:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Cierra guarda el archivo.</li>
<li>Inicia tu servidor.</li>
<li>Asegúrate de que los siguientes resources están funcionando:

* ajax
* elementbrowser
* performancebrowser
* resourcebrowser
* resourcemanager
* webadmin
* webmap
* webstats

</li>
<li>Abre tu navegador web (Internet Explorer 6 y 7 NO están soportados: usa [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] u otro) y dirígete a la URL siguiente: '''http://ip:puerto_http/'''. Por ejemplo, si estás usando el servidor local en el puerto HTTP 22005, usa '''http://127.0.0.1:22005/'''.</li>
<li>Escribe el nombre y contraseña del administrador que creaste en la sección anterior.</li>
</ol>

<br />

Ahora puedes manejar tu servidor desde un navegador web.

=== Configurando un servidor web externo ===
El servidor web interno es capaz de enviar los archivos de ''resources'' que estén corriendo en tu servidor a cualquier jugador que esté conectado. Por ejemplo, si estás corriendo un script de juego con una GUI o modelos especiales (DFF), necesitan ser enviados al jugador para que funcionen. Esto se puede hacer con el servidor por defecto, o con un servidor web externo (el cual usualmente es más rápido, pero necesita ser configurado por separado).

Para un mejor rendimiento o por razones de consistencia durante el juego, puedes hacer uso de un servidor web externo, si es que ya tienes uno configurado. El servidor externo necesita ser de acceso público, para que los usuarios puedan descargar los archivos del lado del cliente necesarios y poder unirse a jugar en tu servidor.

Para habilitar la descarga a través de un servidor externo, debes activar la opción [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] en la configuración de tu servidor, de la siguiente forma:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownloadurl>http://www.miservidor.tld/directorio/aquí</httpdownloadurl>
</syntaxhighlight></div>

Ya que todos los ''resources'' por defecto que vienen con el servidor dedicado están comprimidos en zip, estos son extraídos automáticamente por el servidor web interno, entonces debes ofrecer una forma para que los clientes descarguen los archivos comprimidos a sus equipos. Para configurar MTA para que mantenga una copia solo de tus archivos no comprimidos, modifica el [[Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] en el archivo de configuración:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>

Ahora cuando inicies el servidor, el directorio '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' contendrá los archivos que debes subir al servidor web externo. Si el servidor está en la misma máquina, puedes simplemente crear un enlace en el directorio apropiado del servidor web que apunte hacia '''http-client-files'''. Si el servidor web está en otra máquina, debes asegurarte de que tenga acceso a tu '''http-client-files''' por medio de una ruta de red, o mantener una copia remota usando algún software de sincronización.

'''Nota 1''': Intenta evitar caracteres como "~" o "!" en las URL de descarga.<br />
'''Nota 2''': No termines la dirección web con un slash (por ejemplo, debe ser ''hxxp://www.myserver.tld/directory'' en vez de ''hxxp://www.myserver.tld/directory/'')

==Iniciando tu servidor==
Comienza asegurándote de que has terminado toda la configuración de tu servidor, iniciar tu servidor es la última etapa, así que ¡todo debe estar listo!

Para iniciar tu servidor haz doble clic sobre MTA Server.exe, asegúrate de que autorizaste pasar por todos los firewall y redirecctionaste los puertos donde era necesario.

==Instalando/Actualizando resources en tu servidor==
Los ''resources'' pueden venir en dos formatos, en formato ZIP o solo dentro de una carpeta con los archivos de script. El servidor MTA:SA soporta estos dos métodos.

# Mueve o copia el nuevo ''resource'' a tu carpeta <SERVER>\mods\deathmatch\resources .
# En la ventana del servidor escribe el comando [[Server_Commands#refresh|refresh]], el cual realizará un re-escaneo de la carpeta de ''resources'' y actualizará los recursos en ejecucion si fuese recesario.

==Desinstalando resources==
Los ''resources'' se desinstalan fácilmente quitándolos de tu servidor si ya no los quieres.

# Elimina el archivo ZIP o la carpeta del ''resource'' que deseas desinstalar.
# En la ventana del servidor escribe el comando "refresh" (sin las comillas), el cual realizará un re-escaneo de la carpeta de ''resources'' y actualizará los recursos en ejecucion si fuese recesario.
==Administrando tu servidor==
Para iniciar los ''resources'' solo debes teclear el comando "start nombreresource" en la consola del servidor, o detenerlos con "stop nombreresource".

También es posible ejecutar estos y otros comandos de admin desde la consola dentro del juego (la cual accedes con la tecla ` o F8); para que funcione, primero necesitas iniciar sesión con el comando "[[Server_Commands#login|login usuario contraseña]]". Además, si presionas la tecla p puedes acceder al panel de admin: es una interfaz gráfica la cual permite expulsar (kick) or banear jugadores problemáticos, entre otros.

Para más comandos, escribe [[Server_Commands#help|help]] en una consola.

==Iniciando un mapa o modo de juego==
Para mayor información, mira la sección de comandos en la documentation sobre [[Resource:Map manager|mapmanager]].

==Notas Útiles==

# Tambien se pueden actualizar los ''resources'' dentro del juego siempre que poseas los niveles de acceso correctos tecleando "refresh" en la consola de cliente o "/refresh" en la ventana de chat. Este acción puede producir un segundo de lag si tienes muchos ''resources''.
# En las intrucciones anteriormente vistas, <SERVER> es la ruta hacia el directorio principal de tu servidor. Generalmente este es C:\Program Files\MTA San Andreas\server
# Tambien puedes escoger un archivo de configuracion diferente para el servidor, para realizar esto debes pasar como argumento luego de un --config, p.ej. mtaserver.exe --config otroconfig.cfg.
# No te asustes si ves un warning regarding the parsing of the settings.xml file. Esto sucede porque la instalación tu servidor está limpia y sin uso.

====¿Necesitas más ayuda?====
Por qué no te acercas a nuestro foro [http://forum.mtasa.com/ Forums] o te unes a nuestro [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com mIRC]) [[Image:flag_us.png|En Inglés|24px]]

[[en:Deathmatch Server Manual]]
[[de:MTA DM Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Deathmatch Server Manual]]
[[ru:Deathmatch Server Manual]]
[[pl:Server Manual]]

Settings system

2012-05-22T02:21:56Z

Kzman:

__NOTOC__
The settings system allows you to store and retrieve settings for future use, or provide server administrators with an easy way to configure your resource without modifying any files.

Settings can be modified in two ways - either by scripts or by the server administrator using the console.

==Setting names==
Settings have a fairly simple naming system that allows you to specify the ''scope'' and ''access'' they provide.

Names are in the format:

[''access''][''resourceName''].''settingName''

Access modifiers:
* '''*''': ''public'' and can be read and written by any resource.
* '''#''': ''protected'' and can be read by any resource but only written by the resource they belong to.
* '''@''': ''private'' and can only be read and written to by the resource they belong to.
* None specified: ''private'' if it is a local setting, ''public'' if it's a global setting.

The ''resourceName'' is optional. If it isn't specified, then the setting is ''global''.

The ''settingName'' can be anything you want.

==Manager==
You can manage your settings with the default [[Resource:admin|admin]] manager resource. In addition you can add some attributes in a setting, which will be useful in the settings manager:
<syntaxhighlight lang="xml"><settings>
<setting name="*settingname" value="defValue" friendlyname="" group="" accept="" examples="" desc="" />
</settings></syntaxhighlight>
*'''Explanation:''' <small>TODO</small>

==Scripting functions==
There are two scripting functions in the setting system: [[set]] and [[get]].

==Console functions==
There are two console functions in the settings system:
{{Settings registry functions}}

Call

2012-05-20T22:10:16Z

Kzman: Adding code tag where necessary

__NOTOC__
{{Server client function}}
This function is used to call a function from another resource (which must be running).

The function which you wish to call '''must''' first be exported within the resource's meta. For example:
<syntaxhighlight lang="xml"><meta>
<info author="jbeta" type="script" description="Scoreboard resource" />
<script src="scoreboard_client.lua" type="client"/>
<script src="scoreboard_exports.lua" type="server"/>

<script src="scoreboard_http.lua" type="server"/>

<export function="getScoreboardColumns" http="true" />
<export function="getScoreboardRows" http="true" />

<export function="addScoreboardColumn" type="server"/>
<export function="removeScoreboardColumn" type="server"/>

<export function="setPlayerScoreboardForced" type="server"/>
<export function="setScoreboardForced" type="client"/>
</meta></syntaxhighlight>
This enables other resources to call a function from this resource.

You cannot call a server function from the client or vice versa. See [[triggerServerEvent]] and [[triggerClientEvent]] for possibilities to do that.

{{New feature|3|1.0|
There is an easier syntax replacing this function. For example, you can instead of:<br>
<syntaxhighlight lang="lua">call ( getResourceFromName ( "resource" ), "exportedFunction", 1, "2", "three" )</syntaxhighlight>
do much like a normal call:<br>
<syntaxhighlight lang="lua">exports.resource:exportedFunction ( 1, "2", "three" )</syntaxhighlight>
If the resource name contains illegal characters (such as hyphens), you can also do:<br>
<syntaxhighlight lang="lua">exports["resource-name"]:exportedFunction ( 1, "2", "three" )</syntaxhighlight>

When using the [[call]] function, two extra "hidden" variables are passed to the exported function:
* '''sourceResource''' - The resource that called the exported function
* '''sourceResourceRoot''' - The resource root element of the resource which called the exported function.
}}

==Syntax==
<syntaxhighlight lang="lua">
var... call ( resource theResource, string theFunction, [ arguments... ] )
</syntaxhighlight>

===Required Arguments===
*'''theResource:''' This is a resource pointer which refers to the resource you are calling a function from.
*'''theFunction:''' This is a string with the name of the function which you want to call.

===Optional Arguments===
{{OptionalArg}}
*'''arguments:''' Any arguments you may want to pass to the function when it is called. Any number of arguments of can be specified, each being passed to the designated function.

===Returns===
Returns anything that the designated function has returned appropriately. If the function does not exist, is not exported, or the call was not successful it will return ''nil''.

==Example==
<section name="Server" class="server" show="true">
This extract shows adding of a "kills" column to the scoreboard resource. This then sets the ''gameShowKills'' variable to true, telling the rest of the script to start outputting kills.

<syntaxhighlight lang="lua">
function showKills ( option )
if option == false then
-- Remove the "kills" column
gameShowKills = false
call(getResourceFromName("scoreboard"), "removeScoreboardColumn", "kills")
else
-- Add the "kills" column
gameShowKills = true
call(getResourceFromName("scoreboard"), "addScoreboardColumn", "kills")
outputDebugString ( "Showing kills now..." )
end
end
</syntaxhighlight>
</section>

==See Also==
{{Resource_functions}}

ES/callServerFunction

2012-05-19T05:55:45Z

Kzman: Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ {{Note_box|Se recomienda encerecidamente que valides la funcion que está siendo llamada o potencialmente un cliente puede hacer l..."

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
{{Note_box|Se recomienda encerecidamente que valides la funcion que está siendo llamada o potencialmente un cliente puede hacer lo que quiera con tu servidor - banear jugadores, agregarse a sí mismo como admin (dependiende de que tan bien estén configuradas las ACL ) etc. Por esta razón es que esta función no viene incluida dentro de MTA.}}
Esta funcion te permite llamar cualquier funcion de servidor desde el lado del cliente. Obviamente solo aquellas que están disponibles del lado del servidor. No importa si es una funcion MTA, una funcion estándar Lua o una funcion creada.
<br /><br />
Los numeros se convierten automáticamente a string y vice versa en el servidor para evitar pérdida de datos. Si no necesitas esta caracterñistica, solo elimínala.
<br /><br />
'''Nota Importante:''' Ten presente que ¡el nombre de la función debe ser un '''string'''!

==Sintaxis==
<syntaxhighlight lang="lua">void callServerFunction( string funcname, [ var arg1, ... ] )</syntaxhighlight>

===Argumentos Requeridos===
* '''funcname''': El nombre de la funcion de servidor que será llamada. Tambien puede ser una funcion dentro de una tabla, p.ej. "math.round".

===Argumentos Opcionales===
{{ArgOpcionales}}
* '''arg1-argn''': The arguments that should be passed to the function.

==Código==
<section name="Clientside Script" class="client" show="true">
<syntaxhighlight lang="lua">
function callServerFunction(funcname, ...)
local arg = { ... }
if (arg[1]) then
for key, value in next, arg do
if (type(value) == "number") then arg[key] = tostring(value) end
end
end
-- Si el controlador de eventos en el servidor no está dentro de mismo resource, reemplaza 'resourceRoot' con el elemento apropiado
triggerServerEvent("onClientCallsServerFunction", resourceRoot , funcname, unpack(arg))
end
</syntaxhighlight>
</section>
<section name="Serverside Script" class="server" show="true">
<syntaxhighlight lang="lua">
function callServerFunction(funcname, ...)
local arg = { ... }
if (arg[1]) then
for key, value in next, arg do arg[key] = tonumber(value) or value end
end
loadstring("return "..funcname)()(unpack(arg))
end
addEvent("onClientCallsServerFunction", true)
addEventHandler("onClientCallsServerFunction", resourceRoot , callServerFunction)
</syntaxhighlight>
</section>

==Ejemplo==
<section name="Cliente" class="client" show="true">
En este ejemplo se quitan a los jugaores de su equipo.
<syntaxhighlight lang="lua">
-- obtiene el elemento de jugador local
local _local = getLocalPlayer()
-- define el la funcion del controlador de comandos
function cmdLeaveTeam()
-- establece el equipo del jugador a nil
callServerFunction("setPlayerTeam", _local)
end
-- y en controlador de eme
addCommandHandler("leaveTeam", cmdLeaveTeam, false)
</syntaxhighlight>
</section>

==Vea También==
{{Funciones Útiles}}
[[en:callServerFunction]]

Template:Funciones Útiles

2012-05-19T05:54:31Z

Kzman:

{{Needs_Checking|The function I added at the bottom should be scripted by someone. --[[User:Ransom|Ransom]] 21:45, 2 May 2012 (UTC)}}

*[[ES/callClientFunction|callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función permite llamar cualquier función del lado del cliente desde el lado del servidor.</span>

*[[ES/callServerFunction|callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función permite llamar cualquier función del lado del servidor desde el lado del cliente.</span>

*[[ES/centerWindow|centerWindow]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función centra la ventana en cualquier resolución.</span>

*[[ES/Check|Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta funcion verifica si sus argumentos son de los tipos correctos y llama la función error si uno no lo es.</span>

*[[ES/coroutine.resume|coroutine.resume]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Fix for hidden coroutine error messages</span>

*[[ES/doForAllElements|doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función puede ser usada para ejecutar una funcion especifica para todos los elementos de un tipo especifico.</span>

*[[ES/dxDrawColorText|dxDrawColorText]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función dibuja un texto dx con soporte para códigos de color #RRGGBB.</span>

*[[ES/findRotation|findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Toma dos puntos y devuelve la dirección del punto A al punto B.</span>

*[[ES/FormatDate|FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formatea una fecha sobre la basándose en una cadena de formato y la devuelve.</span>

*[[ES/getAge|getAge]] <span style="color:gray; font-family:'Georgia', sans-serif; font-size:smaller;">» Esta función la edad según el cumpleaños.</span>

*[[ES/getAlivePlayersInTeam|getAlivePlayersInTeam]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función devuelve una tabla de los jugadores vivos en un equipo.</span>

*[[ES/getCursorMoveOn|getCursorMoveOn]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función verifica de que forma se está moviendo el cursor actualmente.</span>

*[[ES/getElementSpeed|getElementSpeed]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función permite obtener la velocidad del elemento en unidades de kph o mph.</span>

*[[ES/getPlayerFromNamePart|getPlayerFromNamePart]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función permite obtener al jugador a partir de una parte de su nombre.</span>

*[[ES/getPointFromDistanceRotation|getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»Encuentra un punto basado en su punto inicial, dirección y distancia.</span>

*[[ES/getResourceSettings|getResourceSettings]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función devuelve una tabla con los datos del resource.</span>

*[[ES/getTimestamp|getTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Con esta funcion se puede obtener la [http://es.wikipedia.org/wiki/Tiempo_Unix marca de Tiempo Unix].</span>

*[[ES/IfElse|IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Devuelve uno de dos valores basado en una expresión booleana.</span>

*[[ES/isLeapYear|isLeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Comprueba si año proporcionado es bisiesto.</span>

*[[ES/iterElements|iterElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Devuelve un iterador para tus bucles, ahorrando tiempo en escribir ipairs( getElementsByType( type ) ), en lugar de eso escribes: iterElements( type ).</span>

*[[ES/math.round|math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»Redondea un número mientras pueden establecerce el numero de decimales y el método.</span>

*[[ES/onVehicleWeaponFire|onVehicleWeaponFire]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Este código implementa un evento que provocado cuando un jugador en un vehículo dispara un arma del vehículo.</span>

*[[ES/RGBToHex|RGBToHex]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta funcion devuelve un string que representa el color en hexadecimal.</span>

*[[ES/setElementSpeed|setElementSpeed]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta funcio permite establecer la velocidad de movimiento de un elemento en unidades de kph o mph.</span>

*[[ES/setTableProtected|setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protege una table y la hace de solo lectura.</span>

*[[ES/setVehicleGravityPoint|setVehicleGravityPoint]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función del lado del cliente establece una gravedad de vehiculo en la dirección de una coordenada tridimensional con la fuerza especificada.</span>

*[[ES/string.explode|string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función divide un string con un patrón separador dado y devuelve una tabla con las partes.</span>

*[[ES/table.copy|table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función copia una tabla completa y todas las tablas dentro de ella.</span>

*[[ES/table.map|table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función recorre una tabla y reemplaza cada campo con lo que devuelva la función que es pasada, donde los valores de campo son pasados como primer argumento y opcionalmente más argumentos.</span>

*[[ES/table.size|table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Encuentra el tamaño completo de una tabla.</span>

*[[ES/toHex|toHex]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función convierte un número decimal a un número hexadecimal, como una corrección para el lado del cliente.</span>

*[[ES/var_dump|var_dump]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función entrega información acerca de una o más variables usando outputConsole(). </span>

*[[ES/multi_check|multi_check]] <span style="color: gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función comprueba de de uno a varios elementos, util y limpia. </span>

*[[ES/isElementInPhotograph|isElementInPhotograph]] <span style="color: gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Esta función comprueba si un elemento estuvo en la foto de cámara de un jugador. Necesita se escrita aun. --[[User:Ransom|Ransom]] 21:45, 2 May 2012 (UTC) </span>

[[Category:Useful Functions]]

Template:ArgOpcionales

2012-05-19T05:44:07Z

Kzman: Created page with "''NOTA:'' cuando se usan argumentos opcionales, debes poporcionar all arguments antes del que deseas usar. For more information on optional arguments, mira los [[ES/Argumentos Op..."

''NOTA:'' cuando se usan argumentos opcionales, debes poporcionar all arguments antes del que deseas usar. For more information on optional arguments, mira los [[ES/Argumentos Opcionales|Argumentos Opcionales]].

ES/Argumentos Opcionales

2012-05-19T05:34:30Z

Kzman: Created page with "Los '''Argumentos Opcionales''' son argumentos que son pasados a una funcion pero no son requeridos para que la funcion se ejecute. Generalmente, si no los especifican, de usará..."

Los '''Argumentos Opcionales''' son argumentos que son pasados a una funcion pero no son requeridos para que la funcion se ejecute. Generalmente, si no los especifican, de usarán los valores por defecto.

Cuando miras la Sintaxis para un argumento, los argumentos Opcionales siempre están encerrados entre parantesis cuadrados.

Ejemplo:
<syntaxhighlight lang="lua">createVehicle ( int model, float x, float y, float z, [ float rx, float ry, float rz ] )</syntaxhighlight>

En este ejemplo, '''rx''', '''ry''', y'''rz''' son '''Argumentos Opcionales'''.

==Usando Argumentos Opcionales==

Los '''Argumentos Opcionales''' tienen una limitación. No puedes usar ningún argumento opcional sin que ''sean proporcionados todos los argumentos.''

Esto significa que, siguiendo el ejemplo anterior, si quisieras proporcionar '''rz''', tambien necesitarías proporcionar '''rx''', y '''ry''' ''en orden.''

[[Category:Scripting Concepts]]
[[en:Optional Arguments]]
[[pl:Argumenty opcjonalne]]
[[ru:Optional Arguments]]

Useful Functions

2012-05-19T04:59:25Z

Kzman: Added interwiki (ES)

<pageclass class="#228B22"></pageclass>

This page lists functions that are not included in the server or the client, but are still useful.
<br/><br/>
{{Useful_Functions}}
<br/><br/>
[[ES:Funciones Útiles]]

Funciones Útiles

2012-05-19T04:57:25Z

Kzman: moved Funciones Útiles to ES/Funciones Útiles: following the format

#REDIRECT [[ES/Funciones Útiles]]

ES/Funciones Útiles

2012-05-19T04:57:25Z

Kzman: moved Funciones Útiles to ES/Funciones Útiles: following the format

<pageclass class="#228B22"></pageclass>

Esta pagina contiene una lista de las functiones que no están incluidas como de servidor or de client, pero siguen siendo útiles.
<br/><br/>
{{Funciones Útiles}}
<br/><br/>

IsTrainDerailable

2012-05-15T02:33:08Z

Kzman: Example added

__NOTOC__
{{Server client function}}
This function will check if a train or tram is derailable.

==Syntax==
<syntaxhighlight lang="lua">
bool isTrainDerailable ( vehicle vehicleToCheck )
</syntaxhighlight>

===Required Arguments===
*'''vehicleToCheck:''' The vehicle you wish to check.

===Returns===
Returns ''true'' if the train is derailable, ''false'' otherwise.

==Example==
This example outputs to the player if the train which he's entered is derrailable or not
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
trainModels = { 449, 537, 538, 570, 569, 590 }
lp = getLocalPlayer()
function playerEntered(theVehicle)
for i,v in ipairs(trainModels) do
if getElementModel(theVehicle) == v then
if isTrainDerailable(theVehicle) then
outputChatBox("Warning: this train could be derailed.")
return
else
outputChatBox("This train is safe.")
end
end
end
end

addEventHandler("onClientPlayerVehicleEnter", getRootElement(), playerEntered)
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

Element tree

2012-05-14T20:58:45Z

Kzman: Added interwiki (ES)

[[File:Tre.png|frame|Element tree]]
MTA uses a so-called ''element tree'' to store all the elements that exist on the server and the client. This is directly related to the set of running [[resources]] and their map files' XML layout, although it can be changed at run-time by scripts.

If you are familiar with the concept of ''trees'' in computer-science, this should be easy to understand. If you are not, think of it like a family tree - except everyone only has a single parent. Every [[element]] has a ''parent'' element.

All elements that are created within scripts or from .map files are child elements of the resource they belong to. Thus, most elements (except for [[client]]s) exist only within resources and are also destroyed as soon as their resource is stopped.

==Tree elements==
* '''root''': This is at the very base of the tree - all elements are children (or descendants) of this element.
* '''resource''': These are direct children of the root element - with one for each ''running'' resource. This element is called the ''resource root''. Its ID holds the name of the resource.
* '''map''': Each resource element contains at least one map element, representing either a ".map" file in the resource or the one containing the elements created by scripts (this is called the ''dynamic'' map). Their IDs contain the maps' filenames, or ''dynamic'' for the dynamic map.
** Map files can contain a number of other [[element]]s as well as an unlimited number of custom elements.

==Example==
This in an example of a serverside tree dumped to XML from a running server.
''Please note that it is shortened on some places for the sake of overview.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explanation===
This tree consists of a number of resource root elements, the [[Element/Console|server console]] and two [[player]] elements, that are direct children of the '''root''' element. All these resources have a ''dynamic map'' as child element (it is just not shown for most of them). These contain the elements that are created dynamically by this resource using scripts, for example a [[vehicle]]. If the resource has a map file, it is also a child element, itself containing all the elements in the .map file.

Let's have a closer look at the '''assault''' resource: This contains just one ''dynamic'' map that has 2 teams, 3 blips, 1 marker and 1 colshape as child elements. These are the elements that are created by the script, for example the marker, the colshape and one of the blips are probably used for the objective.

The '''as-farm''' resource's function on the contrary is to be a map for the '''assault''' gamemode. The dynamic map is empty (it could contain elements if there was a script in it though), while there is a map called 'as-farm.map', that contains a number of elements. These are mostly custom elements (like spawngroup, spawnarea, objective) but also a few elements that MTA creates automactically after loading the map (like pickup). In the brackets after the element type, you can see the element data it contains. These are identical with the attributes the .map file contains within these elements, while you can also set and get element data for any other elements (e.g. players) with [[setElementData]] and [[getElementData]].

==Pratical application==
Elements can have as many children as they like. This does not directly affect the map in any way, but it comes in to its own when combined with the scripting system.

===Setting data for elements===
If you call a set... function on a node of the element tree, the function will affect every element within it (that it can work on).

So, the following code would set the size of every marker (the only type of element the setMarkerSize function can work on) that is below the root element to ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( getRootElement(), 2.5 )
</syntaxhighlight>

The same can be done on any element, it is not restricted to the root element.

===Map manager===
The [[#Example|example above]] shows the way the [[map manager]] uses different resources. The 'assault' resource is the gamemode, that manages what happens on the server using scripts and thus by creating elements in the tree dynamically. When a map resource is started, the gamemode receives a [[resource|resource pointer]] referring to the started resource - in this case ''as-farm'' - from which you can retrieve and store the resource root element. Using this element in conjunction with functions like [[getElementsByType]], [[getElementData]] and various others, you can access any of the information that was loaded into the tree from the 'as-farm.map'-file through scripts in the gamemode resource.

Another thing that has to be considered related to the tree of elements is the fact that when you change the map, you don't have to remove any elements you created within the map resource, while you '''do''' have to remove elements that are created within the gamemode resource, '''if''' they are specific to the map (which will be probably the case for those items you create based on information read from the map resource's .map files).

==Element browser==
You can start the resource ''elementbrowser'' to see a live view of the element tree on your server. Just start the resource and browser to your server's web page and choose the ''Element browser'' option in the sidebar (firefox only currently).
[[Category:Scripting Concepts]]
[[es:Árbol de elementos]]

ES/Árbol de elementos

2012-05-14T20:58:44Z

Kzman: Translating

[[File:Tre.png|frame|Árbol de elementos (En inglés)]]
MTA usa un llamado ''árbol de elementos'' para almacenar todos los elementos que existen en el servidor y en el cliente. Esto está directamente relacionado con los [[resources]] y el diseño de los archivos de mapa XML, aunque se puede cambiar mediante scripts mientras se ejecuta.

Si conoces el concepto de ''árboles'' en computación, deberías entenderlo fácilmente. Si no, piensa que es un árbol genealógico o familiar - solo que todos tienen un solo padre. Cada [[ES/elemento|elemento]] tiene un elemento ''padre''.

Todos los elementos creados dentro de un script o desde un archivo .map son elementos hijos del resource al que pertenecen. Por esta razón, la mayor parte de los elementos (excepto para los [[ES/cliente|clientes]]) existen solo dentro de los resources y además son destruidos tan pronto como el resource es detenido.

==Elementos de árbol==
* '''raíz''' o '''root''': Es la base de todo el árbol - todos los elementos son hijos (o descendientes) de este elemento.
* '''resource''': Son hijos directos del elemento raíz - con uno por cada resource que se está ''ejecutando''. Este elemento es llamado la ''raíz del resource''. Su ID siguen con el mismo nombre del resource.
* '''map''' o '''mapa''': Cada elemento resource contiene por lo menos un elemento mapa que puede representar un archivo ".map" dentro del resource o el que contiene los elementos creados por los scripts (que es llamado el mapa ''dinámico''). Sus IDs contienen los nombres de los archivos de mapa, o ''dynamic'' para el mapa dinámico.
** Los archivos de mapa también puede contener otros [[ES/elemento|elementos]] así como también una cantidad ilimitada de elementos personalizados.

==Ejemplo==
Este es un ejemplo de un árbol del lado del servidor volcado a un XML de un servidor en ejecución.
''El archivo se encuentra acortado en ciertos lugaras por razones de espacio.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explicación===
Este árbol consiste en una cantidad de elementos raíz de un resource, la [[Element/Console|consola del servidor]] y dos elementos [[ES/jugador|jugador]], que son hijos directos del elemento '''raíz''' (o ''root element''). Todos estos resources tienen un ''mapa dinámico'' como elemento hijo (que no se muestra completamente). Estos contienen los elementos que son creados dinámicamente por este resource usando scripts, por ejemplo un [[ES/vehículo|vehículo]]. Si el resource tiene un archivo de mapa, este también sería un elemento hijo, por si mismo contiene todos los elementos dentro del archivo .map.

Centremos la mirada en el resource '''assault''': Este contiene solo un mapa ''dinámico'' que tiene 2 equipos, 3 blips (puntos en el radar), 1 marcador y 1 figura de choque (colshape) como elementos hijos. Estos son los elementos creados por el script, por ejemplo el marcador, la figura de choque y uno de los blips son usados probablemente para el objetivo.

La funcion del resource '''as-farm''' del lado contrario está para ser un mapa para el modo de juego '''assault'''. El mapa dinámico está vacío (podría contener elementos si hubiese un script dentro de él), mientras hay un mapa llamado 'as-farm.map', que contene cierto número de elementos. Mayoritariamente hay elementos personalizados (como spawngroup, spawnarea, objective) pero tambien hay ciertos elementos que MTA crea automáticamente lusgo de cargar el mapa (como un pickup). Dentro de los paréntesis, después del tipo de elemento, se pueden apreciar los datos que contiene, los cuales son idénticos a los atributos que el archivo .map contiene dentro de estos elementos, mientras que puedes ajustar y obtener datos de de cualquier otro elemento (p.el. jugadores) con [[ES/setElementData|setElementData]] and [[ES/getElementData|getElementData]].

==Aplicación práctica==
Los elementos pueden tener tantos hijos como se deseen. Esto no afecta directamente al mapa mapa de ninguna forma, sin embargo cuando se combina con el sistema de scripts puede suceder.

===Estableciendo datos para los elementos===
Si llamamos una función set... en un nodo del árbol de elementos, la función afectará a cada elemento dentro de este (si es aplicable).

Así, el siguiente código debería establecer el tamaño de cada marcador (que es el único elemento con el que funciona la función setMarkerSize) que está bajo el elemento raíz en ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( getRootElement(), 2.5 )
</syntaxhighlight>

The same can be done on any element, it is not restricted to the root element.

===El Mapmanager===
El [[#Ejemplo|ejemplo anterior]] la manera en que el [[mapmanager]] usa diferentes resources. El resource 'assault' es el modo de juego, que controla lo que sucede en el servidor usando scripts y por tanto creando elementos en el árbol dinámicamente. Cuando se inicia un resource de mapa, el modo de juego recibe un [[resource|puntero hacia el resource]] haciendo referencia al resource iniciado - en este caso es ''as-farm'' - desde el cual se pueden recuperar y almacenar elementos raíces de resources. Usar este elemento en conjunto con funciones como [[ES/getElementsByType|getElementsByType]], [[ES/getElementData|getElementData]] y muchas otras, puedes acceder a toda la información que fue cargada dentro del árbol desde el archivo 'as-farm.map' por medio de scripts en el resource de modo de juego.

Otro asunto a considerar relacionado con el árbol de elementos es el hecho de que cuando cambias el mapa, no debes quitar ningún elemento que hayas creado dentro del resource de mapa, mientras que '''sí''' tienes que quitar los elementos que son creados dentro del resource de modo de juego, '''si y solo si''' son específicos para el mapa (el cual será probablemente el caso en el que esos items que creaste estén basados en información que lean desde el archivo .map del resource de mapa).

==Navegador de elementos==
Puedes iniciar el resource ''elementbrowser'' para obtener una visión actual del árbol de elementos de tu servidor. Basta con iniciar el resource y navegar por la página web de tu servidor y elegir la opción ''Element browser'' en la barra lateral.
[[Category:Scripting Concepts]]
[[en:Element tree]]

ES/Página Principal

2012-05-14T19:22:24Z

Kzman: Fixed FAQ link

__NOTOC__
__NOEDITSECTION__
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 120px;">
[[File:Mtalogo.png|left|100px]]'''Bienvenid@ a la Wiki de Multi Theft Auto: San Andreas en español.''' Aquí puedes encontrar mucha información sobre el uso de Multi Theft Auto.

Hay muchas [[ES/Cómo puedes ayudar|cosas que puedes hacer para ayudarnos]] a mejorar MTA - crea un mapa, un modo de juego, escribe códigos de ejemplo, tutoriales, traduce páginas del inglés al español, o simplemente juega y reporta los bugs que encuentres.
<br><br>''Stop playing with yourself''
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
=== Jugando ===
<div style="background: #FFEEAA;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Descargar Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[ES/Manual del Cliente|Manual del Cliente]] [[Image:flag_es.png|En Español|20px]]
* [[Changes_in_1.1|Cambios de la versión 1.1]] [[Image:flag_us.png|En Inglés|20px]]
* [[ES/Problemas_Conocidos_-_FAQ|Problemas Conocidos]] [[Image:flag_es.png|En Español|20px]] (Traducción: 10%)
* [[Upgrading_from_MTA:Race|Cambiando MTA:Race a MTA:SA 1.0.x]] [[Image:flag_us.png|En Inglés|20px]]
* [[ES/Manual del Servidor|Manual del Servidor]] [[Image:flag_es.png|En Español|20px]] (Traducción: 90%)
* [[Map_manager|El Resource "Map Manager"]] [[Image:flag_us.png|En Inglés|20px]]

====Editor de Mapas====
*[[ES/Resource:Editor|Manual del Editor]] [[Image:flag_es.png|En Español|20px]]
*[[Resource:Editor/EDF|EDF: Formato de Definiciones del Editor]] [[Image:flag_us.png|En Inglés|20px]]
*[[Resource:Editor/Plugins|Plugins para el Editor]] [[Image:flag_us.png|En Inglés|20px]]
*[[ES/Resource:Editor#Preguntas_Frecuentes|Preguntas Frecuentes]] [[Image:flag_es.png|En Español|20px]]

====Bases de Datos====
* [[:Category:Resource|Catálogo de Resources]] [[Image:flag_us.png|En Inglés|20px]]
* [[ES/Scripts de Cliente|Scripts de Cliente]] [[Image:flag_es.png|En Español|20px]]
* [[Modules| Módulos]] [[Image:flag_us.png|En Inglés|20px]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎]]</div>
====Desarrollando Multi Theft Auto====
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compilando MTA:SA en Windows]] [[Image:flag_us.png|En Inglés|20px]]
* [[Building_MTASA_Server_on_Mac_OS_X|Compilando MTA:SA en Mac OS X]] [[Image:flag_us.png|En Inglés|20px]]
* [[Building_MTASA_Server_on_GNU_Linux|Compilando MTA:SA en GNU/Linux]] [[Image:flag_us.png|En Inglés|20px]]
* [[Coding guidelines|Guías de Codificación]] [[Image:flag_us.png|En Inglés|20px]]
* [http://code.google.com/p/mtasa-blue Google Code SVN] [[Image:flag_us.png|En Inglés|20px]]
* [http://bugs.mtasa.com/roadmap_page.php Seguimiento de Versiones] [[Image:flag_us.png|En Inglés|20px]]
* [http://bugs.mtasa.com/ Central de Reportes de Bugs] [[Image:flag_us.png|En Inglés|20px]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png‎]]</div>
===Wiki - Cómo puedes ayudar===
* Termina la documentación para [[:Category:Incomplete|funciones incompletas]].
* [[:Category:Needs_Example|Crea ejemplos para eventos y funciones]].
* Revisa y verifica [[:Category:Needs Checking|páginas que necesitan revisión]].
* Escribe tutoriales para ayudar a la gente.
* Traduce las páginas del wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎]]</div>
=== Comunidad ===
* [http://forum.multitheftauto.com/ Foro] [[Image:flag_us.png|En Inglés|20px]]
** [http://forum.multitheftauto.com/viewforum.php?f=122&sid=72be1c29dd00c4442f8112cc09818283 Sección en español] [[Image:flag_es.png|En Español|20px]]
* [irc://irc.multitheftauto.com/mta Canal IRC] [[Image:flag_us.png|En Inglés|20px]]
* [http://community.mtasa.com/ Comunidad MTA] [[Image:flag_us.png|En Inglés|20px]]
* [http://www.youtube.com/user/MTAQA Canal de YouTube oficial] [[Image:flag_us.png|En Inglés|20px]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px; text-align:center">
[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' es un '''Proyecto Open Source'''.
¡Todos podemos contribuir a mejorar Multi Theft Auto!
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png]]</div>
=== Scripting ===
* [[ES/Resources|Introducción a los Resources]] [[Image:flag_es.png|En Español|20px]]
** [[Resource Web Access|Acceso Web con Resources]] [[Image:flag_us.png|En Inglés|20px]]
** [[Meta.xml|Sobre el archivo "meta.xml"]] [[Image:flag_us.png|En Inglés|20px]]
** [[:Category:Resource|Catálogo de Resources]] [[Image:flag_us.png|En Inglés|20px]]
** [[ACL]] [[Image:flag_us.png|En Inglés|20px]]
* [[ES/Introducción a Lua|Introducción a Lua]] [[Image:flag_es.png|En Español|20px]] (Traducción: 70%)
** [[ES/Introducción a la Programación de GUI|Introducción al GUI]] [[Image:flag_es.png|En Español|20px]] (Traducción: 40%)
** [[Debugging|Tutorial de Depuración]] [[Image:flag_us.png|En Inglés|20px]] - Encontrar errores en scripts.
* [[Useful_Functions| Funciones útiles]] [[Image:flag_us.png|En Inglés|20px]]
* [[Writing_Gamemodes|Escribiendo Modos de Juego]] [[Image:flag_us.png|En Inglés|20px]]
====Ayuda General de Lua====
*[http://www.lua.org/manual/5.1/es/manual.html Manual de Referencia de Lua 5.1] [[Image:flag_es.png|En Español|20px]]
*[http://www.lua.org/pil/index.html Manual Programando en Lua] [[Image:flag_us.png|En Inglés|20px]]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki] [[Image:flag_us.png|En Inglés|20px]]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Guía general de Lua de Nixstaller] [[Image:flag_us.png|En Inglés|20px]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Referencia====
* [[Client Scripting Functions|Funciones de Cliente]] [[Image:flag_us.png|En Inglés|20px]]
* [[Client Scripting Events|Eventos de Cliente]] [[Image:flag_us.png|En Inglés|20px]]
* [[ES/Funciones de Servidor|Funciones de Servidor]] [[Image:flag_es.png|En Español|20px]]
* [[Server Scripting Events|Eventos de Servidor]] [[Image:flag_us.png|En Inglés|20px]]

* [[ES/Clases MTA| Clases de MTA]] [[Image:flag_es.png|En Español|20px]]
**[[Element tree| Árbol de Elementos]] [[Image:flag_us.png|En Inglés|20px]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png]]</div>
====[[Id|Lista de ID's]]====
*[[Animations|Animaciones]]
*[[ES/Skins de Personajes|Skins]]
*[[CJ_Clothes|Ropa]]
*[[Garage|Garajes]]
*[[Interior IDs|Interiores]]
*[[Projectiles|Proyectiles]]
*[[Radar Blips|Iconos de Radar]]
*[[Sounds|Sonidos]]
*[[Vehicle IDs|ID's de Vehículos]]
*[[Vehicle Colors|Colores de Vehículos]]
*[[Vehicle Upgrades|Mejoras de Vehículos]]
*[[Weapons|Armas]]
*[[ES/Climas|Climas]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Equipo de Traducción====
* [mailto:zorrigas@gtagamingchile.com zorrigas@gtagamingchile.com]<br>
* [mailto:Brijido_XD@hotmail.com Brijido_XD@hotmail.com]<br>
* Benxamix2/The Kid
* [mailto:matiuno@gmail.com matiuno@gmail.com]<br>
* [mailto:cesarcastillo4@gmail.com cesarcastillo4@gmail.com]<br>
* [mailto:alex_firexx@hotmail.com alex_firexx@hotmail.com]<br>
* [mailto:carlos_olivo@msn.com carlos_olivo@msn.com]<br>
<br>
'''¡NO ELIMINES CONTENIDO SIN AUTORIZACIÓN!'''<br> Tampoco uses modismos, usa el Castellano (Internacional), y trata de que al traducir todo quede tan claro como puedas, y la ortografía sea la mejor posible.
</div>
|-
| colspan="2" |
|}
{{Languages list|es}}

ES/Funciones de Servidor

2012-05-14T03:01:08Z

Kzman: /* Funciones de Eventos */

<pageclass class="server"></pageclass>
Esta página muestra todas las funciones de '''servidor''' que han sido implementadas y están disponibles como funciones nativas. Para pedir que se cree alguna función o un evento, visita el artículo oficial de [[Requested Functions and Events|Pedido de Funciones y Eventos]] o http://bugs.mtasa.com.

Ten en cuenta que las funciones se pueden también extender cargando un modulo dinámico que entregue una nueva funcionalidad, como la base de datos MySQL. Estas funciones no son nativas y requieren que el módulo esté cargado para funcionar.

Véase [[Modules|Módulos]] para una lista de funciones de servidor no-nativas y módulos que están disponibles.

Para las funciones de utilidad no-nativas hechas por usuarios de MTA, revisa la página de [[Useful_Functions|Funciones Útiles]].

'''Las funciones de cliente se pueden encontrar en el artículo sobre [[Client Scripting Functions|Funciones de cliente]].'''

'''También ten en cuenta que casi todas las funciones presentes no presentan una traducción en su definición'''

==Funciones de Cuenta==
{{Funciones_de_Cuenta}}

==Funciones de ACL==
{{Funciones_de_ACL}}

==Funciones Administrativas==
{{Funciones_Administrativas}}

==Funciones de Audio==
{{Audio_functions}}

==Funciones de Anuncios==
{{Announce_functions}}

==Funciones de Íconos de Radar (Blip)==
{{Blip_functions}}

==Funciones de Cámara==
{{Camera functions}}

==Funciones de Objetos de Colisión==
{{Collision shape functions}}

==Funciones de Ropa y Cuerpo==
{{Clothes and body functions}}

==Funciones de Cursor==
{{Cursor_functions}}

==Funciones de Elementos==
{{Element functions}}

==Funciones de Eventos==
{{Funciones de eventos}}

==Funciones Explosivas==
{{Explosion_functions}}

==Funciones de Archivos==
{{Funciones_de_archivos}}

==Funciones de HTTP==
{{HTTP_functions}}

==Funciones de Entrada==
{{Input_functions}}

==Funciones de Mapa==
{{Map_functions}}

==Funciones de Marcadores==
{{Marker functions}}

==Funciones de Módulos==
{{Module functions}}

==Funciones de Objetos==
{{Object functions}}

==Funciones de PED's==
{{Ped_functions}}

==Funciones de Pickup's==
{{Pickup functions}}

==Funciones de Jugadores==
{{Player functions}}

==Funciones de Áreas de Radar==
{{Radar area functions}}

==Funciones de "Resources"==
{{Resource functions}}

==Funciones de Serial==
{{Serial functions}}

==Funciones de Servidor==
{{Server functions}}

==Funciones de Propiedades==
{{Settings registry functions}}

==Funciones de SQL==
{{SQL_functions}}

==Funciones de Equipos==
{{Team functions}}

==Funciones de Texto==
{{Text functions}}

==Funciones de Utilidad==
{{Utility functions}}

==Funciones de Vehículos==
{{Vehicle functions}}

==Funciones de Agua==
{{Water functions}}

==Funciones de Arma==
{{Weapon functions}}

==Funciones del Mundo==
{{World functions}}

==Funciones de XML==
{{XML functions}}

[[ru:Server Scripting Functions]]
[[en:Server Scripting Functions]]

Template:Event functions

2012-05-14T02:59:11Z

Kzman: Added interwiki (ES)

*[[addEvent]]
*[[addEventHandler]]
*[[cancelEvent]]
*[[getCancelReason]]
*[[removeEventHandler]]
*[[triggerClientEvent]]
*[[triggerEvent]]
*[[wasEventCancelled]]
{{New items|3.0151|1.3.1|
*[[triggerLatentClientEvent]]
*[[getLatentEventHandles]]
*[[getLatentEventStatus]]
*[[cancelLatentEvent]]
}}<noinclude>
[[es:Event functions]]
</noinclude>

Event system

2012-05-14T02:57:36Z

Kzman:

__NOTOC__
The event system is at the core of MTA scripting. Events work closely in conjunction with the element tree. Events are triggered when something happens - a player enters a marker, an element is clicked on etc. Each event has a source element, this is the element that performed the action.

==Event handlers==
To use the event system, you attach event handlers to elements in the element tree using [[addEventHandler]]. When you do this, your function will get triggered for all the events triggered on that element, it's parents (and their parents, etc.) and it's children (and their children). As such, an event handler attached to the ''root'' element will be triggered when an event occurs for any element. As a consequence you should generally use as specific a handler as you can. If you wish to just see when the player enters a specific marker, just attach the event handler to that marker.

Each event handler has two 'hidden' variables:
* '''source''': This is the element that the event originated from.
* '''this''': This is the element that the handler is being triggered on (i.e. the one you attached it to with addEventHandler).

The ''source'' variable is the most important one for most handlers. You almost always will want to reference this variable to tell what element triggered the event. The ''this'' variable has some uses for ensuring that an event was emitted by the element that you attached the handler to.

It is ''important'' to note that events follow the element hierachy. All events are initially triggered on the ''source'' element, followed by all the parent and children elements. This has few important implications:

* An event triggered on the root element will be triggered on every element in the element tree. This should be avoided where possible.
* All events anywhere in the element tree will be triggered on the root element. This means you can easily catch every event of a type by attaching a handler to the root element. Only do this if you genuinely want every event of that type, otherwise attach it somewhere more specific in the element tree.
* You can attach an event handler to your resource's root element to get all the events triggered by elements your resource contains.
* You can create 'dummy' elements to catch events from a group of child elements
* You can use dummy elements specified in a .map file (e.g. <flag>) and create 'real' representations for them (e.g. objects) and make these real elements children of the dummy element. Event handlers can then be attached to the dummy element and it will receive all the events of the real elements. This is useful for when one resource manages the representation of the element (creating the objects, for example), while another wants to handle special events. This could be a map resource that wants to handle a flag being captured in a specific way - the map resource would (generally) not be aware of the way the flag is represented. This doesn't matter as it can just attach handlers to it's dummy flag element while the other gamemode resource can handle the representation.

The function you attached to an event gets called and passed a bunch of arguments. These arguments are event-specific. Each event has specific parameters, for instance [[onClientGUIClick]] has 4 parameters, which are:
<syntaxhighlight lang="lua">string button, string state, int absoluteX, int absoluteY</syntaxhighlight>
The function you attached to this event will be passed these parameters as arguments. You must remember that each event has different parameters.

==Built in events==
MTA has a number of built in events. These are listed on the pages [[Client Scripting Events]] and [[Scripting Events]].

==Custom events==
You can create your own events that can be triggered across all resources. This is an important way to communicate with other resources and allow them to hook into your code. To add your own custom event, just call the [[addEvent]] function. You can then use the [[triggerEvent]] function to trigger that event any time you want - either using a timer, or based on a more general event.

For example, you could be making a Capture the Flag game mode and want to trigger an event when a player captures the flag. You could do this by attaching a event handler to the standard MTA [[onMarkerHit]] event and checking that the player entering the marker has the flag. if they do, you can then trigger your more specific ''onFlagCaptured'' event and other resources could handle this as they please.

==Canceling==
Events can be canceled with [[cancelEvent]]. This can have a variety of effects, but in general this means that the server will not perform whatever action it would usually do. For example, canceling [[onPickupUse]] would prevent a player being given what they tried to pick up, canceling [[onVehicleStartEnter]] would prevent the player entering the vehicle. You can check if the currently active event has been canceled using [[wasEventCanceled]]. It's important to note that canceling event ''does not'' prevent other event handlers being triggered.

[[Category:Scripting Concepts]]
[[es:Sistema de eventos]]

Evento

2012-05-14T02:57:10Z

Kzman: Redirected page to ES/Sistema de eventos

#REDIRECT [[ES/Sistema de eventos]]

ES/Sistema de eventos

2012-05-14T02:56:53Z

Kzman: Created page with "__NOTOC__ El sistema de eventos se encuentra en el núcleo del scripting de MTA. Los eventos funcionan en conjunto con el árbol de elementos. Los eventos son provocados cuando a..."

__NOTOC__
El sistema de eventos se encuentra en el núcleo del scripting de MTA. Los eventos funcionan en conjunto con el árbol de elementos. Los eventos son provocados cuando algo sucede - un jugador entra a un marcador, un elemento es cliqueado, etc. Cada evento tiene un elemento de origen, que es el que realiza la acción.

==Controladores de eventos==
Para usar el sistema de eventos, se une o liga el controlador de eventos a los elementos en el árbol de elementos usando [[ES/addEventHandler|addEventHandler]]. Cuando se hace esto, las funciones serán activadas para todos los eventos que fueron provocados en ese elemento, sus padres e hijos. Por si mismo, un controlador de eventos ligado al elemento ''raíz'' será provocado cuando ocurra un evento para cualquier elemento. Como consecuencia se debe usar generalmente un controlador específico, cuando se pueda. Si solo se desea ver cuando el jugador entra a un marcador específico, solo se une el controlador de evento a dicho marcador.

Cada controlador de evento tiene dos variables 'ocultas':
* '''source''': Este es el elemento que origina el evento.
* '''this''': Este el elemento al cual se le provoca (p.ej. el que uniste con addEventHandler).

La variable ''source'' es la mas importante para la mayoría de los controladores. Casi siempre se querrá hacer referencia a esta variable para decir que elemento provoco el evento. La variable ''this'' tiene algunos usos para asegurarse de que el evento fue emitido por el elemento al que el controlador se unió.

Es ''importante'' notar que los eventos siguen la jerarquía de elementos. Inicialmente, todos los elementos provocan al elemento de ''origen'' (o ''source'' element), seguido de todos los elementos padres e hijos. Esto implica ciertas cosas:

* Un evento provocado sobre el elemento raíz se provocará en cada elemento dentro del árbol de elementos. Esto debe ser evitado cuando sea posible.
* Todos los eventos en cualquier parte dentro del árbol de elementos serán provocado sobre el elemento raíz. Esto significa que simplemente se atrapa cada evento de un tipo provocando a un controlador hacia el elemento raíz. Esto solo se debe realizar si verdaderamente se quiere cada evento de ese tipo, de otra forma se une al lugar más específico en el árbol de elementos.
* Puedes unir un controlador de eventos al elementeo raíz de un resource para obtener todos los eventos provocados por los elementos que el resource contiene.
* Puedes crear elementos 'falsos' o 'dummy' para captar eventos de un grupo de elementos hijos.
* Puedes usar elementos falsos especificándolos dentro de un archivo .map (p.ej. <flag>) y crear representaciones 'reales' para ellos (p.ej. objectos) y hacer que sean elementos hijos reales de un elemento falso. Los controladores de eventos pueden entonces ser unidos al elemento falso y recibiran todos los eventos de los elementos reales. Esto es útil para cuando un resource maneja la representación del elemento (creando los objetos, por ejemplo), mientras otro desea controlar eventos especiales. Esto podría ser un resource de mapa que quiera controlar una bandera siendo capturada de alguna manera - el resource de mapa (generalmente) no sería consistente de la forma en que la bandera es representada. Esto no importa ya que este pordría solo unir los controladores a su elemento bandera falso mientras el otro resource de modo de juego puede controlar la representacion.

La función unida a un evento es llamada y pasada con un montón de argumentos. Estos argumentos son específicos del evento. Cada evento tiene parámetros específicos, por ejemplo [[ES/onClientGUIClick|onClientGUIClick]] tiene 4 parámetros, que son:
<syntaxhighlight lang="lua">string botón, string estado, int xAbsoluto, int yAbsoluto</syntaxhighlight>
La función unida a este evento pasará estos parametros como argumentos. Debes recordar que cada evento tiene diferentes parámetros.

==Eventos incorporados==
MTA tiene un número de eventos incorporados, los cuales se encuentran en [[Client Scripting Events]] y [[Scripting Events]].

==Eventos personalizados==
Puedes crear tus propioas eventos que puedan ser provocados a travez de cualquier resource. Esta es una manéra importánte de comunicarse con otros resources y permitirles enlazarlos a tu código. Para agregar tus propios eventos, solo debes llamar la función [[ES/addEvent|addEvent]]. Luego puedes usar la función [[ES/triggerEvent|triggerEvent]] para provocar el evento en cualquier momento que quieras - incluso usando un timer, o basado en un evento general.

Por ejemplo, puedes hacer un modo de juego de Captura la Bandera y quieres provocar un evento cuando un jugador capture la bandera. Podrías haces esto uniendo un controlador de eventos al evento estándar de MTA [[ES/onMarkerHit|triggerEvent]] y verificar que el jugador que entró al marcador tiene la bandera. Si es así, entonces puedes provocar tu evento más específico ''onFlagCaptured'' y otros resources podrían controlarlo como ellos lo deseen.

==Cancelación==
Los eventos pueden ser cancelados con [[ES/cancelEvent|triggerEvent]]. Esto puede tener una veriedad de consecuencias, pero en general significa que el servidor no realizará ninguna acción que debería hacer. Por ejemplo, cancelar el evento [[ES/onPickupUse|onPickupUse]] podría prevenir que un jugador se le de lo que intenta tomar de un pickup, cancelar el evento [[ES/onVehicleStartEnter|onVehicleStartEnter]] pordría prevenir que el jugador entre a un vehículo. Puedes comprobar si el evento actualmente activo ha sido cancelado usando [[ES/wasEventCanceled|wasEventCanceled]]. Es importante notar que cancelar el evento ''no'' previene que otros controladores de evento sean provocados.

[[Category:Scripting Concepts]]
[[en:Event system]]

ES/addEventHandler

2012-05-14T02:54:52Z

Kzman: Created page with "__NOTOC__ {{Server client function}} {{Note_box|Se recomienda encarecidamente que no usen el mismo nombre para la función de controlador y para el nombre del evento, ya que pu..."

__NOTOC__
{{Server client function}}
{{Note_box|Se recomienda encarecidamente que no usen el mismo nombre para la función de controlador y para el nombre del evento, ya que puede producir confusión si se usan múltiples funciones de controlador.}}
Esta función añadirá un controlador de eventos. Un controlador de eventos es una función que se llamará cuando el evento que está unido sea provocado. Mira el [[Sistema de eventos]] para mas informacion sobre como funciona el sistema de eventos.

Los controladores de eventos son funciones que son llamadas cuando un evento en particular sucede. Cada evento especifica una seria específica de variables que son pasadas hacia el controlador de eventos y pueden ser leídas por la función. Las siguientes variables globales están disponibles para usarlas en funciones de controlador:
*'''source''': el elemento que provoca el evento
*'''this''': el elemento al cual está unido el controlador de eventos
*'''sourceResource''': el resource que provocó el evento
*'''sourceResourceRoot''': el elemento raíz del resource que provocó el evento
*'''client''': el cliente que provocó el evento usando [[ES/triggerServerEvent|triggerServerEvent]]. No establecer si el evento no fue provocado por un cliente.
{{New_feature|3|1.0|
*'''eventName''': el nombre del evento que provocó la funcion de controlador.
}}

Es importante recordar que se mueven hacia arriba o hacia abajo en el árbol de elementos. Un evento provocado sobre el elemento raíz es provocado sobre cada elemento del árbol. Un evento provocado sobre cualquier otro elemento es provocado sobre sus antecesores (su elemento padre, los padres de sus padres, etc) y sus hijos, nietos y bisnietos. Puedes usar el argumento ''getPropagated'' para especificar si deseas que el controlador reciba eventos que se han propagado hacia arriba o hacia abajo del árbol.

El orden en el cual los controladores de eventos son provocados no está definido, no debes confiarte de un controlador de evento que está siendo ejecutado antes de otro.

==Sintaxis==
<syntaxhighlight lang="lua">
bool addEventHandler ( string nombreEvento, element unidoA, function funcionControlador, [ bool getPropagated = true, string pioridad= "normal" ] )
</syntaxhighlight>

===Argumentos Requeridos===
*'''nombreEvento:''' El nombre del evento al que quieres unir la funcion de controlador.
*'''unidoA:''' El [[elemento]] al que deseas unir el controlador. El controlador solo será llamado cuando el evento al que está unido sea provocado para este elemento, o uno de sus hijos. Generalmente, puede ser el elemento raíz (queriendo decir que el controlador será llamado cuando el evento sea provocado para ''cualquier'' elemento).
*'''funcionControlador:''' La función de controlador que deseas llamar cuando el evento sea provocado. Esta función pasará todos los parámetros del evento como argumentos, pero no es requerido ya que los toma todos.

===Argumentos Opcionales===
*'''getPropagated:''' Un boolean que representa si el controlador será provocado si el evento fue propagado hacia arriba o hacia abajo del árbol de elementos (comenzando del origen), y no provocado directamente sobre unidoA (esto es, si los controladores que estan están unidos tienen este argumento establecido en ''false'' solo serán profocados si ''source == this'').
{{New_feature|3.0139|1.3.1|
*'''prioridad :''' Un string que representa la prioridad del orden de provocaión relativo a otros controladores de eventos con el mismo nombre. Los valores posibles son:
**'''high :''' alto
**'''normal : ''' normal
**'''low :''' bajo
''Tambien es posible agregar un mejor control de prioridad by añadiendo un número positivo o negativo al string de prioridad. Por ejemplo (en orden de prioridad de preferencia): "high+4" "high" "high-1" "normal-6" "normal-7" "low+1" "low" "low-1"''
}}

===Devuelve===
Devuelve ''true'' si el controlador de eventos fue unido con éxito. Devuelve ''false'' si el evento especificado se pudo encontrar o ningún parámetro es válido.

==Ejemplo==
<section name="Servidor" class="server" show="true">
En este ejemplo de servidor se envía un mensaje a todos dentro del servidor cuando un jugador aparece.
<syntaxhighlight lang="lua">
-- obtiene el elemento raíz
rootElement = getRootElement()
-- define nuestra función de controlador
function onPlayerSpawnHandler ( elJugador )
-- obtiene el nombre del jugador
local nombreJugador = getPlayerName( elJugador )
-- muestra en la ventana de chat que han aparecido
outputChatBox ( "¡Ha aparecido " .. nombreJugador .. "!" )
end

addEventHandler( "onPlayerSpawn", rootElement, onPlayerSpawnHandler )
</syntaxhighlight>
</section>

==Cambios==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.03795|Añadido argumento de prioridad}}

==Vea tambien==
{{Funciones de eventos}}
[[en:addEventHandler]]
[[ru:addEventHandler]]

Template:Funciones de eventos

2012-05-14T02:54:33Z

Kzman:

*[[ES/addEvent|addEvent]]
*[[ES/addEventHandler|addEventHandler]]
*[[ES/cancelEvent|cancelEvent]]
*[[ES/getCancelReason|getCancelReason]]
*[[ES/removeEventHandler|removeEventHandler]]
*[[ES/triggerClientEvent|triggerClientEvent]]
*[[ES/triggerEvent|triggerEvent]]
*[[ES/wasEventCancelled|wasEventCancelled]]
{{New items|3.0151|1.3.1|
*[[ES/triggerLatentClientEvent|triggerLatentClientEvent]]
*[[ES/getLatentEventHandles|getLatentEventHandles]]
*[[ES/getLatentEventStatus|getLatentEventStatus]]
*[[ES/cancelLatentEvent|cancelLatentEvent]]
}}
<noinclude>[[en:Template:Event functions]]</noinclude>

Template:Funciones de eventos

2012-05-14T02:51:51Z

Kzman: Created page with "*addEvent *addEventHandler *cancelEvent *getCancelReason *[[ES/removeEventHandler|removeEventHand..."

PL/Zdarzenia po stronie klienta

2012-05-14T00:52:55Z

Kzman: Added interwikis

<pageclass class="client"></pageclass>
Ta strona zawiera listę wszystkich [[event|wydarzeń]] '''po stronie klienta''', które zostały zaimplementowane i są dostępne w Deathmatch mod. To request a function or event, use [[Requested Functions and Events]].

'''[[event|Zdarzenia]] po stronie klienta można znaleźć tutaj: [[Server Scripting Events|Zdarzenia po stronie serwera]]

==Colshape events==
{{Client_colshape_events}}

==Zdarzenia elementy==
{{Client_element_events}}

==Zdarzenia GUI==
{{GUI_events}}

==Zdarzenia Gracza==
{{Client_player_events}}

==Zdarzenia zasobu==
{{Client_resource_events}}

==Zdarzenia pojazdu==
{{Client_vehicle_events}}

==Inne zdarzenia==
{{Client_other_events}}

[[ru:Client Scripting Events]]
[[en:Client Scripting Events]]

Client Scripting Events

2012-05-14T00:51:49Z

Kzman: Added interwiki (ES)

<pageclass class="client"></pageclass>
This page lists all '''client-side''' scripting [[event]]s that have been implemented and are available in the Deathmatch mod. To request a function or event, use [[Requested Functions and Events]].

'''Server-side scripting events can be found here: [[Server Scripting Events]]

==Colshape events==
{{Client_colshape_events}}

==Element events==
{{Client_element_events}}

==GUI events==
{{GUI_events}}

==Marker events==
{{Client_marker_events}}

==Ped events==
{{Client_ped_events}}

==Pickup events==
{{Client_pickup_events}}

==Player events==
{{Client_player_events}}

==Projectile events==
{{Client_projectile_events}}

==Resource events==
{{Client_resource_events}}

==Sound events==
{{Sound_events}}

==Vehicle events==
{{Client_vehicle_events}}

==Other events==
{{Client_other_events}}

[[pl:Zdarzenia_po_stronie_klienta]]
[[ru:Client Scripting Events]]
[[es:Client Scripting Events]]

ES/Client Scripting Events

2012-05-14T00:51:48Z

Kzman: Added interwiki (EN)

<pageclass class="client"></pageclass>
Esta página contiene una lista de todos los [[evento]]s de script del '''lado del cliente''' que han sido implementados y estan disponibles en el mod Deathmatch. Para pedir una función o evento, usa el [[Requested Functions and Events|Pedido de Funciones y Eventos]] [[Image:flag_us.png|En Inglés|20px]].

'''Los eventos de script de servidor se encuentran aquí: [[Server Scripting Events]] [[Image:flag_us.png|En Inglés|20px]]

==Colshape events [[Image:flag_us.png|En Inglés|20px]]==
{{Client_colshape_events}}

==Eventos de elementos [[Image:flag_us.png|En Inglés|20px]]==
{{Client_element_events}}

==Eventos de GUI [[Image:flag_us.png|En Inglés|20px]]==
{{GUI_events}}

==Eventos de marcadores [[Image:flag_us.png|En Inglés|20px]]==
{{Client_marker_events}}

==Eventos de peds [[Image:flag_us.png|En Inglés|20px]]==
{{Client_ped_events}}

==Eventos de pickups [[Image:flag_us.png|En Inglés|20px]]==
{{Client_pickup_events}}

==Eventos de jugadores [[Image:flag_us.png|En Inglés|20px]]==
{{Client_player_events}}

==Eventos de proyectiles [[Image:flag_us.png|En Inglés|20px]]==
{{Client_projectile_events}}

==Eventos de resources [[Image:flag_us.png|En Inglés|20px]]==
{{Client_resource_events}}

==Eventos de sonidos [[Image:flag_us.png|En Inglés|20px]]==
{{Sound_events}}

==Eventos de vehículos [[Image:flag_es.png|En Español|20px]]==
{{Eventos cliente de vehículos}}

==Otros eventos [[Image:flag_us.png|En Inglés|20px]]==
{{Client_other_events}}

[[pl:Zdarzenia_po_stronie_klienta]]
[[ru:Client Scripting Events]]
[[en:Client Scripting Events]]

ES/Client Scripting Events

2012-05-14T00:50:50Z

Kzman: Traducido parcialmente

OnClientTrailerDetach

2012-05-14T00:41:32Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered when a trailer gets detached from its towing vehicle.

==Parameters==
<syntaxhighlight lang="lua">
vehicle towedBy
</syntaxhighlight>
*'''towedBy:''' the vehicle that was towing the trailer.

==Source==
The source of this event is the trailer that is now detached.

==Example==
This example outputs to the player that's towing the trailer that "The vehicle is now detached". (TESTED!)
<syntaxhighlight lang="lua">addEventHandler("onClientTrailerDetach",root,function(towedBy)
player = getVehicleOccupant(towedBy,0)
outputChatBox("The vehicle is now detached.",player)
end)</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientTrailerDetach]]

OnClientTrailerAttach

2012-05-14T00:40:55Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered by a trailer when it gets attached to a towing vehicle.

==Parameters==
<syntaxhighlight lang="lua">
vehicle towedBy
</syntaxhighlight>
*'''towedBy:''' the vehicle that is now towing the trailer.

==Source==
The source of this event is the trailer that is now being towed.

==Example==
This example shows on chat name of vehicle, what attach a trailer.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function onAttach(vehicle)
local name = getVehicleName(vehicle)
outputChatBox("You were attach the trailer by "..name)
end
addEventHandler("onClientTrailerAttach", getRootElement(), onAttach)
</syntaxhighlight>
</section>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientTrailerAttach]]

OnClientVehicleStartExit

2012-05-14T00:40:29Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered when a player starts exiting a vehicle. Once the exiting animation completes, [[onClientVehicleExit]] is triggered.

==Parameters==
<syntaxhighlight lang="lua">
player thePlayer, int seat, int door
</syntaxhighlight>
*'''thePlayer:''' the player who started exiting the vehicle.
*'''seat:''' the number of the seat that the player was sitting on.
{{New feature/item|3.0110|1.1||
*'''door:''' the number of the door that the player is using to leave.
}}

==Source==
The source of this event is the vehicle that the player started to exit.

==Example==
This example outputs to the player that he's leaving the drivers seat. (TESTED!)
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleStartExit",root,function(player,seat,door)
if(seat==0)and(door==0)then
outputChatBox("You are leaving the drivers seat.",player)
end
end)</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleStartExit]]

OnClientVehicleStartEnter

2012-05-14T00:40:04Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered when a player starts entering a vehicle. Once the entering animation completes, [[onClientVehicleEnter]] is triggered.

==Parameters==
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
player thePlayer, int seat
</syntaxhighlight>
}}
{{new_feature/item|3|1.0||
<syntaxhighlight lang="lua">
player thePlayer, int seat, int door
</syntaxhighlight>
}}
*'''thePlayer:''' the player that just started entering a vehicle.
*'''seat:''' the number of the seat he is going to sit on.
{{new_feature/item|3|1.0||
*'''door:''' An integer of which door the player used (0-3). 0 is driver side door, 1 is front passenger, 2 is back left, 3 is back right.
}}

==Source==
The source of this event is the vehicle the player is entering.

==Example==
This example outputs if the player is sitting in the drivers seat. (TESTED!)
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleStartEnter",root,function(player,seat,door)
if(seat==0)and(door==0)then
outputChatBox("You are going to sit in the drivers seat.",player)
end
end)</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleStartEnter]]

OnClientVehicleExplode

2012-05-14T00:38:16Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered when a vehicle explodes.

==Parameters==
This event has no parameters.

==Source==
The source of this event is the vehicle that exploded.

==Example==
This example will output some text to chat on vehicle explosion
<syntaxhighlight lang="lua">
addEventHandler("onClientVehicleExplode", getRootElement(), function()
local modelname = getVehicleName(source)
outputChatBox(modelname.." just exploded!")
end)
</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleExplode]]

OnClientVehicleExit

2012-05-14T00:37:29Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event gets fired when a player gets out of a vehicle.

==Parameters==
<syntaxhighlight lang="lua">
player thePlayer, int seat
</syntaxhighlight>
*'''thePlayer:''' the player that exited the vehicle
*'''seat:''' the number of the seat that the player was sitting on. 0 = driver, higher numbers are passenger seats.

==Source==
The source of the event is the vehicle that the player exited.

==Example==
This code updates a GUI label with the name of the vehicle the local player is in.
<syntaxhighlight lang="lua">
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Currently on foot", false)
addEventHandler("onClientVehicleEnter", getRootElement(),
function(thePlayer, seat)
if thePlayer == getLocalPlayer() then
guiSetText(lblVehicle, "Currently in a " .. getVehicleName(source))
end
end
)

addEventHandler("onClientVehicleExit", getRootElement(),
function(thePlayer, seat)
if thePlayer == getLocalPlayer() then
guiSetText(lblVehicle, "Currently on foot")
end
end
)
</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleExit]]

ES/onClientVehicleExit

2012-05-14T00:37:28Z

Kzman: Added interwiki (EN)

{{Client event}}
__NOTOC__
Este evento se activa cuando un jugador sale de un vehículo.

==Parámetros==
<syntaxhighlight lang="lua">
player elJugador, int asiento
</syntaxhighlight>
*'''elJugador:''' el jugador que salió del vehículo
*'''asiento:''' el número de asiento donde el jugador estaba sentado. 0 = conductor, los números más altos son de pasajeros.

==Origen==
La variable source de este evento corresponde al vehículo desde donde salió el jugador.

==Example==
Este código actualiza una etiqueta GUI con el nombre del vehículo en el que estaba el jugador.
<syntaxhighlight lang="lua">
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Actualmente a pie", false)
addEventHandler("onClientVehicleEnter", getRootElement(),
function(elJugador, asiento)
if elJugador == getLocalPlayer() then
guiSetText(lblVehicle, "Actualmente en un " .. getVehicleName(source))
end
end
)

addEventHandler("onClientVehicleExit", getRootElement(),
function(elJugador, asiento)
if elJugador == getLocalPlayer() then
guiSetText(lblVehicle, "Actualmente a pie")
end
end
)
</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}
[[en:onClientVehicleExit]]

OnClientVehicleEnter

2012-05-14T00:36:16Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event gets fired when a player enters a vehicle.

==Parameters==
<syntaxhighlight lang="lua">
player thePlayer, int seat
</syntaxhighlight>
*'''thePlayer:''' the player that entered the vehicle
*'''seat:''' the number of the seat that the player is now sitting on. 0 = driver, higher numbers are passenger seats.

==Source==
The source of the event is the vehicle that the player entered.

==Example==
This code updates a GUI label with the name of the vehicle the local player is in.
<syntaxhighlight lang="lua">
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Currently on foot", false)
addEventHandler("onClientVehicleEnter", getRootElement(),
function(thePlayer, seat)
if thePlayer == getLocalPlayer() then
guiSetText(lblVehicle, "Currently in a " .. getVehicleName(source))
end
end
)
addEventHandler("OnClientVehicleExit", getRootElement(),
function(thePlayer, seat)
if thePlayer == getLocalPlayer() then
guiSetText(lblVehicle, "Currently on foot")
end
end
)
</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleEnter]]

ES/onClientVehicleEnter

2012-05-14T00:36:15Z

Kzman: Added interwiki (EN)

{{Client event}}
__NOTOC__
Este evento se activa cuando un jugador entra a un vehículo.

==Parametros==
<syntaxhighlight lang="lua">
player elJugador, int asiento
</syntaxhighlight>
*'''elJugador:''' el jugador que entró al vehículo
*'''asiento:''' el número de asiento donde el jugador esta sentado. 0 = conductor, los números más altos son de pasajeros.

==Origen==
La variable source de este evento corresponde al vehículo donde entró el jugador.

==Ejemplo==
En este ejemplo se actualiza una etiqueta GUI con el nombre del vehículo en el cual está el jugador.
<syntaxhighlight lang="lua">
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Actualmente a pie", false)
addEventHandler("onClientVehicleEnter", getRootElement(),
function(elJugador, asiento)
if elJugador == getLocalPlayer() then
guiSetText(lblVehicle, "Actualmente en un " .. getVehicleName(source))
end
end
)
addEventHandler("OnClientVehicleExit", getRootElement(),
function(elJugador, asiento)
if elJugador == getLocalPlayer() then
guiSetText(lblVehicle, "Actualmente a pie")
end
end
)
</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}
[[en:onClientVehicleEnter]]

OnClientVehicleRespawn

2012-05-14T00:35:22Z

Kzman: Added interwiki (ES)

{{Client event}}
__NOTOC__
This event is triggered when a vehicle respawns.

==Parameters==
This event has no parameters.

==Source==
The source of this event is the vehicle that respawned.

==Example==
This example outputs to the console that a vehicle has respawned.
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleRespawn",root,function()
outputConsole("A vehicle has respawned.")
end)</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleRespawn]]

ES/onClientVehicleRespawn

2012-05-14T00:35:21Z

Kzman: Added interwiki (EN)

{{Client event}}
__NOTOC__
Este evento es provocado cuando un vehículo cuando un vehículo reaparece.

==Parametros==
Este evento no tiene parámetrós.

==Origen==
El origen de este evento es el vehículo que reaparece.

==Example==
Este ejemplo muestra en la consola que un vehículo ha reaparecido.
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleRespawn",root,function()
outputConsole("Un vehículo ha reaparecido.")
end)</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}
[[en:onClientVehicleRespawn]]

OnClientVehicleCollision

2012-05-14T00:15:39Z

Kzman: tested by me

{{New feature/item|3.0130|1.3|3653|
Added in MTA SA 1.3
}}
{{Client event}}
__NOTOC__
This event is triggered when a vehicle collides with peds/vehicles/objects.

==Parameters==
'''Note:''' ''theHitElement'' will be nil or false if it's a default SA object and it will trigger twice for vehicles because one vehicle hit another and one got hit by another.
<syntaxhighlight lang="lua">
entity theHitElement, float force, int bodypart, float collisionX, float collisionY, float collisionZ, float velocityX, float velocityY, float velocityZ, float hitElementForce, int model
</syntaxhighlight>
*'''theHitElement:''' the entity that took damage
*'''force:''' the force of the damage (Note: this is NOT the damage it is a force value which is then multiplied by the vehicles collision damage multiplier. for an example of this see below)
*'''bodyPart:''' the bodypart that hit the other element
*'''collisionX:''' the X position the collision took place
*'''collisionY:''' the Y position the collision took place
*'''collisionZ:''' the Z position the collision took place
*'''velocityX:''' the X velocity of the source before the collision took place
*'''velocityY:''' the Y velocity of the source before the collision took place
*'''velocityZ:''' the Z velocity of the source before the collision took place
*'''hitElementforce:''' 0 for non vehicles or the force of the other vehicle
*'''model:''' model of the hit element (useful to detect building collisions as hitElement will be nil)

==Source==
The source of this event is the vehicle that collided with something.

==Example==
<syntaxhighlight lang="lua">
addEventHandler("onClientVehicleCollision", root,
function(collider,force, bodyPart, x, y, z, vx, vy, vz)
if ( source == getPedOccupiedVehicle(localPlayer) ) then
-- force does not take into account the collision damage multiplier (this is what makes heavy vehicles take less damage than banshees for instance) so take that into account to get the damage delt
local fDamageMultiplier = getVehicleHandling(source).collisionDamageMultiplier
-- Create a marker (I've scaled this down to 1% of the actual damage as we get huge markers else)
local m = createMarker(x, y, z, "corona", force * fDamageMultiplier * 0.01, 0, 9, 231)
-- Destroy the marker in 2 seconds
setTimer(destroyElement, 2000, 1, m)
end
end
)

</syntaxhighlight>

<syntaxhighlight lang="lua">
-- This code works because onClientVehicleCollision is triggered before any SA reaction to the collision, therefore we can update the knocked off bike status just before the collision and stop the falling off effect happening :)
addEventHandler("onClientVehicleCollision", root,
function ( hit )
-- firstly did we trigger this event
if ( source == getPedOccupiedVehicle(localPlayer) ) then
-- knock off defaults to false
local knockOff = false
-- if our hit element is nil (we just hit an SA map object)
if ( hit == nil ) then
-- set knockOff to true
knockOff = true
end
-- update our can be knocked off bike status accordingly
setPedCanBeKnockedOffBike(localPlayer, knockOff)
end
end
)

</syntaxhighlight>
==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}

ES/onClientTrailerDetach

2012-05-14T00:08:57Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento es provocado cuando un tráiler se desacopla de su vehiculo de remolque. ==Parámetros== <syntaxhighlight lang="lua"> vehicle remolcadoPor </syntaxhighlight> *'''re..."

{{Client event}}
__NOTOC__
Este evento es provocado cuando un tráiler se desacopla de su vehiculo de remolque.

==Parámetros==
<syntaxhighlight lang="lua">
vehicle remolcadoPor
</syntaxhighlight>
*'''remolcadoPor:''' el vehículo que remolcaba al tráiler.

==Origen==
La variable source de este evento corresponde al tráiler que está siendo desacoplado.

==Ejemplo==
En este ejemplo se le indica al jugador que ya no está remolcando su tráiler.
<syntaxhighlight lang="lua">addEventHandler("onClientTrailerDetach",root,function(remolcador)
jugador = getVehicleOccupant(remolcador,0)
outputChatBox("El vehículo está desacoplado.", jugador)
end)</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}

[[en:onClientTrailerDetach]]

ES/onClientTrailerAttach

2012-05-14T00:02:34Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento es provocado cuando un tráiler se acopla a un vehiculo de remolque. ==Parámetros== <syntaxhighlight lang="lua"> vehicle remolcadoPor </syntaxhighlight> *'''remol..."

{{Client event}}
__NOTOC__
Este evento es provocado cuando un tráiler se acopla a un vehiculo de remolque.

==Parámetros==
<syntaxhighlight lang="lua">
vehicle remolcadoPor
</syntaxhighlight>
*'''remolcadoPor:''' el vehículo que remolca al tráiler.

==Origen==
La variable source de este evento corresponde al tráiler que está siendo remolcado.

==Example==
En este ejemplo se envía al chat el nombre del vehículo que acopla a un trailer.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function onAttach(vehicle)
local name = getVehicleName(vehicle)
outputChatBox(name.." acopló el remolque")
end
addEventHandler("onClientTrailerAttach", getRootElement(), onAttach)
</syntaxhighlight>
</section>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}

[[en:onClientTrailerAttach]]

ES/onClientVehicleStartExit

2012-05-13T23:54:42Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento es provocado cuando un jugador comienza a salir de un vehículo. Una vez que la animación para salir se complete, se provoca el evento [[..."

{{Client event}}
__NOTOC__
Este evento es provocado cuando un jugador comienza a salir de un vehículo. Una vez que la animación para salir se complete, se provoca el evento [[onClientVehicleExit]].

==Parámetros==
<syntaxhighlight lang="lua">
player elJugador, int asiento, int puerta
</syntaxhighlight>
*'''elJugador:''' el jugador que ha comenzado a salir del vehículo.
*'''asiento:''' el número de asiento en el cual estaba sentado.
*'''puerta:''' un entero que correspondiente a la puerta que el jugador estaba usando (0-3). 0 es la del conductor, 1 el pasajero del frente, 2 es la trasera izquierda, 3 es la trasera derecha.

==Origen==
La variable source de este evento corresponde al vehículo que el jugador intenta entrar.

==Example==
En este ejemplo se muestra si el jugador está saliendo del asiento del conductor.
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleStartExit",root,function(jugador, asiento, puerta)
if(asiento==0)and(puerta==0)then
outputChatBox("Estás saliendo de la silla del conductor.", jugador)
end
end)</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}

[[en:onClientVehicleStartExit]]

ES/onClientVehicleStartEnter

2012-05-13T23:48:43Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento es provocado cuando un jugador comienza a entrar a un vehículo. Una vez que la animación para entrar se complete, se provoca el evento [[..."

{{Client event}}
__NOTOC__
Este evento es provocado cuando un jugador comienza a entrar a un vehículo. Una vez que la animación para entrar se complete, se provoca el evento [[onClientVehicleEnter]].

==Parámetros==
<syntaxhighlight lang="lua">
player elJugador, int asiento, int puerta
</syntaxhighlight>
*'''elJugador:''' el jugador que ha comenzado a entrar al vehículo.
*'''asiento:''' el número de asiento al cual se va a sentar.
*'''puerta:''' un entero que correspondiente a la puerta que el jugador intenta entrar (0-3). 0 es la del conductor, 1 el pasajero del frente, 2 es la trasera izquierda, 3 es la trasera derecha.

==Origen==
La variable source de este evento corresponde al vehículo que el jugador intenta entrar.

==Ejemplo==
En este ejemplo se muestra si el jugador se está sentando en el asiento del conductor.
<syntaxhighlight lang="lua">addEventHandler("onClientVehicleStartEnter", root, function(jugador, asiento, puerta)
if(asiento==0) and (puerta==0)then
outputChatBox("Te vas a sentar en la silla del conductor.", jugador)
end
end)</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}

[[en:onClientVehicleStartEnter]]

ES/onClientVehicleExplode

2012-05-13T23:37:40Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento es provocado cuando un vehículo explota. ==Parametros== Este evento no tiene parámetros. ==Origen== La variable source de este evento..."

{{Client event}}
__NOTOC__
Este evento es provocado cuando un vehículo explota.

==Parametros==
Este evento no tiene parámetros.

==Origen==
La variable source de este evento corresponde al vehículo que explotó.

==Ejemplo==
Este ejemplo enviará un texto hacia el chat cuando un vehículo explote
<syntaxhighlight lang="lua">
addEventHandler("onClientVehicleExplode", getRootElement(), function()
local modelname = getVehicleName(source)
outputChatBox("¡"..modelname.." ha explotado!")
end)
</syntaxhighlight>

==Vea también==
===Eventos cliente de vehículos===
{{Eventos cliente de vehículos}}
===Funciones cliente de eventoss===
{{Funciones cliente de eventos}}

[[EN:onClientVehicleExplode]]

ES/onClientVehicleExit

2012-05-13T23:32:56Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento se activa cuando un jugador sale de un vehículo. ==Parámetros== <syntaxhighlight lang="lua"> player elJugador, int asiento </syntaxhighlight> *'''elJugador:''' el j..."

ES/onClientVehicleEnter

2012-05-13T23:27:07Z

Kzman: Created page with "{{Client event}} __NOTOC__ Este evento se activa cuando un jugador entra a un vehículo. ==Parametros== <syntaxhighlight lang="lua"> player elJugador, int asiento </syntaxhighlight> *'''elJugador:''' el ju..."

ES/OnClientVehicleRespawn

2012-05-13T23:18:38Z

Kzman: moved ES/OnClientVehicleRespawn to ES/onClientVehicleRespawn: typo

#REDIRECT [[ES/onClientVehicleRespawn]]

ES/onClientVehicleRespawn

2012-05-13T23:18:38Z

Kzman: moved ES/OnClientVehicleRespawn to ES/onClientVehicleRespawn: typo