Multi Theft Auto: Wiki - User contributions [en]

Página Inicial

2021-02-16T22:08:06Z

Cristiano Cardoso: [+] link para tutorial CEF (navegador)

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Bem vindo ao Wiki do Multi Theft Auto.''' Aqui você encontra tudo sobre o uso desta modificação.

Há muitas [[How you can help|coisas em que você pode nos ajudar]] para melhorar este programa, como criar um mapa, um modo de jogo, documentar funções e eventos, escrever códigos úteis para outros usuários, fazer tutoriais, reportar bugs que encontrar ou somente jogar a vontade!

Se você tem alguma dúvida a respeito do Multi Theft Auto, não se esqueça de perguntar à comunidade em nossos [http://forum.mtasa.com/ fóruns].
<br><br>
[ Pare de jogar sozinho ]
<br><br>
</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; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div>
<h3>Jogar</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Baixe o Multi Theft Auto {{Current Version|full}}]'''</div>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Onde_adquirir_o_GTASA|Onde adquirir o GTASA]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Cliente|Manual do usuário]]

* [[Image:iUS.png|Em Inglês|20px]] [[Changes_in_{{padleft:|5|{{Current Version|full}}}}| Novidades da versão {{padleft:|5|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de problemas]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Migrando_do_MTA:Race_ao_MTA:SA_1.3|Migrando do MTA:Race para o MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Servidor|Manual do servidor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Recursos:Map_Manager|Gerenciador de mapas (''Map Manager'')]]

<h3>Editor de mapas</h3>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor|Manual do editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-EDF|Ficheiro de definições do editor (EDF)]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-Plugins|Extensões para o editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor#FAQ|Perguntas frequentes (FAQ)]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div>
<h3>Banco de dados</h3>
Aqui tem tudo relacionado às vantagens que Lua tem a oferecer ao MTA e seus recursos.
* [[Image:iUS.png|Em Inglês|20px]] [[:Category:Resource|Catálogo de Recursos]] - Você deve aprender com eles para fazer scripts bons
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Scripts_do_Cliente|Scripts do Cliente]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Módulos|Módulos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div>
<h3>Desenvolvimento do Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Últimas compilações]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA|Compilando o MTASA no Windows]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Mac_OS_X|Compilando o MTASA no Mac OS X]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Linux|Compilando o MTASA no Linux]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Guia_do_Desenvolvedor|Guia do Desenvolvedor]]
* [[File:iUS.png|Em Inglês|20px]] [https://github.com/multitheftauto/mtasa-blue Repositório Github]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Roadmap|Roteiro para versões futuras]]
* [[File:iUS.png|Em Inglês|20px]] [http://bugs.mtasa.com/ Central de bugs]
* [[File:iUS.png|En Inglês|20px]] [[Branches|Ramos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</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|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [irc://irc.multitheftauto.com/mta IRC]
* [[File:iUS.png|Em Inglês|20px]] [http://community.mtasa.com/ Comunidade]
* [[File:iUS.png|Em Inglês|20px]] [http://twitter.com/#!/MTAQA/ Twitter]
* [[File:iUS.png|Em Inglês|20px]] [http://www.youtube.com/user/MTAQA Youtube]
* [[File:iUS.png|Em Inglês|20px]] [http://plus.google.com/102014133442331779727/ Google]
* [[File:iUS.png|Em Inglês|20px]] [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</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|link=]]</div>
<h3>Scripting</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introdução_ao_Scripting|Introdução a ''scripting'']]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introducao_ao_GUI_scripting|Introdução a ''scripting'' de UI]]
* [[File:iBR.png|Em Português|20px]] [[Depuração|Depuração]] - Encontre erros em seu Script
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Recursos|Introdução a recursos]]
** [[File:iBR.png|Em Português|20px]] [[Acesso web via recursos|Acesso web via recursos]] - Abra servidores web através de recursos
** [[File:iBR.png|Em Português|20px]] [[PT-BR/Tutorial_CEF|Tutorial CEF]] - Como usar o navegador web em seus recursos
** [[File:iBR.png|Em Português|20px]] [[:Category:PT-BR/Recursos|Lista de recursos]]
** [[File:iBR.png|Em Português|20px]] [[O arquivo Meta|Meta.xml]] - Todo recurso possui um arquivo meta descrevendo a si próprio
** [[File:iBR.png|Em Português|20px]] [[Lista de Controle de Acesso|Lista de controle de acesso (ACL)]] - Componente vital para recursos complexos
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Composição_de_Gamemodes|Composição de modos de jogo]]
<h3>Links dos fóruns</h3>
* [[File:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=152 Secção do fórum para dúvidas sobre ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewforum.php?f=148 Guias de ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Wiki ''offline'']
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Manuais sobre Lua</h3>
Página muito útil para ajuda-lo a entender o funcionamento do Lua
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/portugues.html Introdução à linguagem]
* [[File:iUS.png|Em Inglês|20px]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Manual básico]
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/manual/5.1/pt/ Manual de referência]
* [[File:iUS.png|Em Inglês|20px]] [http://lua-users.org/wiki/TutorialDirectory Outra wiki, somente de Lua]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Referência</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Funções_de_Scripting_do_Cliente|Funções de Scripting do Cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Events|Eventos do cliente]]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Funções_de_Scripting_do_Servidor|Funções de Scripting do Servidor]]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Eventos_de_Scripting_do_Servidor|Eventos de Scripting do Servidor]]
* [[File:iUS.png|Em Inglês|20px]] [[PT-BR/Funções_Úteis|Funções Úteis]]

* [[File:iUS.png|Em Inglês|20px]] [[MTA Classes|Classes do Multi Theft Auto]] - Informações detalhadas sobre todas as classes do MTA
** [[File:iUS.png|Em Inglês|20px]] [[Element tree|Árvore dos elementos]]
</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|link=]]</div>
<h3>[[Id|Lista de IDs de objetos e texturas]]</h3>
*[[Animations|Animações]]
*[[Character Skins|''Skins'' de pedestres]]
*[[Roupas do CJ|Roupas do CJ]]
*[[Garage|Garagens]]
*[[Interior IDs|Interiores]]
*[[Material IDs|Materiais]]
*[[Projectiles|Projéteis]]
*[[Radar Blips|''Blips'']]
*[[Sounds|Efeitos sonoros]]
*[[Vehicle IDs|Veículos]]
*[[Vehicle Colors|Cores dos veículos]]
*[[Vehicle Upgrades|Acessórios dos veículos]]
*[[Vehicle variants|Variantes dos veículos]]
*[[Weapons|Armas]]
*[[Weather|Ambientação]]
</div>

<div style="border: 1px dotted #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:pBR.png|32px]]</div>

