Multi Theft Auto: Wiki - User contributions [en]

PT-BR/Crashs famosos e seu significado

2022-02-17T14:43:55Z

Vampire: Typo

<big>Esta página da wiki contém o motivo de muitos crashs conhecidas do MTA que podem acontecer com você. Use CTRL + F e procure pelo Offset do seu crash para encontrar alguma informação relevante.</big>

Exemplo de uma mensagem de crash:
<syntaxhighlight lang="xml">
Version = 1.5.6-release-14664.0.000
Time = Mon Oct 8 12:20:00 2018
Module = C:\Program Files (x86)\Rockstar Games\GTA San Andreas\gta_sa.exe
Code = 0xC0000005
Offset = 0x003C91CC

EAX=0F77A3C8 EBX=0F77A3B8 ECX=0177FAA0 EDX=00139700 ESI=00000000
EDI=00000001 EBP=0177FC50 ESP=0177FA80 EIP=007C91CC FLG=00210202
CS=0023 DS=002B SS=002B ES=002B FS=0053 GS=002B
</syntaxhighlight>

(Nota: sempre use o "Offset" do seu crash para procurar nesta página da wiki)

'''A maioria dos crashs do MTA são causadas por algo que o usuário é capaz de resolver porque depende do seu sistema, escolha de servidor ou mods do jogo. '''
Esta página procura ser útil pelo motivo acima mencionado; você saberá onde procurar quando tiver um certo tipo de crash.

Para obter mais conselhos sobre como resolver problemas, role até o final desta página.

<br/>
==Módulo = gta_sa.exe ou proxy_sa.exe==
{| class="wikitable"
|-
!Offset(s)
!Significado
|-
|<syntaxhighlight lang="lua">0x00134134</syntaxhighlight>
|Modelo ruim ou GTA3.img corrompido. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Nota para proprietários de servidores e modeladores: se você abrir o crash dump (.dmp) como texto com o bloco de notas e procurar a palavra-chave `CEntity_GetBoundRect - No collision for model` você pode identificar o ID do modelo ruim.
|-
|<syntaxhighlight lang="lua">0x00348CF4</syntaxhighlight>
|Causado por s0beit d3d9.dll
|-
|<syntaxhighlight lang="lua">
0x003F0C37
0x003F0BF7
</syntaxhighlight>
|Modelo de veículo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
|-
|<syntaxhighlight lang="lua">
0x003C91CC
0x003C920C
</syntaxhighlight>
|Falta de memória de vídeo. Isso pode acontecer em servidores com mods não otimizados e scripts (defeituosos) que abusam da memória de vídeo, ou mesmo quando você tem uma placa de vídeo poderosa, caso as coisas em um servidor sejam extremamente não otimizadas fazendo com que ele comece a atingir os limites do GTA. Se você tiver uma placa de vídeo poderosa e mais jogadores sofrerem com esse tipo de crash, informe o proprietário do servidor sobre esse problema, pois provavelmente significa que seus scripters & designers não sabem o que estão fazendo. Mais informações estão disponíveis nestes links do fórum: [https://forum.mtasa.com/topic/85094-mta-crashing/ aqui] e [https://forum.mtasa.com/topic/127677-c-r-a-s-h-i-n-g/ aqui (caso de exemplo)]
|-
|-
|<syntaxhighlight lang="lua">0x00357DEC</syntaxhighlight>
|Sem memória de vídeo (provavelmente).
|-
|<syntaxhighlight lang="lua">0x003F5A3A</syntaxhighlight>
|Crash de memória, geralmente acontece em servidores altamente não otimizados. Pode ser resultado de falta de memória de vídeo ou o atingimento de limites técnicos de uso de RAM, mas mais frequentemente uma combinação de ambos. Entre em contato com o dono do servidor e peça uma otimização, ou encontre outros servidores para jogar.
|-
|-
|<syntaxhighlight lang="lua">0x004A1ED4</syntaxhighlight>
|Sem memória do sistema (RAM)
|-
|-
|-
|<syntaxhighlight lang="lua">
0x011630F8
0x011630FE
0x01162FE3
0x011630F2
</syntaxhighlight>
|Este crash é resultado de problemas com a colisão de modelos. Pode ser devido a colisões não otimizadas que seu PC (ou limites técnicos do MTA, devido a mods ruins de servidores) não consegue lidar, ou devido a colisão de modelos corrompidas. Ainda não sabemos muito sobre todas as circunstâncias relacionadas a esse crash. Nosso primeiro conselho seria garantir que seu GTA não seja modificado e, caso contrário, pedir ao proprietário do servidor para identificar e resolver os problemas com colisão de modelos ruins/não otimizados.
|-
|<syntaxhighlight lang="lua">0x00137D6E</syntaxhighlight>
|Sem memória do sistema (RAM). Isso coincide com o carregamento de colisões; o risco de obter esse travamento é alto ao entrar em um servidor com muitos mods com um PC fraco e uma quantidade pequena de memória.
Para resolver esse crash, cuidado com os servidores em que você está jogando (em relação a otimização) ou obtenha um PC mais rápido. Subtipo de "Ficando sem memória (Running out of memory)": na maioria das vezes, um resultado direto da falta de espaço de endereço, portanto, atualizar para o Windows 64 bits pode resolvê-lo
|-
|<syntaxhighlight lang="lua">0x0014F406</syntaxhighlight>
|Possivelmente "Ficando sem memória (Running out of memory)": um resultado direto da falta de espaço de endereço, portanto, atualizar para o Windows 64 bits pode resolvê-lo.
|-
|<syntaxhighlight lang="lua">0x00171A10</syntaxhighlight>
|Às vezes, ao entrar em um servidor, talvez esteja relacionado a mods ruins do servidor.
|-
|-
|<syntaxhighlight lang="lua">0x000C9F98</syntaxhighlight>
|Possivelmente modelo ou textura de skin ruim (mods de roupas para diversas skins, como o CJ).
Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e desativar mods em tais skins, ou qualquer recurso que manipule roupas ou acessórios de pedestres.
|-
|-
|<syntaxhighlight lang="lua">0x00349B7B</syntaxhighlight>
|Modelo de skin ruim. Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod de skin corrompido
Informações para modeladores e proprietários de servidores: corrupção na hierarquia da animação no DFF da skin do pedestres ou na configuração dos ossos
|-
|-
|<syntaxhighlight lang="lua">0x00165096</syntaxhighlight>
|Modelo ruim (contendo uma colisão de modelo corrompido). Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Informações para modeladores e proprietários de servidores: corrupção em uma ou várias esferas de colisão (ou seu raio) dentro do modelo DFF.
|-
|<syntaxhighlight lang="lua">0x001D6E6A</syntaxhighlight>
|Ou falta de memória de vídeo ou modelo/textura ruim.
Informações para modeladores e proprietários de servidores: caso a culpa seja de um modelo, a corrupção está na estrutura "prelit" (Cores noturnas) do modelo. Peça ao seu modelador para recriar o prelit.
|-
|-
|<syntaxhighlight lang="lua">
0x000DFE92
0x000DFF90
</syntaxhighlight>
|Mods de som ruins ou driver/dispositivo de áudio com defeito. Instale o GTA sem modificações para verificar ou atualize seus drivers de áudio.
O problema geralmente é conhecido por arquivos de áudio totalmente ausentes ou esvaziados/corrompidos (como em \Rockstar Games\GTA San Andreas\audio > SFX ou outra subpasta), então você pode, alternativamente, restaurar um backup.

Não use re-packs 'comprimidos' do GTA, estes tendem a ter arquivos de áudio recortados.
|-
|-
|-
|<syntaxhighlight lang="lua">0x000CFCD6</syntaxhighlight>
|Falha de alocação como resultado da (re)conexão com servidores após uma longa sessão de jogo em um servidor com más práticas em seus scripts (abusando de RAM e funções de animação).
Este crash pode ser 'corrigido' (evitado) pelo MTA no futuro, estamos trabalhando nisso! Está relacionado a animações na memória e limpeza delas.
|-
|-
|<syntaxhighlight lang="lua">
0x00771848
</syntaxhighlight>
|Crash devido a problemas com arquivos de dados do GTA (o MTA não consegue abri-los, o que pode significar que eles estão corrompidos/modificados e incompatíveis ou ausentes)
Instale o GTA sem modificações para verificar
|-
|<syntaxhighlight lang="lua">
0x001B6B2F
</syntaxhighlight>
|Crash devido a um problema com o arquivo DATA\DEFAULT.DAT ou DATA\CARCOLS.DAT na pasta de instalação do GTA (pode estar ausente ou modificado/corrompido).
Instale o GTA sem modificações para verificar
|-
|<syntaxhighlight lang="lua">
0x003EC9DA
</syntaxhighlight>
|Crash possivelmente devido a um problema com o arquivo ANIM\PED.IFP na pasta de instalação do GTA (pode estar ausente ou modificado/corrompido).
Instale o GTA sem modificações para verificar
|-
|-
|-
|<syntaxhighlight lang="lua">
0x003F18CF
0x003F190F
</syntaxhighlight>
|Modelo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Esse crash foi evitado (corrigido pelo MTA), mas devido a limitações técnicas ainda ocorrerá para usuários do Windows XP.
Informações para modeladores e proprietários de servidores: devido à natureza da corrupção, o modelo apresenta um risco de crash, que pode acontecer a qualquer momento quando próximo dele.
|-
|<syntaxhighlight lang="lua">
0x0019BD39
</syntaxhighlight>
|Modelo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Esse crash geralmente ocorre quando você dispara uma arma enquanto o modelo corrompido é transmitido (fisicamente próximo).
|-
|<syntaxhighlight lang="lua">
0x000C9691
</syntaxhighlight>
|Modelo de veículo ruim ou ausente. Isso geralmente acontece quando você exclui um modelo do seu GTA3.img sem restaurar o original ou colocar outro modelo em seu lugar. Ou quando o DFF não é um arquivo de modelo válido.
Restaure o GTA3.img ou instale o GTA sem modificações para verificar e, se isso não funcionar, peça ao proprietário do servidor para identificar e substituir o mod corrompido, pois também pode ser um modelo ruim (ou um script desonesto, diga-lhes isto: lida com tipos de veículos, variantes, upgrades etc, de maneira imprópria)
|-
|<syntaxhighlight lang="lua">
0x0000F67C
0x0000F663
</syntaxhighlight>
|Modelos personalizados que não funcionam com sombras volumétricas. Corrija os modelos ou desative as sombras volumétricas em Configurações->Vídeo.
|-
|<syntaxhighlight lang="lua">0x00423FD0</syntaxhighlight>
|Mods ruins para o GTA ou GTA3.img corrompido. Reinstale o GTA (com uma versão limpa e original) para resolver este crash. Observação: crash conhecido em cópias e torrents piratas do GTA, devido a arquivos .dat, .col e .ipl ausentes, ruins ou corrompidos (mods pré-instalados). O MTA suporta apenas a versão original do GTA comprada legalmente.
|-
|<syntaxhighlight lang="lua">0x000A2CF3</syntaxhighlight>
|Arquivo '''effects.fxp''' na pasta GTA San Andreas\models corrompido, ausente ou modificado. Se restaurar esse arquivo para o original não corrigir o crash, use o GTA não modificado, pois também pode ser relacionado devido a arquivos de dados do GTA (aqueles que têm a ver com efeitos).
|-
|<syntaxhighlight lang="lua">
0x001A49D4
</syntaxhighlight>
|Mod ruim (player.img personalizado no GTA San Andreas\models). Restaure o player.img para o original ou use o GTA não modificado.
Observação: este crash também pode ser acionado quando um jogador com modelo do CJ (ou roupas do CJ) aparecem na sua tela, em um servidor em que você está jogando. O seu player.img personalizado não pode lidar com isso e causará um crash.
|}

==Resolvendo crashs de falta de memória==
Se você estiver enfrentando crashs que, de acordo com a tabela de falhas comuns, estão relacionadas a qualquer tipo de falta de memória, recomendamos que você faça isso;

- Lembre-se do tipo de servidor em que você está jogando, especialmente em combinação com a potência do seu PC. Existem muitos servidores sobrecarregados e cheios de mods por aí no MTA que exigem o melhor do seu PC e também podem abusar da memória por meio de scripts ineficientes além de mods personalizados (ou mesmo com a falta deles).

Poderíamos escrever um livro sobre a causa real (que esses servidores têm scripters ruins, ou aqueles que não sabem o que é otimização, e que adicionam tudo, enchendo de modelos e texturas, sem revisá-lo), mas não vamos não fazer isso aqui.

Se você tiver um PC lento ou de geração mais antiga, recomendamos que você evite certos servidores "extravagantes" com grandes downloads e tal.

- Instale a versão de 64 bits do Windows em vez da x86 (32 bits)

'''Se você ainda quiser jogar em servidores que podem facilmente obter vantagem do seu sistema, então;'''

- Atualize o hardware do seu PC para desempenho aprimorado; considere substituir a placa de vídeo por uma adequada para jogos ou adicionar memória de sistema adicional (RAM). A reinstalação do Windows às vezes também pode ajudar bastante se o seu sistema operacional em geral for lento e não estiver bem mantido. Como alternativa, faça alguma manutenção (consulte alguém com experiência ou comece atualizando os drivers e executando vários limpadores de lixo e ferramentas de otimização de desempenho de renome)

- Sigas as instruções listadas em [https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/ https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/]

Remova todos os mods da sua instalação do GTA (de preferência reinstale) porque os mods podem ocupar memória de vídeo e RAM, o suficiente para causar alto uso de memória e crashs subsequentes.
Além disso, você deve definitivamente tentar diminuir a memória de streaming, indo em Opções-> Avançado-> Memória para streaming-> e definindo-o como Min.

Lembre-se que o GTA é um jogo antigo, e o MTA coloca muito poder nas mãos dos scripters (para atrapalhar a falta de otimização). Mesmo se você tiver uma grande quantidade de RAM (por exemplo, 8GB, 16GB) você não pode esperar que tudo seja utilizável... jogos antigos têm limites técnicos e espaço de endereçamento limitado. Os scripters de servidor podem fazer coisas muito legais e insanamente realistas enquanto usam um valor muito abaixo de 3,6 GB de RAM (o limite técnico absoluto do SA), mas apenas desde que tenham scripters e modeladores/designers que saibam sobre otimização. Estritamente, qualquer servidor, não importa o quão modificado ou bonito.. deve precisar usar acima de 2 GB de RAM. A maioria dos servidores decentes usa entre 800 MB - 1,6 GB de qualquer maneira. Se você deseja aprender mais sobre este assunto ou é um dono de servidor que quer enteder seus erros, por favor entre no discord do MTA em https://discord.gg/mtasa e vá até o canal #general, em seguida, abra o post fixado desse canal sobre problemas do ecossistema de otimização (optimization ecosystem problems) (escrito por Dutchman101).

Observe que, em geral, '''qualquer crash''' com código de exceção '''0xE06D7363''' (em um módulo do MTA, e não gta_sa.exe como esta página wiki está focada) também é um problema relacionado à memória e volta ao abuso de memória por servidores e mods descritos acima.

==Resolvendo crashs relacionados a modelos personalizados==
Se você estiver enfrentando crashs que, de acordo com a tabela de crashs comuns, estão relacionadas a modelos personalizados corrompidos, recomendamos que você reinstale o GTA a partir da fonte original do jogo (DVD ou Steam, portanto, não haverá repacks pré-modificados) ou restaure backups de arquivos direcionados caso você entenda qual (tipo de) modelo pode estar causando o crash.

Caso você esteja apenas enfrentando os crashs ao jogar em um determinado servidor, há uma grande chance de que o servidor esteja carregando modelos personalizados e, em seguida, recomendamos que você entre em contato com o proprietário do servidor para que ele possa investigar e potencialmente identificar e substituir o modelo corrompido para parar os crashs. Até que eles tomem uma ação bem-sucedida, você pode tentar evitar enfrentar fisicamente o mod que você acredita que resulta em um crash (como não gerar spawnar o veículo ou usar a skin).
Vamos lembrá-lo da chance de que o modelo ruim esteja em seu GTA3.img, mas por coincidência você nunca chega fisicamente perto desse modelo em outros servidores, e o servidor em que você está crashando força o uso desse ID de modelo (como veículo ou skin usado regularmente); portanto, não se pode descartar que possivelmente ainda seja seu mod do seu cliente, apesar de você crashar apenas em um único servidor, e vale a pena pelo menos reinstalar seu GTA para experimentá-lo.

Se você é proprietário de um servidor e não prefere deixar de lado seu modelo amado (corrompido), então você pode pedir a um modelador experiente para tentar corrigir a corrupção modificando/revisando.
A alternativa de crashar muitos jogadores, potencialmente resultando em perda de jogadores para o seu servidor, não é bom de qualquer maneira. Por esse motivo, fique de olho no que os jogadores relatam e acompanhe-os para obter os detalhes do crash (para tentar combiná-los com os crashs do modelo da tabela nesta página da wiki), pode ser que seja uma boa ideia.

Adicionar upgrades (chamados "ug_upgradename") fora do chassis_dummy causará crashs quando o veículo tiver o respectivo upgrade gerado.

[[en:Famous crash offsets and their meaning]]
[[ru:Famous crash offsets and their meaning]]
[[pt-br:Crashs famosos e seu significado]]

SetWorldSpecialPropertyEnabled

2022-02-13T00:53:40Z

Vampire: Fixed a typo in 'vehiclesunglare' description

__NOTOC__
{{Client function}}

Enables or disables a special world property.

==Syntax==
<syntaxhighlight lang="lua">bool setWorldSpecialPropertyEnabled ( string propname, bool enable )</syntaxhighlight>
{{OOP||||isWorldSpecialPropertyEnabled}}
[[File:Randomfoliage.jpeg|frame|right|A photo demonstrating ''randomfoliage'' enabled and disabled.]]
===Required Arguments===
*'''propname:''' the name of the property to set. Possible values are:
**'''hovercars''' - equivalent of the JBGVNB cheat, and allows cars to drive on water.
**'''aircars''' - equivalent of the RIPAZHA cheat, and allows cars to fly.
**'''extrabunny''' - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher.
**'''extrajump''' - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher.
**'''randomfoliage''' - toggle randomly generated foliage on the GTA:SA map (default: true)
**'''snipermoon''' - toggle the GTA:SA easter egg, which increases the size of the moon every time you shoot it with a sniper rifle (default: false)
**'''extraairresistance''' - toggle the vehicle speed limit on cross-country roads (default: true)
**{{New feature/item|3.0156|1.5.5|12286|'''underworldwarp''' - toggle warp of peds and vehicles when fall under map (default: true)}}
**{{New feature/item|1.5.9|1.5.9|21125|'''vehiclesunglare''' - toogle the vehicle sun glare effect (default: false) }}
*'''enable:''' whether or not to enable the property.

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

==Example==

'''Example 1:''' Allows cars to fly.
<syntaxhighlight lang="lua">
addEventHandler( "onClientResourceStart", resourceRoot,
function( )
setWorldSpecialPropertyEnabled( "aircars", true )
end
)
</syntaxhighlight>

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

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.5-3.12286|Added "underworldwarp" property}}
{{ChangelogItem|1.5.9-1.21125|Added "vehiclesunglare" property}}

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

