Multi Theft Auto: Wiki - User contributions [en]

ES/Cambios en la versión 1.3

2012-10-20T19:36:51Z

Araa: /* Traductores */

{{Note|For the upcoming version see [[Changes in 1.3.1]].}}
==Principales Cambios==
* Añadidas Sirenas para vehiculos
* Arreglada descarga muy lenta de archivos map
* Arreglados timeouts en cambios de mapa
* Arreglados varios problemas, crashes y congelamientos
* Actualizado la mayor cantidad de jugadores a 4096
* Añadidos BASS efectos
* Añadido Analog Control States
* Añadido bullet sync
* Arreglados muchos problemas al remplazar custom models
* Soporte para Windows 8 (ambos 32-bits y 64-bits)
* Abilidad de crear peds sin armas a travez de creacion de armas
* Mejorada la estabilidad del map editor y añadidas nuevas caracteristicas
* Instaladores para regular builds y nightlies estan ahora digitalmente registrados.

==Cliente==
=== Funciones ===
* Añadido [[setObjectBreakable]]
* Añadido [[isObjectBreakable]]
* Añadido [[dxSetBlendMode]]
* Añadido [[dxGetBlendMode]]
* Añadido [[dxDrawMaterialLine3D]]
* Añadido [[dxDrawMaterialSectionLine3D]]
* Añadido [[getLatentEventHandles]]
* Añadido [[getLatentEventStatus]]
* Añadido [[cancelLatentEvent]]
* Añadido [[triggerLatentServerEvent]]
* Añadido [[getVehicleSirenParams]]
* Añadido [[getVehicleSirens]]
* Añadido [[setVehicleSirens]]
* Añadido [[getSoundProperties]]
* Añadido [[setSoundProperties]]
* Añadido [[getSoundFFTData]]
* Añadido [[setSoundPanningEnabled]]
* Añadido [[isSoundPanningEnabled]]
* Añadido [[setWorldSoundEnabled]]
* Añadido [[isWorldSoundEnabled]]
* Añadido [[resetWorldSounds]]
* Añadido [[getSoundBPM]]
* Añadido [[getSoundLevelData]]
* Añadido [[getSoundWaveData]]
* Añadido [[setPedAnalogControlState]]
* Añadido [[getPedAnalogControlState]]
* Añadido [[setAnalogControlState]]
* Añadido [[getAnalogControlState]]
* Añadido [[setPedTargetingMarkerEnabled]]
* Añadido [[isPedTargetingMarkerEnabled]]
* Añadido [[setElementMatrix]]
* Añadido [[warpPedIntoVehicle]]
* Añadido [[removePedFromVehicle]]
* Añadido [[setProjectileCounter]]
* Añadido [[createWeapon]]
* Añadido [[fireWeapon]]
* Añadido [[setWeaponProperty]]
* Añadido [[setWeaponState]]
* Añadido [[setWeaponTarget]]
* Añadido [[getWeaponOwner]]
* Añadido [[setWeaponOwner]]
* Añadido [[setWeaponFlags]]
* Añadido [[getWeaponFlags]]
* Añadido [[setWeaponFiringRate]]
* Añadido [[getWeaponFiringRate]]
* Añadido [[resetWeaponFiringRate]]
* Añadido [[getWeaponClipAmmo]]
* Añadido [[setWeaponClipAmmo]]
* Añadido [[getWeaponAmmo]]
* Añadido [[setWeaponAmmo]]
* Añadido [[getProjectileCounter]]
* Añadido [[setWaterDrawnLast]]
* Añadido [[isWaterDrawnLast]]
* Añadido [[guiLabelGetColor]]

===Eventos===
* Añadido [[onClientPedHeliKilled]]
* Añadido [[onClientPlayerHeliKilled]]
* Añadido [[onClientPlayerHitByWaterCannon]]
* Añadido [[onClientPedHitByWaterCannon]]
* Añadido [[onClientPlayerPickupHit]]
* Añadido [[onClientPlayerPickupLeave]]
* Añadido [[onClientSoundBeat]]
* Añadido [[onClientWeaponFire]]