<h3>Sobre a Tradução</h3>
* Tradutores:
** [https://forum.mtasa.com/profile/19686-racextreme/|<span style="color: blue">RaceXtreme</span>]
** [https://forum.mtasa.com/profile/27827-stanley-sathler/|<span style="color: blue">StanleySathler</span>]
** [https://forum.mtasa.com/profile/24588-dnl291/|<span style="color: blue">DNL291</span>]
** [https://forum.mtasa.com/profile/30695-ymassai/|<span style="color: blue">Ninguem</span>]
** [https://forum.mtasa.com/profile/31772-anderl/|<span style="color:blue">Anderl</span>]
** [https://forum.mtasa.com/profile/71215-kronos-lettify|<span style="color:blue">KronoS Lettify</span>]
** [https://forum.mtasa.com/profile/69598-eficiencia/|<span style="color:blue">Eficiencia</span>]

É importante que todos colaborem para que nossa página em português fique melhor a cada dia!

[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' é um projeto '''open source'''. <br>
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Sobre o Multi Theft Auto'''</li>
<li>[[Archive|Arquivos]]</li>
<li>[[Press Coverage|Eventos]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Desenvolvedores]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Baixe-o]]</li>
<li>[[MTA 0.5r2 Known Issues|Solução de problemas]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Status da Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artigos</li>
<li>{{NUMBEROFPAGES}} páginas</li>
<li>{{NUMBEROFUSERS}} usuários registrados</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pt-br}}

CEF Tutorial

2021-02-16T22:05:46Z

Cristiano Cardoso: [+] link to translated pt_BR page

This page gives you a brief introduction to CEF.

=What is CEF?=
CEF stands for '''C'''hromium '''E'''mbedded '''F'''ramework and is a framework for embedding Chromium-based browsers in other applications - in our case MTA. CEF is based on Google's Chromium project so it is also a fast, secure and stable web engine.

You can find more information about CEF on CEF's GoogleCode project page: https://bitbucket.org/chromiumembedded/cef

=The basics=
Creating a new browser is really simple. Let's open YouTube for example:
<syntaxhighlight lang="lua">
-- Create a new remote browser (size is 800*600px) with transparency enabled
local browser = createBrowser(800, 600, true, true)

-- "Wait" for the browser (this is necessary because CEF runs in a secondary thread and hence requires the 'asynchronous' event mechanism)
addEventHandler("onClientBrowserCreated", browser,
function()
-- We're ready to load the URL now (the source of this event is the browser that has been created)
loadBrowserURL(source, "https://youtube.com/")
end
)</syntaxhighlight>
This example does not require any domain requests as YouTube is whitelisted by default. More about domain requests below.

=Domain request system=
In order to prevent people from abusing the possibilities CEF offers, we decided to introduce a request system.
This means the domain you want to load has to meet at least one of the following requirements:
*it is whitelisted globally by the MTA team (you can create a post in [this topic] to suggest a new domain to be whitelisted) - '''**TODO: Add forum URL here**'''
*the domain was requested via requestBrowserDomains/Browser.requestDomains and accepted by the player '''before'''
*the domain is on the user's whitelist (MTA settings => Tab: Browser => Whitelist)

Apart from these options, a domain might be blacklisted due to malicious content. Such domains cannot be requested.

=Local vs remote mode=
There are two modes CEF can run in:

Characteristics of local mode:
*you '''can''' execute Javascript code without any restriction (See: [[executeBrowserJavascript]])
*you '''can''' only load websites stored in the resource folder
*you '''cannot''' load remote content

Characteristics of remote mode:
*you '''cannot''' execute Javascript code
*you '''can''' only load remote content
*keep in mind that either loading remote websites or Javascript on remote websites can be disabled in the MTA settings

Changing the mode after the browser was created is not possible due to technical reasons.

=Resource management=
==How to load local HTML files==
Loading local HTML files works similar to loading images.

Add your HTML files to your meta.xml through the file tag:
<syntaxhighlight lang="xml">
<file src="html/myAwesomeUI.html"/></syntaxhighlight>

==How to load local resources in local HTML files==
Imagine you want to load an image or play a video from your MTA resource. This is possible via a custom URI scheme named '''''"http://mta/"'''''

===Example===
This examples shows how to play a video. Note that you have to enable OOP.
====Lua====
<syntaxhighlight lang="lua">
-- Create a browser (local mode is also required to access local data)
local webView = Browser(640, 480, true, true)

addEventHandler("onClientBrowserCreated", webView,
function()

-- Load HTML UI
webView:loadURL("http://mta/local/html/myVideo.html")

end
)</syntaxhighlight>
====meta.xml====
<syntaxhighlight lang="lua">
<file src="html/myVideo.html"/>
<file src="media/myVideo.webm"/></syntaxhighlight>
====HTML====
This is the most interesting part:
<syntaxhighlight lang="html">
<!DOCTYPE HTML>
<html>
<head></head>
<body>
<video width="640" height="480" controls>
<source src="http://mta/local/myVideo.webm" type="video/webm"/>
</video>
</body>
</html></syntaxhighlight>

=Lua <==> Javascript communication=
First of all, communication between Lua and Javascript is only available in local mode due to security reasons.

==Lua to Javascript==
Lua to javascript is pretty easy as you can execute Javascript code from Lua using [[executeBrowserJavascript]].

So, a bit Lua code around it and you have got the first direction:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/WebWindow.lua#L180-189
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/mtaevents.js#L9-L15

==Javascript to Lua==
You are able to trigger a client event via the Javascript method ''triggerEvent'' which is part of the static class/namespace ''mta''.
The syntax is as follows:
<syntaxhighlight lang="javascript">
mta.triggerEvent(string event, var parameter1, var parameter2, var parameter3, ...)
</syntaxhighlight>
The source of this event is always the browser element that triggered the event.

An example is available here:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/html/ui2.html#L66
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/Main.lua#L35-L40

=Debugging=
The ''web development mode'' can be enabled as follows (type it in the client's F8 console):
<syntaxhighlight lang="lua">start runcode
crun setDevelopmentMode(true, true)
debugscript 3</syntaxhighlight>
Now, you should be able to see web errors and blocked domains/URLs in the debug window at the bottom.

=Things you should keep in mind while working with CEF=
You should always keep in mind that some modern browser features are not available on some computers.
This is for example true for '''WebGL'''.

Another problematic feature is '''Adobe Flash'''. Adobe Flash is enabled by default, but you should avoid using it due to the fact that plugins can be disabled in the settings on the one hand (Java is disabled completely by the way) and Flash is very restrictive on the other hand. Restrictive means it runs in a separate process uses a very old interface and offers therefore just a few ways to control it.
As a consequence, you cannot control the volume of flash objects. Fortunately, HTML5 is an even better replacement and provides very good audio and video interface (http://www.w3schools.com/tags/ref_av_dom.asp) which even supports 3D sound (@all bored people among us: Feel free to write a 3D sound 'wrapper' that maps the GTA onto HTML5 coordinates :P).

=Advanced usage=
Since our CEF implementation does not do z-ordering by default, you have to provide your own z-ordering mechanism.
You can find a basic implementation of such a mechanism here: https://github.com/Jusonex/mtasa_cef_tools
There are also a few utility functions that allow you to integrate these classes easily into your own object-oriented UI system.
I'll provide some code to use CEF along with CEGUI soon too.

=Performance=
Creating lots of browsers does not influence MTA directly (except the fact MTA has to copy the texture data in the main/GTA thread due to technical restrictions), because one part of CEF runs in another process and the other part in a secondary thread.
So if you do not want to show the browser, it is definitely the best to destroy the browser. If you cannot destroy the browser (imagine you have to save the website's state for some reason), you can save a lot of resources by disabling rendering via [[setBrowserRenderingPaused]]. This will stop CEF from rendering new frames/processing input and MTA from copying the texture data.

=Troubleshooting=
===google.com doesn't work (even though I requested google.com)===
Google redirects to a country-specific website by default. If you want to prevent Google from doing this, load the following URL: https://www.google.com/ncr

=Scripting functions=
{{CEF_functions}}
=Scripting events=
{{CEF_events}}

[[Category:Tutorials]]

[[pt-br:Tutorial_CEF]]

PT-BR/Tutorial CEF

2021-02-16T22:03:32Z

Cristiano Cardoso: [+] tradução para Tutorial CEF (navegador)

Esta página possui uma breve introdução ao CEF.

=O que é CEF?=
CEF é um acrônimo para '''C'''hromium '''E'''mbedded '''F'''ramework. Consiste em um ''framework'' para embutir navegadores baseados no Chromium em outras aplicações, neste caso, o MTA. CEF é construido a partir do projeto Chromium mantido pela Google, este por sua vez consiste em um motor web rápido, estável e seguro. É possível encontrar mais informações sobre o CEF em sua página do GoogleCode: https://bitbucket.org/chromiumembedded/cef

=Conceitos Básicos=
Criar uma nova instância do navegador é bem simples. Segue o exemplo para abrir a página do Youtube:
<syntaxhighlight lang="lua">
-- Criar um novo navegador remoto (seu tamanho é 800x600px), com transparência habilitada
local browser = createBrowser(800, 600, true, true)

-- Aguardar pelo navegador (isso é necessário porque o CEF roda em uma thread separada, portanto é necessário adotar o sistema de eventos assíncronos)
addEventHandler("onClientBrowserCreated", browser,
function()
-- Agora é possível carregar a URL (o "source" desse evento é o navegador que foi criado)
loadBrowserURL(source, "https://youtube.com/")
end
)</syntaxhighlight>
Este exemplo não requer solicitação de domínio já que o Youtube está na lista de domínios autorizados do MTA.

=Sistema de Requisição de Domínios=
De modo a prevenir abuso quanto as possibilidades que o CEF oferece, decidiu-se introduzir um sistema de controle. Isso significa que domínios desconhecidos não serão carregados automaticamente caso não cumprir com pelo menos uma das exigências a seguir:
* estar incluso na lista mantida pelo time de desenvolvimento do MTA
* ser autorizado pelo usuário após a chamada via ''script'' da função <code>requestBrowserDomains/Browser.requestDomains</code>
* estar incluso na lista de domínios permitidos do usuário, esta disponível em: Configurações do MTA → Aba: Navegador → ''Whitelist''

Alguns domínios são conhecidos por conter conteúdo malicioso, portanto há uma chance desse estar na lista proibida - esta gerenciada automaticamente pelo MTA. Neste caso, nenhuma das alternativas citadas acima funcionará, portanto, todas as solicitações a ele serão negadas. Não há nada que o usuário ou o desenvolvedor possa fazer. Caso haja algum engano, é sugerido contatar nosso time de suporte.

=Modo remoto versus local=
Existem dois modos que o CEF pode rodar:

1. Modo local:
* é possível executar código em Javascript sem restrição (vide: [[executeBrowserJavascript]])
* é possível carregar sítios hospedados somente na pasta <code>resource</code>
* ''não'' é permitido carregar conteúdo remoto (e.g. www.mtasa.com)

2. Modo remoto:
* ''não'' é permitido executar código em Javascript
* é permitido carregar somente conteúdo remoto
* lembre-se que o usuário pode desabilitar o carregamento de ''websites'' remotos ou a execução de Javascript nas configurações

Vale ressaltar que não é possível mudar o modo do navegador após sua criação devido a limitações técnicas.

=Gerenciamento de Recursos=
==Como carregar arquivos HTML locais==
Carregar um arquivo HTML local funciona de forma similar a carregar imagens.

Adicione o caminho para o arquivo HTML no <code>meta.xml</code> usando a seguinte tag:
<syntaxhighlight lang="xml">
<file src="html/minhaInterface.html"/></syntaxhighlight>

==Como carregar arquivos locais dentro do HTML==
Suponha que seja necessário carregar uma imagem ou reproduzir um vídeo que foi incluso no seu pacote do MTA. Isso é possível através de um URI específico no formato: '''''"http://mta/"'''''

===Exemplo===
Este exemplo mostra como reproduzir um vídeo. Note que é necessário habilitar programação orientada a objeto.
====Lua====
<syntaxhighlight lang="lua">
-- Cria um navegador (modo local também é obrigatório para acessar arquivos locais)
local janelaNavegador = Browser(640, 480, true, true)

addEventHandler("onClientBrowserCreated", janelaNavegador,
function()
-- Carregar interface em HTML
janelaNavegador:loadURL("http://mta/local/html/meuVideo.html")

end
)</syntaxhighlight>
====meta.xml====
<syntaxhighlight lang="lua">
<file src="html/meuVideo.html"/>
<file src="midia/meuVideo.webm"/></syntaxhighlight>
====HTML====
<syntaxhighlight lang="html">
<!DOCTYPE HTML>
<html>
<head></head>
<body>
<video width="640" height="480" controls>

<source src="http://mta/local/midia/meuVideo.webm" type="video/webm"/>
</video>
</body>
</html></syntaxhighlight>

=Comunicação bidirecional entre Lua e JS=
A comunicação entre Lua e Javascript (JS) está somente disponível no modo local devido à razões de segurança.

==Lua para JS==
É possível chamar código em Javascript a partir do Lua usando a função [[executeBrowserJavascript]].

Os links a seguir contém mais detalhes de como isso é implementado:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/WebWindow.lua#L180-189
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/mtaevents.js#L9-L15

==JS para Lua==
É possível adicionar um evento-cliente no Javascript usando a função ''triggerEvent'' a qual é parte da classe estática ''mta''.
Segue a sintaxe:
<syntaxhighlight lang="javascript">
mta.triggerEvent(string evento, var parametro1, var parametro2, var parametro3, ...)
</syntaxhighlight>
A fonte (variável "source") desse evento é sempre o elemento navegador que acionou este evento.

Estão disponíveis exemplos nos seguintes links:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/html/ui2.html#L66
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/Main.lua#L35-L40

=Depuração=
O modo ''desenvolvedor'' pode ser habilitado da seguinte forma (digite no console após pressionar F8):
<syntaxhighlight lang="lua">start runcode
crun setDevelopmentMode(true, true)
debugscript 3</syntaxhighlight>
Agora é possível visualizar os erros no navegador e os domínios/URLs bloqueados na janela de depuração no canto inferior da tela.

=Pontos de atenção=
Importante lembrar que nem todas os recursos de um navegador recente estão disponíveis nos computadores de seus usuários. Um exemplo disso é o '''WebGL'''.

'''Adobe Flash''' também é um recurso problemático. É um complemento habilitado por padrão, porém deve ser evitado porque é possível desabilita-lo nas configurações. Além disso, o Flash, por ser uma tecnologia defasada, não oferece muitas oportunidades para o desenvolvimento de funcionalidades que atendam às expectativas do usuário. Mais especificamente, o flash roda em um processo separado que está limitado a uma interface antiga (aquele dos anos 2010), o qual o desenvolvedor possui pouco controle sob ela. A alternativa recomendada é o ''HTML5'', porque além de ser amplamente adotada, possui uma ótima API para reprodução de áudio/vídeo (http://www.w3schools.com/tags/ref_av_dom.asp). Até mesmo há suporte a áudio 3D.

=Uso Avançado=
Como a implementação do CEF não contempla o ''z-ordering'' por padrão, é necessária uma implementação própria. A especificação sobre esse mecanismo pode ser encontrada em: https://github.com/Jusonex/mtasa_cef_tools
Há também algumas funções auxiliares para integrar essas classes facilmente com sua própria interface usando OOP. Será também criado um tutorial de como usar o CEF com o CEGUI.

=Desempenho=
Criar várias instâncias de navegador não afeta o MTA diretamente porque o CEF roda em um processo distinto. Porém, devido a limitações técnicas, o MTA necessita de uma cópia dos dados de texturas na ''thread'' principal do GTA.

Caso não seja necessário manter o navegador visível, é recomendado encerra-lo para economizar recursos. Porém, caso ainda seja importante deixar o navegador rodando (e.g. manter o estado da página), é possível otimizar o desempenho desabilitando a renderização da página via [[setBrowserRenderingPaused]]. Isso faz com que o CEF pare de atualizar novos quadros e o MTA também irá pausar a cópia de textura.

=Solução de Problemas=
===google.com não funciona===
Por padrão, ao acessar o endereço <code>google.com</code>, o usuário é redirecionado para um site filial específico dependendo do país em que está. No Brasil, por exemplo, o internauta é transferido para o <code>google.com.br</code>. É possível contornar esse problema ao acessar o seguinte endereço: https://www.google.com/ncr.

=Funções de Scripting=
{{CEF_functions}}
=Eventos de Scripting=
{{CEF_events}}

[[Category:Tutorials]]

[[en:CEF_Tutorial]]

Resource Web Access

2021-01-21T15:57:26Z

Cristiano Cardoso: add link to pt-br page

The Multi Theft Auto Server provides a web interface that resources can use in a variety of ways. This document's purpose is to explain what these ways are and how to go about using them.
{{Note|If you are looking for a tutorial on how to use the in-game web browser and create websites using CEF, please visit [[CEF_Tutorial|CEF Tutorial]] instead.}}

==Overview==
There are two key parts that make up this system. The first is a standard web server that allows web browsers to request pages and files you have in a resource. The second is a system for allowing web browsers to call functions you have exported from your resource.

==Pages==
===Specifying a file in the meta===
You can specify in your resource's meta file that certain files are accessible through the web server. To do this, you add a line:
<syntaxhighlight lang="xml">
<html src="filename.ext" />
</syntaxhighlight>
You can then access this file from your web browser by visiting: http://host:port/resourcename/filename.ext<br/>
For example, on a locally hosted server using default http port with webmap started: http://127.0.0.1:22005/webmap/map.htm

===Binary files===
Despite the misleading name, files specified using the html node can be of any type. If they are binary files (like images, zip files) then you need to specify this in the meta file, by adding ''raw="true"'' to the ''html'' node. This means that the files are not preprocessed before being sent to the web browser.

For example:
<syntaxhighlight lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Parsed files===
If a file is not specified in the metafile as "raw", then it is passed through a pre-processor before it is returned to the client. This pre-processor works much like PHP or ASP but uses Lua. You can embed standard MTA scripts within HTML pages, controlling the output. Almost all standard MTA functions work, plus a number of special [[Template:HTTP functions|HTTP Functions]], such as [[httpWrite]], a function that outputs text to the buffer.

For example:
<syntaxhighlight lang="html4strict">
<html>
<body>
This resource is called <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

There is a shorthand (in common with PHP and ASP) for this code, meaning that you can also write the above code as:

<syntaxhighlight lang="html4strict">
<html>
<body>
This resource is called <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

Aside from HTTP functions, embedded Lua has access to the following environment variables that contain information about how the page was requested:
* table '''requestHeaders''': This is a table containing all the headers that were requested with the page. You can set returned headers using [[httpSetResponseHeader]].
* table '''form''': This is a table containing all the form data submitted to the page using HTTP POST combined with any variables passed in the querystring with HTTP GET.
* table '''cookies''': This is a table of all the cookies. You can modify cookies using [[httpSetResponseCookie]].
* string '''hostname''': This is a string containing the IP address or hostname that requested the page.
* string '''url''': This is the URL of the page.
* account '''user''': This is the account of the current user.

It's important to note that parsed files are run in a separate virtual machine from the rest of your resource's code. As such, if you want to call a function in your resource's main code, you need to export the function and use the [[call]] function from your parsed file.

==Calls==
You can specify that certain exported functions in your resource are able to be called from the HTTP interface. All the SDKs (listed below) allow you to call these functions from a remote location.

To specify an exported http-accessible function, add the following to your meta.xml file:
<syntaxhighlight lang="xml">
<export function='functionName' http='true' />
</syntaxhighlight>

You can code your function just as you would any normal function, returning as many values as you want, including tables and resources and most important elements. You ''cannot'' however return other 'userdata' values such as [[xmlnode|xmlnodes]] or functions.

===Protocol===
{{Note|You don't need to know this unless you're writing your own HTTP request code. You can just use one of the [[#SDK|SDKs listed below]].}}

Calls are done by requesting ''<nowiki>http://<your IP>:<your port>/<resource_name>/call/<exported_function_name></nowiki>'' using HTTP POST. The body of the request should be a JSON array of the arguments for the function.

The request will return a JSON array of the value(s) returned from the function as the HTTP response.

The server supports HTTP Basic authentication and you can configure access via the ACL and the built-in accounts system.

===Calls from the HTTP web interface===
Using calls is probably easiest from the web interface and can be done almost seamlessly.

First, add this to your meta.xml file:
<syntaxhighlight lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Secondly, add the following to the <head> section of the page you want to call from:
<syntaxhighlight lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

Finally, you can create a javascript block on your page and call your functions almost as if they were local. The only difference is that the calls are asynchronous - you should specify a callback function as the last argument for your call. This is called when the function returns.

Here's a simple example.

'''meta.xml'''
<syntaxhighlight lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="html4strict">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

You can see (fairly complex) examples of how this can be done in the resources ''resourcebrowser'', ''resourcemanager'' and ''webadmin''.

==Securing the web interface==
The [[ACL]] has a number of rights that can affect what files can be accessed.
{{Deprecated feature|3.0139|1.3.1|
* general.http: If disabled, none of the HTTP files can be accessed (except by game clients)
** '''Important Note''': ''If 'general.http' is enabled, HTTP access to all resources (for that ACL) is enabled by default. To disable HTTP access you have to explicitly block access to resources that contain exported HTTP functions.''
** '''Important Note''': ''If 'general.http' is enabled on an ACL which has a user with no password (i.e. user.* or user.guest or user.http_guest), it is essential that you explicitly block access to resources that contain exported HTTP functions.''
* resource.'''ResourceName''': If disabled, none of the files in the resource can be accessed
* resource.'''ResourceName'''.file.'''FileName''': If disabled, the file named cannot be accessed
* resource.'''ResourceName'''.function.'''FunctionName''': If disabled, the function cannot be called
These work as with other ACL rights - you can disable them for normal users and just enable them for Admin users, or any other group of users you wish.
}}
{{New_feature|3.0139|1.3.1|
* '''resource.ResourceName.http''': If enabled, the resource will be accessible from http://server_ip:22005/ResourceName/
This works as with other ACL rights - You can enable it just for Admin users, or any other group of users you wish.
}}

==SDK==
There are a number of so-called 'SDKs' available that allow you to interface with the server from other programming languages. With these, you could (in theory) write whole gamemodes. In practice, this is probably a bad idea, but it is useful for statistics and administration. The PHP SDK is the most developed version. Feel free to modify or create your own SDKs - if you do please send us a copy.

* [[JavaSDK|Java SDK]]
* [[Javascript SDK]]
* [https://www.npmjs.com/package/mtasa Node.js SDK]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==See Also==
[[callRemote]] - Allows game servers to call functions on PHP pages (with the PHP SDK) and on other game servers.
[[Category:Scripting Concepts]]

[[hu:Resource Web Access]]
[[ru:Resource Web Access]]
[[pt-br:Acesso_web_via_recursos]]

[[Category:Tutorials]]

Depuração

2019-02-28T20:16:43Z

Cristiano Cardoso: [add] [fix] nova introdução; erro de consistência no primeiro exemplo

É comum ao programar cometer erros de sintaxe e semântica. O primeiro deles acontece porque o computador não tem a sensibilidade do ser humano para compreender um texto, mesmo que tenha erros de ortografia. Já o segundo, é basicamente culpa sua, não do computador. Por exemplo, em um complexo algoritmo para distribuir jogadores pelo mapa, ocorre uma [https://pt.wikipedia.org/wiki/Divis%C3%A3o_por_zero divisão por zero]. De fato, até este ponto, a máquina só seguiu suas instruções, que eventualmente, em um caso específico chegou a uma operação matemática inválida.

A depuração (debug, em inglês) ajuda o programador a encontrar erros apontando o que são eles são e onde estão, poupando seu valioso tempo. Esta página irá ensinar como ativar a depuração e dar alguns exemplos de como corrigir erros comuns.

==Debug no Console==
O MTA vem com um sistema no console onde mensagens de ''debug'' relacionadas às funções e scripts são mostradas. Lembrando que é necessário ter uma permissão de administrador para ativá-lo (a não ser se você modificar o ACL). Para fazer isso, digite <code>debugscript X</code> no console, em que ''X'' é o nível:

* '''1:''' mostra somente os erros
* '''2:''' erros e avisos
* '''3:''' erros, avisos e mensagens informativas
Ao digitar <code>debugscript 3</code>, todas as ocorrências serão mostradas. O nível 3 ou o 2 são os recomendados para a maioria dos casos. É recomendado ativar o ''debugscript' para testar seu script e detectar os erros de digitação.

===Exemplo===
Neste código há dois erros. Consegue encontra-los?
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola")
outputChatbox("Olá, Cebola!")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Quando este script for carregado, no console irá aparecer algo assim:
:{{Debug info|Loading script failed: meuRecurso\script.lua:2: 'then' expected near ´outputChatbox'}}

Isso significa que o script não pode ser executado porque há um erro de sintaxe. Nesta mensagem, primeiramente aparece qual script de qual recurso deu problema. Depois disso, há dois pontos e um número mostrando a linha onde está o erro; para facilitar o trabalho do programador quando se trata de scripts maiores. Depois disso, a mensagem irá variar de acordo com o tipo de erro. Neste caso, é fácil concluir que o erro está localizado no '''meuRecurso''' e na linha dois do arquivo '''script.lua'''. Desta vez está na cara: precisamos colocar o "then" na cláusula ''if''.
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola") then
outputChatbox("Olá, Cebola!")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Agora tudo será carregado com sucesso e nenhum erro aparecerá até que um jogador apelidado "Cebola" dizer algo no chat. Aí no console irá aparecer:
:{{Debug error|myResource\script.lua:2: attempt to call global 'outputChatbox' (a nil value)}}
Isso significa que a função '''outputChatbox''' é um valor ''nil'', ou seja, ele não existe! Isso porque a função na verdade se chama [[outputChatBox]], e não [[outputChatbox]]. Então, tome cuidado com a letra maiúscula B.:
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola") then
outputChatBox("Olá, Cebola!")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>

Lembrando que isso é só ''um exemplo'' e não será sempre desse jeito, pois há vários tipos de erros que podem acontecer.

==Log de debug do Cliente e Servidor==
====Servidor====
Na pasta ''../server/mods/deathmatch'', haverá dois arquivos com funções parecidas:

*''local.conf'' - são as configurações oriundas do item "host game" no menu principal do MTA. Isto é uma maneira rápida de iniciar um servidor de testes dentro do próprio programa. Quando o usuário fecha o jogo, ele é automaticamente desligado também.

*''mtaserver.conf'' - é usado quando se inicia o "MTA Server.exe" dentro da pasta ''../server/''. Em outras palavras, o servidor é rodado em prompt de comando e não necessita de o MTA estar executando junto. Isso é muito útil para os interessados em montar um servidor dedicado ou mesmo experimentar como é mexer em um servidor de verdade.

Dependendo das suas necessidades, com certeza irá querer alterar essas configurações abaixo:

<syntaxhighlight lang="xml">

<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>


<scriptdebugloglevel>0</scriptdebugloglevel></syntaxhighlight>

Como as descrições acima já dizem, é opcional salvar um arquivo de log de acordo com o nível desejado. Os três níveis estão descritos acima, sendo neste caso o zero como a não ativação do debugscript - fazendo o arquivo ficar em branco. Se 3 for ativado, todos os erros encontrados no '''lado do servidor''' serão salvos em: ''../server/mods/deathmatch/logs/scripts.log''

====Cliente====
Todos os erros '''do cliente''' serão salvos na pasta ''../server/clientscript.log''. Isso já é definido por padrão, então nenhuma configuração é necessária.

==Habilidades em Deubug==

Em vez de ficar procurando no código os erros cometidos, há algumas coisas a serem feitas para ajudar a encontrar-los. A maioria delas estão relacionadas com a adição de alguma mensagem de debug informando o que está ocorrendo no script.

===Funções Úteis===
As funções abaixo podem lhe ajudar com o debug:
* [[outputDebugString]] ou [[outputChatBox]] para escrever qualquer informação na tela (de preferência outputDebugString para suporte técnico)
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] para tornar qualquer variável em uma ''string''. Muito útil para saber o que ela é, escrevendo na tela. Não será necessário usa-la se a variável já uma string ou um número.
* [[getElementType]] verifica o tipo de elemento do MTA em questão.
* [[isElement]] verifica se elemento existe.

===Adicionando mensagens de debug para verificar ''se'', ''quando'' ou por qual ''frequência'' um código é executado===
Se você terminou de escrever um código e percebe que algo esperado não acontece e fica em dúvida se as instruções foram executadas ou não; nesse caso é recomendado adicionar mensagens de debug para verificar os passos.<br>
Um exemplo típico seria checar se uma clausula ''if'' foi atendida ou não:
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("A variável 1 é igual a 2.")
-- portanto, faça alguma coisa
end
</syntaxhighlight>

Outra maneira semelhante seria verificar se alguma variável muda. Em outras palavras, é só adicionar uma mensagem de debug depois de cada vez que isso acontece.

===Adicionando uma mensagem de debug para verificar o ''valor'' de uma variável===
Digamos que desejas criar um marcador (marker), mas ele não aparece na posição esperada. A primeira coisa a ser feita é verificar se a função [[createMarker]] foi executada com sucesso. Depois disso, só precisamos verificar os valores usados nela.
<syntaxhighlight lang="lua">
local marker = createMarker(x,y,z)
if not marker then
outputChatBox("O marcador não pode ser criado.")
end
outputChatBox("A posX é "..x..", posY "..y..", e posZ "..z)
</syntaxhighlight>
Feito isso, as variáveis usadas como coordenadas serão mostradas. Lembrando que se uma variável não for uma frase ou número, é recomendado usar a função [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()], pois ela torna qualquer variável agrupável em uma ''string'', mesmo se for uma ''bool'' ou tabela.

==Exemplo==
Imagine que você criou um [[Colshape|detector de colisão]] e se o jogador ficar dez segundos dentro dele, algo vai acontecer:
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave", root, colShapeLeave)
</syntaxhighlight>
Quando o jogador entrar no colshape, o debugscript irá escrever a seguinte mensagem:
:{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Isso significa que você tentou endereçar uma tabela não existente quando tentou colocar o timer dentro dela; ou seja, ela é um valor ''nil'' - portanto, não existe. Para corrigir isso, precisamos verificar se a tabela não existe, e caso a resposta for positiva; a criaremos.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",root,colShapeLeave)
</syntaxhighlight>

Desta vez receberemos um aviso quando o jogador entrar no colshape, esperar a mensagem e sair de lá:

:{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

Tirando isso (vamos corrigir mais tarde!), tudo parece funcionar bem. O jogador entra no colshape e o ''timer'' começa a contar: se ele esperar, a mensagem é escrita, caso contrário o ''timer'' é destruído. Mas...

===Um erro imperceptível===
Por alguma razão, quando o jogador entra no colshape usando um veículo, a mensagem é escrita duas vezes; como se o código tivesse sido executado duas vezes. Então, adicionamos uma mensagem de debug para verificar isso.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug
outputDebugString("colShapeHit")
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug
outputDebugString("colShapeLeave")
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora dá pra ter certeza que as funções são executadas duas vezes quando entramos com um veículo, mas só uma quando se está a pé. É possível que o veículo seja um elemento a parte e ativa a função de forma independente ao jogador. Para confirmar essa teoria, verificamos se a variável ''player'' realmente se refere ao jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

A mensagem de debug nos diz que uma referência da variável ''player'' é realmente o jogador, mas outra é o veículo. Já que nós destinamos o evento especificamente ao boneco dele, adicionaremos uma cláusula ''if'', obrigando o término da execução do código caso a variável '''não''' for o jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora tudo está funcionando como o planejado, mas aquela mensagem de aviso mencionada acima ainda aparece. Isso porque quando tentamos destruir o timer depois que o jogador saí do colshape, ele não existe mais, já que os 10 segundos se passaram. Em outras palavras, o timer é automaticamente destruído quando ele conta os 10 segundos. Há diversas formas de se livrar do aviso, uma vez que temos conhecimento da não existência do ''timer''. Uma delas seria verificar se ele existe na tabela. Para fazer isto, usamos a função [[isTimer]] na hora de destruí-lo:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

Então o código completo ficará assim:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Verificando problemas na performance==
Se o seu servidor estiver trabalhando muito além da conta ou você deseja se certificar que seus scripts são eficientes, é possível matar o problema pela raiz usando uma boa ferramenta inclusa na instalação: [[Resource:Performancebrowser|performancebrowser]]. É só inicia-lo usando ''''start performancebrowser''''. Caso ele não exista, pode encontrá-lo no último pacote de recursos hospedado no [https://github.com/multitheftauto/mtasa-resources GitHub]. Esta ferramenta inclui uma série de informações relativas a performance, como:
* Memory leaks - uso excessivo de memória
* Element leaks - criação excessiva de elementos
* CPU usage - uso excessivo de CPU

Para acessar o performancebrowser, é preciso ir até o navegador e digitar o endereço: <nowiki>http://<ip-do-servidor>:<porta>/performancebrowser/</nowiki>. Um exemplo seria o endereço do servidor local: http://127.0.0.1:22005/performancebrowser/. Lembrando que é preciso:
* colocar a barra (/) no final do endereço
* logar no jogo com uma conta de administrador ou outra que tenha acesso no ACL a:
:* '''resource.performancebrowser.http''' e '''resource.ajax.http'''

{{Dica|A maioria das informações relevantes estão nas categorias ''Lua timing'' e ''Lua memory''. E, o problema está nos valores mais altos apresentados.}}

===Exemplos de scripts problemáticos===

Um deles seria adicionar dados a alguma tabela, mas não remover posteriormente. Porém, isso levaria alguns meses ou até anos para danificar o funcionamento do servidor.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- não há nenhum evento para retirar os dados quando o jogador sair. Isso é considerado memory leak
-- Entrando na aba Lua timing, você pode verificar o uso de RAM de cada recurso.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Um caso possível de ''Element leak'' é criar colisores temporários e nunca destruí-los mais tarde. Isso aumenta muito o uso de transferência dados (bandwidth), CPU e memória pelo servidor.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(some code here)
if (algo que deveria acontecer...) then
destroyElement(col)
end
-- E as vezes não acontece, fazendo o colisor permanecer no mapa pra sempre...
-- Criando de centenas à milhares de coliores sem função alguma.
-- Na aba Lua timing é possível ver quantos elementos cada script criou.
end
</syntaxhighlight>

O alto uso de CPU resulta na queda de FPS, fazendo o servidor um lugar ruim para se jogar. Em 24 horas, isso pode causar sérios prejuízos. O número de elementos criados detectados na aba ''Lua timing'' não ajudará neste caso, mas o ''Lua memory'' sim.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- [Código para o novo jogador]
-- Até que um evento é adicionado para quando ele sair
addEventHandler("onPlayerQuit", root, function()
-- Encontrou o problema? Esse evento além de usar o root como o seu causador, é criado infinitamente...
end)
end)
</syntaxhighlight>
Uma função usa muito o CPU quando ela demora para terminar de ser executada. O exemplo abaixo é uma delas. Sem o performancebrowser, você não perceberia tão cedo que esta é a causa do problema. Mas com ele, verá na aba ''Lua timing'' que o seu recurso usa muito o potencial do CPU. Ficará mais fácil descobrir isso se usar o parâmetro ''''d'''' na caixa de entrada ''Options''. Isso porque ela lhe dirá também a linha em que está o código problemático.
<syntaxhighlight lang="lua">
function umaFuncaoPoucoEficaz()
-- para cada cem mil coisas quaisquer
for i=1, 100000 do
-- [código abaixo]
end
end
</syntaxhighlight>

[[en:Debugging]]
[[it:Guida al Debug]]
[[ru:Debugging]]
[[Category:Conceitos de Scripting]]
[[Category:Tutorials]]

FindRotation3D

2017-07-19T23:56:57Z

Cristiano Cardoso: Fix typo

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B. This can for example be used to make objects point at specified point
==Syntax==
<syntaxhighlight lang="lua">float float float findRotation3D( float x1, float y1, float z1, float x2, float y2, float z2 )</syntaxhighlight>

===Required Arguments===
* '''x1''': The X coordinate of the starting point.
* '''y1''': The Y coordinate of the starting point.
* '''z1''': The Z coordinate of the starting point.
* '''x2''': The X coordinate of the target point.
* '''y2''': The Y coordinate of the target point.
* '''z2''': The Z coordinate of the target point.

==Code==
<syntaxhighlight lang="lua">
function findRotation3D( x1, y1, z1, x2, y2, z2 )
local rotx = math.atan2 ( z2 - z1, getDistanceBetweenPoints2D ( x2,y2, x1,y1 ) )
rotx = math.deg(rotx)
local rotz = -math.deg( math.atan2( x2 - x1, y2 - y1 ) )
rotz = rotz < 0 and rotz + 360 or rotz
return rotx, 0,rotz
end
</syntaxhighlight>

==Example==
This command makes the player's vehicle to rotate at vehicle near it.
''Note: This example needs [[OOP]] to be enabled in order to work''
<section name="Client-side example" class="client" show="true">
<syntaxhighlight lang="lua">
local function setRotationAtNearestVehicle()

if not localPlayer.vehicle then return end

local nearestVehicle = false
local dist = 10000
for index,vehicle in ipairs(getElementsByType("vehicle",root,true)) do
if getDistanceBetweenPoints3D(localPlayer.vehicle.position,vehicle.position) < dist and localPlayer.vehicle ~= vehicle then
nearestVehicle = vehicle
dist = getDistanceBetweenPoints3D(localPlayer.vehicle.position,vehicle.position)
end
end

local x1,y1,z1 = getElementPosition(localPlayer.vehicle)
local x2,y2,z2 = getElementPosition(nearestVehicle)
local rx,ry,rz = findRotation3D(x1,y1,z1,x2,y2,z2)

localPlayer.vehicle.rotation = Vector3(rx,ry,rz)

end

addCommandHandler("lookatnearestveh",setRotationAtNearestVehicle)
</syntaxhighlight>
</section>

Thanks for '''ccw''' for alternative [[getCameraRotation]] function which formula is used in this function. Also thanks for '''Doomed_Space_Marine''' for more accurate formula for z-axis which is used in [[findRotation]]

==See Also==
{{Useful_Functions}}

Talk:Página Inicial

2017-03-21T20:25:30Z

Cristiano Cardoso:

'''
I want to create a script that I can change the server interface (hud and radar), but I can not create it, will someone help me ?, I want a panel that I can open and close (f2), cm 2 Option Interface, the first option in hud and radar other than option 2, Thanks'''

'''@RaceXtreme: Wrong Section'''
Please, post this in the [https://forums.mtasa.com forums].

----

Página Inicial

2016-07-18T02:51:49Z

Cristiano Cardoso:

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Bem vindo ao Wiki do Multi Theft Auto.''' Aqui você encontra tudo sobre o uso desta modificação.

Há muitas [[How you can help|coisas em que você pode nos ajudar]] para melhorar este programa, como criar um mapa, um modo de jogo, documentar funções e eventos, escrever códigos úteis para outros usuários, fazer tutoriais, reportar bugs que encontrar ou somente jogar a vontade!

Se você tem alguma dúvida a respeito do Multi Theft Auto, não se esqueça de perguntar à comunidade em nossos [http://forum.mtasa.com/ fóruns].
<br><br>
</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; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div>
<h3>Jogar</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Baixe o Multi Theft Auto {{Current Version|full}}]'''</div>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Onde_adquirir_o_GTASA|Onde adquirir o GTASA]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Cliente|Manual do usuário]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Novidades_na_versão_{{Current Version|full}}|Novidades da última versão ]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de problemas]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Migrando_do_MTA:Race_ao_MTA:SA_1.3|Migrando do MTA:Race para o MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Servidor|Manual do servidor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Recursos:Map_Manager|Gerenciador de mapas (''Map Manager'')]]

<h3>Editor de mapas</h3>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor|Manual do editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-EDF|Ficheiro de definições do editor (EDF)]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-Plugins|Extensões para o editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor#FAQ|Perguntas frequentes (FAQ)]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div>
<h3>Banco de dados</h3>
Aqui tem tudo relacionado às vantagens que Lua tem a oferecer ao MTA e seus recursos.
* [[Image:iUS.png|Em Inglês|20px]] [[:Category:Resource|Catálogo de Recursos]] - Você deve aprender com eles para fazer scripts bons
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Scripts_do_Cliente|Scripts do Cliente]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Módulos|Módulos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div>
<h3>Desenvolvimento do Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Últimas compilações]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA|Compilando o MTASA no Windows]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Mac_OS_X|Compilando o MTASA no Mac OS X]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Linux|Compilando o MTASA no Linux]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Guia_do_Desenvolvedor|Guia do Desenvolvedor]]
* [[File:iUS.png|Em Inglês|20px]] [https://github.com/multitheftauto/mtasa-blue Repositório Github]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Roadmap|Roteiro para versões futuras]]
* [[File:iUS.png|Em Inglês|20px]] [http://bugs.mtasa.com/ Central de bugs]
* [[File:iUS.png|En Inglês|20px]] [[Branches|Ramos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</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|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [irc://irc.multitheftauto.com/mta IRC]
* [[File:iUS.png|Em Inglês|20px]] [http://community.mtasa.com/ Comunidade]
* [[File:iUS.png|Em Inglês|20px]] [http://twitter.com/#!/MTAQA/ Twitter]
* [[File:iUS.png|Em Inglês|20px]] [http://www.youtube.com/user/MTAQA Youtube]
* [[File:iUS.png|Em Inglês|20px]] [http://plus.google.com/102014133442331779727/ Google]
* [[File:iUS.png|Em Inglês|20px]] [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</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|link=]]</div>
<h3>Scripting</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introdução_ao_Scripting|Introdução a ''scripting'']]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introducao_ao_GUI_scripting|Introdução a ''scripting'' de UI]]
* [[File:iBR.png|Em Português|20px]] [[Depuração|Depuração]] - Encontre erros em seu Script
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Recursos|Introdução a recursos]]
** [[File:iBR.png|Em Português|20px]] [[Acesso web via recursos|Acesso web via recursos]] - Abra servidores web através de recursos
** [[File:iBR.png|Em Português|20px]] [[:Category:PT-BR/Recursos|Lista de recursos]]
** [[File:iBR.png|Em Português|20px]] [[O arquivo Meta|Meta.xml]] - Todo recurso possui um arquivo meta descrevendo a si próprio
** [[File:iBR.png|Em Português|20px]] [[Lista de Controle de Acesso|Lista de controle de acesso (ACL)]] - Componente vital para recursos complexos
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Composição_de_Gamemodes|Composição de modos de jogo]]
* [[File:iUS.png|Em Inglês|20px]] [[PT-BR/Funções_Úteis|Funções Úteis]]
<h3>Links dos fóruns</h3>
* [[File:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=152 Secção do fórum para dúvidas sobre ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewforum.php?f=148 Guias de ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Wiki ''offline'']
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Manuais sobre Lua</h3>
Página muito útil para ajuda-lo a entender o funcionamento do Lua
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/portugues.html Introdução à linguagem]
* [[File:iUS.png|Em Inglês|20px]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Manual básico]
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/manual/5.1/pt/ Manual de referência]
* [[File:iUS.png|Em Inglês|20px]] [http://lua-users.org/wiki/TutorialDirectory Outra wiki, somente de Lua]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Referência</h3>
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Functions|Funções do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Events|Eventos do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Functions|Funções do servidor]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Events|Eventos do servidor]]

* [[File:iUS.png|Em Inglês|20px]] [[MTA Classes|Classes do Multi Theft Auto]] - Informações detalhadas sobre todas as classes do MTA
** [[File:iUS.png|Em Inglês|20px]] [[Element tree|Árvore dos elementos]]
</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|link=]]</div>
<h3>[[Id|Lista de IDs de objetos e texturas]]</h3>
*[[Animations|Animações]]
*[[Character Skins|''Skins'' de pedestres]]
*[[Roupas do CJ|Roupas do CJ]]
*[[Garage|Garagens]]
*[[Interior IDs|Interiores]]
*[[Material IDs|Materiais]]
*[[Projectiles|Projéteis]]
*[[Radar Blips|''Blips'']]
*[[Sounds|Efeitos sonoros]]
*[[Vehicle IDs|Veículos]]
*[[Vehicle Colors|Cores dos veículos]]
*[[Vehicle Upgrades|Acessórios dos veículos]]
*[[Vehicle variants|Variantes dos veículos]]
*[[Weapons|Armas]]
*[[Weather|Ambientação]]
</div>

<div style="border: 1px dotted #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:pBR.png|32px]]</div>

<h3>Sobre a Tradução</h3>
* Tradutores:
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=50642|<span style="color: blue">RaceXtreme</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=59023|<span style="color: blue">StanleySathler</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=55744|<span style="color: blue">DNL291</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=62091|<span style="color: blue">Ninguem</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=63192|<span style="color:blue">Anderl</span>]

É importante que todos colaborem para que nossa página em português fique melhor a cada dia!

[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' é um projeto '''open source'''. <br>
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Sobre o Multi Theft Auto'''</li>
<li>[[Archive|Arquivos]]</li>
<li>[[Press Coverage|Eventos]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Desenvolvedores]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Baixe-o]]</li>
<li>[[MTA 0.5r2 Known Issues|Solução de problemas]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Status da Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artigos</li>
<li>{{NUMBEROFPAGES}} páginas</li>
<li>{{NUMBEROFUSERS}} usuários registrados</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pt-br}}

Compiling MTASA