Página Inicial

2022-02-02T21:44:07Z

Vampire: Fixed the link that was leading to a non-translated page of 'How you can help'

{| 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 [[PT-BR/Como_você_pode_ajudar|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:iBR.png|Em Português|20px]] [http://forum.multitheftauto.com/forum/97-portuguese-português/ Seção em Português]
* [[File:iUS.png|Em Inglês|20px]] [https://discord.com/invite/mtasa Discord]
* [[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>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Star.png]]</div>
<h3>Extra</h3>
* [[Special:PrefixIndex/PT-BR|Lista de páginas em Português]]
</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:iBR.png|Em Inglês|20px]] [[PT-BR/Elemento|Elementos do MTA]] / [[PT-BR/Árvore de elementos|Árvore de 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>]
** [https://forum.mtasa.com/profile/74654-hiroshi/|<span style="color:blue">HiroShi</span>]
** [https://forum.mtasa.com/profile/63099-vampire/|<span style="color:blue">Vampire</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}}

Página Inicial

2022-02-02T01:30:54Z

Vampire: Added an 'extra' section mentioning all pages with PT-BR prefix

{| 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:iBR.png|Em Português|20px]] [http://forum.multitheftauto.com/forum/97-portuguese-português/ Seção em Português]
* [[File:iUS.png|Em Inglês|20px]] [https://discord.com/invite/mtasa Discord]
* [[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>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Star.png]]</div>
<h3>Extra</h3>
* [[Special:PrefixIndex/PT-BR|Lista de páginas em Português]]
</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:iBR.png|Em Inglês|20px]] [[PT-BR/Elemento|Elementos do MTA]] / [[PT-BR/Árvore de elementos|Árvore de 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>]
** [https://forum.mtasa.com/profile/74654-hiroshi/|<span style="color:blue">HiroShi</span>]
** [https://forum.mtasa.com/profile/63099-vampire/|<span style="color:blue">Vampire</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}}

Página Inicial

2022-01-31T19:13:36Z

Vampire: Modified the links for MTA Elements / Element (now leading to the translated pages)

{| 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:iBR.png|Em Português|20px]] [http://forum.multitheftauto.com/forum/97-portuguese-português/ Seção em Português]
* [[File:iUS.png|Em Inglês|20px]] [https://discord.com/invite/mtasa Discord]
* [[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:iBR.png|Em Inglês|20px]] [[PT-BR/Elemento|Elementos do MTA]] / [[PT-BR/Árvore de elementos|Árvore de 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>]
** [https://forum.mtasa.com/profile/74654-hiroshi/|<span style="color:blue">HiroShi</span>]
** [https://forum.mtasa.com/profile/63099-vampire/|<span style="color:blue">Vampire</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}}

PT-BR/Árvore de elementos

2022-01-31T18:38:25Z

Vampire: Made links redirect to a translation instead of the English pages

[[File:Tre.png|frame|Element tree]]
O MTA usa a chamada ''árvore de elementos'' para armazenar todos os elementos que existem no servidor e no cliente. Isso está diretamente relacionado ao conjunto de [[PT-BR/Recursos|recursos]] em execução e ao layout XML de seus arquivos de mapa, embora possa o tempo de execução possa ser alterado por scripts.

Se você estiver familiarizado com o conceito de árvores na ciência da computação, isso deve ser fácil de entender. Se não for o caso, pense nisso como uma árvore genealógica - exceto que todos têm apenas um pai/mãe solteiro(a). Cada [[PT-BR/Elemento|elemento]] tem um elemento ''principal''.

Todos os elementos criados em scripts ou em arquivos .map são elementos filhos do recurso ao qual pertencem. Assim, a maioria dos elementos (exceto [[client]]s) existem apenas dentro dos recursos e também são destruídos assim que seu recurso é interrompido.

==Elementos de árvore==
* '''root/raiz''': Isso está na base da árvore - todos os elementos são filhos (ou descendentes) desse elemento.
<syntaxhighlight lang="lua">
getRootElement()
</syntaxhighlight>
* '''resource/recurso''': Estes são filhos diretos do elemento raiz - com um para cada recurso em execução. Esse elemento é chamado de raiz do recurso. Seu ID contém o nome do recurso.
<syntaxhighlight lang="lua">
getResourceRootElement()
</syntaxhighlight>
* '''map/mapa''': Cada elemento do recurso contém pelo menos um elemento de mapa, representando um arquivo ".map" no recurso ou aquele que contém os elementos criados por scripts (isso é chamado de mapa "dinâmico"). Seus IDs contêm os nomes dos arquivos dos mapas, ou "dinâmicos" para o mapa dinâmico.
** Os arquivos de mapa podem conter vários outros [[PT-BR/Elemento|elemento]](s) bem como um número ilimitado de elementos personalizados.

==Exemplo==
Isso em um exemplo de uma árvore do lado do servidor em XML de um servidor em execução.
''Observe que ele é encurtado em alguns lugares para fins de visão geral.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explicação===
Essa árvore consiste em vários elementos raiz do recurso, o [[Elemento/Console|console do servidor]] e dois elementos do [[Elemento/Player|player]], que são filhos diretos do elemento '''raiz'''. Todos esses recursos possuem um ''mapa dinâmico'' como elemento filho (só não é mostrado para a maioria deles). Eles contêm os elementos que são criados dinamicamente por esse recurso usando scripts, por exemplo, um [[Elemento/Vehicle|veículo]]. Se o recurso tiver um arquivo de mapa, ele também será um elemento filho, contendo todos os elementos do arquivo .map.

Vamos dar uma olhada mais de perto no recurso '''assault''': ele contém apenas um mapa ''dinâmico'' que tem 2 times, 3 blips, 1 marcador e 1 colshape como elementos filhos. Estes são os elementos que são criados pelo script, por exemplo, o marcador, o colshape e um dos blips provavelmente são usados para o objetivo.

A função do recurso '''as-farm''' , ao contrário, é ser um mapa para o modo de jogo '''assault'''. O mapa dinâmico está vazio (pode conter elementos se houver um script nele), enquanto há um mapa chamado 'as-farm.map', que contém vários elementos. Estes são os principalmente elementos personalizados (como spawngroup, spawnarea, objective), mas também alguns elementos que o MTA cria automaticamente após carregar o mapa (como pickup). Nos colchetes após o tipo de elemento, você pode ver os dados do elemento que ele contém. Eles são idênticos aos atributos que o arquivo .map contém nesses elementos, enquanto você também pode definir e obter dados de elementos para quaisquer outros elementos (por exemplo, jogadores) com [[PT-BR/SetElementData|setElementData]] e [[PT-BR/getElementData|getElementData]].

==Aplicação prática==
Os elementos podem ter quantos filhos quiserem. Isso não afeta diretamente o mapa de forma alguma, mas se destaca quando combinado com o sistema de script.

===Configurando dados para elementos===
Se você chamar uma definir a função... em um nó da árvore de elementos, a função afetará todos os elementos dentro dela (nos quais ela pode funcionar).

Portanto, o código a seguir definiria o tamanho de cada marcador (o único tipo de elemento em que a função setMarkerSize funcionaria) que está abaixo do elemento raiz para ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( root, 2.5 )
</syntaxhighlight>

O mesmo pode ser feito em qualquer elemento, não se restringe ao elemento raiz.

===Map manager===
O [[#Exemplo|exemplo acima]] mostra a forma como o [[PT-BR/Recursos:Map_Manager|map manager]] usa diferentes recursos. O recurso 'assault' é o modo de jogo, que gerencia o que acontece no servidor usando scripts e assim criando elementos na árvore dinamicamente. Quando um recurso de mapa é iniciado, o modo de jogo recebe um [[resource|ponteiro de recurso ]] referindo-se ao recurso iniciado - neste caso o ''as-farm'' - do qual você pode recuperar e armazenar o elemento raiz do recurso. Usando este elemento em conjunto com funções como [[getElementsByType]], [[PT-BR/getElementData|getElementData]] e várias outras, você pode acessar qualquer informação que foi carregada na árvore a partir do arquivo 'as-farm.map' através de scripts no recurso do modo de jogo.

Outra coisa que deve ser considerada em relação à árvore de elementos é o fato de que quando você altera o mapa, você não precisa remover nenhum elemento que você criou dentro do recurso do mapa, enquanto você '''tem''' que remover elementos que são criados dentro do recurso do modo de jogo, '''se''' eles são específicos do mapa (o que provavelmente será o caso dos itens que você criar com base nas informações lidas nos arquivos .map do recurso do mapa).

==Navegador de elementos==
Você pode iniciar o recurso ''elementbrowser'' para ver uma visualização ao vivo da árvore de elementos em seu servidor. Basta iniciar o recurso e o navegador na página web do seu servidor e escolher a opção ''Element browser'' na barra lateral (somente firefox atualmente).

[[Category:Scripting Concepts]]

[[en:Element tree]]
[[hu:Element tree]]
[[es:Árbol de elementos]]
[[ru:Element tree]]
[[pl:Element tree]]

GetElementData

2022-01-31T18:35:52Z

Vampire: Added Portuguese BR to the sidebar

__NOTOC__
{{Server client function}}
This function retrieves [[element data]] attached to an element under a certain key.

==Syntax==
<syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, bool inherit = true] )</syntaxhighlight>
{{OOP||[[element]]:getData||setElementData}}

===Required Arguments===
*'''theElement:''' This is the element with data you want to retrieve.
*'''key:''' The name of the element data entry you want to retrieve. (Maximum 31 characters.)

===Optional Arguments===
*'''inherit:''' - toggles whether or not the function should go up the hierarchy to find the requested key in case the specified element doesn't have it.

===Returns===
This function returns a ''variable'' containing the requested element data, or ''false'' if the element or the element data does not exist. When getting data corresponding to a XML attribute, this is always a ''string''.

==Example==
This example stores the tick count when a player joins and then allows players to see how long they are connected using a console function 'joinTime'.
<section show="true" name="Server" class="server">
<syntaxhighlight lang="lua">
function joinTime ( )
setElementData ( source, "joinTime", getTickCount() ) -- Store the current tick count in the player's data with the key 'joinTime'
end
-- Make our 'joinTime' function be called when a player joins
addEventHandler ( "onPlayerJoin", root, joinTime )

function showJoinTime ( source, commandName, playerName )
if ( playerName ) then -- see if a player was specified
thePlayer = getPlayerFromName ( playerName ) -- get the player element for the specified player
if ( thePlayer ) then -- if one was found...
local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- calculates the time since join
outputChatBox ( getPlayerName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- output the player's join time
else
outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error
end
else
-- display when the player who used the function joined and inform how to see other people's join time
local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- calculate the time since join
outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
end
end
-- Add a console command joinTime, that takes an optional parameter of a player's name
addCommandHandler ( "joinTime", showJoinTime )
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

[[pt-br:getElementData]]

PT-BR/getElementData

2022-01-31T18:31:32Z

Vampire: Translation of the page 'getElementData' to Portuguese BR

__NOTOC__
{{BR/Funcao compartilhada}}
Esta função recupera dados de elemento anexados a um elemento em uma determinada chave.

==Sintaxe==
<syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, bool inherit = true] )</syntaxhighlight>
{{PT-BR/POO||[[element]]:getData||setElementData}}

===Argumentos Obrigatórios===
*'''theElement:''' Este é o elemento com dados que você deseja recuperar.
*'''key:''' O nome da entrada de dados do elemento que você deseja recuperar. (Máximo de 31 caracteres.)

===Argumentos Opcionai===
*'''inherit:''' - alterna se a função deve ou não subir na hierarquia para encontrar a chave solicitada caso o elemento especificado não a tenha.

===Retorna===
Esta função retorna uma ''variável'' contendo os dados do elemento solicitado, ou ''false'' se o elemento ou os dados do elemento não existirem. Ao obter dados correspondentes a um atributo XML, isso é sempre uma ''string''.

==Exemplo==
Este exemplo armazena a contagem de ticks quando um jogador entra e permite que os jogadores vejam quanto tempo eles estão conectados usando uma função 'joinTime' do console.
<section show="true" name="Server" class="server">
<syntaxhighlight lang="lua">
function joinTime ( )
setElementData ( source, "joinTime", getTickCount() ) -- Store the current tick count in the player's data with the key 'joinTime'
end
-- Make our 'joinTime' function be called when a player joins
addEventHandler ( "onPlayerJoin", root, joinTime )

function showJoinTime ( source, commandName, playerName )
if ( playerName ) then -- see if a player was specified
thePlayer = getPlayerFromName ( playerName ) -- get the player element for the specified player
if ( thePlayer ) then -- if one was found...
local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- calculates the time since join
outputChatBox ( getPlayerName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- output the player's join time
else
outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- display an error
end
else
-- display when the player who used the function joined and inform how to see other people's join time
local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- calculate the time since join
outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
end
end
-- Add a console command joinTime, that takes an optional parameter of a player's name
addCommandHandler ( "joinTime", showJoinTime )
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

[[en:getElementData]]

PT-BR/Elemento

2022-01-31T17:48:02Z

Vampire: Portuguese BR translation for 'Element' page

Um '''elemento''' é uma classe genérica que pode representar quase todas as [[PT-BR/Entidade|entidades]]. Os tipos de elementos internos são:

{{Elements}}

A qualquer outro tipo de elemento pode ser criado como um elemento abstrato, não se referindo a nenhuma [[PT-BR/Entidade|entidades]] de jogo. Por exemplo, '''recurso''' e '''mapa''' são criados quando recursos e mapas são carregados em entidades de grupo que eles criam como seus filhos.

Os elementos compartilham funções comuns, como recuperação de tipo e lista, uma operação de destruição para remover o elemento e a entidade do jogo à qual está vinculado (exceto alguns elementos que não podem ser destruídos, por exemplo, elementos do cliente), armazenamento e recuperação de [[PT-BR/Element data|dado de elemento]], e muitas outras operações comuns.

Todos os elementos são armazenados internamente em uma [[PT-BR/Árvore de elementos|estrutura de árvore]], e, todos os elementos, exceto a '''raiz''' tem um elemento principal, que pode ser o elemento '''raiz''', '''recurso''', '''mapa''' ou outro elemento. Isso é puramente para declarar o escopo das chamadas de função.

==Funções relacionadas a script==
===Cliente===
{{Client element functions}}
===Servidor===
{{Element functions}}
[[Category:Scripting Concepts]]

[[en:Element]]
[[ru:Element]]
[[es:Elemento]]
[[it:Elemento]]
[[hu:Element]]
[[pl:Element]]
[[pt-br:Elemento]]

PT-BR/Entidade

2022-01-31T17:42:47Z

Vampire: Added other language to the sidebar

Uma '''entidade''' é um elemento que tem uma posição e uma representação física no mundo. Os seguintes elementos são entidades:
{{Entidades}}

[[hu:Entity]]
[[pt-br:Entidade]]
[[en:Entity]]

Entity

2022-01-31T17:40:09Z

Vampire: Added Portuguese BR to the sidebar

An entity is an element that has a position and a physical representation in the world. The following elements are entities:
{{Entities}}
[[Category:Scripting Concepts]]

[[hu:Entity]]
[[pt-br:Entidade]]

Element

2022-01-31T17:38:00Z

Vampire: Added Portuguese BR to the sidebar

An '''element''' is a generic class that can represent almost all in-game [[entity|entities]]. The built-in element types are:

{{Elements}}

Any other element type can be created as an abstract element, not referring to any game [[entity]]. For example, '''resource''' and '''map''' elements are created when resources and maps are loaded to group entities they create as their children.

Elements share common functions such as type and list retrieval, a destroy operation to remove both the element and the game entity it is linked to (except for some elements which can't be destroyed, for example client elements), [[element data]] storing and retrieval, and many more common operations.

All elements are stored internally in a [[Element tree|tree structure]], and as such every element except the '''root''' element has a parent element, that can be the '''root''' element, a '''resource''', '''map''' or another element. This is purely for declaring the scope of function calls.

==Related scripting functions==
===Client===
{{Client element functions}}
===Server===
{{Element functions}}
[[Category:Scripting Concepts]]

[[en:Element]]
[[ru:Element]]
[[es:Elemento]]
[[it:Elemento]]
[[hu:Element]]
[[pl:Element]]
[[pt-br:Elemento]]

PT-BR/Árvore de elementos

2022-01-31T17:31:42Z

Vampire: Typo

[[File:Tre.png|frame|Element tree]]
O MTA usa a chamada ''árvore de elementos'' para armazenar todos os elementos que existem no servidor e no cliente. Isso está diretamente relacionado ao conjunto de [[PT-BR/Recursos|recursos]] em execução e ao layout XML de seus arquivos de mapa, embora possa o tempo de execução possa ser alterado por scripts.

Se você estiver familiarizado com o conceito de árvores na ciência da computação, isso deve ser fácil de entender. Se não for o caso, pense nisso como uma árvore genealógica - exceto que todos têm apenas um pai/mãe solteiro(a). Cada [[element]] tem um elemento ''principal''.

Todos os elementos criados em scripts ou em arquivos .map são elementos filhos do recurso ao qual pertencem. Assim, a maioria dos elementos (exceto [[client]]s) existem apenas dentro dos recursos e também são destruídos assim que seu recurso é interrompido.

==Elementos de árvore==
* '''root/raiz''': Isso está na base da árvore - todos os elementos são filhos (ou descendentes) desse elemento.
<syntaxhighlight lang="lua">
getRootElement()
</syntaxhighlight>
* '''resource/recurso''': Estes são filhos diretos do elemento raiz - com um para cada recurso em execução. Esse elemento é chamado de raiz do recurso. Seu ID contém o nome do recurso.
<syntaxhighlight lang="lua">
getResourceRootElement()
</syntaxhighlight>
* '''map/mapa''': Cada elemento do recurso contém pelo menos um elemento de mapa, representando um arquivo ".map" no recurso ou aquele que contém os elementos criados por scripts (isso é chamado de mapa "dinâmico"). Seus IDs contêm os nomes dos arquivos dos mapas, ou "dinâmicos" para o mapa dinâmico.
** Os arquivos de mapa podem conter vários outros [[element]]s bem como um número ilimitado de elementos personalizados.

==Exemplo==
Isso em um exemplo de uma árvore do lado do servidor em XML de um servidor em execução.
''Observe que ele é encurtado em alguns lugares para fins de visão geral.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explicação===
Essa árvore consiste em vários elementos raiz do recurso, o [[Element/Console|server console]] e dois elementos do [[player]], que são filhos diretos do elemento '''raiz'''. Todos esses recursos possuem um ''mapa dinâmico'' como elemento filho (só não é mostrado para a maioria deles). Eles contêm os elementos que são criados dinamicamente por esse recurso usando scripts, por exemplo, um [[vehicle]]. Se o recurso tiver um arquivo de mapa, ele também será um elemento filho, contendo todos os elementos do arquivo .map.

Vamos dar uma olhada mais de perto no recurso '''assault''': ele contém apenas um mapa ''dinâmico'' que tem 2 times, 3 blips, 1 marcador e 1 colshape como elementos filhos. Estes são os elementos que são criados pelo script, por exemplo, o marcador, o colshape e um dos blips provavelmente são usados para o objetivo.

A função do recurso '''as-farm''' , ao contrário, é ser um mapa para o modo de jogo '''assault'''. O mapa dinâmico está vazio (pode conter elementos se houver um script nele), enquanto há um mapa chamado 'as-farm.map', que contém vários elementos. Estes são os principalmente elementos personalizados (como spawngroup, spawnarea, objective), mas também alguns elementos que o MTA cria automaticamente após carregar o mapa (como pickup). Nos colchetes após o tipo de elemento, você pode ver os dados do elemento que ele contém. Eles são idênticos aos atributos que o arquivo .map contém nesses elementos, enquanto você também pode definir e obter dados de elementos para quaisquer outros elementos (por exemplo, jogadores) com [[setElementData]] e [[getElementData]].

==Aplicação prática==
Os elementos podem ter quantos filhos quiserem. Isso não afeta diretamente o mapa de forma alguma, mas se destaca quando combinado com o sistema de script.

===Configurando dados para elementos===
Se você chamar uma definir a função... em um nó da árvore de elementos, a função afetará todos os elementos dentro dela (nos quais ela pode funcionar).

Portanto, o código a seguir definiria o tamanho de cada marcador (o único tipo de elemento em que a função setMarkerSize funcionaria) que está abaixo do elemento raiz para ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( root, 2.5 )
</syntaxhighlight>

O mesmo pode ser feito em qualquer elemento, não se restringe ao elemento raiz.

===Map manager===
O [[#Example|exemplo acima]] mostra a forma como o [[map manager]] usa diferentes recursos. O recurso 'assault' é o modo de jogo, que gerencia o que acontece no servidor usando scripts e assim criando elementos na árvore dinamicamente. Quando um recurso de mapa é iniciado, o modo de jogo recebe um [[resource|ponteiro de recurso ]] referindo-se ao recurso iniciado - neste caso o ''as-farm'' - do qual você pode recuperar e armazenar o elemento raiz do recurso. Usando este elemento em conjunto com funções como [[getElementsByType]], [[getElementData]] e várias outras, você pode acessar qualquer informação que foi carregada na árvore a partir do arquivo 'as-farm.map' através de scripts no recurso do modo de jogo.

Outra coisa que deve ser considerada em relação à árvore de elementos é o fato de que quando você altera o mapa, você não precisa remover nenhum elemento que você criou dentro do recurso do mapa, enquanto você '''tem''' que remover elementos que são criados dentro do recurso do modo de jogo, '''se''' eles são específicos do mapa (o que provavelmente será o caso dos itens que você criar com base nas informações lidas nos arquivos .map do recurso do mapa).

==Navegador de elementos==
Você pode iniciar o recurso ''elementbrowser'' para ver uma visualização ao vivo da árvore de elementos em seu servidor. Basta iniciar o recurso e o navegador na página web do seu servidor e escolher a opção ''Element browser'' na barra lateral (somente firefox atualmente).

[[Category:Scripting Concepts]]

[[en:Element tree]]
[[hu:Element tree]]
[[es:Árbol de elementos]]
[[ru:Element tree]]
[[pl:Element tree]]

PT-BR/Árvore de elementos

2022-01-31T17:26:12Z

Vampire: Translation of the page 'Element tree' to Portuguese BR

[[File:Tre.png|frame|Element tree]]
O MTA usa a chamada ''árvore de elementos'' para armazenar todos os elementos que existem no servidor e no cliente. Isso está diretamente relacionado ao conjunto de [[PT-BR/Recursos|recursos]] em execução e ao layout XML de seus arquivos de mapa, embora possa o tempo de execução possa ser alterado por scripts.

Se você estiver familiarizado com o conceito de árvores na ciência da computação, isso deve ser fácil de entender. Se não for o caso, pense nisso como uma árvore genealógica - exceto que todos têm apenas um pai/mãe solteiro(a). Cada [[element]] has a tem um elemento ''principal''.

Todos os elementos criados em scripts ou em arquivos .map são elementos filhos do recurso ao qual pertencem. Assim, a maioria dos elementos (exceto [[client]]s) existem apenas dentro dos recursos e também são destruídos assim que seu recurso é interrompido.

==Elementos de árvore==
* '''root/raiz''': Isso está na base da árvore - todos os elementos são filhos (ou descendentes) desse elemento.
<syntaxhighlight lang="lua">
getRootElement()
</syntaxhighlight>
* '''resource/recurso''': Estes são filhos diretos do elemento raiz - com um para cada recurso em execução. Esse elemento é chamado de raiz do recurso. Seu ID contém o nome do recurso.
<syntaxhighlight lang="lua">
getResourceRootElement()
</syntaxhighlight>
* '''map/mapa''': Cada elemento do recurso contém pelo menos um elemento de mapa, representando um arquivo ".map" no recurso ou aquele que contém os elementos criados por scripts (isso é chamado de mapa "dinâmico"). Seus IDs contêm os nomes dos arquivos dos mapas, ou "dinâmicos" para o mapa dinâmico.
** Os arquivos de mapa podem conter vários outros [[element]]s bem como um número ilimitado de elementos personalizados.

==Exemplo==
Isso em um exemplo de uma árvore do lado do servidor em XML de um servidor em execução.
''Observe que ele é encurtado em alguns lugares para fins de visão geral.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explicação===
Essa árvore consiste em vários elementos raiz do recurso, o [[Element/Console|server console]] e dois elementos do [[player]], que são filhos diretos do elemento '''raiz'''. Todos esses recursos possuem um ''mapa dinâmico'' como elemento filho (só não é mostrado para a maioria deles). Eles contêm os elementos que são criados dinamicamente por esse recurso usando scripts, por exemplo, um [[vehicle]]. Se o recurso tiver um arquivo de mapa, ele também será um elemento filho, contendo todos os elementos do arquivo .map.

Vamos dar uma olhada mais de perto no recurso '''assault''': ele contém apenas um mapa ''dinâmico'' que tem 2 times, 3 blips, 1 marcador e 1 colshape como elementos filhos. Estes são os elementos que são criados pelo script, por exemplo, o marcador, o colshape e um dos blips provavelmente são usados para o objetivo.

A função do recurso '''as-farm''' , ao contrário, é ser um mapa para o modo de jogo '''assault'''. O mapa dinâmico está vazio (pode conter elementos se houver um script nele), enquanto há um mapa chamado 'as-farm.map', que contém vários elementos. Estes são os principalmente elementos personalizados (como spawngroup, spawnarea, objective), mas também alguns elementos que o MTA cria automaticamente após carregar o mapa (como pickup). Nos colchetes após o tipo de elemento, você pode ver os dados do elemento que ele contém. Eles são idênticos aos atributos que o arquivo .map contém nesses elementos, enquanto você também pode definir e obter dados de elementos para quaisquer outros elementos (por exemplo, jogadores) com [[setElementData]] e [[getElementData]].

==Aplicação prática==
Os elementos podem ter quantos filhos quiserem. Isso não afeta diretamente o mapa de forma alguma, mas se destaca quando combinado com o sistema de script.

===Configurando dados para elementos===
Se você chamar uma definir a função... em um nó da árvore de elementos, a função afetará todos os elementos dentro dela (nos quais ela pode funcionar).

Portanto, o código a seguir definiria o tamanho de cada marcador (o único tipo de elemento em que a função setMarkerSize funcionaria) que está abaixo do elemento raiz para ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( root, 2.5 )
</syntaxhighlight>

O mesmo pode ser feito em qualquer elemento, não se restringe ao elemento raiz.

===Map manager===
O [[#Example|exemplo acima]] mostra a forma como o [[map manager]] usa diferentes recursos. O recurso 'assault' é o modo de jogo, que gerencia o que acontece no servidor usando scripts e assim criando elementos na árvore dinamicamente. Quando um recurso de mapa é iniciado, o modo de jogo recebe um [[resource|ponteiro de recurso ]] referindo-se ao recurso iniciado - neste caso o ''as-farm'' - do qual você pode recuperar e armazenar o elemento raiz do recurso. Usando este elemento em conjunto com funções como [[getElementsByType]], [[getElementData]] e várias outras, você pode acessar qualquer informação que foi carregada na árvore a partir do arquivo 'as-farm.map' através de scripts no recurso do modo de jogo.

Outra coisa que deve ser considerada em relação à árvore de elementos é o fato de que quando você altera o mapa, você não precisa remover nenhum elemento que você criou dentro do recurso do mapa, enquanto você '''tem''' que remover elementos que são criados dentro do recurso do modo de jogo, '''se''' eles são específicos do mapa (o que provavelmente será o caso dos itens que você criar com base nas informações lidas nos arquivos .map do recurso do mapa).

==Navegador de elementos==
Você pode iniciar o recurso ''elementbrowser'' para ver uma visualização ao vivo da árvore de elementos em seu servidor. Basta iniciar o recurso e o navegador na página web do seu servidor e escolher a opção ''Element browser'' na barra lateral (somente firefox atualmente).

[[Category:Scripting Concepts]]

[[en:Element tree]]
[[hu:Element tree]]
[[es:Árbol de elementos]]
[[ru:Element tree]]
[[pl:Element tree]]

Element tree

2022-01-31T17:17:09Z

Vampire: Fixed a typo in Practical application and added a new page to translate this

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

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

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

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

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

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

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

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

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

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

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

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

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

==Element browser==
You can start the resource ''elementbrowser'' to see a live view of the element tree on your server. Just start the resource and browser to your server's web page and choose the ''Element browser'' option in the sidebar (firefox only currently).

[[Category:Scripting Concepts]]

[[hu:Element tree]]
[[es:Árbol de elementos]]
[[ru:Element tree]]
[[pl:Element tree]]
[[pt-br:Árvore de elementos]]

PT-BR/Como você pode ajudar

2022-01-29T22:21:27Z

Vampire:

__NOTOC__
O Multi Theft Auto tem muitas áreas nas quais você pode nos ajudar. Por sua vez, teremos o maior prazer em ajudá-lo a começar com quaisquer ideias que você tenha, ajudar a testá-las e - se forem boas o suficiente - divulgá-las para toda a comunidade. Esta página descreve as principais áreas em que você pode fazer algo, é claro, há muitas coisas nas quais não pensamos, então pense fora da caixa!

==Codando para o MTA:SA==
* Torne-se um contribuidor de patches enviando [https://github.com/multitheftauto/mtasa-blue/pulls pull requests] para o MTA, contendo recursos solicitados ou correções de bugs. ([[Coding guidelines]])
* Traduza o MTA:SA para o seu idioma nativo - https://translate.multitheftauto.com/

==Criação de scripts==
* Torne-se um colaborador dos recursos oficiais do MTA enviando [https://github.com/multitheftauto/mtasa-resources/pulls pull requests] para nosso repositório de recursos
* Crie e [https://community.mtasa.com/ publique] um modo de jogo ou script útil
**[[PT-BR/Introdução ao Scripting|Introdução ao Scripting]]
**[https://www.lua.org/pil/index.html Manual de "Programação em Lua"]
* Crie um recurso de propósito geral que forneça funções úteis a outros recursos.

==Criação de mapas==
* Crie e [https://community.mtasa.com/ publique] um mapa para um modo de jogo existente, com o editor de mapas.
**[[PT-BR/Resource:Editor|Manual do editor]]

==Desenvolvimento web==
* Crie seu próprio sistema de estatísticas - usando o [[PHP SDK]] como uma base. Junte-se ao [https://discord.gg/RygaCSD discord do MTA] (ou ao [https://discord.gg/GNN6PRtTnu discord de desenvolvimento]) para ajuda.

==Documentação==
Antes de fazer alterações confira a: [[PT-BR/Introdução ao Scripting|Introdução ao Scripting]] e [[Help:MTA Wiki Specific Templates|Modelos Específicos]]
* Conclua a documentação para [[:Category:Incomplete|Funções Incompletas]] - pergunte em #mta.scripting se você não tiver certeza de algo.
* Adicione exemplos a [[:Category:Needs Example|exemplos de funções e eventos ausentes]] - por favor '''teste''' eles, e novamente, pergunte se você precisar de ajuda.
* Revise e verifique [[:Category:Needs Checking|páginas que precisam ser verificadas]] - certifique-se de que os problemas destacados sejam resolvidos antes de remover as páginas da categoria.
* Expanda as páginas que explicam os [[:Category:Scripting_Concepts|Conceitos básicos do MTA]].
* Escreva [https://forum.mtasa.com/forum/123-tutorials/ tutoriais] para ajudar novas pessoas.
* Traduza as páginas da wiki para que pessoas de outros países também possam começar no MTA.
* Crie documentação para funções e eventos não documentados - [[Undocumented Items]]
* Mantenha 'alterações em' [trabalho em andamento atual: https://wiki.multitheftauto.com/wiki/Changes_in_1.5.9] para manter os lançamentos futuros atualizados.

==Garantia da Qualidade==
* [https://github.com/multitheftauto/mtasa-blue/issues Relate problemas] com o mod, certifique-se de fazer uma pesquisa dos problemas já relatados primeiro.
* Teste e confirme os problemas relatados existentes.
* Use a versão mais recente do MTA para detectar e relatar novos bugs, acessando 'Opções', 'Avançado', 'Tipo de compilação' e escolha 'Nightly' ou obtenha-o regularmente [https://nightly.mtasa.com/ daqui].
* Quaisquer bugs relacionados a uma função / evento de script e presentes na versão principal (em vez de nightlies), documente esse bug adicionando um [https://wiki.multitheftauto.com/wiki/Help:MTA_Wiki_Specific_Templates aviso] para a página wiki para economizar o tempo de outros scripters.

==Tarefas específicas==
* Crie um fuzzer para verificar falhas em nossas funções de script.

==Doação==
Você pode doar para MTA:SA [https://mtasa.com/donate/manage.php aqui]

[[en:How you can help]]
[[ru:How you can help]]
[[pl:Jak możesz pomóc]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[hu:How you can help]]
[[tr:Nasıl yardımcı olabilirsiniz]]
[[pt-br:Como você pode ajudar]]

Página Inicial

2022-01-29T22:08:58Z

Vampire:

{| 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:iBR.png|Em Português|20px]] [http://forum.multitheftauto.com/forum/97-portuguese-português/ Seção em Português]
* [[File:iUS.png|Em Inglês|20px]] [https://discord.com/invite/mtasa Discord]
* [[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>]
** [https://forum.mtasa.com/profile/74654-hiroshi/|<span style="color:blue">HiroShi</span>]
** [https://forum.mtasa.com/profile/63099-vampire/|<span style="color:blue">Vampire</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}}

PT-BR/Crashs famosos e seu significado

2022-01-29T14:44:58Z

Vampire: Created page with "<big>Esta página da wiki contém o motivo de muitos crashs conhecidas do MTA que podem acontecer com você. Use CTRL + F e procure pelo Offset do seu crash para encontrar alguma informação relevante.</big> Exemplo de uma mensagem de crash: <syntaxhighlight lang="xml"> Version = 1.5.6-release-14664.0.000 Time = Mon Oct 8 12:20:00 2018 Module = C:\Program Files (x86)\Rockstar Games\GTA San Andreas\gta_sa.exe Code = 0xC0000005 Offset = 0x003C91CC EAX=0F77A3C8 EBX=0F..."

<big>Esta página da wiki contém o motivo de muitos crashs conhecidas do MTA que podem acontecer com você. Use CTRL + F e procure pelo Offset do seu crash para encontrar alguma informação relevante.</big>

Exemplo de uma mensagem de crash:
<syntaxhighlight lang="xml">
Version = 1.5.6-release-14664.0.000
Time = Mon Oct 8 12:20:00 2018
Module = C:\Program Files (x86)\Rockstar Games\GTA San Andreas\gta_sa.exe
Code = 0xC0000005
Offset = 0x003C91CC

EAX=0F77A3C8 EBX=0F77A3B8 ECX=0177FAA0 EDX=00139700 ESI=00000000
EDI=00000001 EBP=0177FC50 ESP=0177FA80 EIP=007C91CC FLG=00210202
CS=0023 DS=002B SS=002B ES=002B FS=0053 GS=002B
</syntaxhighlight>

(Nota: sempre use o "Offset" do seu crash para procurar nesta página da wiki)

'''A maioria dos crashs do MTA são causadas por algo que o usuário é capaz de resolver porque depende do seu sistema, escolha de servidor ou mods do jogo. '''
Esta página procura ser útil pelo motivo acima mencionado; você saberá onde procurar quando tiver um certo tipo de crash.

Para obter mais conselhos sobre como resolver problemas, role até o final desta página.

<br/>
==Módulo = gta_sa.exe ou proxy_sa.exe==
{| class="wikitable"
|-
!Offset(s)
!Significado
|-
|<syntaxhighlight lang="lua">0x00134134</syntaxhighlight>
|Modelo ruim ou GTA3.img corrompido. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Nota para proprietários de servidores e modeladores: se você abrir o crash dump (.dmp) como texto com o bloco de notas e procurar a palavra-chave `CEntity_GetBoundRect - No collision for model` você pode identificar o ID do modelo ruim.
|-
|<syntaxhighlight lang="lua">0x00348CF4</syntaxhighlight>
|Causado por s0beit d3d9.dll
|-
|<syntaxhighlight lang="lua">
0x003F0C37
0x003F0BF7
</syntaxhighlight>
|Modelo de veículo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
|-
|<syntaxhighlight lang="lua">
0x003C91CC
0x003C920C
</syntaxhighlight>
|Falta de memória de vídeo. Isso pode acontecer em servidores com mods não otimizados e scripts (defeituosos) que abusam da memória de vídeo, ou mesmo quando você tem uma placa de vídeo poderosa, caso as coisas em um servidor sejam extremamente não otimizadas fazendo com que ele comece a atingir os limites do GTA. Se você tiver uma placa de vídeo poderosa e mais jogadores sofrerem com esse tipo de crash, informe o proprietário do servidor sobre esse problema, pois provavelmente significa que seus scripters & designers não sabem o que estão fazendo. Mais informações estão disponíveis nestes links do fórum: [https://forum.mtasa.com/topic/85094-mta-crashing/ aqui] e [https://forum.mtasa.com/topic/127677-c-r-a-s-h-i-n-g/ aqui (caso de exemplo)]
|-
|-
|<syntaxhighlight lang="lua">0x00357DEC</syntaxhighlight>
|Sem memória de vídeo (provavelmente).
|-
|<syntaxhighlight lang="lua">0x003F5A3A</syntaxhighlight>
|Crash de memória, geralmente acontece em servidores altamente não otimizados. Pode ser resultado de falta de memória de vídeo ou o atingimento de limites técnicos de uso de RAM, mas mais frequentemente uma combinação de ambos. Entre em contato com o dono do servidor e peça uma otimização, ou encontre outros servidores para jogar.
|-
|-
|<syntaxhighlight lang="lua">0x004A1ED4</syntaxhighlight>
|Sem memória do sistema (RAM)
|-
|-
|-
|<syntaxhighlight lang="lua">
0x011630F8
0x011630FE
0x01162FE3
0x011630F2
</syntaxhighlight>
|Este crash é resultado de problemas com a colisão de modelos. Pode ser devido a colisões não otimizadas que seu PC (ou limites técnicos do MTA, devido a mods ruins de servidores) não consegue lidar, ou devido a colisão de modelos corrompidas. Ainda não sabemos muito sobre todas as circunstâncias relacionadas a esse crash. Nosso primeiro conselho seria garantir que seu GTA não seja modificado e, caso contrário, pedir ao proprietário do servidor para identificar e resolver os problemas com colisão de modelos ruins/não otimizados.
|-
|<syntaxhighlight lang="lua">0x00137D6E</syntaxhighlight>
|Sem memória do sistema (RAM). Isso coincide com o carregamento de colisões; o risco de obter esse travamento é alto ao entrar em um servidor com muitos mods com um PC fraco e uma quantidade pequena de memória.
Para resolver esse crash, cuidado com os servidores em que você está jogando (em relação a otimização) ou obtenha um PC mais rápido. Subtipo de "Ficando sem memória (Running out of memory)": na maioria das vezes, um resultado direto da falta de espaço de endereço, portanto, atualizar para o Windows 64 bits pode resolvê-lo
|-
|<syntaxhighlight lang="lua">0x0014F406</syntaxhighlight>
|Possivelmente "Ficando sem memória (Running out of memory)": um resultado direto da falta de espaço de endereço, portanto, atualizar para o Windows 64 bits pode resolvê-lo.
|-
|<syntaxhighlight lang="lua">0x00171A10</syntaxhighlight>
|Às vezes, ao entrar em um servidor, talvez esteja relacionado a mods ruins do servidor.
|-
|-
|<syntaxhighlight lang="lua">0x000C9F98</syntaxhighlight>
|Possivelmente modelo ou textura de skin ruim (mods de roupas para diversas skins, como o CJ).
Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e desativar mods em tais skins, ou qualquer recurso que manipule roupas ou acessórios de pedestres.
|-
|-
|<syntaxhighlight lang="lua">0x00349B7B</syntaxhighlight>
|Modelo de skin ruim. Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod de skin corrompido
Informações para modeladores e proprietários de servidores: corrupção na hierarquia da animação no DFF da skin do pedestres ou na configuração dos ossos
|-
|-
|<syntaxhighlight lang="lua">0x00165096</syntaxhighlight>
|Modelo ruim (contendo uma colisão de modelo corrompido). Instale o GTA sem modificações para verificar ou no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Informações para modeladores e proprietários de servidores: corrupção em uma ou várias esferas de colisão (ou seu raio) dentro do modelo DFF.
|-
|<syntaxhighlight lang="lua">0x001D6E6A</syntaxhighlight>
|Ou falta de memória de vídeo ou modelo/textura ruim.
Informações para modeladores e proprietários de servidores: caso a culpa seja de um modelo, a corrupção está na estrutura "prelit" (Cores noturnas) do modelo. Peça ao seu modelador para recriar o prelit.
|-
|-
|<syntaxhighlight lang="lua">
0x000DFE92
0x000DFF90
</syntaxhighlight>
|Mods de som ruins ou driver/dispositivo de áudio com defeito. Instale o GTA sem modificações para verificar ou atualize seus drivers de áudio.
O problema geralmente é conhecido por arquivos de áudio totalmente ausentes ou esvaziados/corrompidos (como em \Rockstar Games\GTA San Andreas\audio > SFX ou outra subpasta), então você pode, alternativamente, restaurar um backup.

Não use re-packs 'comprimidos' do GTA, estes tendem a ter arquivos de áudio recortados.
|-
|-
|-
|<syntaxhighlight lang="lua">0x000CFCD6</syntaxhighlight>
|Falha de alocação como resultado da (re)conexão com servidores após uma longa sessão de jogo em um servidor com más práticas em seus scripts (abusando de RAM e funções de animação).
Este crash pode ser 'corrigida' (evitado) pelo MTA no futuro, estamos trabalhando nisso! Está relacionado a animações na memória e limpeza delas.
|-
|-
|<syntaxhighlight lang="lua">
0x00771848
</syntaxhighlight>
|Crash devido a problemas com arquivos de dados do GTA (o MTA não consegue abri-los, o que pode significar que eles estão corrompidos/modificados e incompatíveis ou ausentes)
Instale o GTA sem modificações para verificar
|-
|<syntaxhighlight lang="lua">
0x001B6B2F
</syntaxhighlight>
|Crash devido a um problema com o arquivo DATA\DEFAULT.DAT ou DATA\CARCOLS.DAT na pasta de instalação do GTA (pode estar ausente ou modificado/corrompido).
Instale o GTA sem modificações para verificar
|-
|<syntaxhighlight lang="lua">
0x003EC9DA
</syntaxhighlight>
|Crash possivelmente devido a um problema com o arquivo ANIM\PED.IFP na pasta de instalação do GTA (pode estar ausente ou modificado/corrompido).
Instale o GTA sem modificações para verificar
|-
|-
|-
|<syntaxhighlight lang="lua">
0x003F18CF
0x003F190F
</syntaxhighlight>
|Modelo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Esse crash foi evitado (corrigida pelo MTA), mas devido a limitações técnicas ainda ocorrerá para usuários do Windows XP.
Informações para modeladores e proprietários de servidores: devido à natureza da corrupção, o modelo apresenta um risco de crash, que pode acontecer a qualquer momento quando próximo dele.
|-
|<syntaxhighlight lang="lua">
0x0019BD39
</syntaxhighlight>
|Modelo ruim. Instale o GTA sem modificações para verificar ou, no caso de mods do servidor, peça ao proprietário do servidor para identificar e substituir o mod corrompido.
Esse crash geralmente ocorre quando você dispara uma arma enquanto o modelo corrompido é transmitido (fisicamente próximo).
|-
|<syntaxhighlight lang="lua">
0x000C9691
</syntaxhighlight>
|Modelo de veículo ruim ou ausente. Isso geralmente acontece quando você exclui um modelo do seu GTA3.img sem restaurar o original ou colocar outro modelo em seu lugar. Ou quando o DFF não é um arquivo de modelo válido.
Restaure o GTA3.img ou instale o GTA sem modificações para verificar e, se isso não funcionar, peça ao proprietário do servidor para identificar e substituir o mod corrompido, pois também pode ser um modelo ruim (ou um script desonesto, diga-lhes isto: lida com tipos de veículos, variantes, upgrades etc, de maneira imprópria)
|-
|<syntaxhighlight lang="lua">
0x0000F67C
0x0000F663
</syntaxhighlight>
|Modelos personalizados que não funcionam com sombras volumétricas. Corrija os modelos ou desative as sombras volumétricas em Configurações->Vídeo.
|-
|<syntaxhighlight lang="lua">0x00423FD0</syntaxhighlight>
|Mods ruins para o GTA ou GTA3.img corrompido. Reinstale o GTA (com uma versão limpa e original) para resolver este crash. Observação: crash conhecido em cópias e torrents piratas do GTA, devido a arquivos .dat, .col e .ipl ausentes, ruins ou corrompidos (mods pré-instalados). O MTA suporta apenas a versão original do GTA comprada legalmente.
|-
|<syntaxhighlight lang="lua">0x000A2CF3</syntaxhighlight>
|Arquivo '''effects.fxp''' na pasta GTA San Andreas\models corrompido, ausente ou modificado. Se restaurar esse arquivo para o original não corrigir o crash, use o GTA não modificado, pois também pode ser relacionado devido a arquivos de dados do GTA (aqueles que têm a ver com efeitos).
|-
|<syntaxhighlight lang="lua">
0x001A49D4
</syntaxhighlight>
|Mod ruim (player.img personalizado no GTA San Andreas\models). Restaure o player.img para o original ou use o GTA não modificado.
Observação: este crash também pode ser acionado quando um jogador com modelo do CJ (ou roupas do CJ) aparecem na sua tela, em um servidor em que você está jogando. O seu player.img personalizado não pode lidar com isso e causará um crash.
|}

==Resolvendo crashs de falta de memória==
Se você estiver enfrentando crashs que, de acordo com a tabela de falhas comuns, estão relacionadas a qualquer tipo de falta de memória, recomendamos que você faça isso;

- Lembre-se do tipo de servidor em que você está jogando, especialmente em combinação com a potência do seu PC. Existem muitos servidores sobrecarregados e cheios de mods por aí no MTA que exigem o melhor do seu PC e também podem abusar da memória por meio de scripts ineficientes além de mods personalizados (ou mesmo com a falta deles).

Poderíamos escrever um livro sobre a causa real (que esses servidores têm scripters ruins, ou aqueles que não sabem o que é otimização, e que adicionam tudo, enchendo de modelos e texturas, sem revisá-lo), mas não vamos não fazer isso aqui.

Se você tiver um PC lento ou de geração mais antiga, recomendamos que você evite certos servidores "extravagantes" com grandes downloads e tal.

- Instale a versão de 64 bits do Windows em vez da x86 (32 bits)

'''Se você ainda quiser jogar em servidores que podem facilmente obter vantagem do seu sistema, então;'''

- Atualize o hardware do seu PC para desempenho aprimorado; considere substituir a placa de vídeo por uma adequada para jogos ou adicionar memória de sistema adicional (RAM). A reinstalação do Windows às vezes também pode ajudar bastante se o seu sistema operacional em geral for lento e não estiver bem mantido. Como alternativa, faça alguma manutenção (consulte alguém com experiência ou comece atualizando os drivers e executando vários limpadores de lixo e ferramentas de otimização de desempenho de renome)

- Sigas as instruções listadas em [https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/ https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/]

Remova todos os mods da sua instalação do GTA (de preferência reinstale) porque os mods podem ocupar memória de vídeo e RAM, o suficiente para causar alto uso de memória e crashs subsequentes.
Além disso, você deve definitivamente tentar diminuir a memória de streaming, indo em Opções-> Avançado-> Memória para streaming-> e definindo-o como Min.

Lembre-se que o GTA é um jogo antigo, e o MTA coloca muito poder nas mãos dos scripters (para atrapalhar a falta de otimização). Mesmo se você tiver uma grande quantidade de RAM (por exemplo, 8GB, 16GB) você não pode esperar que tudo seja utilizável... jogos antigos têm limites técnicos e espaço de endereçamento limitado. Os scripters de servidor podem fazer coisas muito legais e insanamente realistas enquanto usam um valor muito abaixo de 3,6 GB de RAM (o limite técnico absoluto do SA), mas apenas desde que tenham scripters e modeladores/designers que saibam sobre otimização. Estritamente, qualquer servidor, não importa o quão modificado ou bonito.. deve precisar usar acima de 2 GB de RAM. A maioria dos servidores decentes usa entre 800 MB - 1,6 GB de qualquer maneira. Se você deseja aprender mais sobre este assunto ou é um dono de servidor que quer enteder seus erros, por favor entre no discord do MTA em https://discord.gg/mtasa e vá até o canal #general, em seguida, abra o post fixado desse canal sobre problemas do ecossistema de otimização (optimization ecosystem problems) (escrito por Dutchman101).

Observe que, em geral, '''qualquer crash''' com código de exceção '''0xE06D7363''' (em um módulo do MTA, e não gta_sa.exe como esta página wiki está focada) também é um problema relacionado à memória e volta ao abuso de memória por servidores e mods descritos acima.

==Resolvendo crashs relacionados a modelos personalizados==
Se você estiver enfrentando crashs que, de acordo com a tabela de crashs comuns, estão relacionadas a modelos personalizados corrompidos, recomendamos que você reinstale o GTA a partir da fonte original do jogo (DVD ou Steam, portanto, não haverá repacks pré-modificados) ou restaure backups de arquivos direcionados caso você entenda qual (tipo de) modelo pode estar causando o crash.

Caso você esteja apenas enfrentando os crashs ao jogar em um determinado servidor, há uma grande chance de que o servidor esteja carregando modelos personalizados e, em seguida, recomendamos que você entre em contato com o proprietário do servidor para que ele possa investigar e potencialmente identificar e substituir o modelo corrompido para parar os crashs. Até que eles tomem uma ação bem-sucedida, você pode tentar evitar enfrentar fisicamente o mod que você acredita que resulta em um crash (como não gerar spawnar o veículo ou usar a skin).
Vamos lembrá-lo da chance de que o modelo ruim esteja em seu GTA3.img, mas por coincidência você nunca chega fisicamente perto desse modelo em outros servidores, e o servidor em que você está crashando força o uso desse ID de modelo (como veículo ou skin usado regularmente); portanto, não se pode descartar que possivelmente ainda seja seu mod do seu cliente, apesar de você crashar apenas em um único servidor, e vale a pena pelo menos reinstalar seu GTA para experimentá-lo.

Se você é proprietário de um servidor e não prefere deixar de lado seu modelo amado (corrompido), então você pode pedir a um modelador experiente para tentar corrigir a corrupção modificando/revisando.
A alternativa de crashar muitos jogadores, potencialmente resultando em perda de jogadores para o seu servidor, não é bom de qualquer maneira. Por esse motivo, fique de olho no que os jogadores relatam e acompanhe-os para obter os detalhes do crash (para tentar combiná-los com os crashs do modelo da tabela nesta página da wiki), pode ser que seja uma boa ideia.

Adicionar upgrades (chamados "ug_upgradename") fora do chassis_dummy causará crashs quando o veículo tiver o respectivo upgrade gerado.

[[en:Famous crash offsets and their meaning]]
[[ru:Famous crash offsets and their meaning]]
[[pt-br:Crashs famosos e seu significado]]

Famous crash offsets and their meaning

2022-01-29T14:12:33Z

Vampire:

<big>This wiki page contains the reason for many well-known MTA crashes that you may experience. Use CTRL + F and search for your Crash Offset to find the relevant entry.</big>

Example crash dialog info:
<syntaxhighlight lang="xml">
Version = 1.5.6-release-14664.0.000
Time = Mon Oct 8 12:20:00 2018
Module = C:\Program Files (x86)\Rockstar Games\GTA San Andreas\gta_sa.exe
Code = 0xC0000005
Offset = 0x003C91CC

EAX=0F77A3C8 EBX=0F77A3B8 ECX=0177FAA0 EDX=00139700 ESI=00000000
EDI=00000001 EBP=0177FC50 ESP=0177FA80 EIP=007C91CC FLG=00210202
CS=0023 DS=002B SS=002B ES=002B FS=0053 GS=002B
</syntaxhighlight>

(Note: always use the "Offset" value from the crash dialog to identify your crash and match it up with those listed on this wiki page)

'''Most MTA crashes are caused by something that the user is able to resolve because it depends on their system, choice of server or game mods.'''
This page seeks to be helpful for the aforementioned reason; you'll know where to look for when you get a certain type of crash.

For further advice on resolving issues, scroll down to the bottom of this page.

<br/>
==Module = gta_sa.exe or proxy_sa.exe==
{| class="wikitable"
|-
!Offset(s)
!Meaning
|-
|<syntaxhighlight lang="lua">0x00134134</syntaxhighlight>
|Bad model or corrupted GTA3.img. Use unmodded GTA install to check, or incase of server mods, ask server owner to identify and replace the corrupt mod.
Note for server owners and modellers: if you open the crash dump (.dmp) as text with notepad and search for keyword `CEntity_GetBoundRect - No collision for model` you can often identify the bad model ID.
|-
|<syntaxhighlight lang="lua">0x00348CF4</syntaxhighlight>
|Caused by s0beit d3d9.dll
|-
|<syntaxhighlight lang="lua">
0x003F0C37
0x003F0BF7
</syntaxhighlight>
|Bad vehicle model. Use unmodded GTA install to check, or incase of server mods, ask server owner to identify and replace the corrupt mod.
|-
|<syntaxhighlight lang="lua">
0x003C91CC
0x003C920C
</syntaxhighlight>
|Out of video memory. This can happen on servers with unoptimized mods and (faulty) scripts that abuse video memory, or even when you have a powerful graphics card in case the stuff on a server is extremely unoptimized so that it starts hitting GTA limits. If you have a powerful graphics card and more players suffer from this crash type, inform the server owner of this problem as it probably means their scripters & designers don't know what they are doing. More information is available at these forum links: [https://forum.mtasa.com/topic/85094-mta-crashing/ here] and [https://forum.mtasa.com/topic/127677-c-r-a-s-h-i-n-g/ here (example case)]
|-
|-
|<syntaxhighlight lang="lua">0x00357DEC</syntaxhighlight>
|Out of video memory (probably).
|-
|<syntaxhighlight lang="lua">0x003F5A3A</syntaxhighlight>
|Memory crash, usually happens on heavily unoptimized servers. It can be a result of either out of video memory or reaching technical limits of RAM usage, but more often a combination of both.. hence it's put as "heavily unoptimized servers". Contact the server owner and ask for optimization, or find other servers to play on.
|-
|-
|<syntaxhighlight lang="lua">0x004A1ED4</syntaxhighlight>
|Out of system memory (RAM)
|-
|-
|-
|<syntaxhighlight lang="lua">
0x011630F8
0x011630FE
0x01162FE3
0x011630F2
</syntaxhighlight>
|This crash is a result of problems with collision models. It might be due to unoptimized collisions that your PC (or MTA's technical limits, due to bad server mods) cannot handle, or due to corrupt collision models. We still don't know a lot about all of the circumstances related to this crash. Our first advise would be to ensure that your GTA is unmodded, and otherwise to ask server owner to identify and resolve issues with bad/unoptimized collision models.
|-
|<syntaxhighlight lang="lua">0x00137D6E</syntaxhighlight>
|Out of system memory (RAM). This co-incides with loading collisions; the risk to get this crash is high when joining a mod-heavy server with a weak PC and small amount of memory.
To resolve this crash, mind the servers you're playing on (optimization) or get a faster PC. Sub-type of "Running out of memory": most often a direct result of running out of address space, so upgrading to 64-bit Windows installation might solve it
|-
|<syntaxhighlight lang="lua">0x0014F406</syntaxhighlight>
|Possibly "Running out of memory": a direct result of running out of address space, so upgrading to 64-bit Windows installation might solve it.
|-
|<syntaxhighlight lang="lua">0x00171A10</syntaxhighlight>
|Sometimes when joining a server, maybe related to bad server mods.
|-
|-
|<syntaxhighlight lang="lua">0x000C9F98</syntaxhighlight>
|Possibly bad skin model or texture (clothes mods for multi-clump skins such as CJ).
Use unmodded GTA install to check or incase of server mods, ask server owner to identify and disable mods on such skins, or any resource manipulating clothes or ped accesoires.
|-
|-
|<syntaxhighlight lang="lua">0x00349B7B</syntaxhighlight>
|Bad skin model. Use unmodded GTA install to check or incase of server mods, ask server owner to identify and replace the corrupt skin mod.
Information for modellers & server owners: corruption in the anim hierarchy in ped's skin DFF or bones configuration
|-
|-
|<syntaxhighlight lang="lua">0x00165096</syntaxhighlight>
|Bad model (containing a corrupt collision model). Use unmodded GTA install to check or incase of server mods, ask server owner to identify and replace the corrupt mod.
Information for modellers & server owners: corruption in one or multiple col spheres (or their radius) within the DFF model.
|-
|<syntaxhighlight lang="lua">0x001D6E6A</syntaxhighlight>
|Either out of video memory, or bad model/texture.
Information for modellers & server owners: in case the culprit is a model, then corruption is in "prelit" (Night colors) structure of the model. Ask your modeller to recreate prelit data.
|-
|-
|<syntaxhighlight lang="lua">
0x000DFE92
0x000DFF90
</syntaxhighlight>
|Bad sound mods or faulty audio driver/device. Use unmodded GTA install to check, or update your audio drivers.
The problem is often known to be entirely missing or emptied/corrupted audio files (such as in \Rockstar Games\GTA San Andreas\audio > SFX or other subfolder), so you may alternatively be able to restore a targetted backup.

Do not use 'compressed' GTA re-packs for this reason of cut-out audio files.
|-
|-
|-
|<syntaxhighlight lang="lua">0x000CFCD6</syntaxhighlight>
|Allocation failure as a result of (re-)connecting to servers after a lengthy playing session on a server with bad practise in their scripts (abusing RAM and anim functions).
This crash may be 'fixed' (averted) by MTA in future, we're working on it! It's related to anims in memory and clearing them.
|-
|-
|<syntaxhighlight lang="lua">
0x00771848
</syntaxhighlight>
|Crash because of issue with GTA data files (MTA fails to open them which could mean they are corrupted/modded & incompatible or missing)
Use unmodded GTA install to check
|-
|<syntaxhighlight lang="lua">
0x001B6B2F
</syntaxhighlight>
|Crash because of issue with DATA\DEFAULT.DAT or DATA\CARCOLS.DAT file in your GTA installation folder (may be missing or modded/corrupted).
Use unmodded GTA install to check
|-
|<syntaxhighlight lang="lua">
0x003EC9DA
</syntaxhighlight>
|Crash possibly because of issue with ANIM\PED.IFP file in your GTA installation folder (may be missing or modded/corrupted).
Use unmodded GTA install to check
|-
|-
|-
|<syntaxhighlight lang="lua">
0x003F18CF
0x003F190F
</syntaxhighlight>
|Bad model. Use unmodded GTA install to check or in case of server mods, ask server owner to identify and replace the corrupt mod.
This crash has been averted (fixed by MTA), but due to technical limitations will still occur for Windows XP users.<br/>
Information for modellers & server owners: due to the nature of corruption, the model introduces a risk to crash, it could happen at any given moment while nearby.
|-
|<syntaxhighlight lang="lua">
0x0019BD39
</syntaxhighlight>
|Bad model. Use unmodded GTA install to check or in case of server mods, ask server owner to identify and replace the corrupt mod.
This crash usually occurs when you fire a weapon while the corrupt model is streamed in (physically nearby).
|-
|<syntaxhighlight lang="lua">
0x000C9691
</syntaxhighlight>
|Bad or missing vehicle model. This usually happens when you deleted a model from your GTA3.img without restoring the original or putting another model in its place. Or when the DFF isn't a valid model file at all.
Restore GTA3.img or use unmodded GTA install to check, and if that doesn't work then ask server owner to identify and replace the corrupt mod, since it can also still be a bad model (or a dodgy script, that, tell them this: deals with vehicle types, variants, upgrades etc, in an improper way)
|-
|<syntaxhighlight lang="lua">
0x0000F67C
0x0000F663
</syntaxhighlight>
|Custom models which are not working with volumetric shadows. Fix models or disable volumetric shadows in Settings->Video.
|-
|<syntaxhighlight lang="lua">0x00423FD0</syntaxhighlight>
|Bad GTA mods or corrupted GTA3.img. Re-install GTA (with a clean and original version) to solve this crash. Note: known crash for common pirated copies & torrents of GTA, due to missing, bad or corrupted .dat, .col and .ipl files (pre-installed mods). MTA only supports the original, legally purchased version of GTA.
|-
|<syntaxhighlight lang="lua">0x000A2CF3</syntaxhighlight>
|Corrupted, missing or modded GTA San Andreas\models > '''effects.fxp''' file. If restoring that file to original doesn't fix the crash, use unmodded GTA as it can also be due to related GTA data files (ones that have to do with effects).
|-
|<syntaxhighlight lang="lua">
0x001A49D4
</syntaxhighlight>
|Bad mod (custom player.img in GTA San Andreas\models). Restore player.img to original or use unmodded GTA.
Note: this crash can also be triggered when a player with CJ model (or CJ clothes) appears on your screen, on a server you're playing on. Your custom player.img cannot handle that and will cause a crash.
|}

==Resolving out-of-memory crashes==
If you're experiencing crashes that, according to the table of common crashes, are related to any sort of running out of memory, then we advise you to;

- Mind the type of servers you're playing on, especially in combination with how powerful your PC is. There's lots of bloated, mod-heavy servers out there in MTA that demand the better of your PC and may also abuse memory through inefficient scripts besides custom mods (or even with the lack thereof).

We could write a book about the real cause (which is that such servers have bad scripters, or those that don't know what optimization is, and that they add everything, including bloated models and textures, without reviewing it) but we won't do that here.

If you have a slow or older generation PC, then we advise you to avoid certain "fancy" servers with huge resource downloads and such.

- Install 64-bits version of Windows rather than x86 (32-bit)

'''If you still want to play on servers that may easily get upper hand on your system, then;'''

- Upgrade your PC's hardware for enhanced performance; consider replacing the videocard with one suitable for gaming, or adding additional system memory (RAM). Re-installing Windows can sometimes also help a bunch if your OS in general is slow and not well-maintained. Alternatively, perform some mainentance (consult someone with tech experience, or make a start by updating drivers and running various junk cleaners & renowned PC performance optimization tools)

- Follow the instructions listed at [https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/ https://forum.mtasa.com/topic/78081-32-bit-windows-crashing/]

- Remove any mods to your GTA installation (preferably re-install) because mods may take up video memory and RAM, enough to cause your high memory usage and subsequent crashes.
Also you should definately try lowering streaming memory, by going into Settings->Advanced->Streaming memory-> and setting it to Min.

Remember that GTA is an old game, and MTA places a lot of power in the hands of scripters (to mess up with a lack of optimization). Even if you have a high amount of RAM (for example 8gb, 16gb) you can't expect it to all be usable.. old games have technical limits and limited address space. Server scripters can do really cool and insanely realistic stuff while using far below 3.6GB RAM (the absolute technical limit in SA), but only as long they have scripters and modellers/designers that know about optimization. Strictly taken, no server, no matter how modded or beautiful.. should need to use above 2GB of RAM. Most decent servers use between 800MB - 1.6GB anyways. If you wish to learn more about this subject or are a server owner that wants to realize their mistakes, please join the MTA discord at https://discord.gg/mtasa and go to the #general channel, then open that channel's pinned post about optimization ecosystem problems (written by Dutchman101).

Please note that in general, '''any crash''' with exception code '''0xE06D7363''' (on an MTA module, and not gta_sa.exe like this wiki page is focussed on) is also a memory-related issue, and comes back to the memory abuse by servers and mods described above.

==Resolving crashes related to custom models==
If you're experiencing crashes that, according to the table of common crashes, are related to corrupt custom models, then we advise you to re-install GTA from the original game source (DVD or Steam, so no pre-modded repacks) or restore targetted file back-ups in case you understand which (type of) model may cause the crash.

In case you're only experiencing the crashes while playing on a certain server, there's a high chance that server is loading custom server models, and then we recommend you to contact the server owner so they can investigate and potentially identify & replace the corrupted model to stop the crashes. Until they take successful action, on that server you can try to avoid physically facing the mod you believe results in a crash (like not spawning said vehicle or using said skin).
Let us remind you of the chance that the bad model is in your GTA3.img, but by coincidence you never physically come near that model on other servers, and the server you're crashing the most on happens to force usage of that model ID upon you (like as regularly used vehicle or skin); therefore it cannot be ruled out that it's possibly still your client mod, despite you only crashing on a single server, and it's worth at least re-installing your GTA to try it out.

If you are a server owner and wouldn't prefer letting go of your beloved (corrupt) model, then you can ask an experienced modeller to try fix the corruption by modifying/revising it.
The alternative of crashing many players, potentially resulting in player loss for your server, isn't fine either way. For this reason, keeping a sharp eye on trends of players reporting (or shouting) that they crashed, and following up with them to get the crash details (to try match them up to model crashes from the table on this wiki page), may be a good idea.

Adding upgradable components (named "ug_upgradename") outside of chassis_dummy, will cause crashes once the vehicle has the respective upgrade component spawned.

[[ru:Famous crash offsets and their meaning]]
[[pt-br:Crashs famosos e seu significado ]]

PT-BR/Como você pode ajudar

2022-01-29T14:08:39Z

Vampire: Created page with "__NOTOC__ O Multi Theft Auto tem muitas áreas nas quais você pode nos ajudar. Por sua vez, teremos o maior prazer em ajudá-lo a começar com quaisquer ideias que você tenha, ajudar a testá-las e - se forem boas o suficiente - divulgá-las para toda a comunidade. Esta página descreve as principais áreas em que você pode fazer algo, é claro, há muitas coisas nas quais não pensamos, então pense fora da caixa! ==Codando para o MTA:SA== * Torne-se um contribuidor..."

__NOTOC__
O Multi Theft Auto tem muitas áreas nas quais você pode nos ajudar. Por sua vez, teremos o maior prazer em ajudá-lo a começar com quaisquer ideias que você tenha, ajudar a testá-las e - se forem boas o suficiente - divulgá-las para toda a comunidade. Esta página descreve as principais áreas em que você pode fazer algo, é claro, há muitas coisas nas quais não pensamos, então pense fora da caixa!

==Codando para o MTA:SA==
* Torne-se um contribuidor de patches enviando [https://github.com/multitheftauto/mtasa-blue/pulls pull requests] para o MTA, contendo recursos solicitados ou correções de bugs. ([[Guia de codificação]])
* Traduza o MTA:SA para o seu idioma nativo - https://translate.multitheftauto.com/

==Criação de scripts==
* Torne-se um colaborador dos recursos oficiais do MTA enviando [https://github.com/multitheftauto/mtasa-resources/pulls pull requests] para nosso repositório de recursos
* Crie e [https://community.mtasa.com/ publique] um modo de jogo ou script útil
**[[PT-BR/Introdução ao Scripting|Introdução ao Scripting]]
**[https://www.lua.org/pil/index.html Manual de "Programação em Lua"]
* Crie um recurso de propósito geral que forneça funções úteis a outros recursos.

==Criação de mapas==
* Crie e [https://community.mtasa.com/ publique] um mapa para um modo de jogo existente, com o editor de mapas.
**[[PT-BR/Resource:Editor|Manual do editor]]

==Desenvolvimento web==
* Crie seu próprio sistema de estatísticas - usando o [[PHP SDK]] como uma base. Junte-se ao [https://discord.gg/RygaCSD discord do MTA] (ou ao [https://discord.gg/GNN6PRtTnu discord de desenvolvimento]) para ajuda.

==Documentação==
Antes de fazer alterações confira a: [[PT-BR/Introdução ao Scripting|Introdução ao Scripting]] e [[Help:MTA Wiki Specific Templates|Modelos Específicos]]
* Conclua a documentação para [[:Category:Incomplete|Funções Incompletas]] - pergunte em #mta.scripting se você não tiver certeza de algo.
* Adicione exemplos a [[:Category:Needs Example|exemplos de funções e eventos ausentes]] - por favor '''teste''' eles, e novamente, pergunte se você precisar de ajuda.
* Revise e verifique [[:Category:Needs Checking|páginas que precisam ser verificadas]] - certifique-se de que os problemas destacados sejam resolvidos antes de remover as páginas da categoria.
* Expanda as páginas que explicam os [[:Category:Scripting_Concepts|Conceitos básicos do MTA]].
* Escreva [https://forum.mtasa.com/forum/123-tutorials/ tutoriais] para ajudar novas pessoas.
* Traduza as páginas da wiki para que pessoas de outros países também possam começar no MTA.
* Crie documentação para funções e eventos não documentados - [[Undocumented Items]]
* Mantenha 'alterações em' [trabalho em andamento atual: https://wiki.multitheftauto.com/wiki/Changes_in_1.5.9] para manter os lançamentos futuros atualizados.

==Garantia da Qualidade==
* [https://github.com/multitheftauto/mtasa-blue/issues Relate problemas] com o mod, certifique-se de fazer uma pesquisa dos problemas já relatados primeiro.
* Teste e confirme os problemas relatados existentes.
* Use a versão mais recente do MTA para detectar e relatar novos bugs, acessando 'Opções', 'Avançado', 'Tipo de compilação' e escolha 'Nightly' ou obtenha-o regularmente [https://nightly.mtasa.com/ daqui].
* Quaisquer bugs relacionados a uma função / evento de script e presentes na versão principal (em vez de nightlies), documente esse bug adicionando um [https://wiki.multitheftauto.com/wiki/Help:MTA_Wiki_Specific_Templates aviso] para a página wiki para economizar o tempo de outros scripters.

==Tarefas específicas==
* Crie um fuzzer para verificar falhas em nossas funções de script.

==Doação==
Você pode doar para MTA:SA [https://mtasa.com/donate/manage.php aqui]

[[en:How you can help]]
[[ru:How you can help]]
[[pl:Jak możesz pomóc]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[hu:How you can help]]
[[tr:Nasıl yardımcı olabilirsiniz]]
[[pt-br:Como você pode ajudar]]

PT-BR/Resource:Editor

2022-01-29T13:55:07Z

Vampire:

{{PT-BR/Recursos}}

O Editor de Mapas do MTA:SA lhe permite criar mapas para modos de jogo (gamemodes).

==Iniciando==
Para iniciar o editor, simplesmente clique no item "Map Editor" no menu principal do MTA.

==Menus==
Quando o editor iniciar, haverá dois menus na tela: um menu principal no topo e um menu de elementos no canto inferior esquerdo.

===Menu Principal===
Esses são os botões do menu principal:
* [[Image:Editor_New.png]] Cria um novo mapa.
* [[Image:Editor_Open.png]] Abre um mapa existente.
* [[Image:Editor_Save.png]] Salva o mapa em que se está trabalhando.
* [[Image:Editor_Save_as.png]] Salva o mapa com um nome diferente.
* [[Image:Editor_Options.png]] Altera as configurações do Editor.
* [[Image:Editor_Undo.png]] Desfaz a última ação.
* [[Image:Editor_Redo.png]] Refaz a última ação desfeita.
* [[Image:Editor_Locations.png]] Mostra os locais do jogo. O editor vem também com uma lista das localizações dos interiores do San Andreas, mas você também pode adicionar suas próprias coordenadas para a lista.
* [[Image:Editor_Current_elements.png]] Lista todos os elementos criados no mapa (objetos, veículos, marcadores, pickups...)
* [[Image:Editor_Map_settings.png]] Altera as configurações do mapa, como hora do dia ou gravidade. Neste também podes especificar quais ''gamemodes'' são compatíveis com ele.
* [[Image:Editor_Definitions.png]] Define quais [[PT-BR/Resource:Editor-EDF|EDF's]] desejas usar no seu mapa.
* [[Image:Editor_Test.png]] Entra no modo de jogo para testar seu mapa. Isso carregará o ''gamemode'' compatível ele, caso necessário.

===Menu de Elementos===
O menu de elementos serve para adicionar novos elementos para seu mapa.
* [[Image:Editor_Vehicle.png]] Cria um veículo.
* [[Image:Editor_Object.png]] Cria um objeto (prédios, pistas e outros cenários).
* [[Image:Editor_Pickup.png]] Cria um pickup (vida, munição, armas e outros customizados).
* [[Image:Editor_Marker.png]] Cria um marcador (''checkpoint'', anel, cilindro, seta e ''corona'').
* [[File:Crosshair.png‎]] Seleciona um objeto.
* [[Image:Editor_WorldObjectRemover.png]] Deleta um objeto do mundo.
{{Dica|Se você tiver um [[PT-BR/Resource:Editor-EDF|EDF]] carregado, poderá usar a rolagem (scroll) do mouse para entrar no menu de elementos customizados.}}

==Usando o editor==
Esta seção explica como criar e modificar mapas.

===Andando pelo mapa===
Quando o editor estiver carregado, você estará no ''modo câmera'', ou seja, poderá usar as teclas '''WSAD''' para se mover e usar o mouse para rotacionar. Quando estiver andando, podes pressionar a tecla '''ALT''' para mover-se mais lentamente ou '''SHIFT''' para ir mais rápido.

Para acessar a interface do editor, deves mudar para o ''modo cursor''. Para trocar entre os dois modos, aperte a tecla '''F'''. Quando estiver no modo cursor, sua visão ficará parada e poderá usar o mouse para tanto manipular elementos e usar os itens do menu.

O modo câmera sempre terá uma mira no centro da tela. Ela serve para selecionar elementos e movê-los da mesma forma como se estivesse com o cursor.

[[Image:Editor_Crosshair.png|center]]

===Criando um mapa===
* Inicie o editor, ou se já estiver iniciado, clique no ícone ''Novo Mapa''.
* Clique no ícone ''Configurações do Mapa''.
:* Vá na aba ''Meta'' e preencha o nome dele e o seu apelido nos campos (Name) e (Author), respectivamente.
:* Abra também a aba ''Gamemodes'' e adicione os modos de jogo compatíveis com mapa - eles serão adicionados para a lista de gamemodes compatíveis (''Added gamemodes'') ao lado.
:* Para fazer a ação citada a cima, selecione um item da primeira lista e clique em ''Add'' ou clique duas vezes em cima dele. Quando terminar, clique em OK.
[[Image:Editor_Mapsettings.png|center]]
* Clique na opção ''Definições do Mapa'' (a pasta verde) e adicione recursos dos quais desejas usar elementos customizados. Eles obviamente devem ser os gamemodes adicionados no item ''Configurações do Mapa''. Para mais informações sobre definições do editor, veja a página [[PT-BR/Resource:Editor-EDF|EDF]]. Vá em OK quando terminar.

===Criando elementos===
Adicionar novos elementos para seu mapa, como veículos e objetos é bem fácil.
* Se estiver no modo câmera, mude para o cursor ao clicar em '''F'''.
* Clique no ícone do elemento que desejas criar no canto inferior esquerdo. Ex: no botão com um carrinho para criar um veículo.
* O novo elemento será criado interligado ao seu cursor. Mova ele para o local desejado e aperte o '''botão esquerdo''' do mouse para confirmar.

[[Image:Editor_Addelem.png|center]]

Para criar elementos customizados de um recurso específico, posicione o mouse em cima do menu de elementos, use a roleta dele para alternar entre menus até os elementos do recurso desejado aparecerem. Lembrando, para isso funcionar, deves adicionar o [[PT-BR/Resource:Editor-EDF|EDF]] do recurso na opção ''Definições do Mapa''.

[[Image:Editor_Selectedf.png|center]]

===Selecionando===
* Selecione um elemento com o botão '''esquerdo''' do mouse no ''modo câmera''.
* Selecione um elemento com o botão '''direito''' do mouse no ''modo cursor''.
* Aperte '''espaço''' ou clique em uma área vazia para desselecionar.

Se estiver selecionado, em cima do elemento aparecerá um sinal amarelo. Elementos, principalmente objetos, sem muita colisão podem ser selecionados ao ativar o ''modo de alta precisão'' ao pressionar o botão ''E''. Isso aumenta a sensibilidade e a mira fica vermelha para indicar isso.

A janela ''Current elements'' (elementos do mapa) pode também ser usada para seleciona-los. É só clicar duas vezes em cima do item.

===Movendo===
Existem diferentes maneiras de se mover um elemento.

'''Com o mouse'''
* Selecione-o e mova com o '''botão esquerdo''' do mouse.
Ou:
* Selecione-o no modo mouse com o '''botão direito''', e mova-o aonde quiser, e clique para largar.

Podes também mover um objeto para frente e trás a partir da câmera selecionando-o com o botão direito e usando a rolagem do mouse.

'''Com o teclado'''
* Selecione um elemento com o '''botão esquerdo'''.
* Use as teclas com setas para mover o elemento no plano horizontal e '''Page Up'''/'''Page Down''' para mover verticualmente. Pressione '''ALT''' para mover mais lentamente e '''SHIFT''', mais rapidamente.

Por padrão, os elementos não estão travados nos eixos, portanto irão "entortar" quando for movido. Isso pode ser mudado no menu ''Opções''.

===Rotacionando===
'''Com o mouse'''

Podes rotacionar o elemento selecionado no eixo Z com a rolagem do mouse.
* Selecione o elemento no ''modo câmera'' com o '''botão direito''' e use a rolagem do mouse segurando '''CTRL esquerdo'''.
Ou:
* Selecione o elemento no ''modo cursor'' com o '''botão esqurdo''' e segure '''CTRL''' e role com o mouse.

'''Com o teclado'''
* Selecione o elemento com o '''botão esquerdo'''.
* Use '''CTRL''' (o sinal amarelo ficará verde) e use as setas, '''Page Up'''/'''Page Down''' para rotacionar o elemento em diferentes eixos.

Segure '''ALT''' para mover mais lento e '''SHIFT''' para mais rápido nos dois jeitos citados acima.

[[Image:Editor_Rotateelem.png|center]]

===Mudando o modelo e outras propriedades===
A maioria dos elementos tem uma variedade de propriedades modificadores de sua aparência e comportamento. Exemplos são o modelo, cor e ''tunagem'' de um carro.

* Abra a janela de propriedades do elemento clicando duas vezes nele ou apertando '''F3'''.
* Faça as alterações necessárias. Por exemplo, para mudar o modelo do carro ou objeto, clique no botão '''Browse''' e escolha na lista que se abrirá.
* Clique em OK quando terminar ou Cancel para desfazer as alterações.

[[Image:Editor_Props.png|center]]

===Clonando===
Podes clonar um elemento ao selecioná-lo e apertar '''C''' no teclado.

* No modo câmera, o elemento será preso ao seu cursor. Use o botão esquerdo do mouse para solta-lo.
* No modo cursor, o elemento clonado será posicionado no mesmo lugar do original.

Se segurar '''CTRL''' quando estiver clicando, o elemento será clocando novamente e será preso ao cursor. Isso ajuda quando se estiver posicionando grandes quantidades de algo.

De maneira alternativa, podes usar o botão ''Pullout'' localizado no canto direito da janela de propriedades para clonar o elemento.

===Deletando===
Simplesmente selecione um elemento e pressione '''Delete''' no teclado.

De maneira alternativa, use o botão ''Pullout'' localizado no canto direito inferior da janela de propriedades para deletar o elemento.

==Criando mapas para gamemodes específicos==
Para fazer um mapa para um gamemode desejado, deves fazer duas coisas:
* Clique no item '''Configurações do Mapa''' no menu principal, vá na aba '''Gamemodes'' e adicione quaisquer modos de jogo compatíveis com seu mapa.
* Vais precisar adicionar um ou mais [[PT-BR/Resource:Editor-EDF|EDF's]]. Isso permite seu mapa criar elementos customizados pelo gamemode, como spawnpoints, checkpoints do race, ou bandeiras do CTF. Para isso, clique na pastinha verde (Definições do Mapa) e adicione os gamemodes necessários.

==Controles==
A seguir há uma lista de todos os controles padrões. Para muda-los, vá nas configurações do MTA enquanto o Editor estiver rodando.

===Câmera===
{|
|-
| mover_para_frente
| '''w'''
|-
| mover_para_trás
| '''s'''
|-
| mover_para_esquerda
| '''a'''
|-
| mover_para_direita
| '''d'''
|-
| modo_de_alta_precisão
| '''e'''
|}

===Clonar===
{|
|-
| clonar_elemento_selecionado
| '''c'''
|-
| clonar_sucessivamente
| '''lctrl''' || ''(CTRL da esquerda)''
|}

===Manipulação de Elemento===
{|
|-
| mover_para_frente
| '''arrow_u''' || ''(Seta p/ Cima)''
|-
| mover_para_trás
| '''arrow_d''' || ''(Seta p/ Baixo)''
|-
| mover_para_esquerda
| '''arrow_l''' || ''(Seta p/ Esquerda)''
|-
| mover_para_direita
| '''arrow_r''' || ''(Seta p/ Direita)''
|-
| mover_para_baixo
| '''pgdn''' || ''(Page Down)''
|-
| mover_para_cima
| '''pgup''' || ''(Page Up)''
|-
| ampliar_visão
| '''mouse_wheel_down'''
|-
| diminuir_visão
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| ativar_gui
| '''F4'''
|-
| ativer_cursor
| '''f'''
|-
| selecionar_algo_no_modo_câmera
| '''mouse1''' || ''(Left Mouse button)''
|-
| selecionar_algo_no_modo_cursor
| '''mouse2''' || ''(Right Mouse button)''
|-
| próximo_edf
| '''mouse_wheel_up'''
|-
| edf_anterior
| '''mouse_wheel_down'''
|-
| desfazer
| '''Ctrl''' + '''z'''
|-
| refazer
| '''Ctrl''' + '''y'''
|-
| abrir_propriedades_do_elemento
| '''F3'''
|-
| seleção_de_modelo_para_cima
| '''arrow_u''' || ''(Arrow key Up)''
|-
| seleção_de_modelo_para_baixo
| '''arrow_d''' || ''(Arrow key Down)''
|-
| seleção_de_modelo_ampliar
| '''mouse_wheel_up'''
|-
| seleção_de_modelo_reduzir
| '''mouse_wheel_down'''
|-
| seleção_de_modelo_confirmar
| '''enter'''
|-
| elementos_do_mapa_para_cima
| '''num_8''' || ''(Numpad key 8)''
|-
| elementos_do_mapa_para_baixo
| '''num_2''' || ''(Numpad key 2)''
|-
| entrar_no_modo_teste
| '''F5'''
|}

==Multiplayer==
O editor foi programado em ambos os lados do cliente e servidor, portanto ele suporta multijogadores em um mesmo servidor normalmente. Para fazer um mapa com alguém, copie todos os recursos presentes na pasta ''../server/mods/deathmatch/[editor]'' para seu servidor e o inicie com '''start editor''' no console.

Lembre-se que ainda falta um sistema de permissões para o editor, portanto qualquer usuário poderá ter acesso a todas as opções do menu.

==Plugins e recursos externos==
''Artigo Principal:'' [[Resource:Editor/Plugins]] (Em Inglês)

O editor permite uma importação básica de elementos através de recursos externos. Isso é muito útil para aqueles que precisam manipular elementos de uma maneira específica não podendo ser feita pelo editor. Por exemplo, um recurso que utiliza modelos customizados (fazendo isso a partir de seu script) deverá utilizar esta interface para que o editor possa os gerenciar.

Ao usar o comando '''import <nome-do-Recurso>''' no console, todos os elementos do recurso serão importados para o editor.

==FAQ==
==== Aparece uma tela preta quando estiver iniciando o Editor de Mapas ====

Geralmente a causa disso é a instalação incorreta dos recursos pertencentes ao Map Editor. Se estiver usando uma versão estável do MTA, por gentileza, instale-o novamente e certifique-se que marcou a opção "Cliente e Servidor" na hora da instalação.

Se estiver usando uma versão ''nightly'', para corrigir isso deverá baixar o [https://code.google.com/p/mtasa-resources/downloads/list último pacote de recursos] hospedado no Google Code. Descompacte o arquivo e coloque seu conteúdo em:
''MTA San Andreas/server/mods/deathmatch/resources'' , onde ''MTA San Andreas'' é a pasta de instalação do MTA (O diretório padrão é: C:\Arquivos de Programas\MTA San Andreas).

{{Dica|Colar os arquivos na pasta ''MTA San Andreas/mods/deathmatch/resources'' é um '''erro muito comum''' - e não funcionará se feito isso. Então, lembre-se de colocar no lugar certo.}}

Se esse erro continuar a ocorrer, mesmo feito todos os passos e verificado se a instalação foi bem sucedida, pode ser que haja algum problema com o arquivo '''acl.xml'''. Você pode baixar o original [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml clicando aqui]. Ele deverá ser colado em: '''../server/mods/deathmatch/''', onde ".." é a pasta de instalação do MTA.

==== Quando uso o botão "Map Editor" aparece o erro: "Could not start the local server. See console for details" ====
Isso porque você não possui um arquivo ''editor.conf'' válido. O original pode ser baixado [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf aqui]. Ele deverá ser colado em '''../server/mods/deathmatch/''', onde ".." é a pasta de instalação do MTA.

==== Eu salvei um mapa mas não posso localiza-lo no diretório de recursos, mesmo o Editor sendo capaz de reconhecê-lo ====
Isso acontece porque o Windows Vista/7 impõe limites de escrita para aplicativos em execução que não possuem permissão de administrador. Então os arquivos são redirecionados para pasta "VirtualStore" em vez do "Arquivos de Programas". Podes localizar seu mapa no diretório:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Arquivos de Programa\MTA San Andreas\server\mods\deathmatch\resources\

Ao rodar o Servidor/MTA San Andres com os privilégios de Administrador irá fazer com que seus mapas sejam salvos no local apropriado.

==== Eu tenho outros problemas com o Editor ====

Algumas vezes, o reinstalando pode resolver. O jeito mais fácil é instalar o MTA:SA em uma nova pasta. Em contrapartida, podes tentar os passos a seguir:
::1. Vá a pasta de recursos, '''../server/mods/deathmatch/resources/ e delete a pasta '''editor_dump'''
::2. Vá a pasta de recursos, '''../server/mods/deathmatch/resources/ e delete a pasta '''editor_test'''

==== Encontrei um bug ou tenho uma sugestão/elogio ao Editor de Mapas ====
Use a página oficial do ''[https://github.com/multitheftauto/mtasa-blue/issues bugtracker]'' para reportar o bug. Ou sinta-se a vontade de entrar em nosso [https://discord.com/invite/mtasa Discord].

[[en:Resource:Editor]]
[[hu:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]
[[tr:Resource:Editor]]
[[pt-br:Resource:Editor]]

PT-BR/Resource:Editor

2022-01-29T13:53:32Z

Vampire:

{{PT-BR/Recursos}}

O Editor de Mapas do MTA:SA lhe permite criar mapas para modos de jogo (gamemodes).

==Iniciando==
Para iniciar o editor, simplesmente clique no item "Map Editor" no menu principal do MTA.

==Menus==
Quando o editor iniciar, haverá dois menus na tela: um menu principal no topo e um menu de elementos no canto inferior esquerdo.

===Menu Principal===
Esses são os botões do menu principal:
* [[Image:Editor_New.png]] Cria um novo mapa.
* [[Image:Editor_Open.png]] Abre um mapa existente.
* [[Image:Editor_Save.png]] Salva o mapa em que se está trabalhando.
* [[Image:Editor_Save_as.png]] Salva o mapa com um nome diferente.
* [[Image:Editor_Options.png]] Altera as configurações do Editor.
* [[Image:Editor_Undo.png]] Desfaz a última ação.
* [[Image:Editor_Redo.png]] Refaz a última ação desfeita.
* [[Image:Editor_Locations.png]] Mostra os locais do jogo. O editor vem também com uma lista das localizações dos interiores do San Andreas, mas você também pode adicionar suas próprias coordenadas para a lista.
* [[Image:Editor_Current_elements.png]] Lista todos os elementos criados no mapa (objetos, veículos, marcadores, pickups...)
* [[Image:Editor_Map_settings.png]] Altera as configurações do mapa, como hora do dia ou gravidade. Neste também podes especificar quais ''gamemodes'' são compatíveis com ele.
* [[Image:Editor_Definitions.png]] Define quais [[PT-BR/Resource:Editor-EDF|EDF's]] desejas usar no seu mapa.
* [[Image:Editor_Test.png]] Entra no modo de jogo para testar seu mapa. Isso carregará o ''gamemode'' compatível ele, caso necessário.

===Menu de Elementos===
O menu de elementos serve para adicionar novos elementos para seu mapa.
* [[Image:Editor_Vehicle.png]] Cria um veículo.
* [[Image:Editor_Object.png]] Cria um objeto (prédios, pistas e outros cenários).
* [[Image:Editor_Pickup.png]] Cria um pickup (vida, munição, armas e outros customizados).
* [[Image:Editor_Marker.png]] Cria um marcador (''checkpoint'', anel, cilindro, seta e ''corona'').
* [[File:Crosshair.png‎]] Seleciona um objeto.
* [[Image:Editor_WorldObjectRemover.png]] Deleta um objeto do mundo.
{{Dica|Se você tiver um [[PT-BR/Resource:Editor-EDF|EDF]] carregado, poderá usar a rolagem (scroll) do mouse para entrar no menu de elementos customizados.}}

==Usando o editor==
Esta seção explica como criar e modificar mapas.

===Andando pelo mapa===
Quando o editor estiver carregado, você estará no ''modo câmera'', ou seja, poderá usar as teclas '''WSAD''' para se mover e usar o mouse para rotacionar. Quando estiver andando, podes pressionar a tecla '''ALT''' para mover-se mais lentamente ou '''SHIFT''' para ir mais rápido.

Para acessar a interface do editor, deves mudar para o ''modo cursor''. Para trocar entre os dois modos, aperte a tecla '''F'''. Quando estiver no modo cursor, sua visão ficará parada e poderá usar o mouse para tanto manipular elementos e usar os itens do menu.

O modo câmera sempre terá uma mira no centro da tela. Ela serve para selecionar elementos e movê-los da mesma forma como se estivesse com o cursor.

[[Image:Editor_Crosshair.png|center]]

===Criando um mapa===
* Inicie o editor, ou se já estiver iniciado, clique no ícone ''Novo Mapa''.
* Clique no ícone ''Configurações do Mapa''.
:* Vá na aba ''Meta'' e preencha o nome dele e o seu apelido nos campos (Name) e (Author), respectivamente.
:* Abra também a aba ''Gamemodes'' e adicione os modos de jogo compatíveis com mapa - eles serão adicionados para a lista de gamemodes compatíveis (''Added gamemodes'') ao lado.
:* Para fazer a ação citada a cima, selecione um item da primeira lista e clique em ''Add'' ou clique duas vezes em cima dele. Quando terminar, clique em OK.
[[Image:Editor_Mapsettings.png|center]]
* Clique na opção ''Definições do Mapa'' (a pasta verde) e adicione recursos dos quais desejas usar elementos customizados. Eles obviamente devem ser os gamemodes adicionados no item ''Configurações do Mapa''. Para mais informações sobre definições do editor, veja a página [[PT-BR/Resource:Editor-EDF|EDF]]. Vá em OK quando terminar.

===Criando elementos===
Adicionar novos elementos para seu mapa, como veículos e objetos é bem fácil.
* Se estiver no modo câmera, mude para o cursor ao clicar em '''F'''.
* Clique no ícone do elemento que desejas criar no canto inferior esquerdo. Ex: no botão com um carrinho para criar um veículo.
* O novo elemento será criado interligado ao seu cursor. Mova ele para o local desejado e aperte o '''botão esquerdo''' do mouse para confirmar.

[[Image:Editor_Addelem.png|center]]

Para criar elementos customizados de um recurso específico, posicione o mouse em cima do menu de elementos, use a roleta dele para alternar entre menus até os elementos do recurso desejado aparecerem. Lembrando, para isso funcionar, deves adicionar o [[PT-BR/Resource:Editor-EDF|EDF]] do recurso na opção ''Definições do Mapa''.

[[Image:Editor_Selectedf.png|center]]

===Selecionando===
* Selecione um elemento com o botão '''esquerdo''' do mouse no ''modo câmera''.
* Selecione um elemento com o botão '''direito''' do mouse no ''modo cursor''.
* Aperte '''espaço''' ou clique em uma área vazia para desselecionar.

Se estiver selecionado, em cima do elemento aparecerá um sinal amarelo. Elementos, principalmente objetos, sem muita colisão podem ser selecionados ao ativar o ''modo de alta precisão'' ao pressionar o botão ''E''. Isso aumenta a sensibilidade e a mira fica vermelha para indicar isso.

A janela ''Current elements'' (elementos do mapa) pode também ser usada para seleciona-los. É só clicar duas vezes em cima do item.

===Movendo===
Existem diferentes maneiras de se mover um elemento.

'''Com o mouse'''
* Selecione-o e mova com o '''botão esquerdo''' do mouse.
Ou:
* Selecione-o no modo mouse com o '''botão direito''', e mova-o aonde quiser, e clique para largar.

Podes também mover um objeto para frente e trás a partir da câmera selecionando-o com o botão direito e usando a rolagem do mouse.

'''Com o teclado'''
* Selecione um elemento com o '''botão esquerdo'''.
* Use as teclas com setas para mover o elemento no plano horizontal e '''Page Up'''/'''Page Down''' para mover verticualmente. Pressione '''ALT''' para mover mais lentamente e '''SHIFT''', mais rapidamente.

Por padrão, os elementos não estão travados nos eixos, portanto irão "entortar" quando for movido. Isso pode ser mudado no menu ''Opções''.

===Rotacionando===
'''Com o mouse'''

Podes rotacionar o elemento selecionado no eixo Z com a rolagem do mouse.
* Selecione o elemento no ''modo câmera'' com o '''botão direito''' e use a rolagem do mouse segurando '''CTRL esquerdo'''.
Ou:
* Selecione o elemento no ''modo cursor'' com o '''botão esqurdo''' e segure '''CTRL''' e role com o mouse.

'''Com o teclado'''
* Selecione o elemento com o '''botão esquerdo'''.
* Use '''CTRL''' (o sinal amarelo ficará verde) e use as setas, '''Page Up'''/'''Page Down''' para rotacionar o elemento em diferentes eixos.

Segure '''ALT''' para mover mais lento e '''SHIFT''' para mais rápido nos dois jeitos citados acima.

[[Image:Editor_Rotateelem.png|center]]

===Mudando o modelo e outras propriedades===
A maioria dos elementos tem uma variedade de propriedades modificadores de sua aparência e comportamento. Exemplos são o modelo, cor e ''tunagem'' de um carro.

* Abra a janela de propriedades do elemento clicando duas vezes nele ou apertando '''F3'''.
* Faça as alterações necessárias. Por exemplo, para mudar o modelo do carro ou objeto, clique no botão '''Browse''' e escolha na lista que se abrirá.
* Clique em OK quando terminar ou Cancel para desfazer as alterações.

[[Image:Editor_Props.png|center]]

===Clonando===
Podes clonar um elemento ao selecioná-lo e apertar '''C''' no teclado.

* No modo câmera, o elemento será preso ao seu cursor. Use o botão esquerdo do mouse para solta-lo.
* No modo cursor, o elemento clonado será posicionado no mesmo lugar do original.

Se segurar '''CTRL''' quando estiver clicando, o elemento será clocando novamente e será preso ao cursor. Isso ajuda quando se estiver posicionando grandes quantidades de algo.

De maneira alternativa, podes usar o botão ''Pullout'' localizado no canto direito da janela de propriedades para clonar o elemento.

===Deletando===
Simplesmente selecione um elemento e pressione '''Delete''' no teclado.

De maneira alternativa, use o botão ''Pullout'' localizado no canto direito inferior da janela de propriedades para deletar o elemento.

==Criando mapas para gamemodes específicos==
Para fazer um mapa para um gamemode desejado, deves fazer duas coisas:
* Clique no item '''Configurações do Mapa''' no menu principal, vá na aba '''Gamemodes'' e adicione quaisquer modos de jogo compatíveis com seu mapa.
* Vais precisar adicionar um ou mais [[PT-BR/Resource:Editor-EDF|EDF's]]. Isso permite seu mapa criar elementos customizados pelo gamemode, como spawnpoints, checkpoints do race, ou bandeiras do CTF. Para isso, clique na pastinha verde (Definições do Mapa) e adicione os gamemodes necessários.

==Controles==
A seguir há uma lista de todos os controles padrões. Para muda-los, vá nas configurações do MTA enquanto o Editor estiver rodando.

===Câmera===
{|
|-
| mover_para_frente
| '''w'''
|-
| mover_para_trás
| '''s'''
|-
| mover_para_esquerda
| '''a'''
|-
| mover_para_direita
| '''d'''
|-
| modo_de_alta_precisão
| '''e'''
|}

===Clonar===
{|
|-
| clonar_elemento_selecionado
| '''c'''
|-
| clonar_sucessivamente
| '''lctrl''' || ''(CTRL da esquerda)''
|}

===Manipulação de Elemento===
{|
|-
| mover_para_frente
| '''arrow_u''' || ''(Seta p/ Cima)''
|-
| mover_para_trás
| '''arrow_d''' || ''(Seta p/ Baixo)''
|-
| mover_para_esquerda
| '''arrow_l''' || ''(Seta p/ Esquerda)''
|-
| mover_para_direita
| '''arrow_r''' || ''(Seta p/ Direita)''
|-
| mover_para_baixo
| '''pgdn''' || ''(Page Down)''
|-
| mover_para_cima
| '''pgup''' || ''(Page Up)''
|-
| ampliar_visão
| '''mouse_wheel_down'''
|-
| diminuir_visão
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| ativar_gui
| '''F4'''
|-
| ativer_cursor
| '''f'''
|-
| selecionar_algo_no_modo_câmera
| '''mouse1''' || ''(Left Mouse button)''
|-
| selecionar_algo_no_modo_cursor
| '''mouse2''' || ''(Right Mouse button)''
|-
| próximo_edf
| '''mouse_wheel_up'''
|-
| edf_anterior
| '''mouse_wheel_down'''
|-
| desfazer
| '''Ctrl''' + '''z'''
|-
| refazer
| '''Ctrl''' + '''y'''
|-
| abrir_propriedades_do_elemento
| '''F3'''
|-
| seleção_de_modelo_para_cima
| '''arrow_u''' || ''(Arrow key Up)''
|-
| seleção_de_modelo_para_baixo
| '''arrow_d''' || ''(Arrow key Down)''
|-
| seleção_de_modelo_ampliar
| '''mouse_wheel_up'''
|-
| seleção_de_modelo_reduzir
| '''mouse_wheel_down'''
|-
| seleção_de_modelo_confirmar
| '''enter'''
|-
| elementos_do_mapa_para_cima
| '''num_8''' || ''(Numpad key 8)''
|-
| elementos_do_mapa_para_baixo
| '''num_2''' || ''(Numpad key 2)''
|-
| entrar_no_modo_teste
| '''F5'''
|}

==Multiplayer==
O editor foi programado em ambos os lados do cliente e servidor, portanto ele suporta multijogadores em um mesmo servidor normalmente. Para fazer um mapa com alguém, copie todos os recursos presentes na pasta ''../server/mods/deathmatch/[editor]'' para seu servidor e o inicie com '''start editor''' no console.

Lembre-se que ainda falta um sistema de permissões para o editor, portanto qualquer usuário poderá ter acesso a todas as opções do menu.

==Plugins e recursos externos==
''Artigo Principal:'' [[Resource:Editor/Plugins]] (Em Inglês)

O editor permite uma importação básica de elementos através de recursos externos. Isso é muito útil para aqueles que precisam manipular elementos de uma maneira específica não podendo ser feita pelo editor. Por exemplo, um recurso que utiliza modelos customizados (fazendo isso a partir de seu script) deverá utilizar esta interface para que o editor possa os gerenciar.

Ao usar o comando '''import <nome-do-Recurso>''' no console, todos os elementos do recurso serão importados para o editor.

==FAQ==
==== Aparece uma tela preta quando estiver iniciando o Editor de Mapas ====

Geralmente a causa disso é a instalação incorreta dos recursos pertencentes ao Map Editor. Se estiver usando uma versão estável do MTA, por gentileza, instale-o novamente e certifique-se que marcou a opção "Cliente e Servidor" na hora da instalação.

Se estiver usando uma versão ''nightly'', para corrigir isso deverá baixar o [https://code.google.com/p/mtasa-resources/downloads/list último pacote de recursos] hospedado no Google Code. Descompacte o arquivo e coloque seu conteúdo em:
''MTA San Andreas/server/mods/deathmatch/resources'' , onde ''MTA San Andreas'' é a pasta de instalação do MTA (O diretório padrão é: C:\Arquivos de Programas\MTA San Andreas).

{{Dica|Colar os arquivos na pasta ''MTA San Andreas/mods/deathmatch/resources'' é um '''erro muito comum''' - e não funcionará se feito isso. Então, lembre-se de colocar no lugar certo.}}

Se esse erro continuar a ocorrer, mesmo feito todos os passos e verificado se a instalação foi bem sucedida, pode ser que haja algum problema com o arquivo '''acl.xml'''. Você pode baixar o original [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml clicando aqui]. Ele deverá ser colado em: '''../server/mods/deathmatch/''', onde ".." é a pasta de instalação do MTA.

==== Quando uso o botão "Map Editor" aparece o erro: "Could not start the local server. See console for details" ====
Isso porque você não possui um arquivo ''editor.conf'' válido. O original pode ser baixado [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf aqui]. Ele deverá ser colado em '''../server/mods/deathmatch/''', onde ".." é a pasta de instalação do MTA.

==== Eu salvei um mapa mas não posso localiza-lo no diretório de recursos, mesmo o Editor sendo capaz de reconhecê-lo ====
Isso acontece porque o Windows Vista/7 impõe limites de escrita para aplicativos em execução que não possuem permissão de administrador. Então os arquivos são redirecionados para pasta "VirtualStore" em vez do "Arquivos de Programas". Podes localizar seu mapa no diretório:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Arquivos de Programa\MTA San Andreas\server\mods\deathmatch\resources\

Ao rodar o Servidor/MTA San Andres com os privilégios de Administrador irá fazer com que seus mapas sejam salvos no local apropriado.

==== Eu tenho outros problemas com o Editor ====

Algumas vezes, o reinstalando pode resolver. O jeito mais fácil é instalar o MTA:SA em uma nova pasta. Em contrapartida, podes tentar os passos a seguir:
::1. Vá a pasta de recursos, '''../server/mods/deathmatch/resources/ e delete a pasta '''editor_dump'''
::2. Vá a pasta de recursos, '''../server/mods/deathmatch/resources/ e delete a pasta '''editor_test'''

==== Encontrei um bug ou tenho uma sugestão/elogio ao Editor de Mapas ====
Use a página oficial do ''[https://github.com/multitheftauto/mtasa-blue/issues bugtracker]'' para reportar o bug. Ou sinta-se a vontade de entrar em nosso [https://discord.com/invite/mtasa Discord].

[[hu:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]
[[tr:Resource:Editor]]
[[pt-br:Resource:Editor]]

Resource:Editor

2022-01-29T13:53:27Z

Vampire:

{{Resource page}}
The MTA:SA map editor allows you to create maps for gamemodes.

==Starting==
To start the editor, simply click the "Map editor" menu item in the main MTA menu.

==Menus==
Once the editor has started, you are presented with two menu bars: the main menu at the top, and the element menu in the lower left.

===Main menu===
These are the buttons in the main menu:
* [[Image:Editor_New.png]] Create a new map.
* [[Image:Editor_Open.png]] Open an existing map.
* [[Image:Editor_Save.png]] Save the map you're working on.
* [[Image:Editor_Save_as.png]] Save your map under a different name.
* [[Image:Editor_Options.png]] Alter general map editor settings.
* [[Image:Editor_Undo.png]] Undo the last action.
* [[Image:Editor_Redo.png]] Restore the last undone action.
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use.
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.

===Element menu===
The element menu is used to add new elements to the map.
* [[Image:Editor_Vehicle.png]] Create a new vehicle.
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons and custom).
* [[Image:Editor_Marker.png]] Create a new marker (checkpoint, ring, cylinder, arrow and corona).
* [[File:Crosshair.png‎]] Select world object.
* [[Image:Editor_WorldObjectRemover.png]] Delete world object.
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.

==Using the editor==
This section explains how to create and modify maps.

===Moving around the map===
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WASD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.

To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.

Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.

[[Image:Editor_Crosshair.png|center]]

===Starting a new map===
* Start the editor, or if it is already started, click the ''New'' menu button.
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.
[[Image:Editor_Mapsettings.png|center]]
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.

===Creating new elements===
Adding elements to your map, such as vehicles and objects, is very straightforward.
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.

[[Image:Editor_Addelem.png|center]]

To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.

[[Image:Editor_Selectedf.png|center]]

===Selecting===
* '''Left click''' an element to select it in ''keyboard mode''.
* '''Right click''' it to select it in ''mouse mode''.
* Press the '''Spacebar''' or click in an empty area to deselect.

The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.

The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.

===Moving===
Moving elements can be done in several ways.

'''With the mouse'''
* Simply drag and drop with the '''left mouse button'''.
Or:
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.

You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.

By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.

===Rotating===
'''With the mouse'''

You can rotate selected elements around the Z axis with the mouse wheel.
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.
Or:
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.

With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.

[[Image:Editor_Rotateelem.png|center]]

===Changing model and other properties===
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.

* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.
* Click OK when you're done.

[[Image:Editor_Props.png|center]]

===Cloning===
You can clone an element by selecting it and pressing '''C'''.

* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.
* In keyboard mode the cloned element will be cloned in the identical position.

If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.

===Deleting===
Simply select the element and press '''DEL''' ''(Delete)''.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.

==Creating maps for specific gamemodes==
To make a map for a specific gamemode, you have to do two things:
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.

==Controls==
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.

===Camera===
{|
|-
| camera_move_forwards
| '''w'''
|-
| camera_move_backwards
| '''s'''
|-
| camera_move_left
| '''a'''
|-
| camera_move_right
| '''d'''
|-
| high_sensitivity_mode
| '''e'''
|}

===Cloning===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Element manipulation===
{|
|-
| element_move_forward
| '''arrow_u''' || ''(Arrow key Up)''
|-
| element_move_backward
| '''arrow_d''' || ''(Arrow key Down)''
|-
| element_move_left
| '''arrow_l''' || ''(Arrow key Left)''
|-
| element_move_right
| '''arrow_r''' || ''(Arrow key Right)''
|-
| element_move_downwards
| '''pgdn''' || ''(Page Down)''
|-
| element_move_upwards
| '''pgup''' || ''(Page Up)''
|-
| zoom_in
| '''mouse_wheel_down'''
|-
| zoom_out
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| toggle_gui_display
| '''F4'''
|-
| toggle_cursor
| '''f'''
|-
| select_target_keyboard
| '''mouse1''' || ''(Left Mouse button)''
|-
| select_target_mouse
| '''mouse2''' || ''(Right Mouse button)''
|-
| edf_next
| '''mouse_wheel_up'''
|-
| edf_prev
| '''mouse_wheel_down'''
|-
| undo
| '''Ctrl''' + '''z'''
|-
| redo
| '''Ctrl''' + '''y'''
|-
| properties_toggle
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| browser_zoom_in
| '''mouse_wheel_up'''
|-
| browser_zoom_out
| '''mouse_wheel_down'''
|-
| browser_confirm
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| toggle_test
| '''F5'''
|}

==Multiplayer==
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.

Please note that currently the editor lacks any permissions system, so all users have access to every function.

==Plugins & External resources==
{{Main|Resource:Editor/Plugins}}

The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor.

By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.

==FAQ==
==== I get a black screen when launching the Map Editor ====

Usually this is caused due to incorrect installation of Map Editor resources. If you are using a stable MTASA client, please install it again and make sure that you use Client and Server install option.

If you are using a nightly build, to get it working right you need to download latest [https://github.com/multitheftauto/mtasa-resources resources (step 3)], unpack the archive and put its contents in:
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).

Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.

If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can find the default one [https://github.com/multitheftauto/mtasa-blue/blob/master/Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====
This is because you do not have a valid editor.conf installed. You can find the default one [https://github.com/multitheftauto/mtasa-blue/blob/master/Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====
This is due to the fact that Vista/7 limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" directory instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.

==== I have some other problem with the map editor ====

Sometimes resetting the map editor will solve certain issues. The easiest way to do that is install MTA:SA to a brand new folder. Otherwise you can try the following steps:
::1. Go to the resources folder, '''server/mods/deathmatch/resources/''' and delete the '''editor_dump''' directory
::2. Go to the resources folder, '''server/mods/deathmatch/resources/''' and delete the '''editor_test''' directory

==== I have found a bug or have a suggestion/feedback for the map editor ====
Please use the official [https://github.com/multitheftauto/mtasa-blue/issues github issues] for reporting bugs. Feel free to also join us on [http://www.mtasa.com/discord Discord].

[[hu:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]
[[tr:Resource:Editor]]
[[pt-br:Resource:Editor]]

How you can help

2022-01-29T13:20:06Z

Vampire:

__NOTOC__
Multi Theft Auto has loads of areas in which you can help us. In turn, we'll be more than happy to help you get started with any ideas you have, help test them and - if they're good enough - release them to the whole community. This page outlines the key areas you could do something in, of course, there are many things we've not thought of, so think outside the box!

==Coding for MTA:SA==
* Become a patch contributor by sending [https://github.com/multitheftauto/mtasa-blue/pulls pull requests] to MTA, containing requested features or bugfixes. ([[Coding guidelines]])
* Translate MTA:SA to your native language - https://translate.multitheftauto.com/

==Scripting==
* Become a contributor to MTA's official resources by sending [https://github.com/multitheftauto/mtasa-resources/pulls pull requests] to our resources repository
* Create and [https://community.mtasa.com/ publish] a gamemode or useful script
**[[Scripting Introduction]]
**[https://www.lua.org/pil/index.html "Programming in Lua" Manual]
* Make a general purpose resource that provides useful functions to other resources.

==Mapping==
* Create and [https://community.mtasa.com/ publish] a map for an existing gamemode, with the map editor.
**[[Resource:Editor|Map Editor Manual]]

==Web development==
* Create your own system for statistics - using the [[PHP SDK]] as a basis. Join the [https://discord.gg/RygaCSD MTA discord] (or [https://discord.gg/GNN6PRtTnu development discord]) for help.

==Documentation==
Before you make changes check out: [[Help:Editing Guidelines|Editing Guidelines]] and [[Help:MTA Wiki Specific Templates|Specific Templates]]
* Finish documentation for [[:Category:Incomplete|Incomplete functions]] - ask in #mta.scripting if you're not sure of something.
* Add examples to [[:Category:Needs Example|functions & events missing examples]] - please '''test''' them, and again, ask if you need help.
* Review and verify [[:Category:Needs Checking|pages that need checking]] - make sure highlighted issues are solved before removing pages from the category.
* Expand the pages that explain [[:Category:Scripting_Concepts|MTA core concepts]].
* Write [https://forum.mtasa.com/forum/123-tutorials/ tutorials] to help new people.
* Translate the wiki pages so people from other countries can get started in MTA too.
* Create documentation for undocumented functions and events [[Undocumented Items]]
* Keep 'changes in' [current work-in-progress: https://wiki.multitheftauto.com/wiki/Changes_in_1.5.9] for future releases updated.

==Quality Assurance==
* [https://github.com/multitheftauto/mtasa-blue/issues Report issues] with the mod, make sure to do a search on the already reported issues first.
* Test and confirm existing reported issues.
* Use the newest build of MTA to detect and report new bugs, by going to 'Settings', 'Advanced', 'Update build type' and choosing 'Nightly' or get it regularly [https://nightly.mtasa.com/ from here].
* Any bugs which are related to a scripting function / event and present in the main release (rather than nightlies), document that bug by adding a [https://wiki.multitheftauto.com/wiki/Help:MTA_Wiki_Specific_Templates warning] to the wiki page to save other scripters a lot of time.

==Specific tasks==
* Create a fuzzer to check for crashes in our scripting functions.

==Grant==
You can donate to MTA:SA [https://mtasa.com/donate/manage.php here]

[[en:How you can help]]
[[ru:How you can help]]
[[pl:Jak możesz pomóc]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[hu:How you can help]]
[[tr:Nasıl yardımcı olabilirsiniz]]
[[pt-br:Como você pode ajudar]]