===Cambios/Arreglos (Traduccion 50%)===
* Arreglado 'no estas permitido a ingresar al vehiculo' bug
* Añadida prioridad de order a [[addEventHandler]]
* Arreglada la variante 'engineless' a la NRG-500
* Añadida la opcion para saltar la seleccion de Dual Monitor Resolution
* Hecho [[playSound3D]] usar la posicion de la camara en lugar de la posicion del jugador cuando se determina la distancia
* Añadidas opciones de color coding y sub-pixel positioning a [[dxDrawText]]
* Añadida la habilidad de crear y modificar cubemaps y volume textures - Detalles: [[dxCreateTexture]]
* Añadido un sistema de cache de modelos para reducir los retrasos de carga
* Añadido un sistema de cache de ropa para CJ para reducir los congelamientos en el juego
* Aumentada velocidad de los sistemas para llamar cliente y servidor
* Añadida la opcion element a [[engineApplyShaderToWorldTexture]]
* Añadido un bool opcional a [[getElementMatrix]] ( element, bool )
* Added optional bool to [[getElementMatrix]] ( element, bool )
* Added unrar for smoother update procedure
* Fixed custom model replacement errors sometimes with weapons & weapon pickups.
* Fixed vehicle upgrade custom models not showing immediately
* Fixed accuracy of hit point in [[onClientPlayerWeaponFire]] and added shot origin parameter
* Fixed [[setPedAimTarget]] direction being all wrong
* Fixed issue when peds' bullets origin from wrong position
* Fixed custom models not rendering correctly sometimes parameter
* Fixed custom model LOD distance is not reseting after quiting
* Added size limit for clientscript.log file
* Added ability to shoot with any weapon with jetpack
* Made timers less crashy
* Fixed some animation crashes
* Fixed [[getPedMoveState]] returns false when moving in crouch state
* Fixed a bug when a resource that replace an object model (dff) and texture (txd) is stopped the object texture get white
* Added ped pixel shaders
* Added ability to layer multiple shaders on a world texture
* Fixed Windows 8 missing dll error
* Fixed [[setElementPosition]] for vehicles on a non streamed in position will make the vehicle spin very quickly
* Added check for GTA file loading failures
* Fixed map editor crash
* Fixed floating vehicles when using [[setVehicleIdleRespawnDelay]]
* Fixed [[Client_Commands#showhud|showhud]] not fully working before the player has spawned
* Fixed connect problem when using a domain name that starts with a number
* Fixed missing font error message
* Fixed [[getSoundLength]] returns 0 for sound streams (not radio streams)
* Fixed a crash when taking a screenshot and minimizing then restoring
* Fixed setElementFrozen killing players from falls
* Fixed textures disappearing and flickering at certain camera angles

===Bugs Arreglados===
* Se ha corregido colisiones de vehículos personalizados las cuales no cargaban
* Se ha corregido que algunos modelos personalizados no cargaban
* onVehicleExplode es triggeable para los coches RC tambien ahora.
* Los proyectiles disparan a su distancia
* Arreglada el tatuaje de araña de CJ
* Speed up in entity collision detection client side
* Fixed the glitchy GTASA animation when you block+sprint (where hands are repeatedly raised and lowered)
* Fixed Objects scaled with setObjectScale aren't rendered when the unscaled bounding box goes off-screen
* Fixed Always falling off bikes and motorbikes
* Fixed Some vehicles become indestructible when a certain door is open
* Possible fix for client freezing/crashing after playing a long while
* Los marcadores en interiores ahora aparecen
* Chineese/Japanese/Korean input fixed

==Server==

===Nuevas Funciones===
* Añadido [[takePlayerScreenShot]]
* Añadido [[setOcclusionsEnabled]]
* Añadido [[removeWorldModel]] (Disponible en 1.2.0-3624)
* Añadido [[restoreWorldModel]] (Disponible en 1.2.0-3624)
* Añadido [[restoreAllWorldModels]] (Disponible en 1.2.0-3624)

===Nuevos eventos===
* Añadido [[onPlayerScreenShot]]

===Cambios===
* Ninguno todavía

===Arreglo de bug's===
* Arreglado el map downloader que aveces rompía el mapa en diferentes partes.

==Resources==
* Admin: añadido anti spam nick
* Freeroam: añadido de chat y spam opción de mensaje de repetición
* Freeroam: añadido libro de posicion

==Editor==
* Se agregó información LOD para ayudar a la eliminación de los LOD's

==Traductores==
* F4ST3R
* Pekio123
* Araa

ES/Página Principal

2012-10-20T19:35:11Z

Araa:

__NOTOC__
__NOEDITSECTION__

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 10px; height: 140px;">
[[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.

</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:10px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
=== El Juego ===
<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]]
* [[ES/Cambios en la versión 1.3|Cambios de la versión 1.3]] [[Image:flag_es.png|En Español|20px]] (Traducción 70%)
* [[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.
* [[ES/Useful_Functions| Funciones útiles]] [[Image:flag_es.png|En Español|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/Cambios en la versión 1.3

2012-10-20T19:33:20Z

Araa: /* Cambios */

ES/Cambios en la versión 1.3

2012-10-20T19:25:02Z

Araa: /* Cliente */

ES/Cambios en la versión 1.3

2012-10-20T19:23:52Z

Araa: /* Nuevos Eventos */

ES/Cambios en la versión 1.3

2012-10-20T19:22:59Z

Araa: /* Nuevas Funciones */

ES/Cambios en la versión 1.3

2012-10-20T19:21:33Z

Araa: /* Principales Cambios */

ES/Introducción a Lua

2012-09-26T22:15:59Z

Araa: /* Events */

Los llamados "resources" son fundamentales en MTA. Básicamente consisten en una carpeta o archivo ZIP que contiene una colección archivos, además de un archivo '''meta.xml''' que define qué archivos pertenecen al resource, algunas configuraciones, y otras cosas. Como los programas en un sistema operativo, los resources pueden ser iniciados, detenidos, y reiniciados, y varios pueden funcionar al mismo tiempo.

Todo lo que es la programación ocurre dentro de los resources. Lo que éste haga define si se trata de un modo de juego, un mapa, un script sencillo, u otra cosa. MTA, por defecto, trae ciertos resources que puedes usar opcionalmente en tus modos de juego.

'''Lo primero que debes tener en cuenta al iniciarte en la programacion en LUA, es conseguir un editor que funcione para ello. Esto hace mucho más facil tu trabajo, permitiéndote corregir el sintaxis de las matemáticas, por ejemplo. El equipo de MTA recomienda [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] y [http://luaedit.sourceforge.net/ LuaEdit].'''

==Creando un script funcional==
Primero, aprenderemos a hacer un script que permita al jugador caminar libremente por la ciudad. Esto lo explicaremos paso a paso.

===Estructura de un script y ubicación del mismo===
Dirijámonos a la carpeta raíz de tu servidor para MTA (por defecto es ''C:\Archivos de Programa\Multi Theft Auto\server''). Después vamos a la siguiente ubicación:

\server\mods\deathmatch\resources\

Verás muchos archivos ZIP. Como mencioné antes, estos ZIP son los resources, que vienen por defecto con MTA. Para crear tu propio resource, añade una carpeta a esta ubicación, y dale un nombre. Recomiendo que, al ser tu primer script, sigas las instrucciones al pie de la letra, y a esta carpeta la llames "myserver".

Ahora, entremos a la ubicación:

\resources\myserver\

===Identificando tu resource===
Como mencioné antes, todo resource tiene un archivo que define el tipo, los archivos, y las configuraciones del resource, es el ''meta.xml''. Siempre debe estar dentro de cada resource, de otra forma éste no funciona. Así que creemos un archivo de texto, y llamémoslo "meta.xml" (sin las comillas). Luego abrámoslo con el Bloc de Notas, o con Microsoft Wordpad.

Una vez dentro de este archivo, agregaremos el siguiente código:

<syntaxhighlight lang="xml">
<meta>
<info author="TuNombre" type="gamemode" name="Mi Servidor" description="Mi primer servidor de MTA DM" />
<script src="script.lua" />
</meta>
</syntaxhighlight>

En la etiqueta ''<info />'' hay un campo "type". Éste indica el tipo de resource, que siendo "gamemode" en este caso, define que es un modo de juego. Nótese que cuando es otro tipo de resource, el valor "type" cambia. Pero eso lo veremos luego. Por ahora, un modo de juego es lo que necesitas para comenzar un servidor.

La etiqueta ''<script />'' indica el script que tendrá nuestro modo de juego. A continuación, cómo crearlo.

===Creando un script simple===
Nótese que en la etiqueta ''<script />'', el archivo Lua no está en otro directorio, como por ejemplo ''myserver\script.lua''. Esto es porque el archivo LUA del que hablamos será creado en el mismo lugar en el que el archivo ''meta.xml''. Bueno, ahora creamos en "myserver", otro archivo de texto, y lo llamamos "script.lua". Abrámoslo y agreguemos estas líneas:

<syntaxhighlight lang="lua">
function manejadorDeInicio()
local x = 1959.55
local y = -1714.46
local z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Bienvenido a Mi Servidor", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>

Este script inicia a tu jugador en las coordenadas "x", "y" y "z" (spawnPlayer) cuando entras al servidor. OJO: ¡La función ''fadeCamera'' siempre debe ser usada cuando inicias al jugador, de otra forma, la pantalla quedará en negro!. Lo mismo pasa con la función ''setCameraTarget''; si no la usas, el jugador no podrá verse a sí mismo, si no que mirará al cielo infinito.

La variable '''source''' indica qué fue lo que ocasionó al evento. Como el evento ''onPlayerJoin'' significa ''alIniciarJugador'', lógico que lo que ocasione a este evento sea el jugador. Así, evitaremos iniciar a cualquier jugador.

Ahora, dirigiéndonos a [[addEventHandler]], podrás ver que posee 3 cosas: ''onPlayerJoin'' (el nombre del evento), ''getRootElement()'' (que indica por qué o quién será iniciado el evento, ya que ''getRootElement()'' significa "todo"), y ''joinHandler'', que es el nombre de la función a ejecutar cuando el evento sea activado.

Con esto, deberías poder comenzar a jugar. Pero faltan algunos detalles... ¡Sigamos!

===Corriendo el script===
Para que tu servidor local sea iniciado, debes ir a la carpeta raíz de tu servidor (recuerda cuando fuimos a los resources, 2 puestos encima). Una vez que lo inicies, aparecerá una consola con una serie de datos; recuerda el número del puerto, porque lo necesitarás para jugar. Cuando aparezca un mensaje que diga "Server started and is ready to accept connections!", sabrás que ya está listo.

Pero antes de jugar, debes iniciar el modo de juego. Escribe "gamemode myserver" en la consola del servidor, y presiona Enter. El servidor emitirá algunos mensajes, e iniciará tu modo de juego, y si algún error surge, nos lo dirá. Bueno, ahora es tiempo de probar el modo de juego. Inicia MTA, y en el menú principal escoge "Quick Connect". Apareceren 3 campos. En el primero, escribe "localhost", en el segundo, el número del puerto de tu servidor, y en el tercero, nada, después de todo es la contraseña,y tú no pusiste ninguna. Si todo funciona bien, deberías poder comenzar a jugar en Los Santos.

A continuación, te enseñaremos a crear un comando que permita crear un vehículo a tu lado. Si quieres, puedes saltarte este paso y seguir la programación avanzada con [[Map manager|Map Manager]], que continúa este tutorial. También puedes revisar [[Introduction to Scripting GUI| Introducción a la Programación del GUI]], en el que te enseñaremos a diseñar la Interfaz Gráfica de Usuario (GUI en inglés, por ''Graphical User Interface'').

==Creando un Comando==
Volvamos a ''script.lua''. Como dije hace un momento, crearemos un comando que permita crear un vehículo a tu lado. Primero, necesitaremos crear una función a la que llamar, y un manejador de comandos que cree el comando buscado.

<syntaxhighlight lang="lua">
-- Aquí creamos la función que llama el manejador, con los argumentos "elJugador", "nombreDelComando", "modeloDeVehiculo":
function crearVehículoParaJugador(elJugador, nombreDelComando, modeloDeVehículo)
-- Crear el vehículo y otros.
end

-- Aquí creamos el manejador de comandos:
addCommandHandler("crearvehiculo", crearVehículoParaJugador)
</syntaxhighlight>

'''Nota:''' ''Los nombres de las funciones tienen enlaces que te llevan a la '''documentación''' de ellas.''

====Acerca de los manejadores de comandos====
El primer argumento de ''addCommandHandler'' es el nombre del comando que el jugador podrá ingresar, y el segundo es la función que ejecutará en el momento de ingreso del comando (en este caso ''crearVehiculoParaJugador'').

Si tienes alguna experiencia con la programación en C o algún lenguaje parecido, sabrás que las funciones se ejecutan de la forma:

<syntaxhighlight lang="lua">
nombreDeFunción(argumento1, argumento2, argumento3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
nombreDeFunción(elJugador, nombreDelComando, argumento3, ..)
</syntaxhighlight>

Fijémonos bien en esto. Vemos que ''argumento1'' es ''elJugador'' y ''argumento2'' es ''nombreDelComando''. ''elJugador'' representa al jugador que haya ingresado el comando, por lo que de la forma que lo llames, esta variable será el jugador. ''nombreDelComando'' es simplemente el nombre del comando (sin la barra "/"), no hay ningún misterio en ello, por lo que si el jugador escribió "/crearvehiculo" entonces esta variable sería "crearvehiculo". Por último, ''argumento3'' representa una variable más, que estudiaremos más adelante. Nunca olvides que los 2 primeros argumentos son obligatorios y están predefinidos (y debes tenerlos en el orden que se indican), pero puedes llamarlos como sea.

''addCommandHandler'' permite llamar fácilmente a funciones como ''crearVehículoParaJugador'', de forma interna.

Por ejemplo: Alguien entra el comando "/crearvehiculo 468". El servidor creará el vehículo 468, es decir, la moto Sánchez. Dentro del código, ''addCommandHandler'' llama a la función ''crearVehículoParaJugador'' como si hubiera sido escrito así:

<syntaxhighlight lang="lua">
crearVehículoParaJugador(elJugador,"crearvehiculo","468") -- Recuerda que "elJugador" es el elemento jugador que entró el comando.
</syntaxhighlight>

Como podemos ver, esto prevée ciertos argumentos que ya hemos mencionado. Pero el más importante es "468", que es el "argumento3" del que hablábamos más arriba. Éste se refiere al modelo del vehículo. Recuerda que siempre debes definir los primeros 2 parámetros ("elJugador" y "nombreDelComando"), porque de otra forma el comando no funcionará.

'''Nota:''' ''Tienes que poner el manejador de comandos DEBAJO de la función a llamar por el comando. ¡El orden de las ejecuciones es fundamental!''

====Escribiendo la función====
Para llenar la función que hemos creado, primero hay que plantearse qué se debe hacer:
* Conseguir la posición del jugador, así sabremos dónde crear el vehículo (queremos que aparezca al lado del jugador).
* Calcular la posición donde crearemos el vehículo (no queremos que aparezca en el jugador).
* Crear el vehículo.
* Revisar si fue creado. Si no, mostrar alguna advertencia o algún mensaje de error.

Para conseguir estos objetivos, debemos usar ciertas funciones, las cuales se pueden ver visitando la [[Scripting Functions| Lista de Funciones de Servidor]]. Primero, una función para conseguir la posición del jugador. Si visitaste la [[ES/Clases MTA| Lista de Clases de MTA]], sabrás que un jugador es un elemento, lo que nos lleva a buscar una '''Función de Elemento''', la cual es ''[[getElementPosition]]''. Haciendo click en ella, visitarás la documentación de ella, que contiene una descripción, el sintaxis (los argumentos necesarios en la función), y, generalmente, un ejemplo de cómo usarla.

Para la función [[getElementPosition]], el sintaxis sería:

<syntaxhighlight lang="lua">
float, float, float getElementPosition ( elemento elElemento )
</syntaxhighlight>

Los 3 ''float'' que aparecen, son los valores que regresa la función. Estos valores, en español, se llaman '''Número de punto flotante''', y son números que pueden o no, poseer decimales (véase la [[ES/Tipos de Valores| Lista de tipos de valores]]). Como "x", "y" y "z" son coordenadas, por defecto siempre serán números de punto flotante. Ahora, fijándonos en los paréntesis, notaremos que sólo aparece "elElemento" como argumento de la función. Pues, aplicando la función a un jugador, tendríamos algo como esto:

<syntaxhighlight lang="lua">
function crearVehículoParaJugador(elJugador, nombreDelComando, modeloDeVehículo)
--[[Aquí conseguiremos la posición del jugador, y la almacenaremos en 3 valores: "x", "y" y "z". Nota: "local" significa que las variables indicadas sólo pueden ser usadas en la función actual.]]--
local x,y,z = getElementPosition(elJugador)
end
</syntaxhighlight>

Ahora, para crear el vehículo al lado del jugador, debemos modificar alguna coordenada, en este caso, "x".

<syntaxhighlight lang="lua">
function crearVehículoParaJugador(elJugador, nombreDelComando, modeloDeVehículo)
local x,y,z = getElementPosition(elJugador)
x = x + 5 --Agregamos 5 a la posición "X" (¡esto no altera la posición del jugador!)
end
</syntaxhighlight>

Nuevamente, necesitamos otra función para crear el vehículo. Buscándola en la [[Scripting Functions| Lista de Funciones de Servidor]], la encontraremos. Ya que hablamos de vehículo, vamos a la subcategoría tal, en la que encontramos [[createVehicle]]. En esta función, el valor que regresa la función consta de 1 solo argumento (esto es lo más común en las funciones), y es el vehículo creado, o un valor "boolean" ("lógico" en inglés) de tipo "false", si el vehículo no fue creado.

<syntaxhighlight lang="lua">
function crearVehículoParaJugador(elJugador, nombreDelComando, modeloDeVehículo)
local x,y,z = getElementPosition(elJugador)
x = x + 5
local vehículoCreado = createVehicle(tonumber(modeloDeVehículo),x,y,z)
end
</syntaxhighlight>

Nótese que usamos "tonumber(modeloDeVehículo)" en vez de usar directamente "modeloDeVehículo". Esto es porque cuando entramos un comando, todos los argumentos salen en forma de "string" ("arreglo" en inglés), que es un tipo de valor textual. Por ello, no puede ser usado como número, y la función "tonumber()" nos permite dejarlo como un número.

Bueno, tenemos todo lo necesario para que nuestro script funcione, pero eso no indica que esté listo. Ya tenemos la función para conseguir la posición del jugador, modificarla, y crear el vehículo. Pero nos falta el mensaje. La función para esto se llama ''outputChatBox''. Como dije antes, si el vehículo no fue creado, entonces regresa un valor "false". Así que creamos nuestra primera condición, en la que si el valor regresado es falso, entonces aparece un mensaje.

Veamos cómo luce el script final:

<syntaxhighlight lang="lua">
function crearVehículoParaJugador(elJugador, nombreDelComando, modeloDeVehículo)
local x,y,z = getElementPosition(elJugador)
x = x + 5
local vehículoCreado = createVehicle(tonumber(modeloDeVehículo),x,y,z)
if (vehículoCreado == false) then --"if" es la condición, siempre debe ir acompañado de la condición y un "then".
outputChatBox("Error al crear vehículo.",elJugador) --Crea un mensaje de error simple en el chat.
end
end
addCommandHandler("crearvehiculo", crearVehículoParaJugador) --Y aquí creamos el manejador de comandos.
</syntaxhighlight>

Nada mal, ¿no? Ya te hemos introducido en la creación de 2 scripts sencillos. Si quieres más programación avanzada, entonces visita el [[Map Manager| Mánager de Mapas]].

==Lo que necesitas saber==
Ya has leído un poco sobre resources, manejadores de comandos y funciones de búsqueda en la documentación (en el primer párrafo), pero aún queda mucho por aprender. En esta sección te daremos una vista rápida sobre esto, y si se puede, enlazar a otras páginas útiles.

===Scripts de cliente y servidor===
Quizás ya has notado los términos Server (o Servidor) y Client (o Cliente) en algún lado, mayormente en conjunción con las funciones. MTA no sólo soporta scripts que funcionan en el servidor y prevén comandos (como el que escribimos arriba) u otras características; también scripts que corren en el cliente (MTA en sí, el software que usas para conectarte a los servidores). Esto se debe a que algunas funciones tienen que estar del lado cliente (como el GUI; Graphical User Interface, Interfaz de Usuario Gráfica), si bien funcionan mejor o porque no se pueden hacer en el servidor.

La mayoría de los scripts que harás (modos de juego y/o mapas) probablemente serán de tipo servidor, como el que escribimos en la primera sección. Si tratas de hacer funcionar algo que no se puede hacer en el servidor, probablemente tendrá que ser de cliente. para un script de cliente, por ejemplo, podrías crear un archivo de Lua ordinario (como ''client.lua'') y especificarlo en el archivo meta.xml, así:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
El atributo ''type'' por defecto es 'server' (servidor), por lo que no es necesario escribirlo cuando se trata de scripts de servidor. Si quieres, puedes leer más sobre [[ES/Scripts de Cliente|scripts de cliente]].

===Resources más complejos===

(Falta traducir desde aquí)

The previous section showed briefly how to add clientside scripts to the resource, but there is also much more possible. As mentioned at the very top of this page, resources can be pretty much everything. Their purpose is defined by what they do. Let's have some theoretical resources, by looking at the files it contains, the ''meta.xml'' and what they might do:

====First example - A utility script====
<syntaxhighlight lang="xml">
/admin_commands
/meta.xml
/commands.lua
/client.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="admin commands" />
<script src="commands.lua" />
<script src="client.lua" type="client" />
</meta>
</syntaxhighlight>

* The ''commands.lua'' provides some admin commands, like banning a player, muting or something else that can be used to admin the server
* The ''client.lua'' provides a GUI to be able to perform the mentioned actions easily

This example might be running all the time (maybe even auto-started when the server starts) as it's useful during the whole gaming experience and also wont interfere with the gameplay, unless an admin decides to take some action of course.

====Second example - A gamemode====
<syntaxhighlight lang="xml">
/counterstrike
/meta.xml
/counterstrike.lua
/buymenu.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike remake" type="gamemode" />
<script src="counterstrike.lua" />
<script src="buymenu.lua" type="client" />
</meta>
</syntaxhighlight>

* The ''counterstrike.lua'' contains similiar to the following features:
** Let players choose their team and spawn them
** Provide them with weapons, targets and instructions (maybe read from a Map, see below)
** Define the game's rules, e.g. when does the round end, what happens when a player dies
** .. and maybe some more
* The ''buymenu.lua'' is a clientside script and creates a menu to buy weapons

This example can be called a gamemode, since it not only intereferes with the gameplay, but actually defines the rules of it. The ''type'' attribute indicates that this example works with the [[Map manager]], yet another resource that was written by the QA Team to manage gamemodes and map loading. It is highly recommended that you base your gamemodes on the techniques it provides.

This also means that the gamemode probably won't run without a map. Gamemodes should always be as generic as possible. An example for a map is stated in the next example.

====Third example - A Map====
<syntaxhighlight lang="xml">
/cs-airport
/meta.xml
/airport.map
/airport.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike airport map" type="map" gamemodes="counterstrike" />
<map src="airport.map" />
<script src="airport.lua" />
</meta>
</syntaxhighlight>

* The ''airport.map'' in a XML file that provides information about the map to the gamemode, these may include:
** Where the players should spawn, with what weapons, what teams there are
** What the targets are
** Weather, World Time, Timelimit
** Provide vehicles
* The ''airport.lua'' might contain map-specific features, that may include:
** Opening some door/make something explode when something specific happens
** Create or move some custom objects, or manipulate objects that are created through the .map file
** .. anything else map-specific you can think of

As you can see, the ''type'' attribute changed to 'map', telling the [[Map manager]] that this resource is a map, while the ''gamemodes'' attribute tells it for which gamemodes this map is valid, in this case the gamemode from the above example.
What may come as a surprise is that there is also a script in the Map resource. Of course this is not necessarily needed in a map, but opens a wide range of possibilities for map makers to create their own world within the rules of the gamemode they create it for.

The ''airport.map'' file might look similiar to this:
<syntaxhighlight lang="xml">
<map mode="deathmatch" version="1.0">
<terrorists>
<spawnpoint posX="2332.23" posY="-12232.33" posZ="4.42223" skins="23-40" />
</terrorists>
<counterterrorists>
<spawnpoint posX="2334.23443" posY="-12300.233" posZ="10.2344" skins="40-50" />
</counterterrorists>

<bomb posX="23342.23" posY="" posZ="" />

<vehicle posX="" posY="" posZ="" model="602" />
<vehicle posX="" posY="" posZ="" model="603" />
</map>
</syntaxhighlight>

When a gamemode is started with a map, the map resources is automatically started by the mapmanager and the information it contains can be read by the gamemode resource. When the map changes, the current map resource is stopped and the next map resource is started. For a more in-depth explanation and examples of how map resources are utilized in the main script, please visit the [[Writing Gamemodes]] page.

===Eventos===
Los eventos son la manera en la cual MTA le informa a los scripts cuando las cosas estan ocurriendo. Por ejemplo cuando un jugador muere, el evento [[onPlayerWasted]] es llamado. De manera de realizar cualquier accion cuando un jugador muere, tienes que prepararlo tu mismo, de manera similar a como cuando añades un command handler en[[#Writing_the_script|el primer capitulo]].

Este ejemplo mostrara un mensaje con el nombre del jugador que murió.
<syntaxhighlight lang="lua">
function playerDied(totalAmmo, killer, killerWeapon, bodypart)
outputChatBox(getPlayerName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

Instead of showing what arguments are needed, the documentation page for Events shows what parameters are passed to the handler function, similiar to the way a [[#About_command_handlers|command handler]] does, just that it is different from event to event. Another important point is the ''source'' variable, that exists in handler functions. It doesn't have to be added to the parameter list of the function, but it still exists. It has a different value from event to event, for player events (as in the example above) it is the player element. As another example, you can take a look at the basic spawning player script in the first section to get an idea how ''source'' is used.

==¿Y ahora qué?==
Deberías ya estar familiarizado con los aspectos básicos de los scripts de MTA, así como con la documentación. La [[ES/Pagina Principal|Página Principal]] te provee de enlaces con mayor información, así como tutoriales y Referencias que permiten una vista más profunda a los temas que te interesan.

Recomendamos que leas el tutorial de [[debugging|debug]] (encuentro de errores). Es necesaria una buena habilidad con el "debug" cuando haces scripts. ¡Suerte en MTA!

==Traductores==

*Benxamix2/The Kid

[[ru:Scripting Introduction]]
[[it:Introduzione allo scripting]]
[[en:Scripting Introduction]]