2015-07-06T05:20:07Z

Cristiano Cardoso: Added PT-BR page

__NOTOC__
In order to successfully build Multi Theft Auto from source, it is necessary to perform a number of steps, which we will explain below.

=== Prerequisites ===

Before you can build Multi Theft Auto, make sure you have the following software and SDKs installed:
* Microsoft Visual Studio 2008 ([http://www.microsoft.com/downloads/en/details.aspx?FamilyId=FBEE1648-7106-44A7-9649-6D9F6D58056E&displaylang=en SP1 required])
* [http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=6812 Microsoft DirectX SDK] (only the Direct3D related components are required)
* [http://www.microsoft.com/en-us/download/details.aspx?id=6510 Microsoft Platform SDK] (not required on Windows 7, only the DirectShow components are required)

If you haven't already done so, install a client such as [https://www.sourcetreeapp.com/ SourceTree] or [https://windows.github.com/ GitHub for Windows], which can be used to download and manage the code.

=== Getting the latest source code ===

To get the latest code, you will have to download the latest copy of our Git repository - you can get it [https://github.com/multitheftauto/mtasa-blue here] ([https://github.com/multitheftauto/mtasa-blue/archive/master.zip zip]|[https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz tar.gz])

=== Before building the software ===

To ensure the target directories have the correct permissions it is '''vital''' to install [http://nightly.mtasa.com/ the latest unstable nightly] into this '''exact''' directory:
C:\Program Files\MTA San Andreas x.x\
Where x.x is the version you are compiling for. If you have 64 bit windows, be sure to remove (x86) from the path.

=== Building the software ===

In order to build the source, you will need Microsoft Visual Studio. Open the project file in '''Shared/Core 2008.sln''' and build using one of the project configurations ''Debug'' or ''Release''. Note that everything will run significantly slower in ''Debug'' mode.

=== Target directory and permissions ===

By default, the current version compiles the binaries into 'C:\Program Files\MTA San Andreas 1.5\'. To ensure the correct permissions, registry entries and support files are present, you should install [http://nightly.mtasa.com/ the latest unstable nightly] and [http://mirror.mtasa.com/mtasa/data/ the latest data files] into that directory. Also make sure to add write permissions for your user to that directory.

=== Getting the latest network module ===

Since the '''netc.dll'''/'''net.dll''' network modules for the client are covered by a different license, you will have to use the binary files that get installed with the latest nightly. If you want to run a debug version of MTA, MTA expects a debug version of the net dll. As we don't provide this, you can append '_d' to the filename of a release dll.

= Running the software =

You are almost ready to run your build of the Multi Theft Auto software.

=== Running the game client ===

Double check you have installed [http://nightly.mtasa.com/ the latest unstable nightly] and [http://mirror.mtasa.com/mtasa/data/ the latest data files].

=== Running the dedicated server ===

If you want to run the Multi Theft Auto dedicated server, you will have to install the required resources. These are required because they implement the most basic functionality (e.g. spawning players) in order to play.

Our official resources repository is hosted on GitHub: [https://github.com/multitheftauto/mtasa-resources]. It's recommended that you check out the latest resources from here or download a zipped revision from the [http://mirror.mtasa.com/mtasa/resources/ Downloads] tab on the resources project. Make sure that you are not using any of our resources from any previous versions of Multi Theft Auto, as this '''will''' cause issues.

If you have any problems with missing DLL files (e.g. libcurl.dll), simply copy these over from the client's data archive described above.

= Getting involved =
Please see our [[Coding guidelines]] for information on coding practice.

= Additional information =

If you need more information, try our [http://bugs.mtasa.com/ bug tracker], [irc://irc.multitheftauto.com IRC channel].

[[pt-br:Compilando o MTASA]]
[[ru:Compiling MTASA]]
[[Category: Development]]

PT-BR/Compilando o MTASA

2015-07-06T05:16:47Z

Cristiano Cardoso: Updated Github links

__NOTOC__
Para se conseguir compilar o Multi Theft Auto a partir de seu código fonte, é necessário seguir alguns passos, os quais estão descritos a seguir.

=== Pré-requisitos ===
Antes de você poder fazer isso, certifique-se que os seguintes softwares e SDK's estão instalados:

* Microsoft Visual Studio 2008 ([http://www.microsoft.com/downloads/en/details.aspx?FamilyId=FBEE1648-7106-44A7-9649-6D9F6D58056E&displaylang=en incluindo o SP1])
* [http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=6812 Microsoft DirectX SDK] (só precisa dos componentes do Direct3D)
* [http://www.microsoft.com/en-us/download/details.aspx?id=6510 Microsoft Platform SDK] (não é preciso instalar tudo se tiver o Windows 7, somente os componentes do DirectShow)

Se não tiver feito ainda, instale um cliente como o [https://www.sourcetreeapp.com/ SourceTree] ou [https://windows.github.com/ GitHub para Windows] a fim de fazer o download e gerenciar o código.

=== Adquirindo o último código fonte ===
Para fazer o download da última alteração no código fonte, você tem de fazer o download da última cópia de nosso repositório Git
disponível [https://github.com/multitheftauto/mtasa-blue aqui] ([https://github.com/multitheftauto/mtasa-blue/archive/master.zip zip]|[https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz tar.gz]).

=== Antes de Compilar ===
Para ter certeza que os diretórios-destino tem as permissões corretas, é '''vital''' instalar a última [http://nightly.mtasa.com/ nightly] neste '''exato''' diretório:
C:\Program Files\MTA San Andreas x.x\
Em que x.x é a versão a qual está compilando. Se um windows 64-bit estiver rodando, certifique-se de inserir o "x86" no caminho.

=== Agora como Compilar? ===
Para compilar o programa a partir do código fonte, é necessário ter instalado o Microsoft Visual Studio. Abra o projeto em '''Shared/Core 2008.sln''' e faça-o usando uma das configurações (Debug/Release) disponíveis no mesmo. Note que tudo irá rodar mais lento no modo ''Debug''.

=== Diretório-destino e permissões ===
Por padrão, a versão atual compila os binários em 'C:\Program Files\MTA San Andreas 1.3\'. Para ter certeza que estão corretos as permissões e os registros; e os arquivos de suporte estão presentes, é recomendado instalar ambos os [http://nightly.mtasa.com/ nightly] e [http://code.google.com/p/mtasa-blue/downloads/list?q=label:Data arquivos periféricos] neste diretório.

=== Adquirindo o último módulo de rede===
Já que os módulos de rede '''netc.dll'''/'''net.dll''' destinados ao cliente estão sob uma licença diferente, você deve utilizar os que vem com a última nightly. Se desejar rodar a versão de debug do MTA, ele também vai precisar de uma versão-debug desses módulos. Como não podemos providenciar isso, é só adicionar ao final do nome um "_d" nos já existentes.

= Rodando o programa =
Está quase acabando, só mais uns passos:

=== Rodando o cliente ===
Reveja se está instalado ambos os [http://nightly.mtasa.com/ nightly] e [http://code.google.com/p/mtasa-blue/downloads/list?q=label:Data arquivos periféricos].

=== Rodando o servidor dedicado ===
Se quiser rodar o servidor dedicado, precisará de alguns recursos. Esses são precisos porque incrementa o mais fundamental de um servidor (ex: fazer o jogador nascer) a fim de se poder jogar.

O SVN oficial dos recursos está hospedado no GitHub: [https://github.com/multitheftauto/mtasa-resources]. É recomendado dar uma olhada nas últimas versões ou fazer um download de um zip na aba [http://code.google.com/p/mtasa-resources/downloads/list Downloads] do site. Certifique-se que não esteja rodando nenhum recurso de versões anteriores, porque '''vai''' dar problema.

Se você enfrentar algum confusão por falta de DLL's (ex: libcurl.dll), só é preciso baixar-los nos arquivos periféricos mencionados acima.

= Como se envolver? =
Para começar a contribuir para o MTA, veja mais no [[Coding guidelines|Guia de Programação]] (Em Inglês)

= Informações Adicionais =
Se precisar de mais alguma coisa, tente entrar no [http://bugs.mtasa.com/ bug tracker] ou em nosso [irc://irc.multitheftauto.com canal IRC]

[[en:Compiling MTASA]]
[[ru:Compiling MTASA]]
[[Category: Development]]

Advanced Topics

2015-02-10T13:00:33Z

Cristiano Cardoso:

This page explains some advanced things you can do with scripts, this page should probably be changed later, depending how useful it is.

==Custom element types==
===Forward===
One of the most powerful areas of MTA scripting is custom element types. That is, they are nothing else than new objects you add to extend GTA's world diversity. For instance, the race gamemode uses the spawnpoint and pickup elements to make player matches possible by providing spawn locations and pickups to help them during the track.

By simply defining the element type in any map file entry, MTA automatically recognizes it as a custom one when it starts. Its up to the script to decide how to deal with the information provided. In this section, we're going over the steps how to implement part of the capture-the-flag's system, but this same method can be used for many different things.

===Implemention of an imaginary flag===
First of all, we can't possibly code without thinking how our system going to work first. Lets say we have an imaginary flag around the city created by an ordinary map file:
<syntaxhighlight lang="lua">[pua,N]
<flag id="redFlag" name="red team flag" posX="1210.0" posY="-2241.34" posZ="18.4332" />
</syntaxhighlight>
Why this way? Because it must have an ID to differ from others, a name to be displayed in the game and world position. What we just did was to outline the flag's basic information that our ctf system will require. From that point, we can start coding.

To keep things simple, we'll create a tiny resource for this tutorial, and you should already know [[Scripting_Introduction#Creating_a_simple_script|how to spawn a player]] and [[Scripting_Introduction#Events|make use of events]]. That resource ''will spawn people and handle any flag element created by the current running map'' and it only needs one server-side script called ctf.lua or just whatever name you want to give to it.

With the player spawn code in the script, lets add an custom event that happens when someone pick a flag up, called ''onFlagPickup''. It may be defined anywhere in your script, but it should already exists if you want to use it (i.e. addEventHandler). So, our script will look like this:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
addEvent ("onFlagPickup", true) –- event added here just to ensure it can be used by hole script

function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end

function flagPickup ( player )
flagName = getElementData ( source, "name" )
playerName = getPlayerName ( player )
outputChatBox ( playerName .. " picked up the flag " .. flagName )
end

addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
addEventHandler("onFlagPickup", getRootElement(), flagPickup)
</syntaxhighlight>

Easy enough! We've added an event-driven function (flagPickup). To put it in another way, when the event triggers that function will output who got the flag. We also attached the event to the server root because our gamemode have to function to any flag in the server. We can optimize our script by attaching to the map root, but it requires more code and it is not the our goal yet.

The final part of the puzzle is to trigger the event when the player gets in the flag. To do this, we need to create a timer-driven function that will be used to check if a player is trying to pick it up. So we add the following code to our script:

<syntaxhighlight lang="lua">
function flagCheckPulse ( )
local flags = getElementsByType ( "flag" )
local players = getElementsByType ( "player" )
local flagPositionX, flagPositionY, flagPositionZ
for flagKey,flagValue in ipairs(flags) do
flagX = getElementData ( flagValue, "posX" )
flagY = getElementData ( flagValue, "posY" )
flagZ = getElementData ( flagValue, "posZ" )
for playerKey,playerValue in ipairs(players) do
playerX, playerY, playerZ = getElementPosition ( playerValue )
distance = getDistanceBetweenPoints3D ( flagX, flagY, flagZ, playerX, playerY, playerZ )
if ( distance < 1) then
triggerEvent ( "onFlagPickup", flagValue, playerValue )
end
end
end
end
setTimer (flagCheckPulse,1000,0)
</syntaxhighlight>

What we've done here was to create a simple gamemode which reconizes and listen to a custom element (the flag) in the server's environment (the root). To put simply, it has an abstract capture-the-flag game algorithm. In theory, it would works just great, but the flag doesn't really exists in the world space - nobody even know where it is.

I suppose you just have an meta.xml and ctf.lua in your resource. So if it runs in the server (no conflicting gamemode or errors) we can take the next step to spawn and represent our flag in GTA's world.

===Flag World Represetation===
Soon...

Scripting Introduction

2015-02-09T19:17:05Z

Cristiano Cardoso:

Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.

Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else. MTA comes with resources that you can optionally use in your gamemodes, such as maplimits to keep playings within a playing area or deathpickups to create weapon pickups.
{{tip|Your first step to begin Lua scripting should be using an Lua editor. This makes scripting much easier. We recommend [http://www.sublimetext.com/ Sublime Text], [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] or [http://luaedit.sourceforge.net/ LuaEdit]. There is also an unofficial [[MTASE|MTA Script Editor]] (in work-in-progress state) that you can test out.}}

==Creating a working script==
We will first learn how to make a basic script that lets the player walk around in the city, step by step.
===Where are all the scripts?===
Let's take a look at the script's file structure. Go to your MTA Server folder, and follow the path below:

server/mods/deathmatch/resources/

You will see a lot of .zip files, which are the packaged sample scripts shipped with MTA. Each file is a "resource", and they will all be unzipped and loaded by the server when it starts. To create your own resource, simply make a folder with your preferred name. We'll use "myserver" for this tutorial.

Now you should be under this directory:

server/mods/deathmatch/resources/myserver/

===Identifying your resource===
In order to let the server know what's in the resource, a ''meta.xml'' file must be created to list the resource's content. It must be located in the resource's root directory, which is the "myserver" folder in our case. So create a text file and name it "meta.xml", and open it with notepad.

Enter the following codes in the ''meta.xml'' file:
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
In the ''<info />'' tag, there's a "type" field which indicates that the resource is a ''gamemode'' instead of a regular include or a ''map'', which will be explained later. A gamemode is what you need to make a stand-alone server.

The ''<script />'' tag indicates the script files contained in the resource, which we will create next.
===Creating a simple script===
Note that in the ''<script />'' tag above, the .lua file is not under another directory. Therefore we'll create the file in the same folder as meta.xml. Now you can copy and paste the following code into script.lua:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
The script will spawn you at the coordinate (x, y, z) specified above, when you join the game. Note that the ''fadeCamera'' function must be used or the screen will be black. Also, in releases after DP2, you need to set the camera target (otherwise all the player will see is blue sky).

The '''source''' variable indicates who triggered the event. Since a player has joined when the code is triggered, you use this variable to look which has joined. So it'll spawn that player instead of everyone or a random person.

If we have a closer look on [[addEventHandler]], you can see 3 things: 'onPlayerJoin', which indicates when it's triggered. getRootElement(), which shows by what/who it can be triggered. (getRootElement() is everything/everyone) And joinHandler, which indicates the function that has to be triggered after the event is triggered. Other details will be explained later in another example, now let's just run the server and try it out!

===Running the script===
To get the server started, simply run the executable under the server/ directory. A list of server stats will be shown first; note the port number, which you'll need when joining the game. Then the server loads all the resources under the mods/deathmatch/resources/ directory, and then "ready to accept connections!"

Before you connect to the server, you must run the gamemode. Type "start myserver" and press Enter. The server will start the gamemode you just created, and will also show any errors and warnings from this point on. Now you can start the MTA client, and "Quick Connect" using the IP address of your server and the port number you saw earlier. If all goes well, after a few seconds your character will be walking on the streets of Los Santos.

Next we'll add a command to your script that players can use to spawn a vehicle beside their position. You may skip it and check out more advanced scripting with the [[Map manager|Map Manager]], which continues this tutorial. Another branch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA is drawn and scripted.

==Creating a simple command==
Let's go back to the content of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.

<syntaxhighlight lang="lua">
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- create a vehicle and stuff
end

-- create a command handler
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''

====About command handlers====
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.

If you have already experience in scripting, you will know that you call a function like this:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
If we have a closer look on the lower example above, we can see argument1 is thePlayer and argument2 the commandName. thePlayer is simply the one who typed the command, so whatever you call it, the variable will contain the player who activated the command. commandName is simply the command they typed. So if they typed "/greet", this argument will contain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 arguments are standard arguments, but you can name them to anything you want.

We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.

For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:
<syntaxhighlight lang="lua">
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command
</syntaxhighlight>
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).

''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''

====Writing the function====
In order to fill the function we created, we need to think about what we have to do:
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)
* Spawn the vehicle
* Check if it has been spawned successfully, or output a message

In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.

For [[getElementPosition]], the syntax is:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. (x, y and z) Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (local means, the variables only exist in the current scope, in this case, the function)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
end
</syntaxhighlight>

Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.

We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.

Now we have our complete script:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- check if the return value was ''false''
if (createdVehicle == false) then
-- if so, output a message to the chatbox, but only to this player.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself. For more advanced scripting, please check out the [[Map manager|Map Manager]].

==What you need to know==
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.
===Clientside and Serverside scripts===
You may have already noticed these or similiar terms (Server/Client) somewhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.

Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].

===More complex resources===
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.

===Events===
[[Event|Events]] are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].

This example will output a message with the name of the player who died:
<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.

==Where to go from here==
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.
{{note|From here we recommend reading the [[debugging]] tutorial. Good debugging skills are an absolute necessity when you are making scripts. We also recommend you to use the [[predefined variables list]] to help you with certain tasks and make scripting easier and faster.}}
'''See also:'''
* [[OOP_Introduction|OOP Scripting Introduction]]
* [[Advanced Topics]]
* [[Script_security|Script security]]
* [[Scripting Introduction Urdu]]
[[es:Introducción a la Programación]]
[[it:Introduzione allo scripting]]
[[nl:Scripting_introductie]]
[[pt-br:Introdução ao Scripting]]
[[ru:Scripting Introduction]]
[[ar:مقدمه_في_البرمجه]]
[[zh-cn:脚本编写介绍]]
[[Category:Tutorials]]

Advanced Topics

2015-02-09T19:11:19Z

Cristiano Cardoso: A tiny review in advanced topics

This page explains some advanced things you can do with scripts, this page should probably be changed later, depending how useful it is.

==Custom element types==
===Forward===
One of the most powerful areas of MTA scripting is custom element types. That is, they are nothing else then new objects you add to extend GTA's world diversity. For instance, the race gamemode uses the spawnpoint and pickup elements to make player matches possible by providing spawn locations and pickups to help them during the track.

By simply defining the element type in any map file entry, MTA automatically recognizes it as a custom one when it starts. Its up to the script to decide how to deal with the information provided. In this section, we're going over the steps how to implement part of the capture-the-flag's system, but this same method can be used for many different things.

===Implemention of an imaginary flag===
First of all, we can't possibly code without thinking how our system going to work first. Lets say we have an imaginary flag around the city created by an ordinary map file:
<syntaxhighlight lang="lua">[pua,N]
<flag id="redFlag" name="red team flag" posX="1210.0" posY="-2241.34" posZ="18.4332" />
</syntaxhighlight>
Why this way? Because it must have an ID to differ from others, a name to be displayed in the game and world position. What we just did was to outline the flag's basic information that our ctf system will require. From that point, we can start coding.

To keep things simple, we'll create a tiny resource for this tutorial, and you should already know [[Scripting_Introduction#Creating_a_simple_script|how to spawn a player]] and [[Scripting_Introduction#Events|make use of events]]. That resource ''will spawn people and handle any flag element created by the current running map'' and it only needs one server-side script called ctf.lua or just whatever name you want to give to it.

With the player spawn code in the script, lets add an custom event that happens when someone pick a flag up, called ''onFlagPickup''. It may be defined anywhere in your script, but it should already exists if you want to use it (i.e. addEventHandler). So, our script will look like this:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
addEvent ("onFlagPickup", true) –- event added here just to ensure it can be used by hole script

function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end

function flagPickup ( player )
flagName = getElementData ( source, "name" )
playerName = getPlayerName ( player )
outputChatBox ( playerName .. " picked up the flag " .. flagName )
end

addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
addEventHandler("onFlagPickup", getRootElement(), flagPickup)
</syntaxhighlight>

Easy enough! We've added an event-driven function (flagPickup). To put it in another way, when the event triggers that function will output who got the flag. We also attached the event to the server root because our gamemode have to function to any flag in the server. We can optimize our script by attaching to the map root, but it requires more code and it is not the our goal yet.

The final part of the puzzle is to trigger the event when the player gets in the flag. To do this, we need to create a timer-driven function that will be used to check if a player is trying to pick it up. So we add the following code to our script:

<syntaxhighlight lang="lua">
function flagCheckPulse ( )
local flags = getElementsByType ( "flag" )
local players = getElementsByType ( "player" )
local flagPositionX, flagPositionY, flagPositionZ
for flagKey,flagValue in ipairs(flags) do
flagX = getElementData ( flagValue, "posX" )
flagY = getElementData ( flagValue, "posY" )
flagZ = getElementData ( flagValue, "posZ" )
for playerKey,playerValue in ipairs(players) do
playerX, playerY, playerZ = getElementPosition ( playerValue )
distance = getDistanceBetweenPoints3D ( flagX, flagY, flagZ, playerX, playerY, playerZ )
if ( distance < 1) then
triggerEvent ( "onFlagPickup", flagValue, playerValue )
end
end
end
end
setTimer (flagCheckPulse,1000,0)
</syntaxhighlight>

What we've done here was to create a simple gamemode which reconizes and listen to a custom element (the flag) in the server's environment (the root). To put simply, it has an abstract capture-the-flag game algorithm. In theory, it would works just great, but the flag doesn't really exists in the world space - nobody even know where it is.

I suppose you just have an meta.xml and ctf.lua in your resource. So if it runs in the server (no conflicting gamemode or errors) we can take the next step to spawn and represent our flag in GTA's world.

===Flag World Represetation===
Soon...

Template:PT-BR/Changelogs

2015-02-08T22:39:42Z

Cristiano Cardoso:

{| cellpadding="4" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #FFF; float:right;"
|-
!width=140 style="background-color: #D6DCFF; border-style: solid; border-width: 1px; border-color: #FFF; color:#00000;"| Versão do MTA:SA
!width=400 style="white-space: nowrap; background-color: #D6DCFF; border-style: solid; border-width: 1px; border-color: #FFF;"| Novidades
{{Changelogsrow|1.0|1.0.0 • 1.0.1 • 1.0.2 • 1.0.3 • 1.0.4}}
{{Changelogsrow|1.1|1.1.0 • 1.1.1}}
{{Changelogsrow|1.2|1.2.0}}
{{Changelogsrow|1.3|[[PT-BR/Novidades na versão 1.3|1.3.0]] • [[PT-BR/Novidades na versão 1.3.1|1.3.1]] • 1.3.2 • 1.3.3 • [[PT-BR/Novidades na versão 1.3.4|1.3.4]] • [[PT-BR/Novidades na versão 1.3.5|1.3.5]]}}
{{Changelogsrow|1.4|[[PT-BR/Novidades_na_versão_1.4.0|1.4.0]] • [[PT-BR/Novidades na versão 1.4.1|1.4.1]]}}
|}

Changes in 1.4.1

2015-02-08T22:37:25Z

Cristiano Cardoso:

{{Changelogs}}

== Main Additions / Changes ==
* None yet

== Scripting ==

=== Scripting: New functions ===

====Client====
* None yet

==== Server ====
* None yet

==== Shared (''Client & Server side'') ====
* Added [[hash]]
* Added 'sourceTimer' global variable to timer function

=== Scripting: New Events ===

==== Client ====
* None yet

==== Server ====
* None yet

=== Scripting: Changes, Bugfixes and Additions ===
* Now [[forcePlayerMap]] is a client-side and server-side function
* Fixed a bug when redefining [[Vector|Vectors]] and [[Matrix|Matrices]] (issue [http://bugs.multitheftauto.com/view.php?id=8660 #8660])
* Fixed a crash when trying to get the key of a control bound to a function clientside (issue [http://bugs.multitheftauto.com/view.php?id=8474 #8474])
* Fixed setWeaponFlags(weapon, "flags") returning ''false'' (issue [http://bugs.multitheftauto.com/view.php?id=8686 #8686])

== Client ==

=== Client: Additions ===
* None yet

=== Client: Bugfixes & Changes ===
* None yet

== Server ==

=== Server: Additions ===

=== Server: Bugfixes & Changes ===
* None yet

== Resources ==
* None yet

== Editor ==
* None yet

== Extra information ==
''More detailed information available on [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] and Google Code repositories:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[pt-br:Novidades_na_versão_1.4.1]]

[[Category:Changelog]]
[[Category:Incomplete]]

PT-BR/Novidades na versão 1.4.1

2015-02-08T22:36:04Z

Cristiano Cardoso: Created page with "{{PT-BR/Changelogs}} == Principais Mudanças == * Nada até agora == Scripting == === Novas funções === ====Cliente==== * Nada até agora ====Servidor==== * Nada até a..."

{{PT-BR/Changelogs}}

== Principais Mudanças ==
* Nada até agora

== Scripting ==

=== Novas funções ===

====Cliente====
* Nada até agora

====Servidor====
* Nada até agora

==== Shared (''Client & Server side'') ====
* Adicionada [[hash]]
* Adicionada a variável global "sourceTimer" para a funções de tempo

=== Novos Eventos ===

====Cliente====
* Nada até agora

====Servidor====
* Nada até agora

=== Mudanças, correções de bugs ===
* A função [[forcePlayerMap]] funciona tanto no lado do cliente, quanto servidor.
* Corrigido bug ao redefinir [[Vector|Vetores]] and [[Matrix|Matrizes]] (problema [http://bugs.multitheftauto.com/view.php?id=8660 #8660])
* Corrigido travamento ao tentar obter a tecla vinculada a uma função do cliente (problema [http://bugs.multitheftauto.com/view.php?id=8474 #8474])
* Corrigido o fato da função setWeaponFlags(weapon, "flags") estar retornado "falso" (problema [http://bugs.multitheftauto.com/view.php?id=8686 #8686])

==Cliente==

===Novidades===
* Nada até agora

===Correções de bugs e mudanças===
* Nada até agora

==Servidor==

===Novidades===
* Nada até agora

===Correções de bugs e mudanças===
* Nada até agora

==Recursos==
* Nada até agora

==Editor==
* Nada até agora

== Informações extras ==
''Informações mais detalhadas estão disponíveis em nosso Changelog do [https://bugs.multitheftauto.com/changelog_page.php Bug tracker] e no Google Code:''
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[en:Changes_in_1.4.1]]

[[Category:Changelog]]
[[Category:Incomplete]]

Página Inicial

2015-02-08T22:16:17Z

Cristiano Cardoso:

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Bem vindo ao Wiki do Multi Theft Auto.''' Aqui você encontra tudo sobre o uso desta modificação.

Há muitas [[How you can help|coisas em que você pode nos ajudar]] para melhorar este programa, como criar um mapa, um modo de jogo, documentar funções e eventos, escrever códigos úteis para outros usuários, fazer tutoriais, reportar bugs que encontrar ou somente jogar a vontade!

Se você tem alguma dúvida a respeito do Multi Theft Auto, não se esqueça de perguntar à comunidade em nossos [http://forum.mtasa.com/ fóruns].
<br><br>
</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; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div>
<h3>Jogar</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Baixe o Multi Theft Auto {{Current Version|full}}]'''</div>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Onde_adquirir_o_GTASA|Onde adquirir o GTASA]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Cliente|Manual do usuário]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Novidades_na_versão_{{Current Version|full}}|Novidades da última versão ]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de problemas]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Migrando_do_MTA:Race_ao_MTA:SA_1.3|Migrando do MTA:Race para o MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Servidor|Manual do servidor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Recursos:Map_Manager|Gerenciador de mapas (''Map Manager'')]]

<h3>Editor de mapas</h3>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor|Manual do editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-EDF|Ficheiro de definições do editor (EDF)]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-Plugins|Extensões para o editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor#FAQ|Perguntas frequentes (FAQ)]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div>
<h3>Banco de dados</h3>
Aqui tem tudo relacionado às vantagens que Lua tem a oferecer ao MTA e seus recursos.
* [[Image:iUS.png|Em Inglês|20px]] [[:Category:Resource|Catálogo de Recursos]] - Você deve aprender com eles para fazer scripts bons
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Scripts_do_Cliente|Scripts do Cliente]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Módulos|Módulos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div>
<h3>Desenvolvimento do Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Últimas compilações]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA|Compilando o MTASA no Windows]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Mac_OS_X|Compilando o MTASA no Mac OS X]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Linux|Compilando o MTASA no Linux]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Guia_do_Desenvolvedor|Guia do Desenvolvedor]]
* [[File:iUS.png|Em Inglês|20px]] [http://code.google.com/p/mtasa-blue Código fonte no Google Code]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Roadmap|Roteiro para versões futuras]]
* [[File:iUS.png|Em Inglês|20px]] [http://bugs.mtasa.com/ Central de bugs]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</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|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [irc://irc.multitheftauto.com/mta IRC]
* [[File:iUS.png|Em Inglês|20px]] [http://community.mtasa.com/ Comunidade]
* [[File:iUS.png|Em Inglês|20px]] [http://twitter.com/#!/MTAQA/ Twitter]
* [[File:iUS.png|Em Inglês|20px]] [http://www.youtube.com/user/MTAQA Youtube]
* [[File:iUS.png|Em Inglês|20px]] [http://plus.google.com/102014133442331779727/ Google]
* [[File:iUS.png|Em Inglês|20px]] [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</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|link=]]</div>
<h3>Scripting</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introdução_ao_Scripting|Introdução a ''scripting'']]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introducao_ao_GUI_scripting|Introdução a ''scripting'' de UI]]
* [[File:iBR.png|Em Português|20px]] [[Depuração|Depuração]] - Encontre erros em seu Script
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Recursos|Introdução a recursos]]
** [[File:iBR.png|Em Português|20px]] [[Acesso web via recursos|Acesso web via recursos]] - Abra servidores web através de recursos
** [[File:iBR.png|Em Português|20px]] [[:Category:PT-BR/Recursos|Lista de recursos]]
** [[File:iBR.png|Em Português|20px]] [[O arquivo Meta|Meta.xml]] - Todo recurso possui um arquivo meta descrevendo a si próprio
** [[File:iBR.png|Em Português|20px]] [[Lista de Controle de Acesso|Lista de controle de acesso (ACL)]] - Componente vital para recursos complexos
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Composição_de_Gamemodes|Composição de modos de jogo]]
* [[File:iUS.png|Em Inglês|20px]] [[PT-BR/Funções_Úteis|Funções Úteis]]
<h3>Links dos fóruns</h3>
* [[File:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=152 Secção do fórum para dúvidas sobre ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewforum.php?f=148 Guias de ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Wiki ''offline'']
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Manuais sobre Lua</h3>
Página muito útil para ajuda-lo a entender o funcionamento do Lua
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/portugues.html Introdução à linguagem]
* [[File:iUS.png|Em Inglês|20px]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Manual básico]
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/manual/5.1/pt/ Manual de referência]
* [[File:iUS.png|Em Inglês|20px]] [http://lua-users.org/wiki/TutorialDirectory Outra wiki, somente de Lua]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Referência</h3>
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Functions|Funções do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Events|Eventos do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Functions|Funções do servidor]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Events|Eventos do servidor]]

* [[File:iUS.png|Em Inglês|20px]] [[MTA Classes|Classes do Multi Theft Auto]] - Informações detalhadas sobre todas as classes do MTA
** [[File:iUS.png|Em Inglês|20px]] [[Element tree|Árvore dos elementos]]
</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|link=]]</div>
<h3>[[Id|Lista de IDs de objetos e texturas]]</h3>
*[[Animations|Animações]]
*[[Character Skins|''Skins'' de pedestres]]
*[[Roupas do CJ|Roupas do CJ]]
*[[Garage|Garagens]]
*[[Interior IDs|Interiores]]
*[[Material IDs|Materiais]]
*[[Projectiles|Projéteis]]
*[[Radar Blips|''Blips'']]
*[[Sounds|Efeitos sonoros]]
*[[Vehicle IDs|Veículos]]
*[[Vehicle Colors|Cores dos veículos]]
*[[Vehicle Upgrades|Acessórios dos veículos]]
*[[Vehicle variants|Variantes dos veículos]]
*[[Weapons|Armas]]
*[[Weather|Ambientação]]
</div>

<div style="border: 1px dotted #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:pBR.png|32px]]</div>

<h3>Sobre a Tradução</h3>
* Tradutores:
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=50642|<span style="color: blue">RaceXtreme</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=59023|<span style="color: blue">StanleySathler</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=55744|<span style="color: blue">DNL291</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=62091|<span style="color: blue">Ninguem</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=63192|<span style="color:blue">Anderl</span>]

É importante que todos colaborem para que nossa página em português fique melhor a cada dia!

[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' é um projeto '''open source'''. <br>
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Sobre o Multi Theft Auto'''</li>
<li>[[Archive|Arquivos]]</li>
<li>[[Press Coverage|Eventos]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Desenvolvedores]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Baixe-o]]</li>
<li>[[MTA 0.5r2 Known Issues|Solução de problemas]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Status da Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artigos</li>
<li>{{NUMBEROFPAGES}} páginas</li>
<li>{{NUMBEROFUSERS}} usuários registrados</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pt-br}}

Roupas do CJ

2015-02-08T22:11:47Z

Cristiano Cardoso:

Esta página contem uma lista com todo o vestuário do CJ, incluindo o ID e uma imagem para melhor identificação de cada peça.

*[[CJ Clothes\Shirt (0)|Tipo 0 - Camisas]]
*[[CJ Clothes\Head (1)|Tipo 1 - Cabelo e/ou Barba]]
*[[CJ Clothes\Trousers (2)|Tipo 2 - Calças]]
*[[CJ Clothes\Shoes (3)|Tipo 3 - Sapatos]]
*[[CJ Clothes\Tattoos: Left Upper Arm (4)|Tipo 4 - Tatuagens na parte superior do braço esquerdo]]
*[[CJ Clothes\Tattoos: Left Lower Arm (5)|Tipo 5 - Tatuagens na parte inferior do braço esquerdo]]
*[[CJ Clothes\Tattoos: Right Upper Arm (6)|Tipo 6 - Tatuagens na parte superior do braço direito]]
*[[CJ Clothes\Tattoos: Right Lower Arm (7)|Tipo 7 - Tatuagens na parte inferior do braço direito]]
*[[CJ Clothes\Tattoos: Back (8)|Tipo 8 - Tatuagens nas costas]]
*[[CJ Clothes\Tattoos: Left Chest (9)|Tipo 9 - Tatuagens no peito esquedo]]
*[[CJ Clothes\Tattoos: Right Chest (10)|Tipo 10 - Tatuagens no peito direito]]
*[[CJ Clothes\Tattoos: Stomach (11)|Tipo 11 - Tatuagens na barriga]]
*[[CJ Clothes\Tattoos: Lower Back (12)|Tipo 12 - Tatuagens nas costas]]
*[[CJ Clothes\Necklace (13)|Tipo 13 - Colares]]
*[[CJ Clothes\Watches (14)|Tipo 14 - Relógios]]
*[[CJ Clothes\Glasses (15)|Tipo 15 - Óculos]]
*[[CJ Clothes\Hats (16)|Tipo 16 - Chapéus]]
*[[CJ Clothes\Extra (17)|Tipo 17 - Diversos]]

==Funções relacionadas==
Estão listadas abaixo as funções que podem interagir com esse tipo de elemento (vestimentos do personagem).
{{Client_Clothes and body functions}}

[[en:CJ Clothes]]
[[it:Vestiti di CJ]]
[[ru:CJ Clothes]]
[[de:CJ Kleider]]
[[Category:Conceitos de Scripting]]
[[Category:Translated/ID Lists]]

PT-BR/Roupas do CJ

2015-02-08T22:11:24Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Roupas do CJ to Roupas do CJ

#REDIRECT [[Roupas do CJ]]

Roupas do CJ

2015-02-08T22:11:24Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Roupas do CJ to Roupas do CJ

Esta página contem uma lista com todo o vestuário do CJ, incluindo o ID e uma imagem para melhor identificação de cada peça.

*[[CJ Clothes\Shirt (0)|Tipo 0 - Camisas]]
*[[CJ Clothes\Head (1)|Tipo 1 - Cabelo e/ou Barba]]
*[[CJ Clothes\Trousers (2)|Tipo 2 - Calças]]
*[[CJ Clothes\Shoes (3)|Tipo 3 - Sapatos]]
*[[CJ Clothes\Tattoos: Left Upper Arm (4)|Tipo 4 - Tatuagens na parte superior do braço esquerdo]]
*[[CJ Clothes\Tattoos: Left Lower Arm (5)|Tipo 5 - Tatuagens na parte inferior do braço esquerdo]]
*[[CJ Clothes\Tattoos: Right Upper Arm (6)|Tipo 6 - Tatuagens na parte superior do braço direito]]
*[[CJ Clothes\Tattoos: Right Lower Arm (7)|Tipo 7 - Tatuagens na parte inferior do braço direito]]
*[[CJ Clothes\Tattoos: Back (8)|Tipo 8 - Tatuagens nas costas]]
*[[CJ Clothes\Tattoos: Left Chest (9)|Tipo 9 - Tatuagens no peito esquedo]]
*[[CJ Clothes\Tattoos: Right Chest (10)|Tipo 10 - Tatuagens no peito direito]]
*[[CJ Clothes\Tattoos: Stomach (11)|Tipo 11 - Tatuagens na barriga]]
*[[CJ Clothes\Tattoos: Lower Back (12)|Tipo 12 - Tatuagens nas costas]]
*[[CJ Clothes\Necklace (13)|Tipo 13 - Colares]]
*[[CJ Clothes\Watches (14)|Tipo 14 - Relógios]]
*[[CJ Clothes\Glasses (15)|Tipo 15 - Óculos]]
*[[CJ Clothes\Hats (16)|Tipo 16 - Chapéus]]
*[[CJ Clothes\Extra (17)|Tipo 17 - Diversos]]

==Funções relacionadas==
Estão listadas abaixo as funções que podem interagir com esse tipo de elemento (vestimentos do personagem).
{{Client_Clothes and body functions}}

[[en:CJ Clothes]]
[[it:Vestiti di CJ]]
[[ru:CJ Clothes]]
[[de:CJ Kleider]]
[[Category:Translated/Scripting Concepts]]
[[Category:Translated/ID Lists]]

O arquivo Meta

2015-02-08T22:09:17Z

Cristiano Cardoso:

O ''meta.xml'' é um arquivo de metadados que define ao MTA os conceitos iniciais de um recurso. Exemplos seriam seu nome, os scripts a serem usados e quais devem ser pré-carregados para serem transferidos ao cliente; junto a outros de sua natureza. Ele também transforma arquivos em elementos, a exemplo de sons, imagens e modelos. É escrito em XML, o qual é baseado em HTML e é pai do XHTML.

''obs'': Metadados são dados sobre outros dados. O termo é estranho, mas o próprio nome já diz. No caso do MTA eles seriam metadados descritivos, pois se referem ao conteúdo do jogo.

=Tags=
O XML é um formato de texto muito usado para representar dados, inclusive pelo MTA. As tags a seguir são todas as possibilidades:

*'''<info />''' Representa informações sobre o recurso que podem ser usados de forma opcional, e lidos pela função [[getResourceInfo]], caso necessário:
** '''author:''' O autor do recurso
** '''version:''' A versão do recurso
** '''name:'''' O nome do recurso
** '''description:''' Uma breve descrição do recurso
** '''type:''' Qual é o tipo do recurso, pode ser um "gamemode", "script", "map", ou "misc".
* '''<script />''' O código fonte do recurso, os possíveis parâmetros são:
** '''src:''' O nome do arquivo do código fonte
** '''type:''' O tipo de código-fonte: "client", "server" ou "shared".
** '''cache:''' Quando o script é do tipo client, esse atributo diz se o arquivo será salvo ou não no disco rígido dele. O padrão é "true", se for usado o contrário, será apagado quando o recurso parar.
** '''validate:''' Se for definido como falso, o MTA não verificará se é compatível
* '''<map />''' Define mapa do gamemode, os possíveis atributos são:
** '''src:''' o nome do arquivo .map (pode também ser o diretório, ex: ''maps/nome-do-mapa.map)
** '''dimension:''' Dimensão em que o mapa será carregado (opcional)
* '''<File />''' Um arquivo do lado do cliente. Geralmente são imagens, .txd, .col, .dff ou arquivos .xml. Eles vão ser baixado pelos clientes quando o recurso é iniciado (ou quando ele entrar no servidor)
** '''src:''' nome do arquivo do lado do cliente (pode ser outro caminho por exemplo, "images/imagem.png".)
** '''download:''' Vai ou não ser enviado para o cliente automaticamente(opcional). O padrão é "true". Usando "false" significa que eles não são enviados no início de recursos, mas poderia ser usado posteriormente por DownloadFile (a partir da versão 1.4)
*'''<include />''' Inclui os recursos necessários a estarem rodando
**'''resource:''' Nome do recurso que você quer iniciar junto com esse
**'''minversion:''' A versão mínima desse recurso (opcional)
**'''maxversion:''' A versão máxima desse recurso (opcional)
*'''<config />''' O arquivo de configuração em XML a ser usado pelo recurso:
**'''src:''' Seu nome
**'''type:''' Seu tipo: "client" ou "server"
*'''<export />''' Exporta uma função do seu recurso, para que outros possam usa-la com o [[call]]
**'''function:''' O nome da função
**'''type:''' Diz se será exportado para o lado do cliente ou servidor (valores válidos são: "server" ou "client")
**'''http:''' Indica se ele pode ser chamado via HTTP ("true" ou "false")
*'''<html />'''
**'''src:''' O nome do arquivo HTTP (pode ser um diretório)
**'''default:''' Qual arquivo html a ser mostrado por padrão ao acessar o caminho ''/nome-do-recurso/'' no servidor. Somente um html pode ser definido, os outros são ignorados (true/false)
**'''raw:''' O arquivo html não é interpretado pelo Lua e assim só passa como um dado binário. Deve ser usado para arquivos binários, como imagens principalmente (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Muitos gamemodes usam o [[PT-BR/Sistema_de_Configurações|sistema de configurações]] para habilitar administradores do servidor configurá-los como desejarem. Um exemplo seria definir o tempo de duração da partida e usar o [[get]] e [[set]] para manipular o valor responsável por isso.
*'''<min_mta_version />''' Versão mínima do MTA para o recurso rodar sem problemas. Quando estiver terminando um recurso, a versão mínima deve a mesma da versão do MTA:SA que está usando (a qual no momento é {{Current Version|full}}). Veja o exemplo abaixo.
**'''client:''' A versão mínima do cliente
**'''server:''' A versão mínima do servidor
*'''<aclrequest />''' Indica uma lista de permissões do [[Access_Control_List|ACL]] a serem usados pelo recurso.
*'''<sync_map_element_data />''' Indica se os dados de elemento como "PosX" e "DoubleSided" são tranferidos para o cliente. Esses geralmente não são necessários por muitos gamemodes ou recursos, exceto ''Map Editor'' e ''Interiors''; caso contrário, não funcionarão. Quando definido no recurso, se aplicará a todos os mapas carregados por ele.
**'''false:''' Desabilita essa transferência para todos os recursos. Isso pode reduzir a demora de download consideravelmente.
**'''true:''' Habilita essa tranferência. Se esses valores forem definidos de forma distinta entre os recursos, o que estiver configurado como "true" terá prioridade e todos os demais transferirão esse mesmo dado.
*'''<oop/>''' OOP - Veja mais informações na página: [[OOP]]
**'''false:''' Desabilita o OOP.
**'''true:''' Habilita-o

== Exemplo ==
Aqui está um exemplo de um arquivo meta usando algumas das tags mencionadas:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client" validate="true"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client" cache="false"/>
<map src="base.map" dimension="1"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<export function="exampleExport1" type="server" />
<export function="exampleExport2" type="client" />
<export function="exampleExport3" type="shared" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>
</meta>
|lang="xml"}}
[[Category:Conceitos de Scripting]]
[[en:Meta.xml]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

PT-BR/Meta.xml

2015-02-08T22:08:37Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Meta.xml to O arquivo Meta

#REDIRECT [[O arquivo Meta]]

O arquivo Meta

2015-02-08T22:08:37Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Meta.xml to O arquivo Meta

O ''meta.xml'' é um arquivo de metadados que define ao MTA os conceitos iniciais de um recurso. Exemplos seriam seu nome, os scripts a serem usados e quais devem ser pré-carregados para serem transferidos ao cliente; junto a outros de sua natureza. Ele também transforma arquivos em elementos, a exemplo de sons, imagens e modelos. É escrito em XML, o qual é baseado em HTML e é pai do XHTML.

''obs'': Metadados são dados sobre outros dados. O termo é estranho, mas o próprio nome já diz. No caso do MTA eles seriam metadados descritivos, pois se referem ao conteúdo do jogo.

=Tags=
O XML é um formato de texto muito usado para representar dados, inclusive pelo MTA. As tags a seguir são todas as possibilidades:

*'''<info />''' Representa informações sobre o recurso que podem ser usados de forma opcional, e lidos pela função [[getResourceInfo]], caso necessário:
** '''author:''' O autor do recurso
** '''version:''' A versão do recurso
** '''name:'''' O nome do recurso
** '''description:''' Uma breve descrição do recurso
** '''type:''' Qual é o tipo do recurso, pode ser um "gamemode", "script", "map", ou "misc".
* '''<script />''' O código fonte do recurso, os possíveis parâmetros são:
** '''src:''' O nome do arquivo do código fonte
** '''type:''' O tipo de código-fonte: "client", "server" ou "shared".
** '''cache:''' Quando o script é do tipo client, esse atributo diz se o arquivo será salvo ou não no disco rígido dele. O padrão é "true", se for usado o contrário, será apagado quando o recurso parar.
** '''validate:''' Se for definido como falso, o MTA não verificará se é compatível
* '''<map />''' Define mapa do gamemode, os possíveis atributos são:
** '''src:''' o nome do arquivo .map (pode também ser o diretório, ex: ''maps/nome-do-mapa.map)
** '''dimension:''' Dimensão em que o mapa será carregado (opcional)
* '''<File />''' Um arquivo do lado do cliente. Geralmente são imagens, .txd, .col, .dff ou arquivos .xml. Eles vão ser baixado pelos clientes quando o recurso é iniciado (ou quando ele entrar no servidor)
** '''src:''' nome do arquivo do lado do cliente (pode ser outro caminho por exemplo, "images/imagem.png".)
** '''download:''' Vai ou não ser enviado para o cliente automaticamente(opcional). O padrão é "true". Usando "false" significa que eles não são enviados no início de recursos, mas poderia ser usado posteriormente por DownloadFile (a partir da versão 1.4)
*'''<include />''' Inclui os recursos necessários a estarem rodando
**'''resource:''' Nome do recurso que você quer iniciar junto com esse
**'''minversion:''' A versão mínima desse recurso (opcional)
**'''maxversion:''' A versão máxima desse recurso (opcional)
*'''<config />''' O arquivo de configuração em XML a ser usado pelo recurso:
**'''src:''' Seu nome
**'''type:''' Seu tipo: "client" ou "server"
*'''<export />''' Exporta uma função do seu recurso, para que outros possam usa-la com o [[call]]
**'''function:''' O nome da função
**'''type:''' Diz se será exportado para o lado do cliente ou servidor (valores válidos são: "server" ou "client")
**'''http:''' Indica se ele pode ser chamado via HTTP ("true" ou "false")
*'''<html />'''
**'''src:''' O nome do arquivo HTTP (pode ser um diretório)
**'''default:''' Qual arquivo html a ser mostrado por padrão ao acessar o caminho ''/nome-do-recurso/'' no servidor. Somente um html pode ser definido, os outros são ignorados (true/false)
**'''raw:''' O arquivo html não é interpretado pelo Lua e assim só passa como um dado binário. Deve ser usado para arquivos binários, como imagens principalmente (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Muitos gamemodes usam o [[PT-BR/Sistema_de_Configurações|sistema de configurações]] para habilitar administradores do servidor configurá-los como desejarem. Um exemplo seria definir o tempo de duração da partida e usar o [[get]] e [[set]] para manipular o valor responsável por isso.
*'''<min_mta_version />''' Versão mínima do MTA para o recurso rodar sem problemas. Quando estiver terminando um recurso, a versão mínima deve a mesma da versão do MTA:SA que está usando (a qual no momento é {{Current Version|full}}). Veja o exemplo abaixo.
**'''client:''' A versão mínima do cliente
**'''server:''' A versão mínima do servidor
*'''<aclrequest />''' Indica uma lista de permissões do [[Access_Control_List|ACL]] a serem usados pelo recurso.
*'''<sync_map_element_data />''' Indica se os dados de elemento como "PosX" e "DoubleSided" são tranferidos para o cliente. Esses geralmente não são necessários por muitos gamemodes ou recursos, exceto ''Map Editor'' e ''Interiors''; caso contrário, não funcionarão. Quando definido no recurso, se aplicará a todos os mapas carregados por ele.
**'''false:''' Desabilita essa transferência para todos os recursos. Isso pode reduzir a demora de download consideravelmente.
**'''true:''' Habilita essa tranferência. Se esses valores forem definidos de forma distinta entre os recursos, o que estiver configurado como "true" terá prioridade e todos os demais transferirão esse mesmo dado.
*'''<oop/>''' OOP - Veja mais informações na página: [[OOP]]
**'''false:''' Desabilita o OOP.
**'''true:''' Habilita-o

== Exemplo ==
Aqui está um exemplo de um arquivo meta usando algumas das tags mencionadas:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client" validate="true"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client" cache="false"/>
<map src="base.map" dimension="1"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<export function="exampleExport1" type="server" />
<export function="exampleExport2" type="client" />
<export function="exampleExport3" type="shared" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>
</meta>
|lang="xml"}}
[[Category:Translated/Scripting Concepts]]
[[en:Meta.xml]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

Depuração

2015-02-08T22:07:53Z

Cristiano Cardoso:

Quando você estiver fazendo seu script, certos problemas surgirão. O problema é que nem todos são tão aparentes assim, então esta página irá descrever algumas estratégias básicas para localiza-los.

==Debug no console==
O MTA vem com um sistema no console onde mensagens de ''debug'' relacionadas às funções e scripts são mostradas. Lembrando que é necessário ter uma permissão de administrador para ativá-lo (a não ser se você modificar o ACL). Para fazer isso, digite ''debugscript *x*'' no console, em que ''x'' é o nível:

* '''1:''' mostra somente os erros
* '''2:''' erros e avisos
* '''3:''' erros, avisos e mensagens informativas
Ao digitar ''debugscript 3'', todas as ocorrências serão mostradas. O nível 3 ou o 2 são os recomendados para a maioria dos casos. É de extrema importância estar com o ''debugscript'' ligado para testar seu script e detectar os erros de digitação. Como também, resolver outros eventuais problemas.

===Exemplo===
Neste código há dois erros:
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola")
outputChatbox("Hello Fedor")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Quando este script for carregado, no console irá aparecer algo assim:
:{{Debug info|Loading script failed: meuRecurso\script.lua:2: 'then' expected near ´outputChatbox'}}

Isso significa que o script não pode ser executado porque há um erro de sintaxe. Nesta mensagem, primeiramente aparece qual script de qual recurso deu problema. Depois disso, há dois pontos e um número mostrando a linha onde está o erro; para facilitar o trabalho do programador quando se trata de scripts maiores. Depois disso, a mensagem irá variar de acordo com o tipo de erro. Neste caso, é fácil concluir que o erro está localizado no '''meuRecurso''' e na linha dois do arquivo '''script.lua'''. Desta vez está na cara: precisamos colocar o "then" na cláusula ''if''.
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Agora tudo será carregado com sucesso e nenhum erro aparecerá até que um jogador apelidado "Cebola" dizer algo no chat. Aí no console irá aparecer:
:{{Debug error|myResource\script.lua:2: attempt to call global 'outputChatbox' (a nil value)}}
Isso significa que a função '''outputChatbox''' é um valor ''nil'', ou seja, ele não existe! Isso porque a função na verdade se chama [[outputChatBox]], e não [[outputChatbox]]. Então, tome cuidado com a letra maiúscula B.:
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola") then
outputChatBox("Bem vindo, Cebola!")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>

É óbvio que isso é só um exemplo e não será sempre desse jeito, pois há vários tipos de erros em diversos casos. Mas até aqui, uma boa base já foi ensinada.

==Log de debug do Cliente e Servidor==
====Servidor====
Na pasta ''../server/mods/deathmatch'', haverá dois arquivos com funções parecidas:

*''local.conf'' - são as configurações oriundas do item "host game" no menu principal do MTA. Isto é uma maneira rápida de iniciar um servidor de testes dentro do próprio programa. Quando o usuário fecha o jogo, ele é automaticamente desligado também.

*''mtaserver.conf'' - é usado quando se inicia o "MTA Server.exe" dentro da pasta ''../server/''. Em outras palavras, o servidor é rodado em prompt de comando e não necessita de o MTA estar executando junto. Isso é muito útil para os interessados em montar um servidor dedicado ou mesmo experimentar como é mexer em um servidor de verdade.

Dependendo das suas necessidades, com certeza irá querer alterar essas configurações abaixo:

<syntaxhighlight lang="xml">

<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>


<scriptdebugloglevel>0</scriptdebugloglevel></syntaxhighlight>

Como as descrições acima já dizem, é opcional salvar um arquivo de log de acordo com o nível desejado. Os três níveis estão descritos acima, sendo neste caso o zero como a não ativação do debugscript - fazendo o arquivo ficar em branco. Se 3 for ativado, todos os erros encontrados no '''lado do servidor''' serão salvos em: ''../server/mods/deathmatch/logs/scripts.log''

====Cliente====
Todos os erros '''do cliente''' serão salvos na pasta ''../server/clientscript.log''. Isso já é definido por padrão, então nenhuma configuração é necessária.

==Habilidades em Deubug==

Em vez de ficar procurando no código os erros cometidos, há algumas coisas a serem feitas para ajudar a encontrar-los. A maioria delas estão relacionadas com a adição de alguma mensagem de debug informando o que está ocorrendo no script.

===Funções Úteis===
As funções abaixo podem lhe ajudar com o debug:
* [[outputDebugString]] ou [[outputChatBox]] para escrever qualquer informação na tela (de preferência outputDebugString para suporte técnico)
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] para tornar qualquer variável em uma ''string''. Muito útil para saber o que ela é, escrevendo na tela. Não será necessário usa-la se a variável já uma string ou um número.
* [[getElementType]] verifica o tipo de elemento do MTA em questão.
* [[isElement]] verifica se elemento existe.

===Adicionando mensagens de debug para verificar ''se'', ''quando'' ou por qual ''frequência'' um código é executado===
Se você terminou de escrever um código e percebe que algo esperado não acontece e fica em dúvida se as instruções foram executadas ou não; nesse caso é recomendado adicionar mensagens de debug para verificar os passos.<br>
Um exemplo típico seria checar se uma clausula ''if'' foi atendida ou não:
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("A variável 1 é igual a 2.")
-- portanto, faça alguma coisa
end
</syntaxhighlight>

Outra maneira semelhante seria verificar se alguma variável muda. Em outras palavras, é só adicionar uma mensagem de debug depois de cada vez que isso acontece.

===Adicionando uma mensagem de debug para verificar o ''valor'' de uma variável===
Digamos que desejas criar um marcador (marker), mas ele não aparece na posição esperada. A primeira coisa a ser feita é verificar se a função [[createMarker]] foi executada com sucesso. Depois disso, só precisamos verificar os valores usados nela.
<syntaxhighlight lang="lua">
local marker = createMarker(x,y,z)
if not marker then
outputChatBox("O marcador não pode ser criado.")
end
outputChatBox("A posX é "..x..", posY "..y..", e posZ "..z)
</syntaxhighlight>
Feito isso, as variáveis usadas como coordenadas serão mostradas. Lembrando que se uma variável não for uma frase ou número, é recomendado usar a função [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()], pois ela torna qualquer variável agrupável em uma ''string'', mesmo se for uma ''bool'' ou tabela.

==Exemplo==
Imagine que você criou um [[Colshape|detector de colisão]] e se o jogador ficar dez segundos dentro dele, algo vai acontecer:
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave", root, colShapeLeave)
</syntaxhighlight>
Quando o jogador entrar no colshape, o debugscript irá escrever a seguinte mensagem:
:{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Isso significa que você tentou endereçar uma tabela não existente quando tentou colocar o timer dentro dela; ou seja, ela é um valor ''nil'' - portanto, não existe. Para corrigir isso, precisamos verificar se a tabela não existe, e caso a resposta for positiva; a criaremos.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",root,colShapeLeave)
</syntaxhighlight>

Desta vez receberemos um aviso quando o jogador entrar no colshape, esperar a mensagem e sair de lá:

:{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

Tirando isso (vamos corrigir mais tarde!), tudo parece funcionar bem. O jogador entra no colshape e o ''timer'' começa a contar: se ele esperar, a mensagem é escrita, caso contrário o ''timer'' é destruído. Mas...

===Um erro imperceptível===
Por alguma razão, quando o jogador entra no colshape usando um veículo, a mensagem é escrita duas vezes; como se o código tivesse sido executado duas vezes. Então, adicionamos uma mensagem de debug para verificar isso.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug
outputDebugString("colShapeHit")
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug
outputDebugString("colShapeLeave")
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora dá pra ter certeza que as funções são executadas duas vezes quando entramos com um veículo, mas só uma quando se está a pé. É possível que o veículo seja um elemento a parte e ativa a função de forma independente ao jogador. Para confirmar essa teoria, verificamos se a variável ''player'' realmente se refere ao jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

A mensagem de debug nos diz que uma referência da variável ''player'' é realmente o jogador, mas outra é o veículo. Já que nós destinamos o evento especificamente ao boneco dele, adicionaremos uma cláusula ''if'', obrigando o término da execução do código caso a variável '''não''' for o jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora tudo está funcionando como o planejado, mas aquela mensagem de aviso mencionada acima ainda aparece. Isso porque quando tentamos destruir o timer depois que o jogador saí do colshape, ele não existe mais, já que os 10 segundos se passaram. Em outras palavras, o timer é automaticamente destruído quando ele conta os 10 segundos. Há diversas formas de se livrar do aviso, uma vez que temos conhecimento da não existência do ''timer''. Uma delas seria verificar se ele existe na tabela. Para fazer isto, usamos a função [[isTimer]] na hora de destruí-lo:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

Então o código completo ficará assim:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colshape
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Verificando problemas na performance==
Se o seu servidor estiver trabalhando muito além da conta ou você deseja se certificar que seus scripts são eficientes, é possível matar o problema pela raiz usando uma boa ferramenta inclusa na instalação: [[Resource:Performancebrowser|performancebrowser]]. É só inicia-lo usando ''''start performancebrowser''''. Caso ele não exista, pode encontrá-lo no último pacote de recursos hospedado no [http://code.google.com/p/mtasa-resources Google Code]. Esta ferramenta inclui uma série de informações relativas a performance, como:
* Memory leaks - uso excessivo de memória
* Element leaks - criação excessiva de elementos
* CPU usage - uso excessivo de CPU

Para acessar o performancebrowser, é preciso ir até o navegador e digitar o endereço: <nowiki>http://<ip-do-servidor>:<porta>/performancebrowser/</nowiki>. Um exemplo seria o endereço do servidor local: http://127.0.0.1:22005/performancebrowser/. Lembrando que é preciso:
* colocar a barra (/) no final do endereço
* logar no jogo com uma conta de administrador ou outra que tenha acesso no ACL a:
:* '''resource.performancebrowser.http''' e '''resource.ajax.http'''

{{Dica|A maioria das informações relevantes estão nas categorias ''Lua timing'' e ''Lua memory''. E, o problema está nos valores mais altos apresentados.}}

===Exemplos de scripts problemáticos===

Um deles seria adicionar dados a alguma tabela, mas não remover posteriormente. Porém, isso levaria alguns meses ou até anos para danificar o funcionamento do servidor.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- não há nenhum evento para retirar os dados quando o jogador sair. Isso é considerado memory leak
-- Entrando na aba Lua timing, você pode verificar o uso de RAM de cada recurso.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Um caso possível de ''Element leak'' é criar colisores temporários e nunca destruí-los mais tarde. Isso aumenta muito o uso de transferência dados (bandwidth), CPU e memória pelo servidor.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(some code here)
if (algo que deveria acontecer...) then
destroyElement(col)
end
-- E as vezes não acontece, fazendo o colisor permanecer no mapa pra sempre...
-- Criando de centenas à milhares de coliores sem função alguma.
-- Na aba Lua timing é possível ver quantos elementos cada script criou.
end
</syntaxhighlight>

O alto uso de CPU resulta na queda de FPS, fazendo o servidor um lugar ruim para se jogar. Em 24 horas, isso pode causar sérios prejuízos. O número de elementos criados detectados na aba ''Lua timing'' não ajudará neste caso, mas o ''Lua memory'' sim.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- [Código para o novo jogador]
-- Até que um evento é adicionado para quando ele sair
addEventHandler("onPlayerQuit", root, function()
-- Encontrou o problema? Esse evento além de usar o root como o seu causador, é criado infinitamente...
end)
end)
</syntaxhighlight>
Uma função usa muito o CPU quando ela demora para terminar de ser executada. O exemplo abaixo é uma delas. Sem o performancebrowser, você não perceberia tão cedo que esta é a causa do problema. Mas com ele, verá na aba ''Lua timing'' que o seu recurso usa muito o potencial do CPU. Ficará mais fácil descobrir isso se usar o parâmetro ''''d'''' na caixa de entrada ''Options''. Isso porque ela lhe dirá também a linha em que está o código problemático.
<syntaxhighlight lang="lua">
function umaFuncaoPoucoEficaz()
-- para cada cem mil coisas quaisquer
for i=1, 100000 do
-- [código abaixo]
end
end
</syntaxhighlight>

[[en:Debugging]]
[[it:Guida al Debug]]
[[ru:Debugging]]
[[Category:Conceitos de Scripting]]
[[Category:Tutorials]]

PT-BR/Depuração

2015-02-08T22:07:38Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Depuração to Depuração

#REDIRECT [[Depuração]]

Depuração

2015-02-08T22:07:37Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Depuração to Depuração

Lista de Controle de Acesso

2015-02-08T22:07:15Z

Cristiano Cardoso:

O MTA possui uma lista de controle de acesso chamada ACL (Access Control List ou Lista de Controle de Acesso). Ele permite proteger e limitar o acesso ao servidor, a suas funções e recursos da forma desejada.

Um conceito chave do ACL é que você dá a um determinado objeto um conjunto de direitos. No MTA, os objetos são ora recursos, ora usuários. Existem inúmeros direitos disponíveis, e eles principalmente se referem às funções do lado do servidor (server-side, em Inglês).

Em outras palavras, o ACL permite que você escolha exatamente o que é permitido - o que um recurso ou usuário pode fazer. Essa funcionalidade dentro do jogo é essencial, porque por exemplo, ele impede os jogadores comuns do seu servidor serem capazes de banir outros jogadores, ou previne novos recursos não testados de fazerem o mesmo.

É claro, qualquer grande poder precisa de grandes responsabilidades, ou seja, é facílimo romper completamente os recursos. Por exemplo, desativar a função [[spawnPlayer]] para todos eles seria uma coisa ruim. Porém, há certas situações em que será necessário fazer isso, mesmo sendo uma medida bem rígida.

==Anatomia do ACL==
Há em dois componentes principais no arquivo: os grupos e as listas. Eles aparecem como tags '''<group name="">''' e '''<acl name="" />'''. Suas finalidades são: <br>

'''1.''' Conceder permissão a usuários para controlar o servidor e usar comandos oferecidos pelos recursos.
Exemplos:
* Permitir administradores a usem apenas a função ''giveweapon'' do ''Freeroam''.
* Permitir todos os usuários iniciem recursos.

'''2.''' Conceder permissão a recursos para usar funções de script e de outros recursos.
Exemplos:
* Permitir um recurso utilizar a função ''restartResource''.
* Permitir um recurso utilizar funções exportadas por um script a partir do [[call]].

===Grupos Padrões===
MTA fornece alguns grupos padrões com permissões em ordem decrescente (mais restrito). Estes grupos são os seguintes:
*'''Everyone'''
*'''Moderator'''
*'''SuperModerator'''
*'''Admin'''
*'''Console''' - Este controla as permissões de pessoas que estão usando o console do servidor através do objeto: '''<object name="user.Console" />'''
*'''RPC''' - Remote Procedure Call. Especificamente concede acesso à função [[callRemote]] e o desativa a demais recursos. Dê uma olhada em sua página para saber mais.
<br>Para explicar melhor, será usado o grupo Everyone como exemplo. Se você não tiver modificado o arquivo ainda, ele é idêntico a isso:<br/>
<syntaxhighlight lang="lua"> <group name="Everyone">
<acl name="Default" />
<object name="user.*" />
<object name="resource.*" />
</group>
</syntaxhighlight>
Você primeiro deve identificar o conjunto ACL (o nome) dentro do grupo. Essa tag define quais são poderes do grupo. Quaisquer usuários e recursos neste grupo herdarão as permissões estabelecidos neste conjunto com o nome de "Default".

''Obs'': É bom destacar que esse grupo é especial, pois inclui todos os usuários e recursos por meio de um'' '''asterisco (*)''' ''; ou seja, os nomes de todos serão automaticamente preenchidos pelo computador na hora da leitura''

Agora, desça um pouco o ACL e você verá a entrada '''<acl name="Default" />'''. Note que eu omiti ''drasticamente'' esta lista devido a sua extensão.
<syntaxhighlight lang="lua"> <acl name="Default">
<right name="command.start" access="false" />
<right name="command.stop" access="false" />
<right name="command.stopall" access="false" />
...
<right name="function.executeCommandHandler" access="false" />
<right name="function.setPlayerMuted" access="false" />
<right name="function.restartResource" access="false" />
...
<right name="general.adminpanel" access="false" />
<right name="general.tab_players" access="false" />
<right name="general.tab_resources" access="false" />
...
<right name="command.freeze" access="false" />
<right name="command.shout" access="false" />
<right name="command.spectate" access="false" />
...
</acl>
</syntaxhighlight>

* '''Function''' - cada ''tag'' dele representa uma função do MTA. Por exemplo, se um recurso precisa usar a função ''restartResource'' e ele estiver no grupo "Everyone", será negado o acesso e ele não funcionará corretamente.
* '''Command''' - cada um se refere a um comando criado com [[addCommandHandler]]. Um exemplo de comando seria digitar "/createvehicle [ID]" no chat para o recurso Freeroam criar um veículo. Em outras palavras, esse elemento controla se os usuários do grupo ACL podem ou não usar o comando. ''Os comandos não fazem nenhum efeito sobre os recursos incluídos no grupo, ou seja, os comandos só servem para usuários.''
**''General, é um direito personalizado criado pelo recurso "admin", mas ele funciona com os mesmos princípios. O script trabalha com eles através da função ''[[hasObjectPermissionTo]].

É possível notar alguns grupos, tais como admin, possuem múltiplas ''tags'' do tipo '''<acl name="" />''' definidas nele. Um exemplo:
<syntaxhighlight lang="lua">
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="resource.admin" />
<object name="resource.webadmin" />
<object name="user.Ransom" />
</group>
</syntaxhighlight>

O que acontece aqui é: a cada tag '''<acl name="" />''' apresentada, todas suas permissões serão concedidas a esse grupo. Por exemplo, o recurso ''admin'' se certifica que ganhou todas as permissões de administrador ao usar todos os conjuntos. Caso houver conflito, é dada prioridade ao seguinte. Partindo do exemplo acima, é apresentado o esquema a seguir:

'''1.''' O conjunto '''<acl name="Moderator">''' define a permissão <right name="general.ModifyOtherObjects" access="false" /> como negada<br>
'''2.''' O conjunto '''<acl name="Admin">''' define a permissão <right name="general.ModifyOtherObjects" access="true" /> como permitida<br>
'''3.''' Portanto, para todos os usuários e recursos do grupo "admin", a permissão será: <right name="general.ModifyOtherObjects" access="true"/> permitida<br>

===Grupos e Recursos ACL===
É possível notar que alguns outros grupos vieram no arquivo. Eles são identificados como recursos já inclusos na instalação. Se um recurso deseja designar direitos específicos não previstas pelos grupos padrões do MTA, ele pode criar o seu próprio grupo e conjunto ACL, e usá-lo eventualmente. Por exemplo, o recurso AMX foi projetado para emular scripts do SA-MP e ele precisa de um certo conjunto de permissões que não se enquadram nos grupos existentes. Então ele criou seus próprios conjuntos no arquivo, como mostra a seguir:
<syntaxhighlight lang="lua">
<group name="AMX">
<acl name="AMX" />
<object name="resource.amx" />
</group>

...

<acl name="AMX">
<right name="general.ModifyOtherObjects" access="true" />
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="general.adminpanel" access="false" />
...
<right name="command.kick" access="false" />
<right name="command.freeze" access="false" />
<right name="command.mute" access="false" />
...
</acl>
</syntaxhighlight>
==Modificando o ACL==
Há três maneiras de alterar o ACL, como você irá fazer isso depende de onde partirá a alteração:

===Interface HTTP===
Você pode usar a interface HTTP oferecida pelo [[Resource/webadmin|webadmin]] para modificar o ACL no seu navegador. Esta é a maneira mais fácil de modifica-lo. Apenas certifique-se de que o servidor está executando os recursos de webadmin e visite ''<nowiki>http://<IP-do-servidor>:<porta>/</nowiki>''. Em seguida, será possível acessar duas seções:
* ACLs - permite que você crie suas lista de controle de acesso
* Groups - permite criar grupos de usuários e atribuir-lhes a um conjunto ACL

Por exemplo, a seção ACLs permite que dê a um grupo de administradores existente o acesso ao comando ''start'' do console. Em seguida, você pode ir até a seção "Groups" e criar um novo grupo de administração, tendo acesso a esse mesmo conjunto ACL referido na seção ACLs. Finalmente, você pode adicionar novos usuários e esse grupo criado.

===Arquivo XML===
Você pode modificar o arquivo ACL.xml manualmente. Ele tem uma sintaxe bastante simples, mas pode ficar um pouco confuso às vezes. Se você editá-lo quando o servidor estiver em execução, não se esqueça de chamar a função de script [[aclReload]] ("start runcode", "run aclReload()"), para a nova ACL carregar as alterações. Desta maneira, serão evitadas substituições acidentais no servidor.

===Funções de Scripting===
Você pode usar um certo número de funções de script para modificar a ACL. Claro, você pode (e certamente deve!), limitar o acesso à funções ACL através do próprio ACL.xml. Note-se que o '''recurso admin''', incluso na instalaçao do MTA, pode ser usado para gerenciar a ACL na aba "resources". Você deve estar logado como administrador para usar o painel de administração. [http://wiki.multitheftauto.com/wiki/Admin Clique aqui para mais informações] de como se fazer isto.

==Veja também==
{{ACL functions}}
[[Category:Conceitos de Scripting]]
[[en:Access Control List]]
[[ru:Access Control List]]

PT-BR/ACL

2015-02-08T22:06:50Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/ACL to Lista de Controle de Acesso

#REDIRECT [[Lista de Controle de Acesso]]

Lista de Controle de Acesso

2015-02-08T22:06:50Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/ACL to Lista de Controle de Acesso

O MTA possui uma lista de controle de acesso chamada ACL (Access Control List ou Lista de Controle de Acesso). Ele permite proteger e limitar o acesso ao servidor, a suas funções e recursos da forma desejada.

Um conceito chave do ACL é que você dá a um determinado objeto um conjunto de direitos. No MTA, os objetos são ora recursos, ora usuários. Existem inúmeros direitos disponíveis, e eles principalmente se referem às funções do lado do servidor (server-side, em Inglês).

Em outras palavras, o ACL permite que você escolha exatamente o que é permitido - o que um recurso ou usuário pode fazer. Essa funcionalidade dentro do jogo é essencial, porque por exemplo, ele impede os jogadores comuns do seu servidor serem capazes de banir outros jogadores, ou previne novos recursos não testados de fazerem o mesmo.

É claro, qualquer grande poder precisa de grandes responsabilidades, ou seja, é facílimo romper completamente os recursos. Por exemplo, desativar a função [[spawnPlayer]] para todos eles seria uma coisa ruim. Porém, há certas situações em que será necessário fazer isso, mesmo sendo uma medida bem rígida.

==Anatomia do ACL==
Há em dois componentes principais no arquivo: os grupos e as listas. Eles aparecem como tags '''<group name="">''' e '''<acl name="" />'''. Suas finalidades são: <br>

'''1.''' Conceder permissão a usuários para controlar o servidor e usar comandos oferecidos pelos recursos.
Exemplos:
* Permitir administradores a usem apenas a função ''giveweapon'' do ''Freeroam''.
* Permitir todos os usuários iniciem recursos.

'''2.''' Conceder permissão a recursos para usar funções de script e de outros recursos.
Exemplos:
* Permitir um recurso utilizar a função ''restartResource''.
* Permitir um recurso utilizar funções exportadas por um script a partir do [[call]].

===Grupos Padrões===
MTA fornece alguns grupos padrões com permissões em ordem decrescente (mais restrito). Estes grupos são os seguintes:
*'''Everyone'''
*'''Moderator'''
*'''SuperModerator'''
*'''Admin'''
*'''Console''' - Este controla as permissões de pessoas que estão usando o console do servidor através do objeto: '''<object name="user.Console" />'''
*'''RPC''' - Remote Procedure Call. Especificamente concede acesso à função [[callRemote]] e o desativa a demais recursos. Dê uma olhada em sua página para saber mais.
<br>Para explicar melhor, será usado o grupo Everyone como exemplo. Se você não tiver modificado o arquivo ainda, ele é idêntico a isso:<br/>
<syntaxhighlight lang="lua"> <group name="Everyone">
<acl name="Default" />
<object name="user.*" />
<object name="resource.*" />
</group>
</syntaxhighlight>
Você primeiro deve identificar o conjunto ACL (o nome) dentro do grupo. Essa tag define quais são poderes do grupo. Quaisquer usuários e recursos neste grupo herdarão as permissões estabelecidos neste conjunto com o nome de "Default".

''Obs'': É bom destacar que esse grupo é especial, pois inclui todos os usuários e recursos por meio de um'' '''asterisco (*)''' ''; ou seja, os nomes de todos serão automaticamente preenchidos pelo computador na hora da leitura''

Agora, desça um pouco o ACL e você verá a entrada '''<acl name="Default" />'''. Note que eu omiti ''drasticamente'' esta lista devido a sua extensão.
<syntaxhighlight lang="lua"> <acl name="Default">
<right name="command.start" access="false" />
<right name="command.stop" access="false" />
<right name="command.stopall" access="false" />
...
<right name="function.executeCommandHandler" access="false" />
<right name="function.setPlayerMuted" access="false" />
<right name="function.restartResource" access="false" />
...
<right name="general.adminpanel" access="false" />
<right name="general.tab_players" access="false" />
<right name="general.tab_resources" access="false" />
...
<right name="command.freeze" access="false" />
<right name="command.shout" access="false" />
<right name="command.spectate" access="false" />
...
</acl>
</syntaxhighlight>

* '''Function''' - cada ''tag'' dele representa uma função do MTA. Por exemplo, se um recurso precisa usar a função ''restartResource'' e ele estiver no grupo "Everyone", será negado o acesso e ele não funcionará corretamente.
* '''Command''' - cada um se refere a um comando criado com [[addCommandHandler]]. Um exemplo de comando seria digitar "/createvehicle [ID]" no chat para o recurso Freeroam criar um veículo. Em outras palavras, esse elemento controla se os usuários do grupo ACL podem ou não usar o comando. ''Os comandos não fazem nenhum efeito sobre os recursos incluídos no grupo, ou seja, os comandos só servem para usuários.''
**''General, é um direito personalizado criado pelo recurso "admin", mas ele funciona com os mesmos princípios. O script trabalha com eles através da função ''[[hasObjectPermissionTo]].

É possível notar alguns grupos, tais como admin, possuem múltiplas ''tags'' do tipo '''<acl name="" />''' definidas nele. Um exemplo:
<syntaxhighlight lang="lua">
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="resource.admin" />
<object name="resource.webadmin" />
<object name="user.Ransom" />
</group>
</syntaxhighlight>

O que acontece aqui é: a cada tag '''<acl name="" />''' apresentada, todas suas permissões serão concedidas a esse grupo. Por exemplo, o recurso ''admin'' se certifica que ganhou todas as permissões de administrador ao usar todos os conjuntos. Caso houver conflito, é dada prioridade ao seguinte. Partindo do exemplo acima, é apresentado o esquema a seguir:

'''1.''' O conjunto '''<acl name="Moderator">''' define a permissão <right name="general.ModifyOtherObjects" access="false" /> como negada<br>
'''2.''' O conjunto '''<acl name="Admin">''' define a permissão <right name="general.ModifyOtherObjects" access="true" /> como permitida<br>
'''3.''' Portanto, para todos os usuários e recursos do grupo "admin", a permissão será: <right name="general.ModifyOtherObjects" access="true"/> permitida<br>

===Grupos e Recursos ACL===
É possível notar que alguns outros grupos vieram no arquivo. Eles são identificados como recursos já inclusos na instalação. Se um recurso deseja designar direitos específicos não previstas pelos grupos padrões do MTA, ele pode criar o seu próprio grupo e conjunto ACL, e usá-lo eventualmente. Por exemplo, o recurso AMX foi projetado para emular scripts do SA-MP e ele precisa de um certo conjunto de permissões que não se enquadram nos grupos existentes. Então ele criou seus próprios conjuntos no arquivo, como mostra a seguir:
<syntaxhighlight lang="lua">
<group name="AMX">
<acl name="AMX" />
<object name="resource.amx" />
</group>

...

<acl name="AMX">
<right name="general.ModifyOtherObjects" access="true" />
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="general.adminpanel" access="false" />
...
<right name="command.kick" access="false" />
<right name="command.freeze" access="false" />
<right name="command.mute" access="false" />
...
</acl>
</syntaxhighlight>
==Modificando o ACL==
Há três maneiras de alterar o ACL, como você irá fazer isso depende de onde partirá a alteração:

===Interface HTTP===
Você pode usar a interface HTTP oferecida pelo [[Resource/webadmin|webadmin]] para modificar o ACL no seu navegador. Esta é a maneira mais fácil de modifica-lo. Apenas certifique-se de que o servidor está executando os recursos de webadmin e visite ''<nowiki>http://<IP-do-servidor>:<porta>/</nowiki>''. Em seguida, será possível acessar duas seções:
* ACLs - permite que você crie suas lista de controle de acesso
* Groups - permite criar grupos de usuários e atribuir-lhes a um conjunto ACL

Por exemplo, a seção ACLs permite que dê a um grupo de administradores existente o acesso ao comando ''start'' do console. Em seguida, você pode ir até a seção "Groups" e criar um novo grupo de administração, tendo acesso a esse mesmo conjunto ACL referido na seção ACLs. Finalmente, você pode adicionar novos usuários e esse grupo criado.

===Arquivo XML===
Você pode modificar o arquivo ACL.xml manualmente. Ele tem uma sintaxe bastante simples, mas pode ficar um pouco confuso às vezes. Se você editá-lo quando o servidor estiver em execução, não se esqueça de chamar a função de script [[aclReload]] ("start runcode", "run aclReload()"), para a nova ACL carregar as alterações. Desta maneira, serão evitadas substituições acidentais no servidor.

===Funções de Scripting===
Você pode usar um certo número de funções de script para modificar a ACL. Claro, você pode (e certamente deve!), limitar o acesso à funções ACL através do próprio ACL.xml. Note-se que o '''recurso admin''', incluso na instalaçao do MTA, pode ser usado para gerenciar a ACL na aba "resources". Você deve estar logado como administrador para usar o painel de administração. [http://wiki.multitheftauto.com/wiki/Admin Clique aqui para mais informações] de como se fazer isto.

==Veja também==
{{ACL functions}}
[[Category:Translated/Scripting Concepts]]
[[en:Access Control List]]
[[ru:Access Control List]]

Acesso web via recursos

2015-02-08T22:04:01Z

Cristiano Cardoso:

O Multi Theft Auto disponibiliza uma interface web a ser usada pelos recursos de diferentes formas. A proposta deste artigo é descrever-las e explicar sua utilização.

==Introdução==
Há dois componentes chaves desse ecossistema. O primeiro é um servidor web comum, o qual permite os navegadores demandarem páginas e arquivos presentes no recurso. O segundo é um componente que gerencia chamadas realizadas pelos navegadores à funções exportadas de seu recurso.

==Páginas==
===Especificando componentes no arquivo meta===
É possível definir certos arquivos acessíveis via servidor web em seu recurso. Para fazer isso é só adicionar:
<syntaxhighlight lang="lua" lang="xml">
<html src="nome-do-arquivo.ext" />
</syntaxhighlight>
Você pode acessar esse arquivo ao digitar o link: <nowiki>http://host:port/nome-do-recurso/nome-do-arquivo.ext</nowiki><br/>
Um exemplo seria um servidor local usando a porta http padrão e com o ''webmap'' iniciado: http://127.0.0.1:22005/webmap/map.htm

===Arquivos binários===
Tirando a possibilidade de você errar o nome, os arquivos usando a ''tag'' html podem ser de qualquer tipo. Se eles forem binários (como imagens, .zip), será necessário especificar isso na ''tag'' usando ''raw=true''. Isso significa que ele não será pre-processado antes de serem enviado ao servidor web.

Um exemplo:
<syntaxhighlight lang="lua" lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Arquivos Processados===
Se um arquivo não for binário, então terá de ser pré-processado antes de ser retornado ao cliente. Esse processamento funciona de um jeito muito parecido com PHP ou ASP, mas usa o método do LUA. Você pode inserir scripts do MTA em uma página HTML, controlando sua saída. Quase todas as funções funcionam, incluindo determinadas [[Template:HTTP functions|Funções HTTP]], como [[httpWrite]]; o qual escreve um texto no buffer.

Por exemplo:
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

Há também uma maneira mais simples (muito utilizada no PHP e ASP) de se escrever o código acima:

<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

Junto com as funções HTTP, o Lua trabalha com variáveis específicas que contém informações sobre a página demandada:
* table '''requestHeaders''': É uma tabela contendo todas as ''headers'' requisitadas junto com a página. Você pode definir quais serão retornadas com [[httpSetResponseHeader]].
* table '''form''': Essa tabela abriga todos os dados enviados à página usando ''HTTP POST'' seguidos de quaisquer variáveis enviadas à ''querystring'' usando HTTP GET.
* table '''cookies''': Essa contém todos os cookies. É possível altera-los usando [[httpSetResponseCookie]].
* string '''hostname''': É uma ''string'' contendo o endereço de IP ou o nome do host da página requisitada.
* string '''url''': É a URL da página.
* account '''user''': Retorna a conta do usuário atual.

É importante lembrar que os arquivos estão em uma máquina virtual separada do resto do seu recurso. Como também, se desejar chamar alguma função presente no script dele, ela terá de ser exportada, e mais tarde, usando-a chamando o [[call]] na página criada.

==Calls==
É possível definir certas funções a serem chamadas via HTTP. Todos os SDKs (listados abaixo) lhe permitem fazer isso remotamente.

Para fazer isto, é só adicionar a linha abaixo em seu meta.xml:
<syntaxhighlight lang="lua" lang="xml">
<export function='functionName' http='true' />
</syntaxhighlight>

A sua função pode ser escrita normalmente e retornar quantas variáveis for preciso; incluindo tabelas, recursos, e o mais importante: elementos. Em contrapartida, ''não'' é possível retornar qualquer variável do tipo ''userdata'', como ''[[xmlnode|xmlnodes]]'' ou funções.

==Protocolos==
{{Dica|Não é preciso aprender isso, a não ser que você esteja escrevendo seu próprio código de ''HTTP request''. Se desejar, use uma das [[#SDK|SDKs listadas abaixo]].}}

Chamadas são feitas ao se utilizar ''<nowiki>http://<IP>:<porta>/<recurso>/call/<função-exportada></nowiki>' usando ''HTTP POST''. O corpo do comando pode ser uma ''array'' JSON contendo argumentos a serem enviados à função.

A resposta HTTP também será uma ''array'' JSON contendo valor(es) retornados pela função.

O servidor suporta autenticação HTTP básica e você poderá configurar-la via ACL e pelo sistema padrão de contas.

===Chamadas via interface web HTTP===
Chamadas são praticamente a coisa mais fácil a ser feita pela interface web.

Primeiro, adicione esta linha no meta:
<syntaxhighlight lang="lua" lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Segundo, adicione o código a seguir dentro de <head> na página da qual deseja chamar a função:
<syntaxhighlight lang="lua" lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

E a partir de agora, é só digitar um bloco em javascript e chamar as funções quase como se fossem locais. A única diferença é que as chamadas são assíncronas. Não se esqueça de especificar uma função a qual receberá o retorno HTTP no último argumento.

Aí vai um exemplo:

'''meta.xml'''
<syntaxhighlight lang="lua" lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua" lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

É possível ver alguns exemplos um pouco complexos de como se utiliza esse método nos recursos''resourcebrowser'', ''resourcemanager'' e ''webadmin''.

==Garantindo segurança na interface web==
O [[PT-BR/ACL|ACL]] contém um certo número de permissões que podem afetar a maneira como os arquivos são acessados.
{{Componente_ultrapassado|3.0139|1.3.1|
* general.http: Se for desativada, nenhum dos arquivos http poderão ser acessados (excluindo os do cliente)
** '''É importante lembrar''': ''Se essa for ativada, todos os recursos (definidos nesse ACL) ganharão acesso automaticamente. Para desabilitar isso em recursos com funções exportadas, é preciso explicitar o bloqueio.''
** '''É importante lembrar''': ''Se for ativada em um ACL contendo um usuário sem senha (ex: user.*, user.guest ou user.http_guest), é recomendado bloquear o acesso à recursos que contém funções exportadas ao HTTP.''
* resource.'''Nome-do-recurso''': Se for desabilitada, nenhum dos arquivos do recurso poderão ser acessados
* resource.'''Nome-do-recurso'''.file.'''Nome-do-arquivo''': Se for desabilitada, este não poderá ser acessado
* resource.'''Nome-do-recurso'''.function.'''Nome-da-função''': Se for desabilitada, a função não poderá ser chamada

Todos esses acima funciona com outras permissões do ACL; ou seja, é possível desabilita-los para usuários comuns ou só permitir acesso aos administradores. Ou até mesmo a outro grupo de usuários credenciados.
}}
{{Novo_componente|3.0139|1.3.1|
* '''resource.Nome-do-recurso.http''': Se for habilitada, o recurso será acessível a partir do endereço: http://ip_do_servidor:22005/Nome_do_recurso/
Isso funciona para outras permissões do ACL também, ou seja, é possível habilitar-la só a administradores ou um grupo específico.
}}

==SDK==
Há alguns dos tão conhecidos SDKs disponíveis para interagir com o servidor a partir de outras linguagens de programação. Com isso, é possível (em teoria) escrever gamemodes completos. Na prática, é uma má ideia, porém útil para estatísticas e administração. O SDK de PHP é o mais desenvolvido. Sinta-se a vontade de modificar ou criar seu próprio SDK - não se esqueça de nos mandar uma cópia, por favor!

* [[JavaSDK|Java SDK]]
* [[Javascript SDK]]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==Veja mais==
[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
[[Category:Conceitos_de_Scripting]]
[[en:Resource Web Access]]
[[ru:Resource Web Access]]
[[Category:Tutorials]]

PT-BR/Acesso web via recursos

2015-02-08T22:02:59Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Acesso web via recursos to Acesso web via recursos

#REDIRECT [[Acesso web via recursos]]

Acesso web via recursos

2015-02-08T22:02:58Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Acesso web via recursos to Acesso web via recursos

O Multi Theft Auto disponibiliza uma interface web a ser usada pelos recursos de diferentes formas. A proposta deste artigo é descrever-las e explicar sua utilização.

==Introdução==
Há dois componentes chaves desse ecossistema. O primeiro é um servidor web comum, o qual permite os navegadores demandarem páginas e arquivos presentes no recurso. O segundo é um componente que gerencia chamadas realizadas pelos navegadores à funções exportadas de seu recurso.

==Páginas==
===Especificando componentes no arquivo meta===
É possível definir certos arquivos acessíveis via servidor web em seu recurso. Para fazer isso é só adicionar:
<syntaxhighlight lang="lua" lang="xml">
<html src="nome-do-arquivo.ext" />
</syntaxhighlight>
Você pode acessar esse arquivo ao digitar o link: <nowiki>http://host:port/nome-do-recurso/nome-do-arquivo.ext</nowiki><br/>
Um exemplo seria um servidor local usando a porta http padrão e com o ''webmap'' iniciado: http://127.0.0.1:22005/webmap/map.htm

===Arquivos binários===
Tirando a possibilidade de você errar o nome, os arquivos usando a ''tag'' html podem ser de qualquer tipo. Se eles forem binários (como imagens, .zip), será necessário especificar isso na ''tag'' usando ''raw=true''. Isso significa que ele não será pre-processado antes de serem enviado ao servidor web.

Um exemplo:
<syntaxhighlight lang="lua" lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Arquivos Processados===
Se um arquivo não for binário, então terá de ser pré-processado antes de ser retornado ao cliente. Esse processamento funciona de um jeito muito parecido com PHP ou ASP, mas usa o método do LUA. Você pode inserir scripts do MTA em uma página HTML, controlando sua saída. Quase todas as funções funcionam, incluindo determinadas [[Template:HTTP functions|Funções HTTP]], como [[httpWrite]]; o qual escreve um texto no buffer.

Por exemplo:
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

Há também uma maneira mais simples (muito utilizada no PHP e ASP) de se escrever o código acima:

<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

Junto com as funções HTTP, o Lua trabalha com variáveis específicas que contém informações sobre a página demandada:
* table '''requestHeaders''': É uma tabela contendo todas as ''headers'' requisitadas junto com a página. Você pode definir quais serão retornadas com [[httpSetResponseHeader]].
* table '''form''': Essa tabela abriga todos os dados enviados à página usando ''HTTP POST'' seguidos de quaisquer variáveis enviadas à ''querystring'' usando HTTP GET.
* table '''cookies''': Essa contém todos os cookies. É possível altera-los usando [[httpSetResponseCookie]].
* string '''hostname''': É uma ''string'' contendo o endereço de IP ou o nome do host da página requisitada.
* string '''url''': É a URL da página.
* account '''user''': Retorna a conta do usuário atual.

É importante lembrar que os arquivos estão em uma máquina virtual separada do resto do seu recurso. Como também, se desejar chamar alguma função presente no script dele, ela terá de ser exportada, e mais tarde, usando-a chamando o [[call]] na página criada.

==Calls==
É possível definir certas funções a serem chamadas via HTTP. Todos os SDKs (listados abaixo) lhe permitem fazer isso remotamente.

Para fazer isto, é só adicionar a linha abaixo em seu meta.xml:
<syntaxhighlight lang="lua" lang="xml">
<export function='functionName' http='true' />
</syntaxhighlight>

A sua função pode ser escrita normalmente e retornar quantas variáveis for preciso; incluindo tabelas, recursos, e o mais importante: elementos. Em contrapartida, ''não'' é possível retornar qualquer variável do tipo ''userdata'', como ''[[xmlnode|xmlnodes]]'' ou funções.

==Protocolos==
{{Dica|Não é preciso aprender isso, a não ser que você esteja escrevendo seu próprio código de ''HTTP request''. Se desejar, use uma das [[#SDK|SDKs listadas abaixo]].}}

Chamadas são feitas ao se utilizar ''<nowiki>http://<IP>:<porta>/<recurso>/call/<função-exportada></nowiki>' usando ''HTTP POST''. O corpo do comando pode ser uma ''array'' JSON contendo argumentos a serem enviados à função.

A resposta HTTP também será uma ''array'' JSON contendo valor(es) retornados pela função.

O servidor suporta autenticação HTTP básica e você poderá configurar-la via ACL e pelo sistema padrão de contas.

===Chamadas via interface web HTTP===
Chamadas são praticamente a coisa mais fácil a ser feita pela interface web.

Primeiro, adicione esta linha no meta:
<syntaxhighlight lang="lua" lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Segundo, adicione o código a seguir dentro de <head> na página da qual deseja chamar a função:
<syntaxhighlight lang="lua" lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

E a partir de agora, é só digitar um bloco em javascript e chamar as funções quase como se fossem locais. A única diferença é que as chamadas são assíncronas. Não se esqueça de especificar uma função a qual receberá o retorno HTTP no último argumento.

Aí vai um exemplo:

'''meta.xml'''
<syntaxhighlight lang="lua" lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua" lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

É possível ver alguns exemplos um pouco complexos de como se utiliza esse método nos recursos''resourcebrowser'', ''resourcemanager'' e ''webadmin''.

==Garantindo segurança na interface web==
O [[PT-BR/ACL|ACL]] contém um certo número de permissões que podem afetar a maneira como os arquivos são acessados.
{{Componente_ultrapassado|3.0139|1.3.1|
* general.http: Se for desativada, nenhum dos arquivos http poderão ser acessados (excluindo os do cliente)
** '''É importante lembrar''': ''Se essa for ativada, todos os recursos (definidos nesse ACL) ganharão acesso automaticamente. Para desabilitar isso em recursos com funções exportadas, é preciso explicitar o bloqueio.''
** '''É importante lembrar''': ''Se for ativada em um ACL contendo um usuário sem senha (ex: user.*, user.guest ou user.http_guest), é recomendado bloquear o acesso à recursos que contém funções exportadas ao HTTP.''
* resource.'''Nome-do-recurso''': Se for desabilitada, nenhum dos arquivos do recurso poderão ser acessados
* resource.'''Nome-do-recurso'''.file.'''Nome-do-arquivo''': Se for desabilitada, este não poderá ser acessado
* resource.'''Nome-do-recurso'''.function.'''Nome-da-função''': Se for desabilitada, a função não poderá ser chamada

Todos esses acima funciona com outras permissões do ACL; ou seja, é possível desabilita-los para usuários comuns ou só permitir acesso aos administradores. Ou até mesmo a outro grupo de usuários credenciados.
}}
{{Novo_componente|3.0139|1.3.1|
* '''resource.Nome-do-recurso.http''': Se for habilitada, o recurso será acessível a partir do endereço: http://ip_do_servidor:22005/Nome_do_recurso/
Isso funciona para outras permissões do ACL também, ou seja, é possível habilitar-la só a administradores ou um grupo específico.
}}

==SDK==
Há alguns dos tão conhecidos SDKs disponíveis para interagir com o servidor a partir de outras linguagens de programação. Com isso, é possível (em teoria) escrever gamemodes completos. Na prática, é uma má ideia, porém útil para estatísticas e administração. O SDK de PHP é o mais desenvolvido. Sinta-se a vontade de modificar ou criar seu próprio SDK - não se esqueça de nos mandar uma cópia, por favor!

* [[JavaSDK|Java SDK]]
* [[Javascript SDK]]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==Veja mais==
[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
[[Category:Translated/Scripting Concepts]]
[[en:Resource Web Access]]
[[ru:Resource Web Access]]
[[Category:Tutorials]]

Cetegory:Conceitos de Scripting

2015-02-08T21:56:50Z

Cristiano Cardoso:

Esta categoria reúne artigos sobre elementos fundamentais de scripting para o MTA.

Category:Conceitos de Scripting

2015-02-08T21:56:26Z

Cristiano Cardoso: Created page with "Esta categoria reúne artigos sobre elementos fundamentais de scripting para o MTA. Category:Translated/Scripting Concepts de:Category:Skripting Konzepte en:Catego..."

Esta categoria reúne artigos sobre elementos fundamentais de scripting para o MTA.

[[Category:Translated/Scripting Concepts]]

[[de:Category:Skripting Konzepte]]
[[en:Category:Scripting Concepts]]
[[ru:Category:Понятия скриптинга]]

Cetegory:Conceitos de Scripting

2015-02-08T21:53:10Z

Cristiano Cardoso:

Cetegory:Conceitos de Scripting

2015-02-08T21:51:20Z

Cristiano Cardoso: Created PT-BR Scripting Concepts category.

Esta categoria reúne artigos sobre elementos fundamentais de scripting para o MTA.

Scripting Introduction

2015-02-08T21:37:34Z

Cristiano Cardoso: Added a link to event definition on wiki.

Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.

Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else. MTA comes with resources that you can optionally use in your gamemodes, such as maplimits to keep playings within a playing area or deathpickups to create weapon pickups.
{{tip|Your first step to begin Lua scripting should be using an Lua editor. This makes scripting much easier. We recommend [http://www.sublimetext.com/ Sublime Text], [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] or [http://luaedit.sourceforge.net/ LuaEdit]. There is also an unofficial [[MTASE|MTA Script Editor]] (in work-in-progress state) that you can test out.}}

==Creating a working script==
We will first learn how to make a basic script that lets the player walk around in the city, step by step.
===Where are all the scripts?===
Let's take a look at the script's file structure. Go to your MTA Server folder, and follow the path below:

server/mods/deathmatch/resources/

You will see a lot of .zip files, which are the packaged sample scripts shipped with MTA. Each file is a "resource", and they will all be unzipped and loaded by the server when it starts. To create your own resource, simply make a folder with your preferred name. We'll use "myserver" for this tutorial.

Now you should be under this directory:

server/mods/deathmatch/resources/myserver/

===Identifying your resource===
In order to let the server know what's in the resource, a ''meta.xml'' file must be created to list the resource's content. It must be located in the resource's root directory, which is the "myserver" folder in our case. So create a text file and name it "meta.xml", and open it with notepad.

Enter the following codes in the ''meta.xml'' file:
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
In the ''<info />'' tag, there's a "type" field which indicates that the resource is a ''gamemode'' instead of a regular include or a ''map'', which will be explained later. A gamemode is what you need to make a stand-alone server.

The ''<script />'' tag indicates the script files contained in the resource, which we will create next.
===Creating a simple script===
Note that in the ''<script />'' tag above, the .lua file is not under another directory. Therefore we'll create the file in the same folder as meta.xml. Now you can copy and paste the following code into script.lua:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
The script will spawn you at the coordinate (x, y, z) specified above, when you join the game. Note that the ''fadeCamera'' function must be used or the screen will be black. Also, in releases after DP2, you need to set the camera target (otherwise all the player will see is blue sky).

The '''source''' variable indicates who triggered the event. Since a player has joined when the code is triggered, you use this variable to look which has joined. So it'll spawn that player instead of everyone or a random person.

If we have a closer look on [[addEventHandler]], you can see 3 things: 'onPlayerJoin', which indicates when it's triggered. getRootElement(), which shows by what/who it can be triggered. (getRootElement() is everything/everyone) And joinHandler, which indicates the function that has to be triggered after the event is triggered. Other details will be explained later in another example, now let's just run the server and try it out!

===Running the script===
To get the server started, simply run the executable under the server/ directory. A list of server stats will be shown first; note the port number, which you'll need when joining the game. Then the server loads all the resources under the mods/deathmatch/resources/ directory, and then "ready to accept connections!"

Before you connect to the server, you must run the gamemode. Type "start myserver" and press Enter. The server will start the gamemode you just created, and will also show any errors and warnings from this point on. Now you can start the MTA client, and "Quick Connect" using the IP address of your server and the port number you saw earlier. If all goes well, after a few seconds your character will be walking on the streets of Los Santos.

Next we'll add a command to your script that players can use to spawn a vehicle beside their position. You may skip it and check out more advanced scripting with the [[Map manager|Map Manager]], which continues this tutorial. Another branch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA is drawn and scripted.

==Creating a simple command==
Let's go back to the content of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.

<syntaxhighlight lang="lua">
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- create a vehicle and stuff
end

-- create a command handler
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''

====About command handlers====
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.

If you have already experience in scripting, you will know that you call a function like this:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
If we have a closer look on the lower example above, we can see argument1 is thePlayer and argument2 the commandName. thePlayer is simply the one who typed the command, so whatever you call it, the variable will contain the player who activated the command. commandName is simply the command they typed. So if they typed "/greet", this argument will contain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 arguments are standard arguments, but you can name them to anything you want.

We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.

For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:
<syntaxhighlight lang="lua">
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command
</syntaxhighlight>
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).

''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''

====Writing the function====
In order to fill the function we created, we need to think about what we have to do:
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)
* Spawn the vehicle
* Check if it has been spawned successfully, or output a message

In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.

For [[getElementPosition]], the syntax is:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. (x, y and z) Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (local means, the variables only exist in the current scope, in this case, the function)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
end
</syntaxhighlight>

Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.

We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.

Now we have our complete script:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- check if the return value was ''false''
if (createdVehicle == false) then
-- if so, output a message to the chatbox, but only to this player.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself. For more advanced scripting, please check out the [[Map manager|Map Manager]].

==What you need to know==
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.
===Clientside and Serverside scripts===
You may have already noticed these or similiar terms (Server/Client) somewhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.

Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].

===More complex resources===
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.

===Events===
[[Event|Events]] are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].

This example will output a message with the name of the player who died:
<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.

==Where to go from here==
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.
{{note|From here we recommend reading the [[debugging]] tutorial. Good debugging skills are an absolute necessity when you are making scripts. We also recommend you to use the [[predefined variables list]] to help you with certain tasks and make scripting easier and faster.}}
'''See also:'''
* [[Advanced Topics]]
* [[OOP_Introduction|OOP Scripting Introduction]]
* [[Scripting Introduction Urdu]]
[[es:Introducción a la Programación]]
[[it:Introduzione allo scripting]]
[[nl:Scripting_introductie]]
[[pt-br:Introdução ao Scripting]]
[[ru:Scripting Introduction]]
[[ar:مقدمه_في_البرمجه]]
[[zh-cn:脚本编写介绍]]
[[Category:Tutorials]]

PT-BR/Introducão ao GUI scripting

2014-08-11T17:16:45Z

Cristiano Cardoso:

{{Aviso|Este artigo necessita de revisão, pois está '''incompleto'''.|1}}

Um importante recurso do MTA:SA é capacidade de criar uma GUI (Graphical User Interface) personalizada. Uma GUI consiste em janelas, botões, caixas de edição, caixas de verificação e etc. Em outras palavras, todos os componentes presentes em janelas do Windows, por exemplo. Eles podem ser exibidos enquanto o usuário está no jogo, em vez de eles precisarem usar comandos tradicionais.

''Obs: É de extrema importância dar uma olhada na [[PT-BR/Introducao_ao_Scripting|Introdução ao Scripting]] porque muitas perguntas que poderão surgir neste tutorial provavelmente estão relacionados a falta de conceitos básicos de scripting.''

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==Tutorial: Janela de Login==
Neste tutorial, vamos fazer uma janela de login bem simples, com duas caixas de entrada (input boxes) e um botão (button). A janela aparecerá quando o jogador entrar no jogo, e quando o botão de login for clicado, o jogador nasce no mapa. Usarenos o modo de jogo que foi criado no artigo [[PT-BR/Introducao_ao_Scripting|Introdução ao Scripting]]. Se você procedeu com o mesmo e tem o script em mãos, precisará remover ou comentar a linha [[spawnPlayer]] da função ''joinHandler'', pois iremos criar uma jenela para realizar tal ação.

===Criando a janela===
Todo o scripting GUI deverá ser feito no lado do cliente. Também é recomendado colocar esses arquivos em uma pasta separada, em prol de manter uma melhor organização.

Vá até o diretório ../server/mods/deathmatch/resources/, e crie uma pasta chamada "client". Sob o diretório /client/, crie um arquivo de texto com o nome "gui.lua".

Neste arquivo vamos escrever uma função que cria a janela. Para fazer isto, iremos utilizar [[guiCreateWindow]]:
<syntaxhighlight lang="lua">
function criarJanelaDeLogin()
-- definir a posição X e Y
local x = 0.375
local y = 0.375
-- definir a largura e altura
local largura = 0.25
local altura = 0.25
-- criar a janela e defini-la na variável 'janelaLogin'
-- clique no nome da função para ler a sua documentação
janelaLogin = guiCreateWindow(x, y, largura, altura, "Efetue o Login", true)
end
</syntaxhighlight>

===Relativo e Absoluto===
Nota-se que o último argumento colocado em guiCreateWindow é ''true''. Isto indica que as coordenadas e dimensões da janela são '''relativas''', o que significa que é uma ''porcentagem'' do tamanho total da tela. Em outras palavras, se o lado esquerdo da tela é 0, e a extrema-direita é 1. Desta maneira, a posição X valendo 0.5 representaria o ponto central da tela. De forma análoga, se a parte superior da tela é 0 e a inferior é 1, uma posição Y de 0.2 seria 20% do caminho para baixo da tela. Os mesmos princípios se aplicam para largura e altura, exemplo: Se a largura for 0.5, a janela será a metade da largura da tela.

Caso não queira utilizar valores relativos, poderá optar por '''absolutos''' ao colocar ''false'' no argumento. Os valores absolutos são calculados como o número total de pixels do canto superior esquerdo do elemento o qual o componente GUI está subordinado. Se nenhum elemento pai for especificado, este será a própria tela. Neste caso, se tivermos uma resolução de tela de 1920x1200, o lado esquerdo será 0 pixel e o de extrema-direita, será 1920 pixels. Uma posição X de 960 representará o ponto central da tela. Similarmente, se a parte superior da tela é de 0 pixel e o fundo é de 1200, uma posição Y de 20 seria de 20 pixels para baixo a partir da parte superior da tela. Os mesmos princípios se aplicam a largura e altura, exemplo: Caso a largura seja 50, a janela terá os exatos 50 pixels de largura. ''Com um pouco de matemática, e usando a função [[guiGetScreenSize]], você poderá calcular as posições absolutas corretamente.''

As diferenças entre o uso de valores relativos e absolutos é muito simples. Se uma for GUI criada usando valores absolutos, cada unidade valerá um pixel. Enquanto os valores relativos usarão a porcentagem para definir essas posições.

Absoluto é geralmente mais fácil de usar quando a edição do código for feita a mão. Entretanto, a escolha do tipo de medida dependerá da finalidade do componente GUI.

Uma das principais razões de se utilizar valores relativos é para evitar que as janelas fiquem fora da tela ou em posições nada desejáveis. Um GUI que foi feito, por exemplo, na resolução de 1080p e for posicionada no canto superior direito com valores absolutos, ficará fora da tela caso esse script fosse executado em 720p. Oras, porque posicionarei uma janela nas coordenadas (1080, 0) se a tela do sujeito só vai até 720 pixels no eixo x? Simplesmente não vai funcionar.

Neste tutorial, obviamente usaremos valores relativos para a tela de login, e seus componentes, ficarem exatamente onde é preciso.

===Adicionando os componentes===
Vamos adicionar:
* Textos (labels), para mostrar o que é cada campo - usuário, senha
* Caixas de edição (edit boxes), para que o usuário possa inserir seus dados
* Um botão para efetuar o login

Para criar botões você deve usar [[guiCreateButton]], e para criar caixas de edição você deve usar [[guiCreateEdit]]:

'''Note que agora iremos adicionar mais instruções para a função ''criarJanelaDeLogin''. Portanto, esta não é uma nova função, e sim uma substituta da qual você já tem.'''
<syntaxhighlight lang="lua">
function criarJanelaDeLogin()
local x = 0.375
local y = 0.375
local largura = 0.25
local altura = 0.25
wdwLogin = guiCreateWindow(x, y, largura, altura, "Efetue o Login", true)

-- Definir as novas posições x e y para o primeiro label
x = 0.0391
y = 0.1979
-- Definir o novo valor de largura e altura para o primeiro label
largura = 0.3672
altura = 0.25
-- Criar o primeiro label. Note que o último argumento passado é 'wdwLogin', representando a janela
-- Ou seja, ele será o elemento pai (parent) deste texto (label)
-- Assim toda os valores de tamanho serão relativos a esta janela
guiCreateLabel(x, y, largura, altura, "Usuário:", true, wdwLogin)

-- Alterar o valor de y, assim o segundo label ficará ligeiramente abaixo do primeiro
largura = 0.25
y = 0.5
guiCreateLabel(x, y, largura, altura, "Senha:", true, wdwLogin)

-- Valores para as entradas
x = 0.415
y = 0.2
largura = 0.5
altura = 0.15
editUsuario = guiCreateEdit(x, y, largura, altura, "", true, wdwLogin)
Y = 0.5
edtSenha = guiCreateEdit(x, y, largura, altura, "", true, wdwLogin)

-- Definir o tamanho máximo de caracteres do nome de usuário e a senha para 50
guiEditSetMaxLength(editUsuario, 50)
guiEditSetMaxLength(edtSenha, 50)

x = 0.415
y = 0.7
largura = 0.25
altura = 0.2
btnLogin = guiCreateButton(x, y, largura, altura, "Login", true, wdwLogin)

-- Tornar a janela invisível
guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Em nosso script, quando usamos a função para criar cada componente da janela, definimos a variável ''wdwLogin'' no último argumento. Isso significa que esses componentes estão contidos na janela. Em inglês dizemos que ele é um ''child element'' e a janela é um ''parent element''..

Isto é muito útil porque não só significa que todos os componentes estão anexados à janela e irão mover-se com ela. Além disso, todas as alterações realizadas na janela serão aplicadas a todos os elementos subordinados, ou elementos filhos. Para ocultamos a janela, simplesmente usaremos a função:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) -- Isso fará com que todos os elementos subordinado fiquem invisíveis também. O conjunto só será mostrado quando for preciso.
</syntaxhighlight>

[[Category:GUI_Tutorials]]

[[en:Introduction to Scripting the GUI]]
[[es:Introducción a la Programación de GUI]]
[[it:Introduzione_allo_scripting_della_GUI]]
[[ru:Introduction to Scripting the GUI]]

PT-BR/Página Inicial

2014-08-10T19:02:11Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Página Inicial to Página Inicial: Fix the damn title!

#REDIRECT [[Página Inicial]]

Página Inicial

2014-08-10T19:02:10Z

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Página Inicial to Página Inicial: Fix the damn title!

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Bem vindo ao Wiki do Multi Theft Auto.''' Aqui você encontra tudo sobre o uso desta modificação.

Há muitas [[How you can help|coisas em que você pode nos ajudar]] para melhorar este programa, como criar um mapa, um modo de jogo, documentar funções e eventos, escrever códigos úteis para outros usuários, fazer tutoriais, reportar bugs que encontrar ou somente jogar a vontade!

Se você tem alguma dúvida a respeito do Multi Theft Auto, não se esqueça de perguntar à comunidade em nossos [http://forum.mtasa.com/ fóruns].
<br><br>
</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; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div>
<h3>Jogar</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Baixe o Multi Theft Auto {{Current Version|full}}]'''</div>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Onde_adquirir_o_GTASA|Onde adquirir o GTASA]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Cliente|Manual do usuário]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Novidades_na_versão_{{Current Version|full}}|Novidades da última versão ]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de problemas]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Migrando_do_MTA:Race_ao_MTA:SA_1.3|Migrando do MTA:Race para o MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Servidor|Manual do servidor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Recursos:Map_Manager|Gerenciador de mapas (''Map Manager'')]]

<h3>Editor de mapas</h3>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor|Manual do editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-EDF|Ficheiro de definições do editor (EDF)]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-Plugins|Extensões para o editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor#FAQ|Perguntas frequentes (FAQ)]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div>
<h3>Banco de dados</h3>
Aqui tem tudo relacionado às vantagens que Lua tem a oferecer ao MTA e seus recursos.
* [[Image:iUS.png|Em Inglês|20px]] [[:Category:Resource|Catálogo de Recursos]] - Você deve aprender com eles para fazer scripts bons
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Scripts_do_Cliente|Scripts do Cliente]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Módulos|Módulos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div>
<h3>Desenvolvimento do Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Últimas compilações]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA|Compilando o MTASA no Windows]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Mac_OS_X|Compilando o MTASA no Mac OS X]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Linux|Compilando o MTASA no Linux]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Guia_do_Desenvolvedor|Guia do Desenvolvedor]]
* [[File:iUS.png|Em Inglês|20px]] [http://code.google.com/p/mtasa-blue Código fonte no Google Code]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Roadmap|Roteiro para versões futuras]]
* [[File:iUS.png|Em Inglês|20px]] [http://bugs.mtasa.com/ Central de bugs]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</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|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [irc://irc.multitheftauto.com/mta IRC]
* [[File:iUS.png|Em Inglês|20px]] [http://community.mtasa.com/ Comunidade]
* [[File:iUS.png|Em Inglês|20px]] [http://twitter.com/#!/MTAQA/ Twitter]
* [[File:iUS.png|Em Inglês|20px]] [http://www.youtube.com/user/MTAQA Youtube]
* [[File:iUS.png|Em Inglês|20px]] [http://plus.google.com/102014133442331779727/ Google]
* [[File:iUS.png|Em Inglês|20px]] [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</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|link=]]</div>
<h3>Scripting</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introdução_ao_Scripting|Introdução a ''scripting'']]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introducao_ao_GUI_scripting|Introdução a ''scripting'' de UI]]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Depuração|Depuração]] - Encontre erros em seu Script
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Recursos|Introdução a recursos]]
** [[File:iBR.png|Em Português|20px]] [[PT-BR/Acesso web via recursos|Acesso web via recursos]] - Abra servidores web através de recursos
** [[File:iBR.png|Em Português|20px]] [[:Category:PT-BR/Recursos|Lista de recursos]]
** [[File:iBR.png|Em Português|20px]] [[PT-BR/Meta.xml|Meta.xml]] - Todo recurso possui um arquivo meta descrevendo a si próprio
** [[File:iBR.png|Em Português|20px]] [[PT-BR/ACL|Lista de controle de acesso (ACL)]] - Componente vital para recursos complexos
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Composição_de_Gamemodes|Composição de modos de jogo]]
* [[File:iUS.png|Em Inglês|20px]] [[PT-BR/Funções_Úteis|Funções Úteis]]
<h3>Links dos fóruns</h3>
* [[File:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=152 Secção do fórum para dúvidas sobre ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewforum.php?f=148 Guias de ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Wiki ''offline'']
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Manuais sobre Lua</h3>
Página muito útil para ajuda-lo a entender o funcionamento do Lua
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/portugues.html Introdução à linguagem]
* [[File:iUS.png|Em Inglês|20px]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Manual básico]
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/manual/5.1/pt/ Manual de referência]
* [[File:iUS.png|Em Inglês|20px]] [http://lua-users.org/wiki/TutorialDirectory Outra wiki, somente de Lua]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Referência</h3>
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Functions|Funções do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Events|Eventos do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Functions|Funções do servidor]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Events|Eventos do servidor]]

* [[File:iUS.png|Em Inglês|20px]] [[MTA Classes|Classes do Multi Theft Auto]] - Informações detalhadas sobre todas as classes do MTA
** [[File:iUS.png|Em Inglês|20px]] [[Element tree|Árvore dos elementos]]
</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|link=]]</div>
<h3>[[Id|Lista de IDs de objetos e texturas]]</h3>
*[[Animations|Animações]]
*[[Character Skins|''Skins'' de pedestres]]
*[[PT-BR/Roupas_CJ|Roupas do CJ]]
*[[Garage|Garagens]]
*[[Interior IDs|Interiores]]
*[[Material IDs|Materiais]]
*[[Projectiles|Projéteis]]
*[[Radar Blips|''Blips'']]
*[[Sounds|Efeitos sonoros]]
*[[Vehicle IDs|Veículos]]
*[[Vehicle Colors|Cores dos veículos]]
*[[Vehicle Upgrades|Acessórios dos veículos]]
*[[Vehicle variants|Variantes dos veículos]]
*[[Weapons|Armas]]
*[[Weather|Ambientação]]
</div>

<div style="border: 1px dotted #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:pBR.png|32px]]</div>

<h3>Sobre a Tradução</h3>
* Tradutores:
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=50642|<span style="color: blue">RaceXtreme</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=59023|<span style="color: blue">StanleySathler</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=55744|<span style="color: blue">DNL291</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=62091|<span style="color: blue">Ninguem</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=63192|<span style="color:blue">Anderl</span>]

É importante que todos colaborem para que nossa página em português fique melhor a cada dia!

[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' é um projeto '''open source'''. <br>
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Sobre o Multi Theft Auto'''</li>
<li>[[Archive|Arquivos]]</li>
<li>[[Press Coverage|Eventos]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Desenvolvedores]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Baixe-o]]</li>
<li>[[MTA 0.5r2 Known Issues|Solução de problemas]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Status da Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artigos</li>
<li>{{NUMBEROFPAGES}} páginas</li>
<li>{{NUMBEROFUSERS}} usuários registrados</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pt-br}}

Changes in 1.4

2014-08-10T14:35:31Z

Cristiano Cardoso: Added languages

{{Changelogs}}

== Main Additions / Changes ==
* Localization of MTA's menus
* [[OOP]] classes
* [[Matrix|Matrices]] and [[Vector|Vectors]]
* Significantly improved train synchronization
* Improved all sound functions to work with player elements

== Scripting ==

=== Scripting: New functions ===

====Client====
* Added [[createEffect]]
* Added [[setEffectSpeed]]
* Added [[getEffectSpeed]]
* Added [[setEffectDensity]]
* Added [[getEffectDensity]]
* Added [[getLocalization]]
* Added [[isChatVisible]]
* Added [[downloadFile]]
* Added [[isTrainChainEngine]]

==== Server ====
* Added [[isBan]]
* Added [[setBanAdmin]]
* Added [[setBanReason]]
* Added [[setUnbanTime]]
* Added [[getAccountsBySerial]]
* Added [[getAccountSerial]]

==== Shared (''Client & Server side'') ====
* Added [[isElementWaitingForGroundToLoad]]
* Added additional optional parameter bInstant to setPlayerMoney to instantly set the money without counting up/down
* Fixed toJSON/fromJSON not handling binary data properly

=== Scripting: New Events ===

==== Client ====
* Added [[onClientFileDownloadComplete]]

==== Server ====
* Added [[onWeaponFire]]

=== Scripting: Changes, Bugfixes and Additions ===
* Fixed getResourceConfig() not working on foreign resources
* Fixed the Brown Streak Carriage (ID: 570)
* Changed attachTrailerToVehicle to support trains

== Client ==

=== Client: Additions ===
* Distinguish between left and right Shift, Ctrl and Alt presses.
* Added SettingHUDMatchAspectRatio, SettingAspectRatio to dxGetStatus.
* Added support for the use of [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] audio files in playSound and playSound3D.

=== Client: Bugfixes & Changes ===
* Fixed the money "counts down" GTA-Style when you change a server.
* Fixed peds being invulnerable to gun fire when doing a drive by.
* Fixed onClientPlayerDamage not triggering for spray can.
* Satchels should now be removed on [[resetMapInfo]].
* Fixed getPedMoveState returns false when moving in crouch state
* Fixed guiScrollPaneGetVerticalScrollPosition returning strange and stepped values.
* Fixed setPedCameraRotation not working.
* Fixed peds continuing to fire their weapons after running out of ammo.
* Fixed radio titles not always showing.
* Fixed radio music skipping when browsing between different channels.
* Fixed user track skip (F5) being disabled.
* Fixed vehicles falling through the map.

== Server ==

=== Server: Additions ===
* [[setElementDimension]] should now apply to children
* More descriptive module error messages
* Commands: unloadmodule and reloadmodule
* Added server side custom weapons.

=== Server: Bugfixes & Changes ===
* Fixed 128 character limit in [[setAccountData]]
* Wildcard bans should now be checked properly on connect
* Fixed Team members not being sent to clients if set in [[onResourceStart]].

== Resources ==
* None yet

== Editor ==
* None yet

== Extra information ==
''More detailed information available on [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] and Google Code repositories:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[pl:Changes_in_1.4]]
[[pt-br:Novidades_na_versão_1.4.0]]
[[ru:Changes_in_1.4.0]]

[[Category:Changelog]]
[[Category:Incomplete]]

RU/Changes in 1.4.0

2014-08-10T14:34:29Z

Cristiano Cardoso: Added languages

{{Changelogs}}

== Главные дополнения / изменения ==
* Локализация меню МТА
* [[OOP]] классы
* [[Matrix|Матрицы]] и [[Vector|Векторы]]
* Значительно улучшена синхронизация поездов
* Улучшены все звуковые функции для работы с элементами игрока

== Скриптинг ==

=== Скриптинг: Новые функции ===

==== Клиент ====
* Добавлена [[createEffect]]
* Добавлена [[setEffectSpeed]]
* Добавлена [[getEffectSpeed]]
* Добавлена [[setEffectDensity]]
* Добавлена [[getEffectDensity]]
* Добавлена [[getLocalization]]
* Добавлена [[isChatVisible]]
* Добавлена [[downloadFile]]
* Добавлена [[isTrainChainEngine]]

==== Сервер ====
* Добавлена [[isBan]]
* Добавлена [[setBanAdmin]]
* Добавлена [[setBanReason]]
* Добавлена [[setUnbanTime]]
* Добавлена [[getAccountsBySerial]]
* Добавлена [[getAccountSerial]]

==== Общие (''Клиентская и серверная сторона'') ====
* Добавлена [[isElementWaitingForGroundToLoad]]
* Добавлен дополнительный необязательный параметр bInstant к setPlayerMoney,чтобы срочно установить деньги без подсчета вверх/вниз
* Исправлены toJSON/fromJSON не обрабатывали бинарные данные правильно

=== Скриптинг: Новые эвенты ===

==== Клиент ====
* Добавлен [[onClientFileDownloadComplete]]

==== Сервер ====
* Добавлен [[onWeaponFire]]

=== Скриптинг: Изменения, исправления багов и дополнения ===
* Исправлена getResourceConfig() не работает на чужих ресурсах
* Исправлен Brown Streak Carriage (ID: 570)
* Изменена attachTrailerToVehicle для поддержки поездов

== Клиент ==

=== Клиент: Дополнения ===
* Распознавание нажатия между левым и правым Shift, Ctrl и Alt.
* Добавлены SettingHUDMatchAspectRatio, SettingAspectRatio к dxGetStatus.
* Добавлена поддержка для использования [https://ru.wikipedia.org/wiki/Opus_(%D0%BA%D0%BE%D0%B4%D0%B5%D0%BA) Opus] аудио файлов в playSound и playSound3D.

=== Клиент: Исправления багов и изменения ===
* Исправлен денежный "счет вниз" GTA-стиля, когда Вы меняете сервер.
* Исправлены неуязвимые для стрельбы из оружия педы когда выполняется драйв бай.
* Исправлена onClientPlayerDamage не срабатывала для балончика.
* Ранцы должны быть удалены на [[resetMapInfo]].
* Исправлена getPedMoveState возвращает false, когда перемещается в состояние сидя
* Исправлена guiScrollPaneGetVerticalScrollPosition возвращала странные и ступенчатые значения.
* Исправлена setPedCameraRotation не работала.
* Исправлено пед продолжал стрелять после окончания патронов.
* Исправлено не всегда показывало название радио.
* Исправлен пропуск музыки радио при просматривании между различными каналами.
* Исправлены пользовательские дорожки (F5) были отключены.
* Исправлено падение транспорта через карту.

== Сервер ==

=== Сервер: Дополнения ===
* [[setElementDimension]] теперь должен распространяться на потомков
* Более наглядный модуль сообщения об ошибках
* Команды: unloadmodule и reloadmodule
* Добавлено кастомное оружие на серверной стороне.

=== Сервер: Исправления багов и изменения ===
* Исправлен лимит персонажей(128) в [[setAccountData]]
* Конструкция запрета теперь должна быть проверена должным образом при подключении.
* Исправлено члены команды не отправляются клиентам если установлено в [[onResourceStart]].

== Ресурсы ==
* Еще нет

== Редактор ==
* Еще нет

== Дополнительная информация ==
''Более подробную информацию смотрите на [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] и репозиториях Google Code:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[en:Changes_in_1.4.0]]
[[pl:Changes_in_1.4]]
[[pt-br:Novidades_na_versão_1.4.0]]

[[Category:Changelog]]
[[Category:Incomplete]]

PL/Changes in 1.4

2014-08-10T14:33:33Z

Cristiano Cardoso: Added languages

{{PL/Changelogs}}

== Główne dodatki/zmiany ==
* Lokalizacja menu MTA
* Klasy [[OOP]]
* [[Matrix|Matrix]] i [[Vector|Vector'y]]
* Znacznie poprawiono synchronizację pociągu
* Poprawiono wszystkie dźwięki funkcji do pracy z elementami gracza

== Skryptowanie ==

=== Skryptowanie: Nowe funkcje ===

====Klient====
* Dodano [[createEffect]]
* Dodano [[setEffectSpeed]]
* Dodano [[getEffectSpeed]]
* Dodano [[setEffectDensity]]
* Dodano [[getEffectDensity]]
* Dodano [[getLocalization]]
* Dodano [[isChatVisible]]
* Dodano [[downloadFile]]
* Dodano [[isTrainChainEngine]]

==== Serwer ====
* Dodano [[isBan]]
* Dodano [[setBanAdmin]]
* Dodano [[setBanReason]]
* Dodano [[setUnbanTime]]
* Dodano [[getAccountsBySerial]]
* Dodano [[getAccountSerial]]

==== Wspólne (''Klienta i po stronie serwera'') ====
* Dodano dodatkową opcję, parametr bInstant do setPlayerMoney do natychmiastowego ustawiania pieniędzy bez liczenia w górę/dół
* Naprawiono toJSON/fromJSON nie obsługiwało prawidłowo danych binarnych

=== Skryptowanie: Nowe wydarzenia ===

==== Klient ====
* Dodano [[onClientFileDownloadComplete]]

==== Serwer ====
* Dodano [[onWeaponFire]]

=== Skryptowanie: Zmiany, poprawki i uzupełnienia ===
* Naprawiono getResourceConfig() nie działa na zagranicznych zasobach
* Naprawiono the Brown Streak Carriage (ID: 570)
* Zmieniono attachTrailerToVehicle do wspierania pociągów

== Klient ==

=== Klient: Dodatki ===
* Distinguish between left and right Shift, Ctrl and Alt presses.
* Added SettingHUDMatchAspectRatio, SettingAspectRatio to dxGetStatus.
* Added support for the use of [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] audio files in playSound and playSound3D.

=== Klient: Poprawki i zmiany ===
* Fixed the money "counts down" GTA-Style when you change a server.
* Fixed peds being invulnerable to gun fire when doing a drive by.
* Fixed onClientPlayerDamage not triggering for spray can.
* Satchels should now be removed on [[resetMapInfo]].
* Fixed getPedMoveState returns false when moving in crouch state
* Fixed guiScrollPaneGetVerticalScrollPosition returning strange and stepped values.
* Naprawiono setPedCameraRotation nie działało.
* Fixed peds continuing to fire their weapons after running out of ammo.
* Naprawiono tytuły radiów, które nie zawsze się pokazywały
* Fixed radio music skipping when browsing between different channels.
* Fixed user track skip (F5) being disabled.
* Naprawiono pojazdy spadające przez mapę

== Serwer ==

=== Serwer: Dodatki ===
* [[setElementDimension]] powinien teraz mieć zastosowanie do "dzieci"
* Bardziej opisowe komunikaty o błędach modułu
* Komendy: unloadmodule i reloadmodule
* Dodano po stronie serwera niestandardowe bronie.

=== Serwer: Poprawki i zmiany ===
* Naprawiono 128 limit znaków w [[setAccountData]]
* Zakazy powinny być teraz prawidłowo sprawdzane po połączeniu.
* Naprawiono członkowie zespołu nie są wysyłani do klientów, jeśli są w [[onResourceStart]].

== Zasoby ==
* Na razie brak

== Edytor ==
* Na razie brak

== Dodatkowe informacje ==
''Bardziej szczegółowe informacje dostępne na [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] i repozytorium Google Code:
:* [https://code.google.com/p/mtasa-blue/source/list Niebieskie MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Oficjalne zasoby]

[[en:Changes_in_1.4.0]]
[[pt-br:Novidades_na_versão_1.4.0]]
[[ru:Changes_in_1.4.0]]

PT-BR/Novidades na versão 1.4.0

2014-08-10T14:32:17Z

Cristiano Cardoso:

{{PT-BR/Changelogs}}

== Principais Mudanças ==
* Tradução para os menus do MTA
* Classes [[OOP]]
* [[Matrix|Matrizes]] e [[Vector|Vetores]]
* Melhorou muito a sincronização de trens
* As funções relacionadas a áudio agora são compatíveis com os elementos do tipo jogador

== Scripting ==

=== Novas Funções ===

====Cliente====
* [[createEffect]]
* [[setEffectSpeed]]
* [[getEffectSpeed]]
* [[setEffectDensity]]
* [[getEffectDensity]]
* [[getLocalization]]
* [[isChatVisible]]
* [[downloadFile]]
* [[isTrainChainEngine]]

==== Servidor ====
* [[isBan]]
* [[setBanAdmin]]
* [[setBanReason]]
* [[setUnbanTime]]
* [[getAccountsBySerial]]
* [[getAccountSerial]]

==== Compartilhados (Cliente e Servidor) ====
* Adicionado um parâmetro bInstant para setPlayerMoney a fim de definir o montante de dinheiro instantaneamente, sem aparecer a contagem/descontagem no HUD
* toJSON/fromJSON agora lida melhor com dados binários

=== Novos Eventos ===

==== Cliente ====
* [[onClientFileDownloadComplete]]

==== Servidor ====
* [[onWeaponFire]]

=== Mudanças, correções de bugs ===
* getResourceConfig() funciona para recursos adicionados posteriormente a inicialização do servidor
* Consertado o veículo de ID 570
* attachTrailerToVehicle agora suporta trens

== Cliente ==

=== Novidades ===
* Distinção entre Shift, Ctrl e Alt esquerdo/direito
* Adicionados os parâmetros SettingHUDMatchAspectRatio, SettingAspectRatio para [[dxGetStatus]]
* Suporte de arquivos de áudio usando o [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] nas funções playSound e playSound3D

=== Correções de bugs e mudanças ===
* Foram corrigidos as ocasiões:
** O dinheiro é "drenado" no GTA quando se muda de servidor.
** Os pedestres ficam invencíveis a tiros quando estão no banco de passageiro.
** O evento onClientPlayerDamage não ativar para a lata de spray.
** Mochilas não serem removidas com [[resetMapInfo]].
** getPedMoveState retornar falso quando o jogador estiver se movendo agachado
** guiScrollPaneGetVerticalScrollPosition retornar valores estranhos
** setPedCameraRotation não funcionar as vezes.
** Pedestres continuarem atirando depois de sua munição ter acabado.
** Títulos de rádio não aparecerem.
** As músicas da rádio serem puladas quando se estiver passando entre as estações.
** A função para pular uma faixa de áudio (F5) não funcionar.
** Veículos caírem de repente pelo mapa.

== Servidor ==

=== Novidades ===
* [[setElementDimension]] deve agora fazer efeito para elementos subordinados
* Erros de módulo estão mais explicados nas mensagens
* Novos comandos: unloadmodule e reloadmodule
* Adicionadas armas customizadas para o lado do servidor.

=== Correções de bugs e mudanças ===
* Agora não há limite de 128 caracteres para a função [[setAccountData]].
* Jogadores com nomes contendo caracteres especiais são verificados de forma correta ao conectar.
* Corrigidos os membros de times não serem enviados ao cliente se forem definidos pela função [[onResourceStart]].

== Resources ==
* Nada até então

== Editor ==
* Nada até então

== Informações Extras ==
''Informações mais detalhadas estão disponíveis em nosso Changelog do [https://bugs.multitheftauto.com/changelog_page.php Bug tracker] e no Google Code:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[en:Changes_in_1.4.0]]
[[pl:Changes_in_1.4]]
[[ru:Changes_in_1.4.0]]

[[Category:Changelog]]
[[Category:Incomplete]]

PT-BR/Novidades na versão 1.4.0

2014-08-10T14:30:42Z

Cristiano Cardoso: Traduzido!

{{PT-BR/Changelogs}}
{{Atenção|Este artigo necessita de revisão, pois está '''incompleto'''.|1}}

== Principais Mudanças ==
* Tradução para os menus do MTA
* Classes [[OOP]]
* [[Matrix|Matrizes]] e [[Vector|Vetores]]
* Melhorou muito a sincronização de trens
* As funções relacionadas a áudio agora são compatíveis com os elementos do tipo jogador

== Scripting ==

=== Novas Funções ===

====Cliente====
* [[createEffect]]
* [[setEffectSpeed]]
* [[getEffectSpeed]]
* [[setEffectDensity]]
* [[getEffectDensity]]
* [[getLocalization]]
* [[isChatVisible]]
* [[downloadFile]]
* [[isTrainChainEngine]]

==== Servidor ====
* [[isBan]]
* [[setBanAdmin]]
* [[setBanReason]]
* [[setUnbanTime]]
* [[getAccountsBySerial]]
* [[getAccountSerial]]

==== Compartilhados (Cliente e Servidor) ====
* Adicionado um parâmetro bInstant para setPlayerMoney a fim de definir o montante de dinheiro instantaneamente, sem aparecer a contagem/descontagem no HUD
* toJSON/fromJSON agora lida melhor com dados binários

=== Novos Eventos ===

==== Cliente ====
* [[onClientFileDownloadComplete]]

==== Servidor ====
* [[onWeaponFire]]

=== Mudanças, correções de bugs ===
* getResourceConfig() funciona para recursos adicionados posteriormente a inicialização do servidor
* Consertado o veículo de ID 570
* attachTrailerToVehicle agora suporta trens

== Cliente ==

=== Novidades ===
* Distinção entre Shift, Ctrl e Alt esquerdo/direito
* Adicionados os parâmetros SettingHUDMatchAspectRatio, SettingAspectRatio para [[dxGetStatus]]
* Suporte de arquivos de áudio usando o [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] nas funções playSound e playSound3D

=== Correções de bugs e mudanças ===
* Foram corrigidos as ocasiões:
** O dinheiro é "drenado" no GTA quando se muda de servidor.
** Os pedestres ficam invencíveis a tiros quando estão no banco de passageiro.
** O evento onClientPlayerDamage não ativar para a lata de spray.
** Mochilas não serem removidas com [[resetMapInfo]].
** getPedMoveState retornar falso quando o jogador estiver se movendo agachado
** guiScrollPaneGetVerticalScrollPosition retornar valores estranhos
** setPedCameraRotation não funcionar as vezes.
** Pedestres continuarem atirando depois de sua munição ter acabado.
** Títulos de rádio não aparecerem.
** As músicas da rádio serem puladas quando se estiver passando entre as estações.
** A função para pular uma faixa de áudio (F5) não funcionar.
** Veículos caírem de repente pelo mapa.

== Servidor ==

=== Novidades ===
* [[setElementDimension]] deve agora fazer efeito para elementos subordinados
* Erros de módulo estão mais explicados nas mensagens
* Novos comandos: unloadmodule e reloadmodule
* Adicionadas armas customizadas para o lado do servidor.

=== Correções de bugs e mudanças ===
* Agora não há limite de 128 caracteres para a função [[setAccountData]].
* Jogadores com nomes contendo caracteres especiais são verificados de forma correta ao conectar.
* Corrigidos os membros de times não serem enviados ao cliente se forem definidos pela função [[onResourceStart]].

== Resources ==
* Nada até então

== Editor ==
* Nada até então

== Informações Extras ==
''Informações mais detalhadas estão disponíveis em nosso Changelog do [https://bugs.multitheftauto.com/changelog_page.php Bug tracker] e no Google Code:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[en:Changes_in_1.4.0]]
[[Category:Changelog]]
[[Category:Incomplete]]

Scripting Introduction

2014-08-07T14:22:01Z

Cristiano Cardoso: Added OOP entry at "See also".

Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.

Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else. MTA comes with resources that you can optionally use in your gamemodes, such as maplimits to keep playings within a playing area or deathpickups to create weapon pickups.
{{tip|Your first step to begin Lua scripting should be using an Lua editor. This makes scripting much easier. We recommend [http://www.sublimetext.com/ Sublime Text], [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] or [http://luaedit.sourceforge.net/ LuaEdit]. There is also an unofficial [[MTASE|MTA Script Editor]] (in work-in-progress state) that you can test out.}}

==Creating a working script==
We will first learn how to make a basic script that lets the player walk around in the city, step by step.
===Where are all the scripts?===
Let's take a look at the script's file structure. Go to your MTA Server folder, and follow the path below:

server/mods/deathmatch/resources/

You will see a lot of .zip files, which are the packaged sample scripts shipped with MTA. Each file is a "resource", and they will all be unzipped and loaded by the server when it starts. To create your own resource, simply make a folder with your preferred name. We'll use "myserver" for this tutorial.

Now you should be under this directory:

server/mods/deathmatch/resources/myserver/

===Identifying your resource===
In order to let the server know what's in the resource, a ''meta.xml'' file must be created to list the resource's content. It must be located in the resource's root directory, which is the "myserver" folder in our case. So create a text file and name it "meta.xml", and open it with notepad.

Enter the following codes in the ''meta.xml'' file:
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
In the ''<info />'' tag, there's a "type" field which indicates that the resource is a ''gamemode'' instead of a regular include or a ''map'', which will be explained later. A gamemode is what you need to make a stand-alone server.

The ''<script />'' tag indicates the script files contained in the resource, which we will create next.
===Creating a simple script===
Note that in the ''<script />'' tag above, the .lua file is not under another directory. Therefore we'll create the file in the same folder as meta.xml. Now you can copy and paste the following code into script.lua:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
The script will spawn you at the coordinate (x, y, z) specified above, when you join the game. Note that the ''fadeCamera'' function must be used or the screen will be black. Also, in releases after DP2, you need to set the camera target (otherwise all the player will see is blue sky).

The '''source''' variable indicates who triggered the event. Since a player has joined when the code is triggered, you use this variable to look which has joined. So it'll spawn that player instead of everyone or a random person.

If we have a closer look on [[addEventHandler]], you can see 3 things: 'onPlayerJoin', which indicates when it's triggered. getRootElement(), which shows by what/who it can be triggered. (getRootElement() is everything/everyone) And joinHandler, which indicates the function that has to be triggered after the event is triggered. Other details will be explained later in another example, now let's just run the server and try it out!

===Running the script===
To get the server started, simply run the executable under the server/ directory. A list of server stats will be shown first; note the port number, which you'll need when joining the game. Then the server loads all the resources under the mods/deathmatch/resources/ directory, and then "ready to accept connections!"

Before you connect to the server, you must run the gamemode. Type "start myserver" and press Enter. The server will start the gamemode you just created, and will also show any errors and warnings from this point on. Now you can start the MTA client, and "Quick Connect" using the IP address of your server and the port number you saw earlier. If all goes well, after a few seconds your character will be walking on the streets of Los Santos.

Next we'll add a command to your script that players can use to spawn a vehicle beside their position. You may skip it and check out more advanced scripting with the [[Map manager|Map Manager]], which continues this tutorial. Another branch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA is drawn and scripted.

==Creating a simple command==
Let's go back to the content of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.

<syntaxhighlight lang="lua">
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- create a vehicle and stuff
end

-- create a command handler
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''

====About command handlers====
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.

If you have already experience in scripting, you will know that you call a function like this:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
If we have a closer look on the lower example above, we can see argument1 is thePlayer and argument2 the commandName. thePlayer is simply the one who typed the command, so whatever you call it, the variable will contain the player who activated the command. commandName is simply the command they typed. So if they typed "/greet", this argument will contain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 arguments are standard arguments, but you can name them to anything you want.

We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.

For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:
<syntaxhighlight lang="lua">
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command
</syntaxhighlight>
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).

''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''

====Writing the function====
In order to fill the function we created, we need to think about what we have to do:
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)
* Spawn the vehicle
* Check if it has been spawned successfully, or output a message

In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.

For [[getElementPosition]], the syntax is:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. (x, y and z) Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (local means, the variables only exist in the current scope, in this case, the function)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
end
</syntaxhighlight>

Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.

We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.

Now we have our complete script:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- check if the return value was ''false''
if (createdVehicle == false) then
-- if so, output a message to the chatbox, but only to this player.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself. For more advanced scripting, please check out the [[Map manager|Map Manager]].

==What you need to know==
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.
===Clientside and Serverside scripts===
You may have already noticed these or similiar terms (Server/Client) somewhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.

Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].

===More complex resources===
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.

===Events===
Events are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].

This example will output a message with the name of the player who died:
<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.

==Where to go from here==
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.
{{note|From here we recommend reading the [[debugging]] tutorial. Good debugging skills are an absolute necessity when you are making scripts. We also recommend you to use the [[predefined variables list]] to help you with certain tasks and make scripting easier and faster.}}
'''See also:'''
* [[Advanced Topics]]
* [[OOP_Introduction|OOP Scripting Introduction]]
[[es:Introducción a la Programación]]
[[it:Introduzione allo scripting]]
[[nl:Scripting_introductie]]
[[pt-br:Introdução ao Scripting]]
[[ru:Scripting Introduction]]
[[ar:مقدمه_في_البرمجه]]
[[zh-cn:脚本编写介绍]]
[[Category:Tutorials]]

Template:PT-BR/Changelogs

2014-08-06T15:07:53Z

Cristiano Cardoso: Added 1.4.0 entry

PT-BR/Novidades na versão 1.4.0

2014-08-06T15:06:39Z

Cristiano Cardoso:

{{PT-BR/Changelogs}}
{{Atenção|Este artigo necessita de revisão, pois está '''incompleto'''.|1}}

== Principais Mudanças ==
* Tradução para os menus do MTA
* Classes [[OOP]]
* [[Matrix|Matrizes]] e [[Vector|Vetores]]
* Melhorou muito a sincronização de trens
* As funções relacionadas a áudio agora são compatíveis com os elementos do tipo jogador

[[en:Changes_in_1.4.0]]
<!--
== Scripting ==

=== Scripting: New functions ===

====Client====
* Added [[createEffect]]
* Added [[setEffectSpeed]]
* Added [[getEffectSpeed]]
* Added [[setEffectDensity]]
* Added [[getEffectDensity]]
* Added [[getLocalization]]
* Added [[isChatVisible]]
* Added [[downloadFile]]
* Added [[isTrainChainEngine]]

==== Server ====
* Added [[isBan]]
* Added [[setBanAdmin]]
* Added [[setBanReason]]
* Added [[setUnbanTime]]
* Added [[getAccountsBySerial]]
* Added [[getAccountSerial]]

==== Shared (''Client & Server side'') ====
* Added additional optional parameter bInstant to setPlayerMoney to instantly set the money without counting up/down
* Fixed toJSON/fromJSON not handling binary data properly

=== Scripting: New Events ===

==== Client ====
* Added [[onClientFileDownloadComplete]]

==== Server ====
* Added [[onWeaponFire]]

=== Scripting: Changes, Bugfixes and Additions ===
* Fixed getResourceConfig() not working on foreign resources
* Fixed the Brown Streak Carriage (ID: 570)
* Changed attachTrailerToVehicle to support trains

== Client ==

=== Client: Additions ===
* Distinguish between left and right Shift, Ctrl and Alt presses.
* Added SettingHUDMatchAspectRatio, SettingAspectRatio to dxGetStatus.
* Added support for the use of [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] audio files in playSound and playSound3D.

=== Client: Bugfixes & Changes ===
* Fixed the money "counts down" GTA-Style when you change a server.
* Fixed peds being invulnerable to gun fire when doing a drive by.
* Fixed onClientPlayerDamage not triggering for spray can.
* Satchels should now be removed on [[resetMapInfo]].
* Fixed getPedMoveState returns false when moving in crouch state
* Fixed guiScrollPaneGetVerticalScrollPosition returning strange and stepped values.
* Fixed setPedCameraRotation not working.
* Fixed peds continuing to fire their weapons after running out of ammo.
* Fixed radio titles not always showing.
* Fixed radio music skipping when browsing between different channels.
* Fixed user track skip (F5) being disabled.
* Fixed vehicles falling through the map.

== Server ==

=== Server: Additions ===
* [[setElementDimension]] should now apply to children
* More descriptive module error messages
* Commands: unloadmodule and reloadmodule
* Added server side custom weapons.

=== Server: Bugfixes & Changes ===
* Fixed 128 character limit in [[setAccountData]]
* Wildcard bans should now be checked properly on connect
* Fixed Team members not being sent to clients if set in [[onResourceStart]].

== Resources ==
* None yet

== Editor ==
* None yet

== Extra information ==
''More detailed information available on [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] and Google Code repositories:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[Category:Changelog]]
[[Category:Incomplete]]

PT-BR/Novidades na versão 1.4.0

2014-08-06T15:05:09Z

Cristiano Cardoso: Created page with "{{PT-BR/Changelogs}} {{Atenção|Este artigo necessita de revisão, pois está '''incompleto'''.|1}} == Principais Mudanças == * Tradução para os menus do MTA * Classes ..."

{{PT-BR/Changelogs}}
{{Atenção|Este artigo necessita de revisão, pois está '''incompleto'''.|1}}

== Principais Mudanças ==
* Tradução para os menus do MTA
* Classes [[OOP]]
* [[Matrix|Matrizes]] e [[Vector|Vetores]]
* Melhorou muito a sincronização de trens
* As funções relacionadas a áudio agora são compatíveis com os elementos do tipo jogador
<!--
== Scripting ==

=== Scripting: New functions ===

====Client====
* Added [[createEffect]]
* Added [[setEffectSpeed]]
* Added [[getEffectSpeed]]
* Added [[setEffectDensity]]
* Added [[getEffectDensity]]
* Added [[getLocalization]]
* Added [[isChatVisible]]
* Added [[downloadFile]]
* Added [[isTrainChainEngine]]

==== Server ====
* Added [[isBan]]
* Added [[setBanAdmin]]
* Added [[setBanReason]]
* Added [[setUnbanTime]]
* Added [[getAccountsBySerial]]
* Added [[getAccountSerial]]

==== Shared (''Client & Server side'') ====
* Added additional optional parameter bInstant to setPlayerMoney to instantly set the money without counting up/down
* Fixed toJSON/fromJSON not handling binary data properly

=== Scripting: New Events ===

==== Client ====
* Added [[onClientFileDownloadComplete]]

==== Server ====
* Added [[onWeaponFire]]

=== Scripting: Changes, Bugfixes and Additions ===
* Fixed getResourceConfig() not working on foreign resources
* Fixed the Brown Streak Carriage (ID: 570)
* Changed attachTrailerToVehicle to support trains

== Client ==

=== Client: Additions ===
* Distinguish between left and right Shift, Ctrl and Alt presses.
* Added SettingHUDMatchAspectRatio, SettingAspectRatio to dxGetStatus.
* Added support for the use of [https://en.wikipedia.org/wiki/Opus_codec Opus Codec] audio files in playSound and playSound3D.

=== Client: Bugfixes & Changes ===
* Fixed the money "counts down" GTA-Style when you change a server.
* Fixed peds being invulnerable to gun fire when doing a drive by.
* Fixed onClientPlayerDamage not triggering for spray can.
* Satchels should now be removed on [[resetMapInfo]].
* Fixed getPedMoveState returns false when moving in crouch state
* Fixed guiScrollPaneGetVerticalScrollPosition returning strange and stepped values.
* Fixed setPedCameraRotation not working.
* Fixed peds continuing to fire their weapons after running out of ammo.
* Fixed radio titles not always showing.
* Fixed radio music skipping when browsing between different channels.
* Fixed user track skip (F5) being disabled.
* Fixed vehicles falling through the map.

== Server ==

=== Server: Additions ===
* [[setElementDimension]] should now apply to children
* More descriptive module error messages
* Commands: unloadmodule and reloadmodule
* Added server side custom weapons.

=== Server: Bugfixes & Changes ===
* Fixed 128 character limit in [[setAccountData]]
* Wildcard bans should now be checked properly on connect
* Fixed Team members not being sent to clients if set in [[onResourceStart]].

== Resources ==
* None yet

== Editor ==
* None yet

== Extra information ==
''More detailed information available on [https://bugs.multitheftauto.com/changelog_page.php Bug tracker Changelog] and Google Code repositories:
:* [https://code.google.com/p/mtasa-blue/source/list MTA: SA Blue]
:* [https://code.google.com/p/mtasa-resources/source/list MTA: SA Official Resources]

[[Category:Changelog]]
[[Category:Incomplete]]

Página Inicial

2014-08-06T14:59:19Z

Cristiano Cardoso:

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Bem vindo ao Wiki do Multi Theft Auto.''' Aqui você encontra tudo sobre o uso desta modificação.

Há muitas [[How you can help|coisas em que você pode nos ajudar]] para melhorar este programa, como criar um mapa, um modo de jogo, documentar funções e eventos, escrever códigos úteis para outros usuários, fazer tutoriais, reportar bugs que encontrar ou somente jogar a vontade!

Se você tem alguma dúvida a respeito do Multi Theft Auto, não se esqueça de perguntar à comunidade em nossos [http://forum.mtasa.com/ fóruns].
<br><br>
</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; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div>
<h3>Jogar</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Baixe o Multi Theft Auto {{Current Version|full}}]'''</div>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Onde_adquirir_o_GTASA|Onde adquirir o GTASA]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Cliente|Manual do usuário]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Novidades_na_versão_{{Current Version|full}}|Novidades da última versão ]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de problemas]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Migrando_do_MTA:Race_ao_MTA:SA_1.3|Migrando do MTA:Race para o MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Manual_do_Servidor|Manual do servidor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Recursos:Map_Manager|Gerenciador de mapas (''Map Manager'')]]

<h3>Editor de mapas</h3>
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor|Manual do editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-EDF|Ficheiro de definições do editor (EDF)]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor-Plugins|Extensões para o editor]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Resource:Editor#FAQ|Perguntas frequentes (FAQ)]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div>
<h3>Banco de dados</h3>
Aqui tem tudo relacionado às vantagens que Lua tem a oferecer ao MTA e seus recursos.
* [[Image:iUS.png|Em Inglês|20px]] [[:Category:Resource|Catálogo de Recursos]] - Você deve aprender com eles para fazer scripts bons
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Scripts_do_Cliente|Scripts do Cliente]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Módulos|Módulos]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div>
<h3>Desenvolvimento do Multi Theft Auto</h3>
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Últimas compilações]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA|Compilando o MTASA no Windows]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Mac_OS_X|Compilando o MTASA no Mac OS X]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Compilando_o_MTASA_no_Linux|Compilando o MTASA no Linux]]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Guia_do_Desenvolvedor|Guia do Desenvolvedor]]
* [[File:iUS.png|Em Inglês|20px]] [http://code.google.com/p/mtasa-blue Código fonte no Google Code]
* [[Image:iBR.png|Em Português|20px]] [[PT-BR/Roadmap|Roteiro para versões futuras]]
* [[File:iUS.png|Em Inglês|20px]] [http://bugs.mtasa.com/ Central de bugs]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</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|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [irc://irc.multitheftauto.com/mta IRC]
* [[File:iUS.png|Em Inglês|20px]] [http://community.mtasa.com/ Comunidade]
* [[File:iUS.png|Em Inglês|20px]] [http://twitter.com/#!/MTAQA/ Twitter]
* [[File:iUS.png|Em Inglês|20px]] [http://www.youtube.com/user/MTAQA Youtube]
* [[File:iUS.png|Em Inglês|20px]] [http://plus.google.com/102014133442331779727/ Google]
* [[File:iUS.png|Em Inglês|20px]] [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</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|link=]]</div>
<h3>Scripting</h3>
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introdução_ao_Scripting|Introdução a ''scripting'']]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Introducao_ao_GUI_scripting|Introdução a ''scripting'' de UI]]
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Depuração|Depuração]] - Encontre erros em seu Script
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Recursos|Introdução a recursos]]
** [[File:iBR.png|Em Português|20px]] [[PT-BR/Acesso web via recursos|Acesso web via recursos]] - Abra servidores web através de recursos
** [[File:iBR.png|Em Português|20px]] [[:Category:PT-BR/Recursos|Lista de recursos]]
** [[File:iBR.png|Em Português|20px]] [[PT-BR/Meta.xml|Meta.xml]] - Todo recurso possui um arquivo meta descrevendo a si próprio
** [[File:iBR.png|Em Português|20px]] [[PT-BR/ACL|Lista de controle de acesso (ACL)]] - Componente vital para recursos complexos
* [[File:iBR.png|Em Português|20px]] [[PT-BR/Composição_de_Gamemodes|Composição de modos de jogo]]
* [[File:iUS.png|Em Inglês|20px]] [[PT-BR/Funções_Úteis|Funções Úteis]]
<h3>Links dos fóruns</h3>
* [[File:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=152 Secção do fórum para dúvidas sobre ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewforum.php?f=148 Guias de ''scripting'']
* [[File:iUS.png|Em Inglês|20px]] [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Wiki ''offline'']
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Manuais sobre Lua</h3>
Página muito útil para ajuda-lo a entender o funcionamento do Lua
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/portugues.html Introdução à linguagem]
* [[File:iUS.png|Em Inglês|20px]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Manual básico]
* [[Image:iBR.png|Em Português|20px]] [http://www.lua.org/manual/5.1/pt/ Manual de referência]
* [[File:iUS.png|Em Inglês|20px]] [http://lua-users.org/wiki/TutorialDirectory Outra wiki, somente de Lua]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Referência</h3>
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Functions|Funções do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Client Scripting Events|Eventos do cliente]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Functions|Funções do servidor]]
* [[File:iUS.png|Em Inglês|20px]] [[Server Scripting Events|Eventos do servidor]]

* [[File:iUS.png|Em Inglês|20px]] [[MTA Classes|Classes do Multi Theft Auto]] - Informações detalhadas sobre todas as classes do MTA
** [[File:iUS.png|Em Inglês|20px]] [[Element tree|Árvore dos elementos]]
</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|link=]]</div>
<h3>[[Id|Lista de IDs de objetos e texturas]]</h3>
*[[Animations|Animações]]
*[[Character Skins|''Skins'' de pedestres]]
*[[PT-BR/Roupas_CJ|Roupas do CJ]]
*[[Garage|Garagens]]
*[[Interior IDs|Interiores]]
*[[Material IDs|Materiais]]
*[[Projectiles|Projéteis]]
*[[Radar Blips|''Blips'']]
*[[Sounds|Efeitos sonoros]]
*[[Vehicle IDs|Veículos]]
*[[Vehicle Colors|Cores dos veículos]]
*[[Vehicle Upgrades|Acessórios dos veículos]]
*[[Vehicle variants|Variantes dos veículos]]
*[[Weapons|Armas]]
*[[Weather|Ambientação]]
</div>

<div style="border: 1px dotted #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:pBR.png|32px]]</div>

<h3>Sobre a Tradução</h3>
* Tradutores:
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=50642|<span style="color: blue">RaceXtreme</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=59023|<span style="color: blue">StanleySathler</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=55744|<span style="color: blue">DNL291</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=62091|<span style="color: blue">Ninguem</span>]
** [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=63192|<span style="color:blue">Anderl</span>]

É importante que todos colaborem para que nossa página em português fique melhor a cada dia!

[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' é um projeto '''open source'''. <br>
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Sobre o Multi Theft Auto'''</li>
<li>[[Archive|Arquivos]]</li>
<li>[[Press Coverage|Eventos]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Desenvolvedores]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Baixe-o]]</li>
<li>[[MTA 0.5r2 Known Issues|Solução de problemas]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Status da Wiki'''</li>
<li>{{NUMBEROFARTICLES}} artigos</li>
<li>{{NUMBEROFPAGES}} páginas</li>
<li>{{NUMBEROFUSERS}} usuários registrados</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|pt-br}}