Multi Theft Auto: Wiki - User contributions [en]

DxDrawBluredRectangle

2024-12-09T18:13:51Z

Turret001: Reverted edits by Borsuczyna (talk) to last revision by Fixelly

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
This function draws a 2D blured rectangle on the screen - rendered for one frame. This should be used in conjunction with onClientRender for continuous display.

== Syntax ==
<syntaxhighlight lang="lua">
bool dxDrawBluredRectangle ( float x, float y, float width, float height )
</syntaxhighlight>

=== Required Arguments ===
* '''x:''' An float representing the '''absolute''' origin X position of the rectangle, represented by pixels on the screen.
* '''y:''' An float representing the '''absolute''' origin Y position of the rectangle, represented by pixels on the screen.
* '''width:''' An float representing the width of the rectangle, drawn in a ''right'' direction from the origin.
* '''height:''' An float representing the height of the rectangle, drawn in a ''downwards'' direction from the origin.

=== Required Files ===
[https://cdn.discordapp.com/attachments/851000636484747274/861170045651910686/mta-helper.fx mta-helper.fx],
[https://cdn.discordapp.com/attachments/851000636484747274/861170037255307294/blurV.fx blurV.fx],
[https://cdn.discordapp.com/attachments/851000636484747274/861170034495455232/blurH.fx blurH.fx]

=== Returns ===
Returns true if the operation was successful, false otherwise.

== Code ==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local scx, scy = guiGetScreenSize()

Settings = {}
Settings.var = {}
Settings.var.blur = 1
Settings.var.optim = 4
Settings.screenRectangle = {}

local current

function createShader()
myScreenSource = dxCreateScreenSource( scx/Settings.var.optim, scy/Settings.var.optim )
blurHShader,tecName = dxCreateShader( "shaders/blurH.fx" )
blurVShader,tecName = dxCreateShader( "shaders/blurV.fx" )
bAllValid = myScreenSource and blurHShader and blurVShader
end
createShader()

function preRender ()
if not Settings.var then
return
end
RTPool.frameStart()
dxUpdateScreenSource( myScreenSource )
current = myScreenSource
current = applyGBlurH( current, Settings.var.blur )
current = applyGBlurV( current, Settings.var.blur )
dxSetRenderTarget()
end
addEventHandler ("onClientRender", root, preRender)

function dxDrawBluredRectangle (pos_x, pos_y, size_x, size_y, color)
if bAllValid then
dxDrawImageSection ( pos_x, pos_y, size_x, size_y, pos_x/Settings.var.optim, pos_y/Settings.var.optim, size_x/Settings.var.optim, size_y/Settings.var.optim, current, 0,0,0, color)
end
end

function applyGBlurH( Src, blur )
if not Src then return nil end
local mx,my = dxGetMaterialSize( Src )
local newRT = RTPool.GetUnused(mx,my)
if not newRT then return nil end
dxSetRenderTarget( newRT, true )
dxSetShaderValue( blurHShader, "TEX0", Src )
dxSetShaderValue( blurHShader, "TEX0SIZE", mx,my )
dxSetShaderValue( blurHShader, "BLUR", blur )
dxDrawImage( 0, 0, mx, my, blurHShader )
return newRT
end

function applyGBlurV( Src, blur )
if not Src then return nil end
local mx,my = dxGetMaterialSize( Src )
local newRT = RTPool.GetUnused(mx,my)
if not newRT then return nil end
dxSetRenderTarget( newRT, true )
dxSetShaderValue( blurVShader, "TEX0", Src )
dxSetShaderValue( blurVShader, "TEX0SIZE", mx,my )
dxSetShaderValue( blurVShader, "BLUR", blur )
dxDrawImage( 0, 0, mx,my, blurVShader )
return newRT
end

RTPool = {}
RTPool.list = {}

function RTPool.frameStart()
for rt,info in pairs(RTPool.list) do
info.bInUse = false
end
end

function RTPool.GetUnused( mx, my )
for rt,info in pairs(RTPool.list) do
if not info.bInUse and info.mx == mx and info.my == my then
info.bInUse = true
return rt
end
end

local rt = dxCreateRenderTarget( mx, my )
if rt then
RTPool.list[rt] = { bInUse = true, mx = mx, my = my }
end
return rt
end</syntaxhighlight>
</section>

== Example ==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local scx, scy = guiGetScreenSize()

function drawBluredRectangle()
dxDrawBluredRectangle( scx/3.8, scy/3.8, scx/2.02, scy/2 )
end

addEventHandler("onClientRender", root, drawBluredRectangle)</syntaxhighlight>
</section>

===== Author: fiXlly, WaRuS =====

How you can help

2022-02-15T23:07:51Z

Turret001: updated current work-in-progress

__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.6] 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]]

PT-BR/Resource:Editor

2022-01-23T17:19:18Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{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.
{{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]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]

HU/Resource:Editor

2022-01-23T17:19:08Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{Resource page}}
Az MTA:SA map editor lehetővé teszi, hogy mapokat hozzon létre gamemode-ok számára.

==Kezdés==
Az editor elindításához csak egyszerűen kattintson a "Map editor" menüpontra az MTA főmenüjében.

==Menük==
Miután elindult az editor, két menüsáv fog megjelenni: a főmenü a tetején, és az elem menü a bal alsó sarokban.

===Főmenü===
Ezeket a gombokat láthatja a főmenüben:
* [[Image:Editor_New.png]] Új map létrehozása.
* [[Image:Editor_Open.png]] Meglévő map megnyitása.
* [[Image:Editor_Save.png]] Az aktuális map elmentése.
* [[Image:Editor_Save_as.png]] A map elmentése egy másik névre.
* [[Image:Editor_Options.png]] Az általános map editor beállításainak módosítása.
* [[Image:Editor_Undo.png]] Az utolsó művelet visszavonása.
* [[Image:Editor_Redo.png]] Visszaállítja az utolsó befejezetlen műveletet.
* [[Image:Editor_Locations.png]] A játék tárolt helyszínei. Az editor tartalmaz egy jelentős mértékű Interior helyszínt a San Andreas-ból, emellett készíthet saját interiort és non-interior helyszínt a listához.
* [[Image:Editor_Current_elements.png]] Listázza a map összes elemét (objektek, járművek, marker-ek, pickup-ok, stb.)
* [[Image:Editor_Map_settings.png]] A map sajátos beállításai, mint pl. a napszak, gravitáció stb. Itt megadhatja, hogy a map milyen gamemódokkal legyen kompatibilis.
* [[Image:Editor_Definitions.png]] Töltse fel az [[HU/Resource:Editor/EDF|editort definiáló fájlokat (EDF)]], amelyeket használni szeretne.
* [[Image:Editor_Test.png]] Play mode-ba helyez, hogy kipróbálhassa a mapot. Ez betölti a gamemode-ot, amelyre a map készült.

===Elem menü===
Az elem menü a maphoz új elemek hozzáadására szolgál.
* [[Image:Editor_Vehicle.png]] Egy új jármű létrehozása.
* [[Image:Editor_Object.png]] Egy új object létrehozása (épületek, utak és más elemek).
* [[Image:Editor_Pickup.png]] Egy új pickup létrehozása (health, armor, weapons and custom).
* [[Image:Editor_Marker.png]] Egy új marker létrehozása (checkpoint, ring, cylinder, arrow and corona).
* [[File:Crosshair.png‎]] World object kiválasztása.
Ezen kívül, ha [[HU/Resource:Editor/EDF|van betöltött editort definiáló fájl (EDF)]], akkor görgethet az egérrel a menüben, hogy előhozza az egyedi elemeket.

==Az editor használata==
Ez a rész ismerteti a mapok létrehozásának és módosításának módját.

===Mozgás a map körül===
Amikor először elindítja az editort, akkor ''camera mode''-ban van. A '''WSAD''' gombokkal és az egérrel mozgathatja a kamerát. Mozgás közben az '''ALT''' lenyomásával lassíthatja, vagy a '''SHIFT'''-el gyorsíthatja a kamera mozgását.

Az editor kezelőfelületének és a kezelőpaneljének eléréséhez át kell váltania 'kurzor módba'. Az '''F''' gomb használatával tud váltani a kurzor mód és a kamera mód között. Kurzor módban a nézet rögzített, és az egérrel tudja mozgatni az elemeket és használni a grafikus felületet.

A kamera módot a képernyő közepén található kereszttel lehet felismerni. Használhatja az elemek kijelöléséhez és mozgatásához, csakúgy, mint a kurzor módban.

[[Image:Editor_Crosshair.png|center]]

===Egy új map indítása===
* Indítsa el az editort, vagy ha már elindította kattintson a ''New'' menü gombra.
* Kattintson a ''Map settings'' gombra. A ''Meta'' fülben töltse ki a Name és az Author mezőket a map nevével, illetve az Ön nevével. Valamint nyissa meg a ''Gamemodes'' fület, és addja hozzá azokat a gamemódokat, amelyekre a map készült (''Added gamemodes'' listához lesznek helyezve). Ezt úgy teheti meg, hogy kiválasztja őket, majd rákattint az ''Add'' gombra, vagy kétszer rájuk kattint. Majd kattintson az OK-ra, ha készen van.
[[Image:Editor_Mapsettings.png|center]]
* Kattintson a ''Definitions'' ablakra és adja hozzá azokat a resource-okat, amelyekhez az egyéni elemeket szeretné használni. Ezek a "Map settings" ablakban kiválasztott gamemode-ekből és esetleges további resource-kből állnak. További infórmáciért az editor definitions-ról olvassa el az [[HU/Resource:Editor/EDF|EDF]] oldalt. Majd kattintson az OK-ra, ha készen van.

===Új elem létrehozása===
Nagyon egyszerűen adhat hozzá elemeket a maphoz, például járműveket, objekteket.
* Ha kamera módban van, akkor váltson kurzor módba az '''F''' megnyomásával.
* Kattintson az element menüben lévő gombra, amely a kívánt tartalmat jelöli. Például kattintson a jármű gombra egy jármű hozzáadásához.
* A kiválasztott típus egy új eleme lesz létrehozva és hozzácsatolva a kurzorhoz. Helyezze arra a helyre, ahova szeretné, és a '''bal egérrel''' engedje el.

[[Image:Editor_Addelem.png|center]]

Egyéni elemek létrehozásához, melyek a resource-ra jellemzőek vigye az egerét az element menü fölé, és görgessen addig, míg a kívánt resource elő nem jön. Vegye figyelembe, hogy ennek működése érdekében hozzá kell adnia a resource [[Resource:Editor/EDF|EDF]] fájlját a ''Definitions'' ablakba.

[[Image:Editor_Selectedf.png|center]]

===Kiválasztás===
* A '''bal egérrel''' kattintson egy elemre, hogy kiválassza azt ''billentyűzet módban''.
* A '''jobb egérrel''' kattintson hogy kiválassza azt ''egér módban''.
* Nyomja meg a '''Szóközt''', vagy kattintson egy üres területre a kijelölés megszüntetéséhez.

A kiválasztott elemeket, ha van, sárga kurzorral jelöltük. Kevés collisionnal rendelkező elemeket (különösen az objektek) könnyen észlelni tudjuk a ''High sensitivity mode'' aktiválásával az '''E''' gomb lenyomásával.

A ''Current elements'' is használható az elemek kiválasztásához. A listában szereplő elemre való dupla kattintás kiválasztja azt ''billentyűzet módba''.

===Mozgatás===
Az elemeket többféle módon is tudja mozgatni.

'''Az egérrel'''
* Egyszerűen csak húzza, majd tegye le a '''bal egérgombbal'''.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), vigye oda, ahová szeretné, majd tegye le.

A kameramód használatával is tudja az elemek ''távolságát'' állítani, hogy távolabb, vagy közelebb legyen a kamerához, '''jobb egérrel''' kattintson az elemre majd görgessen az egérrel '''egérgörgő'''.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Használja a '''nyilakat''' az elem vízszintes való mozgatásához, és a '''PgUp'''/'''PgDn''' a függőleges mozgatáshoz. Tartsa lenyomva az '''ALT''' gombot a mozgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.
Alapértelmezetten az elemek relatívan mozognak a kamerához, és nincsenek tengelyükhöz rögzítve. Ezt le tudja tiltani az ''Options'' menüben.

===Forgatás===
'''Az egérrel'''

A kiválasztott elemeket a Z tengely körül elforgathatja az egérgörgővel.
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''') majd görgesse az egeret, míg a '''Left CTRL'''-t lenyomva tartja.
vagy:
* Válassza ki az elemet egér módban ('''jobb egér'''), tartsa lenyomva a '''CTRL'''-t, és görgessen az egérrel.

'''A billentyűzettel'''
* Válassza ki az elemet billentyűzet módban ('''bal egérgomb''').
* Amíg lenyomva tartja a '''CTRL'''-t (a kijelölési marker zöldre vált), használja az '''arrow keys''' és a '''PgUp'''/'''PgDn''', hogy az elemet eltérő tengelyek körül forgassa.

Ezen felül mind a két módszernél lenyomva tarthatja az '''ALT''' billentyűt a forgási sebesség csökkentéséhez, vagy a '''SHIFT'''-et a növeléséhez.

[[Image:Editor_Rotateelem.png|center]]

===Modell és egyéb tulajdonságok módosítása===
A legtöbb elemnek számos modosítási lehetősége van, melyeknek a megjelenésük és a viselkedésük megváltoztatható. Például a modellek, szín és vizuális változásokat is végezhetünk.

* Nyissa meg egy elem 'properties' ablakát dupla kattintással, vagy az '''F3''' megynyomásával.
* Végezzen olyan módosításokat, amelyeket szeretne. Például, egy autó vagy objekt modelljének megváltoztatásához kattintson a '''Browse''' gombra, mely a "model" mellett található.
* Majd kattintson az OK-ra, ha készen van.

[[Image:Editor_Props.png|center]]

===Klónozás===
Az elem kiválasztásával és a '''C''' gomb lenyomásával klónozni tudja azt.

* Egér módban a klónozott elem a kurzorhoz lesz csatolva. Nyomja le a '''bal egeret''', hogy elhelyezze a mapon.
* A billentyűzet módban a klónozott eleme az ugyan abban a helyzetbe klónozódik.

Ha lenyomva tartja a '''CTRL'''-t amíg kattint, akkor az elemet újra klónozza és megint a kurzorhoz lesz csatolva. Így könnyen el tud helyezni sok darabot valamiből.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is klónozhat egy elemet.

===Törlés===
Egyszerűen válassza ki az elemet, majd nyomja meg a '''DEL''' gombot, ''(Delete)''.

Alternatív megoldásként a 'properties' box jobb alsó sarkában lévő ''Pullout'' gomb megnyomásával is törölhet egy elemet.

==Mapok készítése sajátos gamemode-okhoz==
Két dolgot kell tenni a sajátos gamemode-okhoz való mapok készítésekor:
* Kattintson a '''Map Settings''' gombra a fenti menüben, menjen a '''Gamemodes''' fülre, majd adja hozzá azokat a gamemode-okat, amelyket a mapjához szeretne használni.
* Valószínűleg majd hozzá kell adnia egy, vagy több [[HU/Resource:Editor/EDF|editort definiáló fájlt (EDF)]] is. Ez lehetővé teszi, hogy sajátos gamemode elemeket helyezzen a map-ba, mint például spawnpoints, race checkpoints, vagy CTF flags. A '''Definitions''' menü gombjára kattintva hozzáadhatja az EDF-eket a megfelelő gamemode-ekhez.

==Irányítás==
Itt található az alapértelmezett irányítások listája. Ezek megváltoztatásához menjen az MTA beállítások menüjébe, amíg az Editor el van indítva.

===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==
Az '''editor''' két részből épül fel, szerver oldalból, és client oldalból, és ezért támogatja a multiplayer-t is. Az '''editor''' más játékosokkal való használatához egyszerűen csak másolja át az összes '''editor''' resource-ot a szerverébe, indítsa el, majd engedélyezze a játékosok csatlakozását a szerverhez.

Vegye figyelemben, hogy jelenleg az editornak nincs engedélyezési rendszere, szóval minden felhasználó hozzáférhet minden function-hoz.

==Pluginok és külső resource-ok==
{{Main|HU/Resource:Editor/Plugins}}

Az edirot lehetővé teszi külső resource-ból való elemek importálását. Ez olyan resource-ok esetén hasznos, ahol olyan elemeket kell kezelniük, amelyeket már az editor nem képes elvégezni. Például, egy map resource, mely egyéni modelleket használ (és van egy script, ami importálja ezeket a modelleket) nem lehet szerkeszteni alapértelmezetten az editor-ban.

Az '''import <resourceName>''' parancs használatával a resource elemei importálhatóak lesznek az editor-ban.

==Gyakran Ismételt Kérdések==
==== A Map Editor elindításakor fekete képernyő jelenik meg ====

Általában ez a Map Editor resource-ok helytelen telepítése miatt következik be. Ha egy stabil MTASA client-et használ, kérjük teleptíse újra, és győződjön meg róla, hogy a Client and Server telepítési opciót használja.

Ha a nightly build-et használja, frissítse a legújjabb verzióra a megfelelő működéshez [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], csomagolja ki és a tartalmát helyezze a:
''MTA San Andreas\server\mods\deathmatch\resources''-ba, ahol az "MTA San Andreas" az a mappa, ahova az MTA San Andreas-ot telepítette (alapértelmezett hely: C:\Program Files\MTA San Andreas).

Tegye őket erre az elérési útra: MTA San Andreas\mods\deathmatch\resources '''ez egy gyakori hiba''' - nem fog működni, ha nem ide teszi őket. Tehát győződjön meg arról, hogy a "dőlt" útvonalon helyezte el őket.

Ha ez a probléma továbbra is fennáll, még akkor is, ha ellenőrizte a fenti megjegyzést, valamint ellenőrizte, hogy helyesen telepítette-e, talnán azért lehet, mert egy elavult '''acl.xml''' fájlt használ. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== "Map Editor" gomb használatakor ezt az üzenetet kaptam "Nem sikerült elindítani a helyi szervert. Információkért nyissa meg a konzolt" ====
Ez azért van, mert nem egy érvényes editor.conf fájl van telepítve. [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf Itt] letölheti az lapértelmezettet. Ezt az MTA:San Andreas telepítési mappán belül a '''server/mods/deathmatch/''' mappába kell helyeznie.

==== Elmentettem egy mapot, de nem találom a szerverem resources könyvtárában annak ellenére, hogy maga az Editor képes látni azt ====
Ez amiatt van, hogy a Vista/7 limitálja a nem adminként futó programok hozzáférését a Program Files könyvtárhoz. A fájlok az igazi Program Files könyvtár helyett a "VirtualStore"-ba kerülnek. A map resource-ot megtalálhatja egy ehhez hasonló könyvtárban:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

A Server/MTA San Andreas futtatása rendszergazdaként lehetővé teszi, hogy a map a megfelelő helyre kerüljön.

==== Más problémáim vannak a map editor-al ====

Néha az editor újra telepítése számos problémát megoldhat. Ennek legegyszerűbb módja az, ha az MTA:SA-t egy teljesen új mappába telepíti. Vagy kipóbálhatja ezeket a módszereket is:
::1. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_dump''' könyvtárat
::2. Menjen a resources mappába, '''server/mods/deathmatch/resources/''' és törölje ki az '''editor_test''' könyvtárat

==== Találtam egy hibát, vagy javaslatom/visszajelzésem van a map editor-al kapcsolatban ====
Kérjük, hogy a hibák jelentése érdekében használja a [https://github.com/multitheftauto/mtasa-blue/issues bugtracker] oldalt. Bátran csatlakozhat hozzánk az [https://discord.com/invite/mtasa Discord] is.

[[en:Resource:Editor]]
[[ru:Resource:Editor]]
[[es:Resource:Editor]]

==Fordította==
'''2018.11.11.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

RU/Resource:Editor

2022-01-23T17:18:55Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{RU/Resource page}}
Редактор карт MTA:SA позволяет вам создавать карты для игровых модов (gamemode).

==Начало==
Чтобы запустить редактор, просто нажмите на кнопку ''Map editor'' в главном меню MTA.

==Меню==
После запуска вы увидите два меню: главное меню сверху и меню элементов в левом нижнем углу.

===Главное меню===
Это меню состоит из нескольких кнопок:
* [[Image:Editor_New.png]] Создать новую карту.
* [[Image:Editor_Open.png]] Открыть существующую карту.
* [[Image:Editor_Save.png]] Сохранить карту, над которой вы работаете в данный момент.
* [[Image:Editor_Save_as.png]] Сохраните карту под другим именем.
* [[Image:Editor_Options.png]] Другие основные настройки карты.
* [[Image:Editor_Undo.png]] Отменить последнее действие.
* [[Image:Editor_Redo.png]] Восстановить отмененное действие.
* [[Image:Editor_Locations.png]] Сохраненные местоположения игрового мира. Редактор поставляется с большим списком локаций интерьеров San Andreas, но вы можете также добавить к ним свои собственные (как внутренние, так и внешние).
* [[Image:Editor_Current_elements.png]] Список всех элементов, которые содержит карта (Объекты, транспорт, маркеры, пикапы и т.п.)
* [[Image:Editor_Map_settings.png]] Специфические настройки карты, такие как время, гравитация и т.д. Здесь Вы можете также определить, с каким модом (gamemode) будет совместима ваша карта.
* [[Image:Editor_Definitions.png]] Загрузить [[RU/Resource:Editor/EDF|editor definition files (EDF)]], которые вы хотите использовать.
* [[Image:Editor_Test.png]] Вход в игровой режим для живого тестирования вашей карты. Эта функция подгрузит мод, под который написана ваша карта.

===Меню элементов===
Меню элементов используется для добавления новых элементов на карту.
* [[Image:Editor_Vehicle.png]] Создать новую машину.
* [[Image:Editor_Object.png]] Создать новый объект (здания, дороги и другие "декорации").
* [[Image:Editor_Pickup.png]] Создать новый пикап (жизнь, броня, оружие или специфическое).
* [[Image:Editor_Marker.png]] Создать новый маркер (чекпоинт, кольцо, цилиндр, стрела или корона).
* [[Image:Crosshair.png‎]] Выбрать объект из мира.
К тому же, если у вас подгружены [[RU/Resource:Editor/EDF|"editor definitions"]], прокрутка колесиком мыши явит вам новые специфические элементы.

==Использование редактора==
Этот раздел научит вас создавать и редактировать карты.

===Перемещение по карте===
Когда вы запускаете редактор, вы в режиме '''camera mode''' (режим камеры). Используйте клавиши '''WSAD''' для передвижения и мышь для вращения камерой. Если вам нужно перемещать камеру медленнее, зажмите '''ALT''', для быстрого перемещения используйте '''SHIFT'''.

Чтобы получить доступ к интерфейсу и панели управления редактором, перейдите в '''cursor mode''' (режим курсора). Вы можете переключаться между режимом курсора и режимом камеры, нажимая '''F'''. Когда вы в режиме курсора, позиция камеры зафиксирована, и вы можете использовать курсор для управления элементами карты и пользования графическим интерфейсом.

Режим камеры легко узнать по прицелу в середине экрана. В нем вы можете выбирать и двигать элементы, как и в режиме курсора.

[[Image:Editor_Crosshair.png|center]]

===Запуск новой карты===
* Запустите редактор, а если он уже запущен, выберите в меню ''New''.
* Выберите ''Map settings''. В разделе ''Meta'' заполните поля ''Name'' (имя) и ''Author'' (автор) названиями карты и вашим именем соотвественно. Также откройте ''Gamemodes'' и добавьте игровой мод к вашей карте (они будет перемещены в список ''Added gamemodes''). Вы можете сделать это, выбрав их и нажав ''Add'', или двойным кликом по ним. Нажмите OK, когда закончите.
[[Image:Editor_Mapsettings.png|center]]
* Выберите пункт ''Definitions'' и добавьте ресурсы, элементы которых вы хотите использовать. Они будут использованы в игровых модах, которые вы выбрали в окне ''Map settings'', также возможные дополнительные ресурсы. Для более подробной информации о "editor definitions", смотрите здесь [[RU/Resource:Editor/EDF|EDF]]. Нажмите OK, когда закончите.

===Создание новых элементов===
Добавлять новые элементы на карту, такие как транспорт или объекты, очень просто!
* Если вы в режиме камеры, переключитесь в режим курсора нажатием '''F'''.
* Кликните по кнопке в меню элементов, отвечающей за то, что вам нужно. Например, нажмите на кнопку с машиной для того, чтобы добавить транспортное средство.
* Новый элемент выбранного вами типа будет создан и прикреплен к вашему курсору. Передвиньте его на нужное вам место и кликните '''левой кнопкой мыши''', чтобы открепить его.

[[Image:Editor_Addelem.png|center]]

Для создания своих элементов, специфических ресурсу, наведите курсор на меню элементов и крутаните колесиком мыши, пока не появится желаемый ресурс. Заметьте, что для того, чтобы это работало, надо для начача добавить [[RU/Resource:Editor/EDF|EDF]]-файл ресурса в окне ''Definitions''.

[[Image:Editor_Selectedf.png|center]]

===Выбор===
* Кликните '''левой кнопкой мыши''' по элементу, чтобы выбрать его и перейти в '''режим управления с клавиатуры'''.
* Кликните '''правой кнопкой мыши''', чтобы выбрать его и перейти в '''режим управления мышью'''.
* Нажмите '''пробел''' или кликните по пустой области, чтобы снять выделение.

Выбранный элемент, если таковой имеется, выделен желтым коническим маркером сверху. Элементы (в частности объекты) с плохими коллизиями легче выделить, включив '''"режим высокой чувствительности"''', для его активации зажмите клавишу '''E'''. Это увеличивает способность обнаружения за счет точности.

Список всех элементов также может использоваться для выбора элементов. Двойной клик по пункту из списка выберет его в '''режиме управления с клавиатуры'''.

===Перемещение===
Перемещение элементов может быть сделано несколькими способами.

'''С использованием мыши'''
* Просто перетащите элемент в нужное место при помощи '''левой кнопки мыши'''.
Или:
* Выберите элемент в '''режиме управления мышью''' ('''правая кнопка мыши'''), переместите его туда, куда вы хотите, и нажмите на кнопку еще раз.

Вы также можете регулировать положение элемент вдали/вблизи относительно камеры в режиме камеры, для этого выполните '''правый клик''' по элементу, и вращайте '''колесиком мыши'''.

'''С использованием клавиатуры'''
* Выберите элемент в '''режиме управления с клавиатуры''' ('''левая кнопка мыши''').
* Используйте '''клавиши-стрелки''', чтобы перемещать элемент по горизонтали, и '''PgUp'''/'''PgDn''', чтобы перемещать элемент по вертикали. Зажмите '''ALT''', чтобы уменьшить скорость передвижения элемента, или '''SHIFT''', чтобы увеличить скорость перемещения элемента.

По умолчанию, элементы двигаются относительно камеры и не зафиксированы ни по каким осям. Это может быть отключено в меню ''Options''.

===Вращение===
'''С использованием мыши'''

Вы также можете вращать выбранные элементы относительно оси Z с использованием колесика мыши.

* Выберите нужный вам элемент в '''режиме управления с клавиатуры''' ('''левая кнопка мыши''') и вращайте колесико мыши с зажатой клавишей '''левый CTRL'''.
Или:
* Выберите элемент в '''режиме управления мышью''' ('''правая кнопка мыши'''), зажмите '''CTRL''' и вращайте колесико мыши.

'''С использованием клавиатуры'''

* Выберите элемент в '''режиме управления с клавиатуры''' ('''левая кнопка мыши''').
* Вместе с зажатой клавишей '''CTRL''' (маркер конической формы, находящийся над элементом, станет зеленого цвета), используйте '''клавиши-стрелки''' и '''PgUp'''/'''PgDn''', чтобы вращать элементы относительно различных осей.

С обоими методами вы можете дополнительно зажимать '''ALT''', чтобы уменьшить скорость и '''SHIFT''', чтобы увеличить ее.

[[Image:Editor_Rotateelem.png|center]]

==Изменение модели и другие настройки==
У большинства элементов есть множество вариантов настроек, которые нужны для измения их внешности и поведения. Примеры - модель, цвет и визуальная модернизация автомобиля.

* Откройте окно свойств элемента двойным щелчком на нем или выбрав его и нажав клавишу '''F3'''.
* Сделайте изменения по вашему усмотрению. Например, чтобы изменить модель автомобиля или объекта, щелкните кнопку ''Browse'' рядом с ''model'' для открытия браузера моделей.
* Нажмите OK, когда закончите.

[[Image:Editor_Props.png|center]]

===Копирование (клонирование)===
Вы можете копировать (клонировать) элемент, выбирая его и нажимая '''C'''.

* В '''режиме управление мышью''' копируемый элемент "приклеится" к вашему курсору мыши, кликните '''левой кнопкой мыши''', чтобы устоновить элемент в выбранное вами место.

* В '''режиме управления с клавиатуры''' копируемый элемент останеться в той же позиции, что и элемент, с которого его копировали. Нажмите '''F2''' для быстрого перехода в '''режим управления мышью''' при выбранном элементе.

Если вы зажмете '''CTRL''' в то время как кликаете, то элемент будет копирован и снова "приклеен" к курсору мыши. Этим способом вы легко сможете поместить большое количество чего-либо.

Также вы можете использовать кнопку '''Pullout''' ('''>'''), расположенную в нижнем правом углу окна свойств элемента, чтобы копировать его.

===Удаление===
Чтобы удалить элемент, просто нажмите клавишу '''DEL''' с предварительно выделенным элементом для удаления.

Также вы можете использовать кнопку '''Pullout''' ('''>'''), расположенную в нижнем правом углу окна свойств элемента, чтобы удалить его.

==Создание карт для специфических модов==
Чтобы создать карту для специфического мода, вам нужно сделать две вещи:
* Кликните по кнопке '''Map Settings''' в верхнем меню, нажмите по вкладке '''Gamemodes''' и добавьте любые моды, с которыми будет использоваться ваша карта.
* Вам, скорее всего, захочется добавить один или несколько [[RU/Resource:Editor/EDF|Editor Definition Files]]. Это позволит вам размещать специфические моду элементы на карте, такие как точки спавна, гоночные чекпоинты или CTF-флаги. Вы можете добавлять EDF'ы , кликнув по кнопке '''Definitions''' в меню и добавив релевантные моды.

==Управление==
Здесь приведен список клавиш для управления. Чтобы изменить их, необходимо войти в настройки МТА, при запущенном Map Editor'e

===Камера===
{|
|-
| перемещение камеры вперед
| '''w'''
|-
| перемещение камеры назад
| '''s'''
|-
| перемещение камеры влево
| '''a'''
|-
| перемещение камеры вправо
| '''d'''
|-
| "режим высокой чувствительности"
| '''e'''
|}

===Клонирование===
{|
|-
| клонировать выбранный элемент
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Манипуляции с элементами===
{|
|-
| перемещение элемента вперед
| '''arrow_u''' || ''(Стрелочка Вверх)''
|-
| перемещение элемента назад
| '''arrow_d''' || ''(Стрелочка Вниз)''
|-
| перемещение элемента влево
| '''arrow_l''' || ''(Стрелочка Влево)''
|-
| перемещение элемента вправо
| '''arrow_r''' || ''(Стрелочка Вправо)''
|-
| опустить элемент вниз
| '''pgdn''' || ''(Page Down)''
|-
| поднять элемент вверх
| '''pgup''' || ''(Page Up)''
|-
| приблизить
| '''Колесико мыши вниз'''
|-
| отдалить
| '''Колесико мыши вверх'''
|-
| быстрое перемещение элемента в одну сторону
| '''клавиша "режима перемещения"''' + '''колесико мыши вверх''' || ''(Левый CTRL + Колесико мыши вверх)''
|-
| быстрое перемещние элемента в другую сторону
| '''клавиша "режима перемещения"''' + '''колесико мыши вниз''' || ''(Левый CTRL + Колесико мыши вниз)''
|-
| включение "Режима перемещения" ''(клавишу необходимо зажать)''
| '''lctrl''' || ''(Левый CTRL)''
|-
| режим "замедленная скорость перемещния\камеры"
| '''lalt''' || ''(Левый ALT)''
|-
| режим "быстрая скорость перемещения\камеры"
| '''lshift''' || ''(Левый SHIFT)''
|-
| удалить выбранный эмемент
| '''delete'''
|-
| прекратить производить действие в элементом
| '''пробел'''
|-
| начать производить дейтвите в выбранным элементом
| '''F2'''
|-
| отменить перемещение
| '''mod_rotate''' + '''r''' || ''(Левый CTRL + R)''
|}

===GUI===
{|
| Переключить gui экран
| '''F4'''
|-
| Переключить курсор
| '''f'''
|-
| Выбрать нужный элемент (в '''Режим управления с клавиатуры''')
| '''mouse1''' || ''(Левая кнопка мыши)''
|-
| Выбрать нужный элемент (в '''Режим управления мышью''')
| '''mouse2''' || ''(Правая кнопка мыши)''
|-
| следующий EDF
| '''mouse_wheel_up'''
|-
| предыдущий EDF
| '''mouse_wheel_down'''
|-
| Отменить
| '''Ctrl''' + '''z'''
|-
| Вернуть
| '''Ctrl''' + '''y'''
|-
| окно настроек
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| приблизить
| '''mouse_wheel_up'''
|-
| отдалить
| '''mouse_wheel_down'''
|-
| подтвердить
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| перейти к тесту
| '''F5'''
|}

==Мультиплеер==
В редакторе встроены и серверный, и клиентский компоненты, поэтому он изначально совместим с мультиплеером. Чтобы подключить в редактор несколько пользователей, просто скопируйте все ресурсы редактора на ваш сервер, запустите ресурс 'editor' и позвольте другим пользователям присоединиться.

Просим заметить, что на данный момент редактор лишен какой ыб то ни было системы прав, так что все пользователи имеют полный доступ к функционалу.

==Плагины и внешние ресурсы==
{{Main|RU/Resource:Editor/Plugins}}

Редактор позволяет базовое импортирование элементов из внешних ресурсов. Это может оказаться полезным для ресурсов, которым понадобится как-то по-особенному обращаться с элементом, как это нельзя сделать через редактор. Например, ресурс карты, использующий специфические модели (и имеет скрипт для импортирования этих моделей) по умолчанию не может быть управляемым через редактор.

Через использование команды '''import <resourceName>''' в консоли элементы ресурса могут быть импортированы через редактор.

==FAQ==
==== У меня черный экран при запуске Map Editor ====

Обычно это вызвано из-за неправильной установки ресурсов Map Editor'а. Если вы используете стабильный клиент MTASA, пожалуйста, переустановите его и удостоверьтесь, что используете опции Client и Server при установке.

Если вы используете nightly билд, чтобы он правильно заработал, вам понадобятся новейшие [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 ресурсы (шаг 3)], распакуйте архив и поместите его содержимое в:
''MTA San Andreas 1.3\server\mods\deathmatch\resources'' , гду ''MTA San Andreas 1.3'' - папка, куда вы установили MTA San Andreas (по умолчанию: C:\Program Files\MTA San Andreas 1.3).

Помещение их в: MTA San Andreas 1.3\mods\deathmatch\resources - '''распространенная ошибка''' - это не даст эффекта. Так что убедитесь, что помещаете их по пути, выделенным выше ''курсивом''.

Если проблема все еще актуальна, даже когда вы проверили заметку выше и удостоверились, что установили все правильно, это может происходить из-за устаревшего файла '''acl.xml'''. Вы можете получить стандартный [http://linux.mtasa.com/dl/130/baseconfig.tar.gz в архиве]. Он должен быть помещен в '''server/mods/deathmatch/''' в папке с установленной MTA: San Andreas.

==== Я вижу "Could not start the local server. See console for details" при использвовании кнопки "Map Editor" ====
Это происходит, потому что у вас устаревший файл editor.conf. Вы можете получить стандартный [http://linux.mtasa.com/dl/130/baseconfig.tar.gz в архиве]. Он должен быть помещен в '''server/mods/deathmatch/''' в папке с установленной MTA: San Andreas.

==== Я сохранил карту, но не могу найти ее в папке resources своего сервера, но могу видеть ее в самом редакторе ====
Это из-за того, что Vista/7 ограничивает права на запись в папку Program Files для процессов, запущенных не от имени администратора. Файлы записываются в папку "VirtualStore" вместо реальной папки Program Files. Вы сможете найти свой ресурс-карту по схожему пути:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas 1.3\server\mods\deathmatch\resources\

Запуск сервера/MTA San Andreas с администраторскими правами позволит карте сохраниться по нормальному пути.

==== У меня другая проблема с редактором карт ====

Иногда разрешению определенных проблем способствует сброс редактора. Наиболее легкий путь его провести - установить MTA:SA в новую совершенно другую папку. Или же можно попробовать следующие шаги:
::1. Зайдите в папку resources, '''server/mods/deathmatch/resources/''' и удалите папку '''editor_dump'''
::2. Зайдите в папку resources, '''server/mods/deathmatch/resources/''' и удалите папку '''editor_test'''

==== Я нашел баг или у меня есть предложение/отзыв по редактору карт ====
Пожалуйста, воспользуйтесь официальным [https://github.com/multitheftauto/mtasa-blue/issues багтрекером], чтобы сообщать о багах. Также не стесняйтесь присоединиться к нам на [https://discord.com/invite/mtasa Discord].

[[en:Resource:Editor]]
[[es:Resource:Editor]]

AT/Resource:Editor

2022-01-23T17:18:20Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{Resource page}}
Der MTA:SA Map Editor erlaubt es dir Maps für Gamemodes zu erstellen.

==Starten==
Um den Map Editor zu starten, musst du nur auf den "Map Editor" Menüpunkt im MTA Hauptmenü klicken.

==Menüs==
Sobald der Map Editor gestartet wurde, solltet ihr 2 Menüleisten sehen können: das Hauptmenü am oberen und das Element-Menü am unteren linken Rand des Bildschirms.

===Hauptmenü===
Die sind die Buttons im Hauptmenü:
* [[Image:Editor_New.png]] Eine neue Map erstellen.
* [[Image:Editor_Open.png]] Eine bereits existierende Map öffnen.
* [[Image:Editor_Save.png]] Map speichern.
* [[Image:Editor_Save_as.png]] Map unter einem anderen Namen speichern.
* [[Image:Editor_Options.png]] Allgemeine Einstellungen des Map Editors verändern.
* [[Image:Editor_Undo.png]] Die letzte Aktion rückgängig machen.
* [[Image:Editor_Redo.png]] Die letzte Aktion wiederherstellen.
* [[Image:Editor_Locations.png]] Liste von gespeicherten Orten und Interiors (Innenräume) anzeigen, zudem kannst du auch eigene Orte und Interiors abspeichern.
* [[Image:Editor_Current_elements.png]] Liste, mit allen Elementen deiner Map, anzeigen. (Objekte, Fahrzeuge, Markierungen, Pickups etc.)
* [[Image:Editor_Map_settings.png]] Map spezifische Einstellungen, wie z.B. Wetter, Tageszeit oder Schwerkraft, ändern. Hier kannst du zudem einstellen mit welchen Gamemodes deine Map kompatibel ist.
* [[Image:Editor_Definitions.png]] Lade eine [[Resource:Editor/EDF|editor definition file (EDF)]] die du benutzen möchtest.
* [[Image:Editor_Test.png]] In den Test-Modus wechseln um deine Map zu testen. Hast du zudem in den Map Einstellungen einen Gamemode angegeben kannst du deine Map sofort mit diesem testen.

===Element Menü===
Das Element Menü dient zum Hinzufügen neuer Elemente zu deiner Map.
* [[Image:Editor_Vehicle.png]] Erstelle ein neues Fahrzeug
* [[Image:Editor_Object.png]] Erstelle ein neues Objekt (Gebäude, Straßen, Bäume etc.).
* [[Image:Editor_Pickup.png]] Erstelle ein neues Pickup (Gesundheit, Rüstung, Waffen etc.).
* [[Image:Editor_Marker.png]] Erstelle eine neue Makierung.

Zusätzlich kannst du, wenn du eine [[Resource:Editor/EDF|EDF geladen]] hast, mit der Maus über das Element Menü fahren und durch scrollen des Mausrades benutzerdefinierte Elemente anzeigen.

==Benutzung des Editors==
Dieser Abschnitt erklärt wie man Maps erstellt und bearbeitet.

===Auf der Map bewegen===
Direkt nach dem Starten des Editors, befindest du dich im ''Kamera-Modus''. Mit Hilfe der '''WASD''' Tasten kannst du die Kamera bewegen, mit der Maus kannst du die Kamera schwenken. Hältst du während du die Kamera bewegst '''ALT''' gedrückt bewegt sich die Kamera langsamer, hältst du '''SHIFT''' gedrückt bewegt sich diese schneller.

Um auf das Interface (Menüs) des Map Editors zugreifen zu können, musst du in den ''Mauszeiger-Modus'' wechseln, dies erreichst du durch drücken der '''F''' Taste, drückst du diese erneut gelangst du wieder zurück in den ''Kamera-Modus''.
Während du im ''Mauszeiger-Modus'' bist, ist die Kamera fixiert und du kannst mit Hilfe des Mauszeigers Elemente bearbeiten oder auf die Menüs zugreifen.

Das du gerade im ''Kamera-Modus'' bist erkennst du daran, dass in der Mitte des Bildschirms ein Fadenkreuz zu sehen ist, mit diesem kannst du genau wie im ''Mauszeiger-Modus'' Elemente auswählen und bewegen.

[[Image:Editor_Crosshair.png|center]]

===Eine neue Map beginnen===
* Starte den Editor und drücke im oberen Menü auf den ''New'' Button.
* Drücke nun den ''Map Settings'' Button und wechsle in den ''Meta'' Tab, trage in das ''Name'' Feld den Namen deiner Map ein und in das ''Author'' Feld deinen eigenen Namen. Öffne zudem den ''Gamemodes'' Tab und füge nun dort die Gamemodes für die deine Map gedacht ist hinzu, dies erreichst du entweder durch einen Doppel-Klick auf den Namen des Gamemodes oder durch das Drücken des ''Add'' Buttons (die Gamemodes sollten sich dann im rechten Feld mit dem Namen ''Added gamemodes'' befinden). Klicke ''OK'' wenn du fertig bist.
[[Image:Editor_Mapsettings.png|center]]
*Klicke jetzt im oberen Menü auf den ''Definitions'' Button und füge, ähnlich wie du es gerade mit den Gamemodes getan hast, Ressourcen deren benutzerdefinierte Elemente du nutzen möchtest zur Liste auf der rechten seite des Fensters hinzu. Klicke ''OK'' wenn du fertig bist.
Für mehr Informationen zu den EDFs solltest du dir [[Resource:Editor/EDF|diesen Artikel durchlesen]]

===Neue Elemente erstellen===
Das Hinzufügen von Elementen, wie Vehikeln oder Objekten, ist sehr einfach.
* Wechsel zunächst, durch drücken der '''F''' Taste in den Mauszeiger-Modus, falls du dich im Kamera-Modus befindest.
* Klicke im Element Menü auf den Button des Elements welches du hinzufügen möchtest, klicke z.B. auf den Button auf dem ein Auto abgebildet ist um neue Vehikel zu erstellen.
* Das entsprechende Element wird erstellt und an den Mauszeiger "geheftet". Bewege es nun an einen Ort deiner Wahl und drücke die '''linke Maustaste''' um das Objekt zu platzieren.

[[Image:Editor_Addelem.png|center]]

Um benutzerdefinierte Elemente einer Ressource zu erstellen, fahre mit dem Mauszeiger über das Element Menü und scrolle solange mit dem Mausrad bis die gewünschte Ressource und deren Elemente erscheinen.
Beachte das du jedoch zunächst die zur Ressource gehörende [[Resource:Editor/EDF|EDF]] im ''Definitions'' Fenster hinzugefügt haben musst.

[[Image:Editor_Selectedf.png|center]]

===Elemente auswählen===
* '''Linksklick''' auf ein Element um es im ''Tastaturmodus'' auszuwählen.
* '''Rechtsklick''' auf ein Element um es im ''Mausmodus'' auszuwählen.
* '''Leertaste''' drücken oder in einen leeren Bereich klicken um die Auswahl aufzuheben.

Das ausgewählte Element wird durch eine gelbe konische Markierung hervorgehoben. Elemente (vor allem Objekte) mit mangelhaften Kollisionen können leichter ausgewählt werden, wenn man durch Drücken von '''E''' den ''"High sensitivity mode"'' aktiviert, der die Erkennung verbessert, aber die Genauigkeit senkt.

Der ''"Current elements"'' Dialog kann auch verwendet werden um Elemente auszuwählen. Doppelklick auf ein Element wählt es im ''Tastaturmodus'' aus.

===Elemente verschieben===
Elemente können über verschiedene Wege verschoben werden.

'''Mit der Maus'''
* Elemente können über Drag & Drop mit '''Linksklick''' verschoben werden.
Oder:
* Wähle das Element im Mausmodus mit ('''Rechtsklick'''), bewege es dort hin, wo du es haben willst, und Klicke um es zu platzieren.

Du kannst auch die ''Distanz'' von einem Element zur Kamera ändern durch wählen des '''Kameramodus''', '''Rechtsklick''' auf das Element, und rollen des '''Mausrad'''.

'''Mit der Tastatur'''
* Wähle das Element im Tastaturmodus ('''Linksklick''').
* Benutze die '''Pfeiltasten''' um das Element horizontal zu bewegen, und '''Bild hoch'''/'''Bild runter''' um es vertikal zu bewegen. Halte '''ALT''' um die Bewegungsgeschwindigkeit zu verringern, oder '''SHIFT''' um die Bewegungsgeschwindigkeit zu erhöhen.

Standardmäßig werden Elemente relativ zur Kamera bewegt, die Bewegungen sind nicht auf Achsen limitiert. Dieses Verhalten kann im ''Options'' Menü geändert werden.

===Elemente drehen===
'''Mit der Maus'''

Du kannst die ausgewählten Elemente um die Z Achse mit dem '''Mausrad''' drehen.
* Wähle das Element im Tastaturmodus ('''Linksklick''') und rolle das Mausrad, während du '''STRG-Links''' gedrückt hältst.
Oder:
* Wähle das Element im Mausmodus ('''Rechtsklick'''), halte '''STRG''', und rolle das Mausrad.

'''Mit der Tastatur'''
* Wähle das Element im Tastaturmodus ('''Linksklick''').
* Während du '''STRG''' hältst (der Auswahl Marker wird grün), benutze die '''Pfeiltasten''' and '''Bild hoch'''/'''Bild runter''' um das Element um die verschiedenen Achsen zu bewegen.

Bei beiden Methoden kannst du '''ALT''' gedrückt halten um die Drehgeschwindigkeit zu verringern oder '''SHIFT''' um die Drehgeschwindigkeit zu erhöhen.

[[Image:Editor_Rotateelem.png|center]]

===Model ändern und andere Einstellungen===
Die meisten Elemente haben eine Vielfalt von Optionen die verändert werden können um das Aussehen und Verhalten der Elemente zu verändern. z.B. Model, Farbe und Tuning von einem Auto.

* Öffne das Einstellungsfenster von einem Element indem du es Doppelklickst oder es wählst und '''F3''' drückst.
* Mach die Veränderungen, die du willst. z.B. um das Model von einem Auto oder Objekt zu ändern, klicke den '''Browse''' Button neben '''model''' um den Modellbrowser zu öffnen.
* Klicke OK wenn du fertig bist.

[[Image:Editor_Props.png|center]]

===Klonen===
Du kannst ein Element klonen indem du es auswählst und '''C''' drückst.

* Im Mausmodus wird das Model an den Cursor "gehängt". '''Linksklick''' um es auf der Karte zu platzieren.
* Im Tastaturmodus wird das geklonte Element in der identischen Position geklont.

Wenn du '''STRG''' drückst, während du auf das Element klickst, wird das Element wieder geklont und an den Cursor "gehängt". Mit diesem Weg kannst du ganz einfach große Mengen von etwas Platzieren.

Alternativ kannst du auch den ''>'' Button unten-rechts in der Einstellungsbox benutzen um ein Element zu klonen.

===Löschen===
Wähle das Element und drücke '''Entf''' ''(Entfernen)''.

Alternativ kannst du auch den ''>'' Button unten-rechts in der Einstellungsbox benutzen, um ein Element zu löschen.

==Maps erstellen für bestimmte Gamemodes==
Um eine Map für einen bestimmten Gamemode zu erstellen, hast du zwei Dinge zu tun:
* Klicke den '''Map Settings''' Button in dem oberen Menü, gehe zu dem '''Gamemodes''' Tab und füge alle Gamemodes hinzu die diese Map benutzen sollen.
* Wahrscheinlich wirst du brauchen eine oder mehrere [[Resource:Editor/EDF|Editor Definition Files]] hinzuzufügen. Diese erlauben es dir in deiner Map Gamemode bestimmte Elemente zu platzieren, wie Spawnpoints, Race Checkpoints, oder CTF Flaggen. Du kannst EDF's hinzufügen, indem du den '''Definitions''' Menü Button klickst und die entsprechenden Gamemodes hinzufügst.

==Controls==
Hier ist eine Liste von allen Standart Steuerungen. Um sie zu ändern gehe zu den MTA Einstellungen während der Map Editor gestartet ist.

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

===Klonen===
{|
|-
| 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==
Der Editor ist "gebaut" mit Server- und Clientseitigen Komponenten, und unterstüzt Multiplayer.
Um den Editor im Multliplayer-Modus zu benutzen, kopiere die Map-Editpr Ressourcen in deinen Server, starte die '''editor''' Ressource und erlaube Spielern beizutreten.

Vergesse nicht, dass jeder Spieler Zugriff auf jede Funktion des Map-Editors hat!

==Plugins & Externe Ressourcen==
{{Main|Resource:Editor/Plugins}}

Der Editor erlaubt importieren von Elementen von Externen Ressourcen. Diese Funktion ist nützlich für Ressourcen die ein Element verändern müssen, wie es in dem Map-Editor nicht möglich ist. Zum Beispiel, für eine Map-Ressource, welche das Modell ändern muss.

Beim Benutzen des '''import <resourceName>''' command in der Konsole können die Ressource-Elemente in den Editor importiert werden.

==FAQ==
==== Ich bekomme einen schwarzen Bildschirm beim Ausführen des Map-Editors ====

Meistens passiert der Fehler durch inkorrekte Installation der Map-Editor-Ressourcen. Wenn du einen stabilen MTASA Client benutzt, installiere ihn erneut und sei dir dabei sicher, dass du die "Server und Client Option" auswählst.

Wenn du die Nightly Build Version von MTASA benutzt, lade dir die neueste Version [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 hier], entpacke das Archiv und verschiebe seinen Inhalt nach:
''MTA San Andreas\server\mods\deathmatch\resources'' , wo ''MTA San Andreas'' der Ordner ist wohin du MTASA installiert hast. (Standart Ort: C:\Programme\MTA San Andreas).

In diesen Pfad verschieben: MTA San Andreas\mods\deathmatch\resources '''ist ein häufiger Fehler''' - es funktioniert nicht wenn du es dort hin verschiebst.
Sei dir sicher, dass du die Dateien in den oben genannten Pfad gelegt hast.

Wenn der Fehler trotzdem erscheint, kann es sein, dass du eine veraltete '''acl.xml''' hast.
Du kannst die Standard '''acl.xml''' [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml hier] runterladen. Es sollte in '''server/mods/deathmatch/''' in deinem MTASA Ordner platziert werden.

==== Ich bekomme einen "Could not start the local server. See console for details" Fehler, wenn ich den "Map Editor" Button benutze ====
Dieser Fehler entsteht, wenn du keine gültige editor.conf installiert hast. Du kannst die Standard editor.conf [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf hier] runterladen.
Die Datei sollte in dem '''server/mods/deathmatch/''' Ordner in deinem MTASA Verzeichnis platziert werden.

==== Ich habe eine Map erstellt, kann sie aber nicht finden, aber im Map-Editor öffnen ====
Das ist dadurch, dass nicht-Admin Prozesse keine Schreibrechte in dem MTASA Verzeichnis haben. Dateien werden in das "VirtualStore" Verzeichnis geschrieben. Du solltest deine Map in diesem Verzeichnis finden:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Den MTA Server als Administrator auszuführen erlaubt die Dateien direkt in dem Verzeichnis zu speichern.

==== Ich habe einen Bug gefunden oder habe Anregungen/Feedback für den Map Editor ====
Bitte benutze den offiziellen [https://github.com/multitheftauto/mtasa-blue/issues Bugtracker] um Bugs zu melden. Du kannst auch den [https://discord.com/invite/mtasa Discord] benutzen.

[[de:Resource:Editor]]
[[ru:Resource:Editor]]

DE/Resource:Editor

2022-01-23T17:17:55Z

Turret001: replaced IRC with Discord and updated bug tracker link

ES/Resource:Editor

2022-01-23T17:17:31Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{Resource page}}
El editor de mapas de MTA:SA te permite crear mapas para los modos de juego.
Para iniciarlo, simplemente presiona "Map Editor" en el menú principal de MTA

==Menus==
Una vez que el editor haya comenzado, se te mostrarán dos menús de barras: la principal (arriba), y la de elementos (esquina inferior izquierda).

===Menú principal===
Estos son los botones en el menú principal:
* [[Image:Editor_New.png]] Crear un nuevo mapa.
* [[Image:Editor_Open.png]] Abrir un mapa existente.
* [[Image:Editor_Save.png]] Grabar el mapa en que estás trabajando.
* [[Image:Editor_Save_as.png]] Grabar el mapa bajo un nombre diferente.
* [[Image:Editor_Options.png]] Modificar las opciones generales del editor.
* [[Image:Editor_Undo.png]] Deshacer la última acción.
* [[Image:Editor_Redo.png]] Restaurar la última acción deshecha.
* [[Image:Editor_Locations.png]] Lista de lugares "marcados" (como los Favoritos).
* [[Image:Editor_Current_elements.png]] Lista de todos los elementos contenidos en el mapa (vehículos, objetos, marcadores, pickups, etc).
* [[Image:Editor_Map_settings.png]] Propiedades del mapa, como el tiempo o la gravedad. Aquí también puedes especificar los modos de juego que son compatibles con tu mapa.
* [[Image:Editor_Definitions.png]] Cargar las [[Resource:Editor/EDF| Definiciones del Editor (EDF)]].
* [[Image:Editor_Test.png]] Probar el mapa.

===Menú de elementos===
El menú de elementos es usado para agregar nuevos elementos al mapa.
* [[Image:Editor_Vehicle.png]] Crear un vehículo.
* [[Image:Editor_Object.png]] Crear un objeto (edificios, caminos, basura, árboles, rocas, decoración exterior, etc).
* [[Image:Editor_Pickup.png]] Crear un pickup (sólo se puede crear de vida, armadura o de un arma).
* [[Image:Editor_Marker.png]] Crear un marcador.

Adicionalmente, si tienes una [[Resource:Editor/EDF| Definición de Editor (EDF)]] cargada, girando la rueda del ratón (con el cursor sobre el menú) puedes cargar los elementos derivados de esa definición.

==Usando el editor==
Esta sección te explicará cómo crear y modificar mapas.

===Moviéndose alrededor del mapa===
Al iniciarse el editor, inicias en el ''modo de cámara''. Puedes usar las teclas '''WSAD''' para mover la cámara, y el ratón para girarla. Cuando te muevas, puedes mantener la tecla '''ALT''' para moverte más lento, o la tecla '''SHIFT''' para ir más rápido.

Para acceder a la interfaz del editor y al panel de control, necesitas cambiar al ''modo de cursor''. Puedes cambiar entre el modo de cursor y el modo de cámara con la tecla '''F'''. Cuando estés en modo de cursor, tu vista estará congelada, y solo podrás usar el cursor del ratón para manipular elementos y usar la interfaz gráfica.

El modo de cámara puede ser reconocido por una mira en medio de la pantalla. Puedes usarla para seleccionar y mover elementos como en el modo de cursor. Esta mira luce así:

[[Image:Editor_Crosshair.png|center]]

===Empezando un nuevo mapa===
* Inicia el editor, o si ya está iniciado, apreta el boton ''Nuevo'' del menú.
* Apreta el botón ''Opciones de mapa''. En la pestaña ''Meta'', llena los campos de "Name" y "Author" con el nombre de tu mapa y tu nick en MTA, respectivamente. También abre la pestaña ''Gamemodes'' y agrega los modos de juego para los cuales tu mapa está hecho (éstos se van a mover a la lista de ''Added Gamemodes''). Puedes hacer esto seleccionándolos y apretando en ''Add'', o haciendo doble click sobre ellos. Apreta OK cuando estés listo.
[[Image:Editor_Mapsettings.png|center]]
* Apreta en la ventana de ''Definiciones'' y agrega los recursos en donde uses los elementos alternativos. Estos debieran consistir de los modos que tu seleccionaste en la ventana de ''Map settings'', ademas de eventuales recursos adicionales. Para mas informacion acerca de las definiciones del editor, ve [[Resource:Editor/EDF|EDF (En Inglés)]]. Apreta OK cuando estes listo.

===Creando nuevos elementos===
* Si tu estas en el modo de camara, cambia al modo de cursor primero apretando '''F'''.
* Apreta un boton en el menu de elementos que represente lo que tu quieres. Ej: Apreta el boton con un auto en el para agregar un vehiculo.
* Un nuevo elemento del tipo seleccionado sera creado y pegado a tu cursor. Muevelo a la posicion que quieras y apreta el '''botón izquierdo''' para dejarlo.

[[Image:Editor_Addelem.png|center]]

Para crear un elemento alternativo que es especifico a un recurso, mueve tu cursor sobre el menu de elementos y gira la rueda del ratón hasta el recurso esperado. Ten en cuenta que para este trabajo, primero necesitas haber agregado el archivo de [[Resource:Editor/EDF|Definición de editor]] del recurso en la ventana ''Definitions''.

[[Image:Editor_Selectedf.png|center]]

===Seleccionando===
* '''Click izquierdo''' sobre un elemento para seleccionarlo en ''modo de teclado''.
* '''Click derecho''' sobre este elemento para seleccionarlo en ''modo de ratón''.
* Apreta la '''Barra espaciadora''' o apreta sobre un area vacia para sacar la selección.

El elemento elegido, si lo hay, es representado por un marcador de cono amarillo. Elementos (particularmente objetos) con pesima colision se peuden detectar facilmente activando el ''modo de alta sensibilidad'', apretando la tecla '''E'''. Esto incrementara la detección.

El dialogo ''Current elements'' puede ser usado tambien para seleccionar elementos. Has doble-click sobre un item de la lista para seleccionarlo en ''modo de teclado''

===Moviendo===
El movimiento de los elementos se puede hacer de muchas maneras:

'''Con el ratón'''
* Simplemente selecciónalo y déjalo con el '''boton izquierdo'''
O bien:
* Selecciona el elemento en el modo de ratón ('''boton derecho'''), muévelo hacia la posición que quieras, y haz clic izquierdo para dejarlo.

También puedes ajustar la ''distancia'' de un elemento acercándolo o alejándolo de la cámara mediante el cambio al modo de cámara. Haz ''''clic derecho''' en un elemento, y gira la '''rueda del ratón'''.

'''Con el teclado'''
* Selecciona el elemento en el modo de teclado ('''clic izquierdo''').
* Luego, usa las '''teclas de dirección''' para mover el elemento en un plano horizontal (ejes ''X'' y ''Z''), y '''RePág'''/'''AvPág''' para moverlo verticalmente (eje Z). Mantén presionado '''ALT''' para disminuir la velocidad de movimiento, y '''SHIFT''' para incrementarla.

Por defecto, los elementos se mueven relativamente a la cámara y no están limitadas a sus ejes. Esto se puede desactivar en el menú de '''Opciones'''.

===Rotando===

'''Con el ratón'''
Puedes rotar un elemento selecionado en el eje Z, con la rueda del ratón.
* Seleciona el elemento con un clic (derecho o izquierdo) y ruédala mantiendo apretado '''CTRL'''.

'''Con el teclado'''
* Selecciona el elemento ('''clic izquierdo''').
* Mientras se presiona '''CTRL''' (la marca de selección se volverá verde), y usa las '''teclas de dirección''' o '''RePág'''/'''AvPág''' para rotar el elemento en los 3 ejes.

En ambos métodos, puedes presionar '''ALT''' para reducir la velocidad de rotación del elemento, y '''SHIFT''' para incrementarla.

[[Image:Editor_Rotateelem.png|center]]

===Cambio de modelo y otras propiedades===
La mayoría de los elementos tiene una variedad de opciones que pueden ser alteradas para cambiar su apariencia. Ejemplos son los modelos, color y las actualizaciones visuales de un auto.

* Abre la ventana de propiedades de un elemento, presionando dos veces en el o seleccionándolo y apretando '''F3'''.
* Hace las modificaciones que tu quieras. Por ejemplo, para cambiar el modelo de un auto o objeto, presiona en el botón '''Browse''' al lado de "model" para abrir el buscador de modelos.
* presiona OK cuando estés listo

[[Image:Editor_Props.png|center]]

===Clonando===
Puedes clonar un elemento seleccionándolo y presionando '''C'''.

* En el modo de cursor, este elemento clonado será "adjuntado" a tu cursor. Para posicionarlo haz click con el botón izquierdo.
* En el modo de teclado, el elemento será puesto en la misma posición del elemento original.

Si presionas '''CTRL''' mientras haces click, el elemento será clonado otra vez.

También puedes usar el botón ''Pullout'' de la esquina inferior derecha de la ventana de propiedades del elemento.

===Borrando===
Simplemente selecciona el elemento y pulsa ''SUPR''' ''(Borrar o Suprimir)''.

También puedes usar el botón ''Pullout'' de la esquina inferior derecha de la ventana de propiedades del elemento.

==Creando mapas para modos de juego específicos==
Para lograr esto, tienes que hacer 2 cosas.
* Clickea '''Map Settings''' en la barra superior del editor, busca la sección '''Gamemodes'''. De ahí seleccionas los modos de juego en los que tu mapa se puede usar.
* También necesitarás usar [[Resource:Editor/EDF|Archivos de Definición del Editor]] (EDF, o sea Editor Definition Files). Estos te permiten poner elementos de un modo de juego en específico, ya sean puntos de Spawn, las banderas de CTF, etc... Los EDF se cargan desde la sección "Definitions", en "Map Settings".

==Controles==
Aquí tienes la lista de los controles por defecto. Para editarlos, debes ir a la sección "Binds", en "Settings", en el menú de MTA, mientras el editor está abierto.

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

===Clonación===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Manipulación de elementos===
{|
|-
| 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 (Interfaz Gráfica)===
{|
| 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'''
|}

==Multijugador==
El editor de mapas está hecho para que se pueda usar por más de un jugador a la vez. Esto se hace copiando los "resources" que usa el editor, a tu servidor. Luego tienes que iniciarlo y ya puedes hacer mapas con otros jugadores.

Nota: no hay sistema de restricciones en el editor; todos los jugadores tienen los mismos permisos para editar el mapa.

==Plugins y Recursos externos==
{{Main|Resource:Editor/Plugins}}

El editor permite una importación básica de recursos externos. Esto es útil para "resources" que manipulan o crean objetos que el editor no puede, como vehículos con modelos modificados.

Usando el comando '''import <nombreDeResource>''' en la consola, los elementos del resource pueden ser importados al editor.

==Preguntas Frecuentes==
==== No veo nada (pantalla negra) al usar el editor ====

Generalmente esto ocurre debido a una mala instalación del editor de mapas. Si usas una versión estable de MTA, prueba a instalarlo de nuevo, y asegúrate de que las opciones "Client" y "Server" del instalador estén marcadas.

En cambio, si usas una versión "nightly", debes bajar la última versión de los[http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 "resources" (paso 3)], descomprimir el archivo y colocar su contenido en:
''MTA San Andreas\server\mods\deathmatch\resources'', donde ''MTA San Andreas'' es la carpeta donde instalaste MTA San Andreas (por defecto es: C:\Archivos de Programa\MTA San Andreas).

'''Poner los archivos en: MTA San Andreas\mods\deathmatch\resources es un error común''' - no funcionarán ahí. Asegúrate de que dentro de la ruta donde colocas los archivos encuentres la palabra "server".

Si este problema persiste aún después de haber hecho los pasos mencionados y revisada la versión actual, puede ser porque tienes una versión obsoleta del archivo ''acl.xml''. Puedes descargarlo [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml aquí]. Una vez descargado, colócalo en la carpeta '''MTA San Andreas/server/mods/deathmatch/'''.

==== Me sale un mensaje que dice "Could not start the local server. See console for details" al iniciar el editor ====
Esto pasa porque tu archivo ''mtaserver.conf'' está dañado o está mal editado. Puedes descargarlo [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf aquí]. Debes colocarlo en '''MTA San Andreas/server/mods/deathmatch/'''.

==== Guardé un mapa con el editor, pero no lo encuentro en la carpeta resources. Sin embargo el editor lo carga en la lista ====
Esto se debe a que Windows Vista/7 tiene cietos límites de escritura para procesos no administrativos del directorio Archivos de Programa. Los archivos se guardan en el directorio "VirtualStore" en vez de en Archivos de Programa. Deberías poder encontrar tu mapa en el directorio:
C:\Usuarios\<NOMBRE>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Si inicias el servidor o el cliente de MTA con derechos administrativos, tu mapa debería ser guardado en el lugar correcto.

==== Encontré un error o tengo una sugerencia ====
Visita el [https://github.com/multitheftauto/mtasa-blue/issues sistema de seguimiento de errores] oficial. También puedes ingresar al [https://discord.com/invite/mtasa Discord].

==Traductores==

*Gothem
*F4ST3R
*Benxamix2/The Kid

[[ru:Resource:Editor]]
[[en:Resource:Editor]]

NL/Client Manual

2022-01-23T17:15:54Z

Turret001: replaced IRC with Discord

{{Outdatedtr}}
__TOC__

==Introductie==
Multi Theft Auto: San Andreas is de laatste versie van een serie van door-fans-gemaakte multiplayer aanpassing voor de Grand Theft Auto spellen (alleen de PC versies). Voor de GTA3 en Vice City versies, die op de oude kern draaien, bezoek [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Deze aanpassing is niet ondersteund door Rockstar Games of Take 2 Interactive.

==Voor je begint==

Zorg ervoor dat je voordat je Multi Theft Auto: San Andreas installeert, geen aanpassingen voor GTA:SA hebt geinstalleerd. Deze kunnen conflicten veroorzaken met MTA. Als je je aanpassingen wilt behouden, kan je GTA twee keer installeren (verschillende mappen op de harde schijf).

Zorg ervoor dat je '''Windows XP''', '''Windows 2000''', '''Windows Vista''' of '''Windows Server 2003''' hebt, en dat je machine het spel in de single player mode (goed) kan draaien. Als je de single player mode al op minimaal moet zetten om te kunnen draaien, kan je slowdowns in MTA hebben, omdat het meer proccessorkracht nodig heeft.

'''Notitie: MTA:SA werkt alleen met GTA:SA v1.0.''' Als je het spel onlangs hebt gekocht, is het onwaarschijnlijk dat je deze versie hebt.

Zorg ervoor dat je naar de [[Known_Issues_-_FAQ|Bekende Problemen]] pagina kijkt als je problemen hebt, of kom op ons [https://discord.com/invite/mtasa Discord]

===Systeemeisen===
De minimale systeemeisen voor Multi Theft Auto: San Andreas zijn net iets hoger dan de originele eisen voor Grand Theft Auto: San Andreas.
* Intel Pentium 4 of AMD Athlon XP
* 512MB DDR RAM
* Schone installatie van Grand Theft Auto: San Andreas, versie 1.0 (Amerikaans of Europees)
* 4.7GB vrije harde schijf data (3.6GB voor een minimale Grand Theft Auto installatie)
* nVidia GeForce 4 serie of ATI Radeon 8xxx serie videokaart (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible geluidskaart
* Toetsenbord en muis
* Breedband internet (voor goede online ervaringen)

Voor extra functies, is een videokaart met pixel shader 2.0 nodig (nVidia GeForce FX serie of hoger, ATI Radeon 9xxx serie of hoger aanbevolen).

Voor extra laadprestaties is meer RAM aangeraden.

==Installing the game==

# Als je het nog niet gedaan hebt download dan MTA:SA van de downloadpagina op [mtasa.com].
# Start de installatie. Er wordt gevraagd welke onderdelen je wilt installeren:
#* '''Client''' is het onderdeel dat met het spel 'interfacet', het is een noodzakelijk onderdeel.
#* '''MTA Server''' geeft je de mogelijkheid om zelf een server te hosten.
#* '''MTA Server > Editor''' wordt gebruikt om zelf maps ('kaarten') te maken, dit is een optioneel onderdeel.
# Er wordt gevraagd waar je de mod wilt installeren. Dit kan overal zijn. Het hoeft niet in je GTA San Andreas map.
# Daarna wordt er gevraagd waar GTA geinstalleerd staat. Standaard is dit: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# Als de installatie klaar is wordt je de mogelijkheid gegeven om MTA meteen te starten. Maak je keuze en klik op '''Voltooien''' ('''Finish''').
# Je kunt MTA:SA:DM starten met het Start Menu als je het wilt spelen.

==Het spel spelen==
# Start Multi Theft Auto door op het icoontje in je start menu of op je achtergrond te drukken (bij '''MTA:San Andreas''').
# GTA: San Andreas zal starten, en als het geladen is, zul je het MTA:SA hoofdmenu zien. Je zult hier de volgende opties hebben:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – Dit geeft je de mogelijkheid om snel te verbinden met een server waarvan je het IP adres (of de URL) en de poort weet. Dit is handig, omdat je niet door de hele serverlijst heen hoeft te scrollen.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – Hiermee kan je een lijst van beschikbare server om op te spelen bekijken. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host Game '''– Hiermee kan je een local server starten, denk er dus aan dat de server ''niet'' in de publieke server lijst komt.</font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– Hiermee, kun je je naam, controls en beeldscherminstellingen veranderen.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– Dit laat een lijst zien van mensen die aan dit project hebben geholpen.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– Hiermee kun je je eigen maps, compleet met checkpoints, stuntblokken, pickups en andere objecten maken. Deze kan geupload worden naar een server, waarna je hem met andere spelers kan spelen.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– Hiermee ga je terug naar je bureaublad (desktop).</font>

<br /><br />
|}

De makkelijkste manier om het spel te spelen is om op '''Browse Servers''' te klikken in het menu. Een nieuw venster zal verschijnen:

<center>[[Image:manual_image006a.jpg]]</center>

Als er nog geen servers staan, druk dan op '''Refresh''', en er wordt een lijst gemaakt met beschikbare servers.

* Bij '''Name''' wordt de naam van elke server weergegeven.
* Bij '''Players''' wordt het aantal spelers aangegeven in het volgende formaat [Aantal spelers] / [Maximum spelers].
* Bij '''Ping''' wordt de ping (ook wel "latency") aangegeven tussen je machine en de serveer. Ping is een meting van hoe lang het duurt om pakketten te versturen en ontvangen van de server. Een hogere ping betekent meer lag. Over het algemeen heeft een server een lagere ping als hij dichter bij jouw locatie staat.
* Bij '''Host''' staat het IP adres van de server weergegeven, dit kan gebruikt worden met de Quick Connect optie in het menu.

Je kan op elk van deze tabs drukken om de lijst te sorteren op deze kolom. Druk nogmaals om van oplopende en aflopende volgorde te wisselen.

Voor de beste gameplay moet je zoeken naar de beste balans tussen ping en spelers.

Als je een server hebt uitgekozen, druk op '''Connect''' (rechtsbovenaan in de server browser). Als alles goed gaat, wordt je verbonden met de server, en kom je automatisch in het spel.

==Hoe te spelen==

MTA:SA bied een scripting systeem aan, waarmee mapmakeers veel elementen kunnen aanpassen, om hun eigen innovatieve gamemode te maken. Het spel heeft zoveel single player elementen als mogelijk, hoewel sommige aspecten anders zijn.

Er zijn geen voetgangers en er is geen AI verkeer op de weg. De enige andere mensen in het spel zijn je tegenstanders, of vrienden als je in een team of een niet-deathmatch game mode speelt. Je kunt praten door op '''T''' te drukken. Om alleen met je eigen team te praten, druk op '''Y'''.

MTA's map editor geeft je de mogelijkheid om GTA objecten toe te voegen aan het spel, explosieve vaten, stuntblokken, gebouwen, heuvels, en nog veel meer. Dat is nog niet alles, de objecten kunnen gescript worden om te bewegen, van model te veranderen, en te verdwijnen. Dat geeft een grote hoeveelheid aan variatie en plezier in het spel.

Tab ingedrukt houden zal het scoreboard weergeven. Normaal staan er alleen namen en pings, maar scripts kunnen extra kolommen toevoegen die informatie over een bepaalde gamemode weergeven. Bijvoorbeeld, een deathmatch game mode kan het aantal kills en deaths weergeven.

==Controle==

===In-Game Toetsen===

* F8 (of ~ toets) - Console
* F9 - In-game help
* F11 - Laat de SA kaart zien ''(the following list is for use when the map is up)''
**numpad +/- - Zoom in en uit
**numpad 4, 8, 6, 2 - beweeg de kaart
**numpad 0 - wissel tussen het laten zien van de speler's locatie, en het stil laten staan van de kaart
* F12 - Maak een screenshot
* T - Praten
* Y - Praten met team
* TAB - Lijst van spelers (als [[Scoreboard]] aanstaat op de server)

==Console Commands==

'''bind defaults''' Stelt standaard toetsen in

Druk op '''~ ''' of '''F8''' om bij de console te komen, volg dan een commando, gevolgd door eventuele parameterrs, druk daarna op enter.

;'''maps''' :Laat een lijst van alle maps op de server zien.

;'''nick [nickname]''' :Dit stelt je naam in, terwijl je in een server zit. Je naam wordt veranderd in je parameters.

;'''msg [naam] [bericht]''' of '''pm [naam] [bericht]''' :Dit stuurt een bericht naar de persoon die je aangeeft in de [naam] parameter. Alleen die peersoon kan het bericht zien. Zowel '''msg''' and '''pm''' doen dit.

;'''quit''' of '''exit''' :Dit sluit MTA af, je gaat terug naar windows. Dit is hetzelfde als het indrukken van de Quit (afsluiten) knop in het hoofdmenu.

;'''ver''' :Dit laat de versie en copyright informatie van de software zien.

;'''time''' :Dit laat de huidige tijd zien.

;'''disconnect''' :Hiermee verlaat je de server, en ga je terug naar het hoofdmenu.

;'''say [tekst]''' :Hiermee kun je in de chatbox praten terwijl de console open staat.

;'''ignore [naam]''' :Dit laat geen text zien die getypt is door de speler die je aangeeft. Om deze text weer te laten zien, moet je opnieuw '''ignore [naam]''' typen.

'''Tip:''' Je kan deze commando's in de chatbox gebruiken door een / (slash) ervoor te zetten.

Een lijst van commando's kan bekeken worden door '''help''' in de console te typen, en op penter te drukken. De huidige map kan ook extra commando's hebben die je kan zien door '''commands''' in de console te typen.

==Fout codes en hun betekenis==
'''Download fouten'''<br>
0: UNKNOWN_ERROR (onbekende fout)<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT (kan niet verbinden)<br>
9: UNABLE_TO_DOWNLOAD_FILE (kan niet downloaden)<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD (kan download niet initialiseren)<br>

'''Fatale fouten'''<br>
1: no local player model on ingame event (geen speler model bij in-game gebeurtenis)<br>
2: no local player on ingame event (geen speler bij in-game gebeurtenis)<br>
3: server downloads disabled (server downloads staan uit)<br>
4: no local player model on player-list packet (geen speler model bij spelerlijst pakket)<br>
5: no local player on player-list packet (geen speler bij spelerlijst pakket)<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Kan voertuig niet ingaan' fouten'''<br>
1: script cancelled (script geannuleerd)<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting (de huidige bestuurder gaat erin/eruit)<br>
4: invalid seat (ongeldige stoel)<br>
5: not close enough (niet dichtbij genoeg)<br>
6: already in a vehicle (is al in een voertuig)<br>
7: already entering/exiting (is al bezig met een voertuig in-/uitgaan)<br>
8: invalid vehicle (trailer) (ongeldig voertuig (aanhanger))<br>

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

AR/دليل اللاعب

2022-01-23T17:15:30Z

Turret001: replaced IRC with Discord and added a translate tag.

{{translate}}
__TOC__

==مقدمة==
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.

==قبل أن تبدأ==

قبل تثبيت MTA:SA , تأكد أولاً من عدم وجود أي تعديلات لـ GTA:SA وهذه تتعارض مع MTA.
إذا كنت ترغب في الحفاظ على التعديل الخاص بالسينقل بلآير ( لاعب واحد ), تستطيع تثبيتَ GTASA أخر على القرص الاخر بجهازك
وتأكد أيضا من ان تقوم بتشغيل "Windows XP" أوَ "Windows 2000" أوَ "Windows Vista"
أوَ "Windows server 2003" وهذا الجهاز الخاص بك قادر على تشغيل اللعبة بنظام السينقل بلآير ..
لاحظ أنه إذا كنت تقوم بتشغيل ( السينقل بلآير ) على الحد الادنى لمتطلبات تشغيل اللعبة , سوف تؤاجه بطئ في MTA ..

* ملآحظة : MTA:SA تعمل فقط على GTA:SA v1.0.. إذا كنت قد اشتريت اللعبة مؤخراً, فمن المحتمل أن يكون لديك إصدار لاحق

إذا كان للديك مشكلة او استفسار , [[Known_Issues_-_FAQ|Known Issues]]
أو عبر الدخول الى [https://discord.com/invite/mtasa Discord]

===متطلبات النظام===
متطلبات النظام الادنى:
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

ميزات اضافية: من المستحسن بأن يكون كرت الفيديو:
* nVidia GeForce FX series أو أعلىَ
* ATI Radeon 9xxx series أو اعلى

==تثبيت اللعبة==

'''This section will need to be updated when we get an installer'''

# If you haven't already, download the MTA:SA client from the download page at mtasa.com.
# Run the installer. You will be asked which components to install:
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==شرح تشغيل اللعبة==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – هذا يمكنك من الحصول على قائمة السيرفرات المتوافرة للعب فيها. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – هذا يسمح لك ببدأ سيرفر محلي </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– تستطيع من خلال هذه القائمة التحكم بأعدادات اللعبة كـتغيير الأسم الخاص بك أو تغيير أعدادات الفيديو</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– هذا يعطيك قائمة المساهمين في المشروع.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– للعودة الى سطح المكتب</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

==شرح كيفية اللعب==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==التحكم==

===المفاتيح داخل اللعبة===

* F8 (or Tilde Key) لفتح شات الكونسول
* F9 - In-game الدعم
* F11 - اظهار الخريطة ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - لتصوير الشاشة
* T - للتحدث في الشات
* Y - للتحدث في شات التيم
* TAB - ( لفتح السكور بورد ( اذا كان شغال بالسيرفر

==أوامر الكونسول==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''sver''' :This displays the version number of the server you are connected to.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

==رموز الخطأ ومعانيها==
'''أخطاء التحميل'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

==Special: Playing MTA on Linux?==
If you're one of those who have Linux as OS, and want to have the client working on Linux,
please read the [[Client_on_Linux_Manual|Client on Linux Manual]]

[[es:Manual Cliente Deathmatch]]
[[de:MTA DM Client Anleitung]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

ZH-CN/Resource:Editor

2022-01-23T17:14:34Z

Turret001: replaced IRC with Discord and added a translate tag.

{{Resource page}}
{{translate}}
MTA:SA 地图编辑器允许您创建游戏模式的地图。

==开始创建==
单击 MTA 主菜单上的 "Map editor" 选项以启动地图编辑器。

==菜单==
地图编辑器启动后，可以看到有两条菜单栏：位于顶部的主菜单，以及位于左下方的元素菜单。

===主菜单===
主菜单中有以下的选项：
* [[Image:Editor_New.png]] 创建新地图。
* [[Image:Editor_Open.png]] 打开已有地图。
* [[Image:Editor_Save.png]] 保存地图编辑进度。
* [[Image:Editor_Save_as.png]] 另存地图。
* [[Image:Editor_Options.png]] 修改地图编辑器通用设置。
* [[Image:Editor_Undo.png]] 撤销上一次的更改。
* [[Image:Editor_Redo.png]] 还原上一次的更改。
* [[Image:Editor_Locations.png]] 储存游戏世界的各个重要坐标。地图编辑器内有列举了 San Andreas 所有室内空间坐标的列表，但您也可以自行向该列表内添加室内及非室内坐标。
* [[Image:Editor_Current_elements.png]] 列举该地图内所包含的所有元素（对象、交通工具、标识等）。
* [[Image:Editor_Map_settings.png]] 地图设置，例如事件、重力等。也可以设置该地图所支持的游戏模式。
* [[Image:Editor_Definitions.png]] 加载您想要使用的[[Resource:Editor/EDF|地图编辑器定义文件 (EDF)]]。
* [[Image:Editor_Test.png]] 测试地图。同时加载该地图所支持的游戏模式以进行游戏测试。

===元素菜单===
元素菜单用于向地图中添加新元素。
* [[Image:Editor_Vehicle.png]] 创建新交通工具。
* [[Image:Editor_Object.png]] 创建新对象（建筑物、道路、装饰物等）。
* [[Image:Editor_Pickup.png]] 创建新拾取物（补血、补防护、武器及自定义拾取物）。
* [[Image:Editor_Marker.png]] 创建新标识（检查点、圆环、圆柱、箭头及光影）。
* [[File:Crosshair.png‎]] 选择世界对象。
此外，如果您加载了[[Resource:Editor/EDF|地图编辑器定义]]，您可以在元素菜单上滚动鼠标滚轮以浏览自定义元素。

==使用地图编辑器==
本节介绍如何创建及修改地图。

===移动地图===
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' 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.
当初次启动地图编辑器，当前模式为 ''摄影机模式''。您可以使用 '''WSAD''' 键

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 [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 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 download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_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 download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_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 [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [https://discord.com/invite/mtasa Discord].

[[ru:Resource:Editor]]
[[es:Resource:Editor]]

RU/Client Manual

2022-01-23T17:14:00Z

Turret001: replaced IRC with Discord

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://wiki.multitheftauto.com/wiki/Archive архив]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

==Перед началом установки==
Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете сохранить модифицированную однопользовательскую игру, вы можете повторно установить San Andreas в другую директорию на жестком диске, в которую затем установите Multi Theft Auto: San Andreas.

Также убедитесь в том, что у вас установлена одна из следующих операционных систем: '''Windows XP''', '''Windows Vista''' (32- или 64-битная), '''Windows 7''' (32- или 64-битная) или '''Windows 8''' (32- или 64-битная), и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. Обратите внимание на то, что если вы запускаете одиночный режим игры на компьютере, обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные тем, что MTA требуются некоторые большие вычислительные мощности.

{{Note|
* Обратите внимание: MTA:SA работает только с GTA:SA EXE '''v1.0'''. Если вы приобрели игру недавно, то возможно, что у вас более поздняя версия игры. [[RU/Known_Issues_-_FAQ#Работает ли MTASA 1.x с версиями GTA San Andreas 1.01 или 2.00?| (Подробнее)]]
* Если у вас GTA: San Andreas от Steam, вам следует [[RU/Known_Issues_-_FAQ#У меня Steam-версия GTA San Andreas. Как я могу сыграть в MTASA?|сначала ознакомиться с этим]].
}}

===Системные требования===
====Минимальные системные требования====
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas '''незначительно выше''' системных требований игры Grand Theft Auto: San Andreas:
* процессор класса Intel Pentium 4 или AMD Athlon XP
* 512МБ DDR ОЗУ
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 (американская или европейская)
* 3.7ГБ свободного места на жестком диске (3.6ГБ для установки Grand Theft Auto) (Помните, что MTA кэширует файлы серверов, на которых вы играете, и для них тоже требуется место)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx с 64MB ОЗУ и поддержкой DirectX 9.0
* звуковая карта или кодек с поддержкой DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет (для стабильной игры по сети)
====Рекомендуемые системные требования====
* процессор класса Intel Core 2 Duo или эквивалентные им от AMD
* 1ГБ DDR ОЗУ
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 (американская или европейская)
* >5ГБ свободного места на жестком диске
* видеокарта семейства nVidia GeForce FX или выше, семейства ATI Radeon 9xxx или выше (с поддержкой пиксельных шейдеров версии 2.0.)
* звуковая карта или кодек с поддержкой DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет (для стабильной игры по сети)
====Заметки====
* Минимальные системные требования следует считать "сырым" минимумом для MTA: San Andreas, быстродействие же может зависеть от запущенных игровых режимов и количества игроков.
* Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.
* Убедитесь, что на Windows установлены все обновления.
* Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[RU/Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами в [https://discord.com/invite/mtasa Discord]

==Установка игры==

# Перейдите на сайт [http://mtasa.com mtasa.com] и скачайте установщик клиентского приложения MTA:SA, если вы еще этого не сделали.
# Запустите установочный файл, для запуска на Windows Vista и 7 требуются права администратора. (Установщик сам их спросит)
# Вам потребуется принять лицензионное соглашение, идущее с MTA:SA (GPLv3).
# Затем вам предложат выбрать компоненты для установки.
#* '''Game Client''' интерфейсы игры, является обязательным компонентом.
#* '''Dedicated Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#**'''Core components''' и '''Game module''' являются компонентами, требующимися для выделенного сервера.
#** '''Core resources''' это требуемые для выделенного сервера ресурсы.
#** '''Optional resources''' это дополнительные ресурсы для вашего выделенного сервера, игровые режимы и карты.
#** '''Editor''' используется для создания новых карт, является необязательным компонентом.
#* '''Development''' Инструменты разработчика.
#** '''Module SDK''' разработческий SDK для создания ваших собственных серверных модулей, данный компонент требует знания C++.
#* '''Start menu group''' создает папку с установленными компонентами в меню "Пуск"
#* '''Desktop icon''' создает иконку клиента на рабочем столе.
# Затем вас спросят, в какую папку установить мод. Устанавливать можно куда угодно, не обязательно, чтобы это была папка с игрой.
# После, вам необходимо выбрать директорию, в которую установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA San Andreas из меню "Пуск", когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto, щелкнув левой кнопкой мыши по иконке, расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запустится GTA: San Andreas, и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню (вы также можете посмотреть how-to пособие [http://www.youtube.com/watch?v=ShiqnOazNYw здесь]):

{| border="0" align="center"

| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – позволяет вам создать свой собственный локальный сервер. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings''' – этот пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About''' – этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor''' – этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, пикапы и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit''' – этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру является выбор в меню пункта '''Browse Servers'''. Если сервера не появились автоматически, нажмите кнопку '''Refresh''', и MTA выполнит поиск серверов, отобразив их в виде списка.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно сервера, расположенные наиболее близко к вам по географическому местоположению, должны иметь наиболее низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

По каждому столбцу можно щелкать указателем мыши для упорядочивания значений столбца по возрастанию или убыванию.

Для оптимальной работы приложения и процесса игры, выбирайте сервера с наилучшим балансом между числом игроков и временем задержки.

После того, как вы выбрали нужный вам сервер, выберите его строку из списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединитесь с сервером и автоматически включитесь в процесс игры.

==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателям игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра включает в себя настолько много элементов однопользовательской игры, насколько возможно, но в некоторых аспектах может отличаться.

Вашими оппонентами на игровой карте являются другие игроки, или союзники, если это карта командной игры. Вы можете общаться с ними, используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты, включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, изменения модели и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

Окно просмотра игроков, доступное по нажатию на клавишу '''Tab''', будет отображать очки, заработанные игроком. По умолчанию, отображаются только имена и время задержки, но сценарии могут добавить дополнительные столбцы, которые являются специфичными определенному режиму игры. Например, режим игры "deathmatch" может иметь столбец, перечисляющий общее число убийств, но создатель карт может выбирать сам и добавить дополнительные колонки для числа смертей вашего персонажа, длительности вашей игры, а также поместить очки, заработанные вами.

==Управление по умолчанию==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - переключиться между режимами карты: закрепить карту за локальным игроком (карта следует за меткой игрока) и свободное передвижение (карта остается неподвижной)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат

===Специфические ресурсам клавиши===
Данные клавиши зависят от скриптов, запущенных на сервере.

* F9 - Внутриигровая помощь (ресурс Help manager)
* V - Голосовой чат (нажмите, чтобы говорить), если запущен ресурс voice.
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажмите '''~ (тильду)''' или '''F8''' для доступа к консоли, затем введите команду, за которой при необходимости следуют параметры (если нужно), затем нажмите Enter.

;'''maps''' :Отобразить список всех карт, доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами, может увидеть это сообщение. И '''msg''', и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''sver''' :Отобразить номер версии сервера, к которому вы подключены.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока, введите команду '''ignore [nickname]''' снова.

{{Tip|Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).}}

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ, введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
====Ошибки загрузки====
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}

====Неустранимые ошибки====
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|no local player model on ingame event
|-
|2
|no local player on ingame event
|-
|3
|server downloads disabled
|-
|4
|no local player model on player-list packet
|-
|5
|no local player on player-list packet
|-
|6
|invalid custom data length on entity-add packet
|-
|7
|invalid bitstream data on entity-add packet
|-
|8
|system entity on entity-add packet
|-
|9
|failed to create object on entity-add packet
|-
|10
|failed to create pickup on entity-add packet
|-
|11
|failed to create vehicle on entity-add packet
|-
|12
|invalid team-name length on entity-add packet
|-
|13
|invalid lua-event name length in lua-event packet
|-
|14
|invalid resource name length in resource-start packet
|}

====Ошибки типа 'Unable to enter vehicle====
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

==Дополнительно: Играть в MTA на Linux?==
Если вы один из тех, кто использует Linux в качестве ОС и хотите иметь рабочий клиент на Linux, пожалуйста, прочитайте [[RU/Client_on_Linux_Manual|клиентскую справку для Linux]]

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

[[Category:Поддержка]]

PT-BR/Manual do Servidor

2022-01-23T17:12:45Z

Turret001: replaced IRC with Discord

==Introdução==
Configurar um servidor e disponibilizá-lo para que seus amigos joguem via Internet ou LAN é mais fácil do que parece. Neste artigo estaremos abordando os passos iniciais para que você possa criar seu próprio servidor para o MTA.

==Instalando o servidor==
A primeira parte consiste na instalação do servidor. Abaixo há dois tópicos, abordando a instalação em plataformas Linux e Windows.

===Instalando no Linux===
Há diversas maneiras de instalar, configurar e iniciar um servidor no Linux:
* [[Image:iUS.png|Em Inglês|20px]] [[Building MTASA Server on GNU Linux|Configurando um Servidor de MTASA no GNU Linux]]
* [[Image:iUS.png|Em Inglês|20px]] [http://linux.mtasa.com Baixando o servidor para Linux]

===Instalando no Windows===
Instalar um servidor do MTA:SA no Windows é bem simples:
:*Vá para [http://mtasa.com/ página de download] do MTA:SA e baixe o instalador.
:*Após o término do download, execute o arquivo.
:*Clique em Next e depois em "I Agree".
:*Nesta etapa você pode selecionar os componentes que deseja ou não instalar:
:**Para instalar somente o servidor, mude a opção "Client and Server" para "Server Only"
:**Next para continuar.
:*Selecione a pasta na qual deseja instalar o servidor. Em seguida, Next.
:*Clique em Install.
:*Pronto!

==Configurando o servidor==
O servidor dedicado do Multi Theft Auto pode ser configurado através...

*De uma espécie de prompt de comando chamado '''console''', ou seja, um programa onde comandos não são enviados através de cliques, mas sim através de linhas de comando digitadas pelo usuário.
** Esse programa está localizado em "MTA San Andreas 1.3\server\MTA Server.exe".
** Ele é idêntico a janela ''cmd'' do windows.
** Enquanto este estiver executando, o servidor vai permanecer online, caso contrário, o servidor sai do ar.

*'''Do próprio jogo'''
**Os comandos para configurar o servidor são enviados a partir do chat.
** Para que estes comandos sejam efetivamente enviados, é necessário o uso da "/" antes do comando em si, pois esta identifica o que vem logo em seguida faz parte de um comando.. Exemplo "/addaccount".
*'''De um navegador de internet'''. Um website pode receber informações e configurar um servidor de MTA.

{{Dica|''Para que possa configurar um servidor do MTASA no jogo ou via website é necessário que pelo menos uma conta com privilégios de administrador seja adicionada no arquivo '''acl.xml'''.''}}

===Configurações Gerais===

*Todas as configurações gerais podem ser encontradas no arquivo "[[Server_mtaserver.conf|'''mtaserver.conf''']]" localizado na pasta "mods/deathmatch/". Este arquivo pode ser visualizado em qualquer editor de texto.

Ele é bem simples e direto, toda variável tem uma [[Server_mtaserver.conf|descrição abordando o que esta faz e como usa-la]].

*O MTA possui um arquivo exclusivo para limitar o acesso de certos usuários, administradores ou recursos à certas funções. O arquivo é conhecido como ''Lista de Controle de Acesso (ACL)'' e ele é importantissímo para que você estabeleça uma ordem em seu servidor. É recomendado que seja feita a leitura deste artigo, então não se esqueça dar uma olhada em:
** [[Image:iUS.png|Em Inglês|20px]] [[Access_Control_List|O que é Access Control List]]''

===Configurando as Portas===
Caso esteja executando um servidor a partir de seu computador e há um roteador entre a internet e sua máquina, então será necessário configurar 3 portas.

Antes de mais nada, abra o arquivo localizado em "mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]" e procure pelas linhas citadas a seguir:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Estas portas são necessárias para que o servidor inicie corretamente. Explicaremos com maiores detalhes mais a frente. Se deseja também que seu servidor apareça na lista de servidores do MTA (Server Browser, no menu), será preciso configurar mais uma porta chamada "ASE".

(Exemplo de como ativar/desativar a porta ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Agora vamos liberar essas portas em seu roteador. Caso todas as portas estejam abertas ou você possui um roteador sem firewall, esta etapa é desnecessária.

Se você não sabe como abrir portas em seu roteador, visite [http://portforward.com/ este site], procure pelo modelo de seu roteador e siga as instruções.

Na maioria dos roteadores, há a opção de selecionar o tipo de porta: UDP ou TCP. A lista a seguir irá explicar qual porta é necessaria para que ela serve:

*Porta principal do servidor: UDP (a porta padrão é 22003, mas você pode alterá-la no parâmetro <serverport> do mtaserver.config)
*Porta HTTP: TCP (a porta padrão é 22005, mas você pode alterá-la no parâmetro <httpport> do mtaserver.config)
*Porta ASE: UDP (esta é necessária caso deseje que o servidor apareça na lista de servidores do gamemonitor.com)

Para configurar a porta ASE, somamos 123 (cento e vinte e três) à porta padrão. Exemplo:

Porta padrão: 22003
ASE: 22003 + 123 = 22126

Boa sorte!

''Na ultima versão do servidor, ao se digitar o comando "/[[Server_Commands#openports|openports]]", os status de todas as portas serão mostrados.''

===Verificação dos clientes===
Todo jogador que entra em um servidor passa por várias "avaliações", também conhecidas como "Client Checks" (em inglês).
Esse processo é necessário, principalmente, para previnir trapaças no jogo, as quais são feitas através de trainers e/ou modificações realizadas nos arquivos originais do GTA SA.
Todas essas "avaliações" são divididas em diversos parâmetros, os quais são configuráveis através do arquivo [[Server_mtaserver.conf|'''mtaserver.conf''']] localizado em "mods/deathmatch".
Destacamos 2 delas como exemplo:

* O parâmetro '''client-file''' ...
** Habilita que um ou mais arquivos possam ser modificados no computador do jogador (exemplo: carmods.dat). Por padrão, o MTA não permite que nenhum arquivo da pasta "data" e "anim" do GTA SA seja modificado.
** Pertence a um grupo denominado Anti-Cheat, pois, por padrão, ele evita que um ou mais jogadores tenham vantagens sobre os outros. Todos os demais parâmetros que fazem parte desse grupo estão detalhados neste guia [[Anti-cheat_guide|Anti-Cheat]].
* O parâmetro '''minclientversion'''...
** Estabelece que todos os jogadores usem uma versão igual ou superior a estipulada (exemplo: 1.3.0).
** Aqueles que estiverem usando uma versão inferior serão automaticamente desconectados do servidor.<br/>

Cada parâmetro contido no arquivo [[Server_mtaserver.conf|'''mtaserver.conf''']] tem um valor atribuido a ele. O que faz que o servidor ignore ou trabalhe de forma diferente ao realizar essas avaliações em cada jogador.

Se deseja definir uma versão mínima do MTA dos seus jogadores, procure pela linha:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Use valores como: 1.1.1-9.02320

===Adicionando administradores===
É altamente recomendável adicionar, no mínimo, um administrador em seu servidor. Pois assim você poderá fazer uso de alguns recursos especiais, como o gerenciador Web ou alguns scripts que precisem acessar a lista ACL (painéis administrativos, por exemplo).

Para adicionar um administrador ao seu servidor, siga os seguintes passos:<br>
<ol>
<li>Enquanto o servidor estiver ligado (MTA Server.exe sendo executado), adicione uma nova conta digitando '''[[Server_Commands#addaccount|addaccount nome senha]]''' no console. Por exemplo, para adicionar o usuário Fulano você poderia digitar:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount Fulano minhasenha123
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
{{Dica|''Se você não tem acesso à janela do console, e o recurso "admin" está sendo executado, você pode adicionar uma nova conta digitando, no chat principal, o comando '''/register Fulano minhasenha123'''''}}
</div>
<li>O servidor deverá mostrar uma mensagem confirmando o registo da nova conta.
<li>A seguir, desligue o servidor digitando '''shutdown''' no console.
<li>Tenha certeza de que seu servidor foi desligado. Se ele continua online, as informações a seguir serão perdidas</li>
<li>Abra o arquivo 'mods/deathmatch/'acl.xml'''' com um Editor de Textos qualquer (pode ser o Bloco de Notas).
<li>Adicione a nova conta no grupo ''Admin'' usando a seguinte sintaxe do XML:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.Fulano" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Você pode adicionar o usuário criado no grupo que preferir. Cada grupo é linkado a um ACL ([[Acess Control List]]). Cada ACL contém uma série de ações que você pode ou não realizar dentro deste grupo (como kickar, banir, etc). Estes grupos existem para que diferentes usuários possam ter diferentes direitos em um servidor. O grupo ''Admin'' é apontado no ACL como um grupo poderoso (onde tudo é permitido). Já o grupo ''Everyone'', que significa ''Todos'', é apontado no ACL como um grupo com diversas restrições (ou seja, não podem kickar, banir, mutar, etc.).
</li>
<li>Pronto, você terminou! Agora você pode adicionar diversos usuários (sejam administradores ou usuários comuns). Dê uma olhada também nos outros grupos e ACLs disponíveis. O ACL é também acessível a partir do [[Acess_Control_List|Mecanismo de Scripting Lua]].<br>
É recomendado também que você dê uma olhada na interface Web. Iremos explicar como a seguir.
</li>
</ol>

{{Dica|Existem também outras formas de adicionar contas e editar as permissões do servidor enquanto ele está sendo executado. "[[Server_Commands#addaccount|addaccount <usuário> <senha>]]" é um comando interno para adicionar contas, mas você vai precisar usar a interface Web para adicionar essas contas a um grupo/ACL específico.}}<br />

===Usando a interface Web===
O servidor dedicado (o servidor configurado em sua máquina) vem, por padrão, com alguns [[recursos]] em Lua que fornecem uma inteface Web de gerenciamento para seu servidor (melhor dizendo, permite que você gerencie seu servidor através de um site). O recurso pode ser usado para facilitar a manutenção de seu servidor, permitindo adicionar usuários, iniciar/pausar recursos, e muito mais.

A interface Web é habilitada por padrão e são servidos através do protocolo HTTP. Para ter certeza de que o servidor web está rodando na sua porta HTTP (que por padrão é a 22005), siga os seguintes passos:
<ol>
<li>Certifique-se que seu servidor foi pausado (ou desligado)
<li>Abra o arquivo 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' com um editor de textos qualquer</li>
<li>Verifique se o servidor HTTP está ativado:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Escolha a sua porta HTTP:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Salve o arquivo e feche-o</li>
<li>Inicie seu servidor (MTA Server.exe)</li>
<li>Se você chegou a alterar os recursos que são iniciados por padrão com o seu servidor, então certifique-se de que os seguintes recursos foram iniciados:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Estes recursos são, por padrão, iniciados automaticamente com seu servidor, no caso de você ter instalado somente o servidor.
</li>
<li>Abra um navegador web (Internet Explorer 6 ou 7 não é suportado; use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] ou outros) e navegue até o endereço do servidor HTTP:
'''http://servidor:porta/'''. Por exemplo, se você está rodando o servidor localmente (no seu próprio computador) com a porta 22005 (padrão), use '''http://127.0.0.1:22005/'''.</li>
<li>Entre com o usuário e senha do administrador (que você adicionou nos passos anteriores).</li>
</ol>
<br />

Agora você deverá estar possibilitado de manipular seu servidor através do gerenciador Web.

=== Configurando um servidor web externo ===

A interface web é também usada para distribuir arquivos que precisam estar nos computadores dos jogadores para que os recursos, que estão rodando no servidor, funcionem corretamente. Por exemplo, se um script que use a interface gráfica ou modelos costumizados para realizar tal função, o próprio código e os modelos terão que ser transferidos para cada jogador que estiver conectado. Isso porque estes recursos são processados no computador de cada cliente sem precisar da "tutela" do servidor. Estes arquivos são salvos em uma pasta do MTA para não haver uma necessidade de baixar-los novamente na próxima vez que estes forem requisitados.
Este processo de distribuir os arquivos para todos os clientes pode ser feito por um:
* ''Servidor web embutido no próprio servidor'', ou seja, já vem com o servidor.
* ''Servidor web externo'' (este é comum ser um pouco mais rápido) que precisa de ser configurado separadamente.

Devido a razões relacionadas a performace e experiência durante o jogo, você provavelmente vai preferir usar um servidor web externo. Caso possuir algum a disposição, este servidor deve ser acessível para o público (sem o requisito de um usuário e senha, por exemplo), visto que todo cliente poderá baixar os arquivos necessários e jogar em seu servidor sem menor problema algum.

Para habilitar o download de arquivos em um servidor externo, é preciso colocar o link de seu servidor na ''marcação'' [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] do arquivo mtaserver.conf:

* Você encontrará a seguinte linha, coloque o link de seu servidor...
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>AQUI</httpdownloadurl>
</syntaxhighlight></div>

Todos os recursos que já vem na instalação do MTA (race, assault, play) são fornecidos ao servidor dedicado ainda zipados. O servidor web embutido automaticamente já extrai estes arquivos, mas você tem que encontrar uma forma de enviar só a parte necessária (os modelos, texturas, scripts contendo GUI's) para os computadores dos clientes ou você vai querer que ele baixe seu todos seus scripts? Para fazer uma cópia somente destes arquivos necessários, verifique se o valor da marcação [[Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] esteje em 1:

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

Quando seu servidor estiver rodando, o diretório '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' vai conter os arquivos corretos para serem hospedados em seu servidor web.

* Se este servidor for embutido (na mesma máquina), você pode simplesmente botar '''http-client-files''' como o link de seu servidor web:

<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>http-client-files</httpdownloadurl>
</syntaxhighlight></div>

* Se este servidor for externo (em uma máquina diferente), certifique que o link esteja acessível. Este link também pode ser de um computador remoto que esteja conectado ao seu via um programa de sincronização, exemplo:

<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>http://www.meuservidor.pb/diretorio</httpdownloadurl>
</syntaxhighlight></div>

{{Dica| Tente evitar quaisquer caracteres speciais como ~, ! em seus links. Não use use uma barra no final de seu link. Use ''hxxp://www.meuservidor.pb/diretorio'' em vez de ''hxxp://www.meuservidor.pb/diretorio/''}}

==Iniciando seu servidor==
Primeiro, tenha certeza que todas as etapas acima estão devidamente concluídas para que seu servidor esteja configurado e pronto para entrar no ar!

Para iniciar seu servidor, dê um clique duplo em "MTA Server.exe". Certifique-se que você liberou este aplicativo em todos os firewalls instalados e que todas as portas estejam abertas para que tudo funcione como o esperado.

==Instalando/Atualizando/Desinstalando recursos de seu servidor==

Os recursos podem estar em dois formatos, tanto em ZIP, tanto em uma pasta normal com os arquivos de script e seus derivados dentro dela. O servidor do MTA:SA carrega estes dois formatos. Para instalar/atualizar quaisquer recursos, o processo é bem simples:

# Mova ou copie o novo recurso para a pasta do seu "<SERVIDOR>\mods\deathmatch\resources".
# Na janela de comando do seu servidor, digite [[Server_Commands#refresh|refresh]]. Assim será feito um escaneamento todas as pastas para verificar se recursos foram adicionados.

A desinstalação de recursos que não são mais úteis é feita de uma forma bem simples:

# Delete o arquivo ZIP ou a pasta do recurso que desejas remover.
# Na janela de comando, digite "refresh" (sem as aspas). Assim será feito um escaneamento todas as pastas para verificar se recursos foram removidos.

{{Dica| O sistema de pastas do MTA mudou a partir das novas versões lançadas, facilitando a organização dos recursos. Então a pasta que estiver nomeada entre cochetes (exemplo: '''['''editor''']''') não será interpretada como um recurso mais sim como uma "pasta normal".}}

==Administrando seu servidor==

Ao se digitar o comando "start nomedorecurso" na janela de comando do servidor, um recurso será iniciado. Se quiser parar, digite "stop nomedorecurso".

É possivel executar estes comandos e outros na janela de comando dentro do próprio jogo, a qual pode ser aberta com a tecla F8. Para que esta tática funcione, você deve fazer seu login com o comando "[[Server_Commands#login|login usuário senha]]". Você pode também apertar a tecla p para mostrar o painel de administrador (uma interface gráfica que lhe permite ganhar tempo para kickar ou banir maus encarnados de seu servidor).

Para saber de outros comandos, digite [[Server_Commands#help|help]] em um console.

==Iniciando um mapa ou modo de jogo==

Dê uma lida na sessão de comandos para o [[Resource:Map manager|mapmanager (em Inglês)]] para mais informações:

==Notas Úteis==

# Você pode estar sempre atualizando seus recursos enquanto estiver no jogo desde que você esteje logado em um devido nível: "refresh" na janela de comando do servidor ou "/refresh" na janela do chat. Isso pode causar um lag por alguns segundos, se muitos recursos estiverem isntalados.
# Nas instruções acima, <SERVIDOR> é um diretório para a pasta principal do servidor. Na maioria dos casos, o diretório é: C:\Program Files\MTA San Andreas\server
# Você pode indicar um arquivo diferente para servir como aquele de configuração (por padrão é o mtaserver.conf): "<SERVIDOR>\MTA Server.exe -config outraconfiguração.conf"

====Dúvidas?====
Porque não nos visitar em nosso:
* [[Image:iBR.png|Em Português|20px]] [http://forum.mtasa.com/viewforum.php?f=120&sid=e8dc031718fa8b150d7138db91ccd47f Fórum]
* [[Image:iBR.png|Em Português|20px]][[Image:iUS.png|Em Inglês|20px]] [https://discord.com/invite/mtasa Discord]

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

[[Category:Suporte]]

PL/Server Manual

2022-01-23T17:11:44Z

Turret001: replaced IRC with Discord

__TOC__

== Pierwsze kroki ==
Uruchomienie swojego własnego serwera MTA:SA jest o wiele łatwiejsze niż mogłoby się wydawać. Jeżeli chciałbyś postawić serwer by pograć ze znajomymi lub po prostu z ludźmi z sieci - zachęcam do lektury.

== Instalacja serwera ==
Poniżej opisane są sposoby instalacji serwera w zależności od posiadanego systemu operacyjnego.

=== Linux ===
Serwer pod Linuksem można zainstalować na dwa sposoby:
* [http://wiki.github.com/multitheftauto/multitheftauto/building-on-gnulinux Kompilując kod źródłowy ]
* [http://linux.mtasa.com Uruchamiając gotowe binarki (wcześniej skompilowane pliki) ]

=== Linux (x64/x86) ===
Dokładniejszy opis dedykowany instalacji serwera na systemach 64 lub 86 bitowych (które nie są wspierane przez zespół MTA) można znaleźć w moim [[PL/Linux_64 | dokładniejszym opisie ]]

=== Windows ===
Instalacja serwera na Windowsie jest prosta "jak budowa cepa".
* Najpierw pobieramy instalator [http://mtasa.com ze strony głównej]
* Po ściągnięciu uruchamiamy ów instalator
* Wybieramy folder gdzie chcemy zainstalować MTA (serwer jest w jednej paczce z klientem)
* Klikamy na zainstaluj...
* ...i gotowe!

== Konfiguracja serwera ==
Serwer Multi Theft Auto jest wstępnie konfigurowany z okna konsoli, z poziomu gry i z przeglądarki internetowej.

=== Ogólna konfiguracja ===
Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/'''mtaserver.conf'''".
Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego ''notatnik''-a, zaś na Linuksie ''nano'' lub ''vi'').

W pliku tym przy prawie każdej zmiennej znajduje się opis w języku angielskim, co jest dużym ułatwieniem.

=== Przekierowanie portów ===
W pliku '''mtaserver.conf''' znajdują się takie dwie linijki:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Odpowiadają one za to na jakim porcie (portach) będzie nasłuchiwał nasz serwer.
Jak już wcześniej była o tym mowa - panel-www domyślnie nasłuchuje na porcie 22005 (tutaj to ustawienie możemy zmienić).
Podobnie serwer domyślnie nasłuchuje na porcie 22003 (co również może ulec zmianie - w/g naszego "widzimisię").

<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

=== Kontrola klienta ===

MTA San Andreas ma skonfigurowanego AntyCheata. Aby antycheat działał na wszystkich, należy ustawić minimalną wersje klienta.

Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Minimalna wersja z antycheatem: 1.1.1-9.02320

=== Konta administratorskie ===
Zaleca się, aby serwer posiadał przynajmniej jedno konto administratora - tak, aby właściciel serwera miał w każdej chwili możliwość włączenia/wyłączenia serwera (lub danej jego części poprzez panel-www, konsole, grę).

Aby dodać konto administratora, postępuj według tych kroków:<br>
<ol>
<li>Uruchom serwer i dodaj nowe konto za pomocą '''[[Server_Commands#addaccount|addaccount name password]]''' w konsoli serwera, o tak:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount SEBA18293 12344321
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Notka: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\
'''/register SEBA18293 12344321'''''
</div>
<li>Serwer wyświetli wiadomość, a ty zarejestrujesz konto.
<li>Następnie wyłącz serwer za pomocą '''shutdown''' w konsoli serwera.
<li>Serwer zostanie zatrzymany.</li>
<li>Otwórz plik 'mods/deathmatch/acl.xml' za pomocą edytora tekstu.</li>
<li>Dodaj konto do grupy ''Admin''
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.SEBA18293" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Gratulacje, dodałeś konto administratora.
</li>
</ol>

=== Korzystanie z interfejsu WWW (panelu www) ===
Poprzez panel-www możemy zarządzać jak już wcześniej wspomniano konkretnymi elementami serwera (tzw. "zasobami" - z ang. resource).
Możemy je uruchamiać, zatrzymywać, restartować.

Interfejs WWW może zostać wyłączony poprzez ustawienie zmiennej:
<syntaxhighlight lang="lua">
<httpserver>1</httpserver>
</syntaxhighlight>
na 0.

Za poprawne działanie interfejsu WWW odpowiadają następujące zasoby:
* resourcebrowser
* resourcemanager
* webadmin
* webmap

Są one ustawione jako uruchamiane domyślnie w standardowej konfiguracji serwera.

=== Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, cssy itd.) ===
Jeżeli twój serwer korzysta z edytowanych modeli aut, obrazków w grze (lub na wbudowanym serwerze www) możesz ustawić w ustawieniach serwera, aby zewnętrzny serwer WWW serwował pliki za nie odpowiedzialne.
Domyślnie pliki serwowane są z serwera MTA (powyższa operacja może służyć przyśpieszeniu procesu pobierania - lub po prostu odciążeniu serwera).

Aby umożliwić pobieranie potrzebnych plików z zewnętrznego serwera, należy ustawić zmienną '''httpdownload''' i '''httpdownloadurl''' w konfiguracji serwera:

<syntaxhighlight lang="lua"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>
</syntaxhighlight>

W tym momencie po uruchomieniu serwera w katalogu '''/mods/deathmatch/resourcecache/http-client-files''' będą znajdować się archiwa .zip zawierające pliki które należy wrzucić na wcześniej ustawiony zewnętrzny serwer www.

Domyślnie zostaną wygenerowane pliki dla wszystkich zasobów. Jeżeli chcielibyśmy aby domyślne (takie jak webadmin itd.) dalej korzystały z wbudowanego serwowania plików w MTA, możemy ustawić w konfiguracji serwera, aby wygenerowane zostały tylko pliki dla '''rozpakowanych''' (w katalogu ''resources'') zasobów.
<syntaxhighlight lang="lua"><httpautoclientfiles>1</httpautoclientfiles></syntaxhighlight>

'''Uwaga:
* Zaleca się nie używać w adresie zewnętrznego serwera www specjalnych znaków (takich jak !, ~).
* Na końcu adresu zewnętrznego serwera nie należy stawiać "slesza" (/).'''

== Uruchamianie serwera ==
Aby uruchomić serwer kliknij dwukrotnie na plik '''MTA-Server.exe'''.
Na Linuksie uruchom komende '''./mta-server'''.

== Instalacja/Aktualizacja zasobów ("modów") na serwerze ==
Zasoby serwera (tzw. "mody") mogą być wgrane na dwa sposoby:
* Archiwum ZIP (zawierające pliki zasobu)
* Katalog zawierający pliki zasobu

Aby wgrać nowy zasób należy:
# Przenieść lub skopiować go do '''mods/deathmatch/resources/'''.
# W oknie konsoli serwera wpisać komendę '''refresh'''.

== Usuwanie zasobów ("modów") ==
Usuwanie zasobów jest bardzo proste. Sprowadza się do:

# Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
# Wpisania w oknie konsoli komendy '''refresh'''.

== Administrowanie serwerem ==
Aby uruchomić dany zasób wystarczy użyć polecenia (oczywiście bez nawiasu):
<syntaxhighlight lang="lua">start [nazwa zasobu]</syntaxhighlight>
Następnie gdybyśmy chcieli go zatrzymać:
<syntaxhighlight lang="lua">stop [nazwa zasobu]</syntaxhighlight>
Jeśli zrestartować:
<syntaxhighlight lang="lua">restart [nazwa zasobu]</syntaxhighlight>

Administracja jest również możliwa poprzez panel www (wcześniej opisany) lub poprzez grę.
Po zalogowaniu się na konto administratora:
<syntaxhighlight lang="lua">/login [nazwa konta] [haslo]</syntaxhighlight>
i wciskając klawisz F8. W owym panel oferuje nam kick-owanie i banowanie graczy (czyli takie podstawowe czynności).

== Uruchamianie map / Tryb gry ==
Więcej informacji [[map_manager|znajdziesz tutaj]][[Image:usen.gif|Artykuł w języku angielskim]].

== Uwagi ==

# Zasoby można odświeżać również w grze, jeżeli w nadamy odpowiednie uprawnienia w pliku ''acl.xml''.
# W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera).
# Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr ''--config [nazwa pliku konfiguracyjnego]''
# Nie należy martwić się błędem dotyczącym pliku ''settings.xml''.

== Potrzebujesz pomocy ?==
Potrzebujesz pomocy? Napisz na [http://forum.mtasa.com/ forum] lub napisz na [https://discord.com/invite/mtasa Discord].

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

PT-BR/Manual do Cliente

2022-01-23T17:11:29Z

Turret001: replaced IRC with Discord

==Introdução==
Multi Theft Auto: San Andreas, também conhecido como MTA ou MTA:SA, é uma modificação criada por fãs que permite jogar o Grand Theft Auto: San Andreas (somente versão PC) no modo multiplayer. Para jogar Grand Theft Auto III e Grand Theft Auto: Vice City no modo multiplayer, há antigas versões do MTA disponíveis, as quais estão descritas em [[Archive|Arquivos]]. MTA:SA não tem vínculos com a Rockstar Games ou Take 2 Interactive.

==Antes de começar==

Antes de instalar o Multi Theft Auto: San Andreas, assegure-se de que não há modificações (também conhecidas como "mods") instaladas em seu GTA:SA, caso contrário, as modificações entrarão em conflito com o MTA. Se deseja preservar seus mods, instale o GTA: San Andreas novamente em uma outra pasta em seu disco rígido e, em seguida, instale o MTA nela.

Certifique-se de que seu computador seja capaz de rodar o jogo no modo single player. Se o seu computador estiver rodando GTA: San Andreas nos requisitos mínimos, ficará mais lento ainda no MTA:SA, já que este exige maior processamento de sua máquina.

{{Dica|
* MTA:SA só funcionará no GTA:SA v1.0. Se você comprou o jogo recentemente, é provável que ele seja uma versão mais nova. Para mais informações, clique [[PT-BR/Soluções_de_Problemas_-_FAQ#MTASA_funciona_na_vers.C3.A3o_1.01_ou_2.00_do_GTA_San_Andreas.3F|aqui]]
* Se você tem uma cópia do GTA: San Andreas baixada na Steam, é recomendado a leitura [[PT-BR/Soluções_de_Problemas_-_FAQ#Meu_GTA_San_Andreas_foi_baixado_pelo_Steam._MTASA_.C3.A9_compativel.3F|deste tópico.]]}}

===Requisitos do Sistema===
====Requisitos Mínimos====
Os requisitos mínimos para Multi Theft Auto: San Andreas são um pouco superiores aos requisitos mínimos do Grand Theft Auto: San Andreas.
* Windows 7 ou versões superiores (Windows XP e Windows Vista também são suportados, mas estes estão obsoletos e o suporte está acabando)
* Intel Pentium 4 ou AMD Athlon XP
* 1GB DDR RAM
* Grand Theft Auto: San Andreas versão 1.0 (Americana ou Européia) sem nenhuma modificação
* 3.7 GB livres em disco (3.6 GB para a instalação "econômica" do Grand Theft Auto. Lembre-se: o MTA faz cache dos arquivos dos servidores. Conforme você joga, vai precisar de mais espaço.)
* nVidia GeForce 4 series ou ATI Radeon 8xxx series (64MB VRAM e compatível com DirectX 9.0)
* Som compatível com DirectX 9.0
* Mouse e teclado
* Acesso à Internet

====Requisitos Recomendados====
* Windows 7 ou versões mais novas de 64 bits
* Intel Core 2 Duo ou um AMD equivalente
* 2GB DDR RAM
* Grand Theft Auto: San Andreas versão 1.0 (Americana ou Européia) sem nenhuma modificação
* Pelo menos 5GB de espaço livre em disco
* nVidia GeForce FX series ou superior, ATI Radeon 9xxx series ou superior, compatível com Pixel Shader 2.0
* Som compatível com DirectX 9.0
* Mouse e teclado
* Acesso à Internet

====Notas====
* Os requisitos mínimos citados são o mínimo necessário para rodar o MTA:SA, mas a performance do seu jogo pode variar conforme os recursos e mods de cada servidor.
* Para mais performance de carregamento, experimente aplicar mais memória RAM.
* Certifique-se de que seu Windows está totalmente atualizado.
* Caso tenha problemas, certifique-se de conferir a seção [[PT-BR/Soluções_de_Problemas_-_FAQ|Solução de Problemas]] ou juntar-se no [https://discord.com/invite/mtasa Discord].

==Instalando o Multi Theft Auto==

# Se você ainda não baixou o instalador do MTA:SA, acesse a página de download [http://mtasa.com aqui].
# Após o término do download, execute o arquivo. Vá em Next, leia os Termos de Licença (Em Inglês) e clique em "I Agree" para continuar.
# Agora você terá que escolher quais componentes deseja incluir na instalação:
#* '''Game client:''' Programa que faz você se conectar aos servidores do MTA, para participar de partidas online. (este componente é obrigatório)
#* '''Dedicated Server:''' São os arquivos necessários para criar seu servidor a partir de seu computador.
#** '''Core resources''': São os recursos mais importantes para que seu servidor funcione de forma adequada.
#** '''Optional resources''': São os recursos mais famosos do MTA, como "race" (corrida) e "Team Deathmatch" (combate entre times).
#** Editor: O famoso editor para criar seus próprios mapas para os gamemodes "race", "assault" e entre outros.
#* '''Development:''' Só instale este componente se você vai desenvolver módulos para o MTA. (Necessário conhecimento em C++)
#* '''Start menu group''': Este cria uma pasta no meu iniciar, contendo atalhos para jogar e desinstalar o MTA.
#* '''Desktop icon''': Adiciona um atalho na área de trabalho para jogar o MTA: San Andreas.
# Quando terminar de escolher os componentes clique em Next. Agora, escolha a pasta onde deseja instalar o MTA (Não é necessário ser na pasta de seu SA)
# Next novamente para avançar. Clique no botão Browse para escolher o diretório onde seu San Andreas está instalado. O diretório padrão é: '''C:\Arquivos de Programas\Rockstar Games\GTA San Andreas\'''.
# E por fim vá em Install. Quando a instalação estiver concluída, aparecerá uma opção para iniciar o MTA, marque ou desmarque a vontade.
# Após clicar em '''Finish''', o ícone estará disponível no "Meu Iniciar" e também na sua área de trabalho.

==Rodando o Jogo==
# Inicie o Multi Theft Auto clicando no ícone localizado em seu Desktop ou no Meu Iniciar (Dentro da pasta '''MTA: San Andreas {{Current Version|full}}''')
# O GTA: San Andreas irá iniciar e, após de ser carregado, e você vai se deparar com o menu principal do MTA:SA. Aqui você encontrará algumas opções como:

{| border="0" align="center"

| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – disponibiliza uma lista com os servidores on-line para jogar. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – inicia um servidor local. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– aqui você pode mudar seu apelido no jogo, customizar os comandos do teclado e ajustar as configurações de vídeo.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– mostra os créditos dos contribuidores do projeto.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– aqui você pode criar seus próprios mapas, posicionando checkpoints, rampas, pickups e outros objetos. Estes mapas podem ser enviados à um servidor para que jogadores possam jogar entre si.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– faz você sair do jogo e retornar à sua área de trabalho.</font>
|}

O caminho mais simples para se jogar é clicando em '''Browse Servers''' no menu. Se depois de um tempo nenhuma lista apareceu, clique no botão '''Refresh''' e o MTA irá procurar por servidores on-line, disponibilizando-os na tela.

<center>[[Image:BR_Client_Browser.jpg|600px]]</center>

* Na coluna '''Name''' estão os nomes dos servidores.
* Na coluna '''Players''' é mostrado o número de jogadores que estão conectados ao servidor e sua capacidade máxima no formato [Jogadores Conectados] / [Capacidade Máxima].
* A coluna '''Ping''' é o intervalo de tempo para que seu computador e o servidor se comuniquem. O valor é baseado no tempo que leva para que "pacotes" de dados sejam recebidos pelo servidor após serem enviados para seu computador. Então um ping maior indica que você terá travamentos em um servidor específico. No geral, servidores mais próximos de você são os que tem os menores pings.
**Ping é a mesma coisa do servidor te fazer perguntas e seu computador responder. Para que todas essas mensagens sejam entregues demora um certo intervalo de tempo. Se o servidor estiver no japão, com certeza seu ping será maior.
* A coluna '''Host''' é o enderesso de IP do servidor. Você pode usar este endereço no futuro para se conectar ao mesmo servidor via Quick Connect no menu principal.

Toda coluna pode ser clicada para organizar-la na ordem crescente ou decrescente. Exemplo: Clicando em cima da palavra '''Name''' obteremos os servidores começando com Z e terminando com A.

Para melhor experiência ao jogar, encontre um bom equilibrio entre jogadores e ping. Se o servidor tem muitos jogadores conectados você terá que ter um ping baixo e virse-versa.

Quando escolher um servidor, selecione-o e clique no botão '''Connect''' localizado no canto direito da janela. Se tudo der certo, vais se conectar ao servidor e automaticamente entrará no jogo.

==Como Jogar==

MTA:SA oferece um sistema que habilita os criadores de mapas manipularem vários elementos do GTA, resultando em um modo de jogo totalmente inovador. O MTA utiliza vários elementos do jogo normal (single player), mas há algumas pequenas diferenças:

Não há pedestres ou carros andando na rua. As únicas pessoas no mapa são seus oponentes ou aliados (se o jogo for do modo cooperativo). Ao pressionar a tecla '''T''', você pode escrever aos outros jogadores usando o chat localizado no canto superior esquerdo da tela. Para se comunicar somente com os membros de seu time, precione '''Y'''.

O Editor de mapas do MTA permite que usuários adicionem vários objetos do GTA em seus mapas incluindo ruas, barris explosíveis, rampas, prédios, colinas e muito mais. E não é só isso, objetos podem se mover, mudarem de aparência e desaparecerem por meio de scripts. Isso torna o mundo mais vivo, trás diversão garantida e infinitas formas de jogar.

Ao pressionar a tecla ''Tab'', aparecerá um scoreboard. O '''scoreboard''' disponibiliza os nomes dos jogadores e seus respectivos pings. Mas, pode haver mais colunas dependendo das necessidades de cada modo de jogo. Por exemplo, o modo ''deathmatch'' (mata-mata) precisará, com certeza, de uma coluna listando quantos assassinatos um certo jogador fez. Além disso, há possibilidade de customizar mais ainda ao adicionar, por exemplo, uma coluna para o número de mortes que você tem ou há quanto tempo você jogou.

==Comandos==

===do Jogador===

* F8 (ou a tecla Tilde) - Abre o Console
* F9 - Abre uma tela fornecendo o manual de como jogar. Isto varia de servidor para servidor.
* F11 - Mostra o mapa de San Andreas. ''A lista seguinte é para quando o mapa estiver visível:''
**numpad +/- - Lupa (Aumenta ou Diminui)
**numpad 2, 4, 6, 8 - move o mapa para baixo, esquerda, direita e cima, respectivamente.
**numpad 0 - alterna entre seguir o jogador (o mapa segue a localização do jogador no mapa) e modo livre (o mapa fica parado)
* F12 - Screenshot (tira uma foto da tela)
* T - Chat
* Y - Chat do time
* TAB - Abre uma lista contendo todos os jogadores conectados (Somente se o recurso [[Scoreboard]] estiver rodando no servidor)

===do Console===

O '''Console''' é uma janela a qual te habilita a obter informações, sair do jogo e desconectar de um servidor de uma maneira fácil e mais rápida.

<center>[[Image:BR_Client_Console.jpg|600px]]</center>

Precione '''~ (tilde)''' ou '''F8''' para acessar o '''Console'''. Digite um comando da lista abaixo com seus respectivos parâmetros (se requisitar) e precione Enter.

;'''maps''' :Disponibiliza uma lista com todos os mapas disponíveis no servidor.

;'''nick [seu nome]''' :Muda seu nome (nickname) para o qual você digitou no parâmetro.
> Exemplo - nick Cebolinha

;'''msg [nome] [mensagem]''' ou '''pm [nome] [mensagem]''' :Este manda uma mensagem somente para a pessoa a qual você especificou no parâmetro [nome]. Somente esta pessoa verá a mensagem. Ambos '''msg''' e '''pm''' podem ser utilizados.
> Exemplo - msg Cascão vamos atormentar a Mônica!

;'''quit''' ou '''exit''' :Desconecta do servidor e retorna para área de trabalho do Windows. Ambos fazem o mesmo que o ''Quit'' no menu principal.

;'''ver''' :Mostra a versão e os direitos autorais para este software(programa).

;'''sver''' :Mostra a versão do servidor que está conectado(a) no momento.

;'''time''' :Mostra a hora atual.

;'''disconnect''' :Desconecta do servidor e volta para o menu principal.

;'''say [texo]''' :Escreva aos jogadores do chat enquanto o console está aberto.

;'''ignore [apelido]''' :Simplesmente vais ignorar o jogador que desejas, ou seja, ele não vai mais te incomodar. Para voltar à receber mensagens deste jogador, digite '''ignore [apelido]''' novamente.
> Exemplo - como a Mônica não quer ser incomodada digitará: ignore Cebolinha

{{Dica|''Podes usar estes comandos listados acima enquanto estiver no chat, botando uma "/" na frente. Exemplo: /time''}}
<br>
*A aba '''Binds''', no menu "settings", muda todos os controles do GTA e do MTA já pré-programados, como a tecla W para andar pra frente/acelerar ou a tecla T para falar no chat respectivamente.
*Ao digitar '''help''' no console, uma lista com todos os comandos pode ser visualizada.
*Os recursos que estão sendo executado no momento podem também conter comandos novos. Ao digitar '''commands''' no console eles serão mostrados, se existirem.

==Códigos de Erros e seus significados==
===Erros de Download===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}

===Erros Fatais===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|no local player model on ingame event
|-
|2
|no local player on ingame event
|-
|3
|server downloads disabled
|-
|4
|no local player model on player-list packet
|-
|5
|no local player on player-list packet
|-
|6
|invalid custom data length on entity-add packet
|-
|7
|invalid bitstream data on entity-add packet
|-
|8
|system entity on entity-add packet
|-
|9
|failed to create object on entity-add packet
|-
|10
|failed to create pickup on entity-add packet
|-
|11
|failed to create vehicle on entity-add packet
|-
|12
|invalid team-name length on entity-add packet
|-
|13
|invalid lua-event name length in lua-event packet
|-
|14
|invalid resource name length in resource-start packet
|}

===Erros ao entrar no veículo===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

==Jogando MTA:SA no Linux==
Se o sistema operacional que você estiver usando for o Linux, siga o [[Client_on_Linux_Manual|Manual do Cliente - Linux]] para jogar MTA: San Andreas em seu computador!

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

[[Category:Suporte]]

PL/Obsluga Serwera

2022-01-23T17:11:09Z

Turret001: replaced IRC with Discord

== Pierwsze kroki ==
Uruchomienie swojego własnego serwera MTA:SA jest o wiele łatwiejsze niż mogło by się wydawać. Jeżeli chciałbyś postawić serwer by pograć ze znajomymi, lub po prostu z ludźmi z sieci - Zachęcam do lektury.

== Instalacja serwera ==
Poniżej opisane są sposoby instalacji serwera w zależności od posiadanego systemu operacyjnego

=== Linux ===
Serwer, pod Linuksem można zainstalować na dwa sposoby:
* [http://wiki.github.com/multitheftauto/multitheftauto/building-on-gnulinux Kompilując kod źródłowy ]
* [http://linux.mtasa.com Uruchamiając gotowe binarki (wcześniej skompilowane pliki) ]

=== Linux (x64/x86) ===
Dokładniejszy opis dedykowany instalacji serwera na systemach 64 lub 86 bitowych (które nie są supportowane przez team mta) można znaleźć w moim [[PL/Linux_64 | dokładniejszym opisie ]]

=== Windows ===
Instalacja serwera na Windowsie jest prosta "jak budowa cepa".
* Najpierw pobieramy instalator [http://mtasa.com ze strony głównej]
* Po ściągnięciu uruchamiamy owy instalator
* Wybieramy folder gdzie chcemy zainstalować MTA (serwer jest w jednej paczce z klientem)
* Klikamy na zainstaluj...
* ...i gotowe!

== Konfiguracja serwera ==
Serwer Multi Theft Auto jest wstępnie konfigurowany z okna konsoli, z poziomu gry i z przeglądarki internetowej.

=== Ogólna konfiguracja ===
Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/'''mtaserver.conf'''".
Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego ''notatnik''-a, zaś na Linuksie ''nano'' lub ''vi'').

W pliku tym przy prawie każdej zmiennej znajduje się opis w języku angielskim, co jest dużym ułatwieniem.

=== Przekierowanie portów ===
W pliku '''mtaserver.conf''' znajdują się takie dwie linijki:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Odpowiadają one za to na jakim porcie (portach) będzie nasłuchiwał nasz serwer.
Jak już wcześniej była o tym mowa - panel-www domyślnie nasłuchuje na porcie 22005 (tutaj to ustawienie możemy zmienić).
Podobnie serwer domyślnie nasłuchuje na porcie 22003 (co również może ulec zmianie - w/g naszego "widzimisię").

<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

=== Kontrola klienta ===

MTA San Andreas ma skonfigurowanego AntyCheata. Aby antycheat działał na wszystkich, należy ustawić minimalną wersje klienta.

Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Minimalna wersja z antycheatem: 1.1.1-9.02320

=== Konta administratorskie ===
Zaleca się, aby serwer posiadał przynajmniej jedno konto administratora - tak, aby właściciel serwera miał w każdej chwili możliwość włączenia/wyłączenia serwera (lub danej jego części poprzez panel-www, konsole, grę).

Aby dodać konto administratora, postępuj według tych kroków:<br>
<ol>
<li>Uruchom serwer i dodaj nowe konto za pomocą '''[[Server_Commands#addaccount|addaccount name password]]''' w konsoli serwera, o tak:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount SEBA18293 12344321
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Notka: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\
'''/register SEBA18293 12344321'''''
</div>
<li>Serwer wyświetli wiadomość, a ty zarejestrujesz konto.
<li>Następnie wyłącz serwer za pomocą '''shutdown''' w konsoli serwera.
<li>Serwer zostanie zatrzymany.</li>
<li>Otwórz plik 'mods/deathmatch/acl.xml' za pomocą edytora tekstu.</li>
<li>Dodaj konto do grupy ''Admin''
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.SEBA18293" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Gratulacje, dodałeś konto administratora.
</li>
</ol>

=== Korzystanie z interfejsu WWW (panelu www) ===
Poprzez panel-www możemy zarządzać jak już wcześniej wspomniano konkretnymi elementami serwera (tzw. "zasobami" - z ang. resource).
Możemy je uruchamiać, zatrzymywać, restartować.

Interfejs WWW może zostać wyłączony poprzez ustawienie zmiennej:
<syntaxhighlight lang="lua">
<httpserver>1</httpserver>
</syntaxhighlight>
na 0.

Za poprawne działanie interfejsu WWW odpowiadają następujące zasoby:
* resourcebrowser
* resourcemanager
* webadmin
* webmap

Są one ustawione jako uruchamiane domyślnie w standardowej konfiguracji serwera.

=== Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, cssy itd.) ===
Jeżeli twój serwer korzysta z edytowanych modeli aut, obrazków w grze (lub na wbudowanym serwerze www) możesz ustawić w ustawieniach serwera, aby zewnętrzny serwer WWW serwował pliki za nie odpowiedzialne.
Domyślnie pliki serwowane są z serwera MTA (powyższa operacja może służyć przyśpieszeniu procesu pobierania - lub po prostu odciążeniu serwera).

Aby umożliwić pobieranie potrzebnych plików z zewnętrznego serwera, należy ustawić zmienną '''httpdownload''' i '''httpdownloadurl''' w konfiguracji serwera:

<syntaxhighlight lang="lua"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>
</syntaxhighlight>

W tym momencie po uruchomieniu serwera w katalogu '''/mods/deathmatch/resourcecache/http-client-files''' będą znajdować się archiwa .zip zawierające pliki które należy wrzucić na wcześniej ustawiony zewnętrzny serwer www.

Domyślnie zostaną wygenerowane pliki dla wszystkich zasobów. Jeżeli chcielibyśmy aby domyślne (takie jak webadmin itd.) dalej korzystały z wbudowanego serwowania plików w MTA, możemy ustawić w konfiguracji serwera, aby wygenerowane zostały tylko pliki dla '''rozpakowanych''' (w katalogu ''resources'') zasobów.
<syntaxhighlight lang="lua"><httpautoclientfiles>1</httpautoclientfiles></syntaxhighlight>

'''Uwaga:
* Zaleca się nie używać w adresie zewnętrznego serwera www specjalnych znaków (takich jak !, ~).
* Na końcu adresu zewnętrznego serwera nie należy stawiać "slesza" (/).'''

== Uruchamianie serwera ==
Aby uruchomić serwer kliknij dwukrotnie na plik '''MTA-Server.exe'''.
Na Linuksie uruchom komende '''./mta-server'''.

== Instalacja/Aktualizacja zasobów ("modów") na serwerze ==
Zasoby serwera (tzw. "mody") mogą być wgrane na dwa sposoby:
* Archiwum ZIP (zawierające pliki zasobu)
* Katalog zawierający pliki zasobu

Aby wgrać nowy zasób należy:
# Przenieść lub skopiować go do '''mods/deathmatch/resources/'''.
# W oknie konsoli serwera wpisać komendę '''refresh'''.

== Usuwanie zasobów ("modów") ==
Usuwanie zasobów jest bardzo proste. Sprowadza się do:

# Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
# Wpisania w oknie konsoli komendy '''refresh'''.

== Administrowanie serwerem ==
Aby uruchomić dany zasób wystarczy użyć polecenia (oczywiście bez nawiasu):
<syntaxhighlight lang="lua">start [nazwa zasobu]</syntaxhighlight>
Następnie gdybyśmy chcieli go zatrzymać:
<syntaxhighlight lang="lua">stop [nazwa zasobu]</syntaxhighlight>
Jeśli zrestartować:
<syntaxhighlight lang="lua">restart [nazwa zasobu]</syntaxhighlight>

Administracja jest również możliwa poprzez panel www (wcześniej opisany) lub poprzez grę.
Po zalogowaniu się na konto administratora:
<syntaxhighlight lang="lua">/login [nazwa konta] [haslo]</syntaxhighlight>
i wciskając klawisz F8. W owym panel oferuje nam kick-owanie i banowanie graczy (czyli takie podstawowe czynności).

== Uruchamianie map / Tryb gry ==
Więcej informacji [[map_manager|znajdziesz tutaj]][[Image:usen.gif|Artykuł w języku angielskim]].

== Uwagi ==

# Zasoby można odświeżać również w grze, jeżeli w nadamy odpowiednie uprawnienia w pliku ''acl.xml''.
# W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera).
# Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr ''--config [nazwa pliku konfiguracyjnego]''
# Nie należy martwić się błędem dotyczącym pliku ''settings.xml''.

== Potrzebujesz pomocy ?==
Potrzebujesz pomocy? Napisz na [http://forum.mtasa.com/ forum] lub napisz na [https://discord.com/invite/mtasa Discord]

[[Es: Manual Deathmatch Servidor]]
[[De: Serwer DM MTA Anleitung]]
[[It: Manuale Server del]]
[[Nl: Serwer Deathmatch Manual]]
[[Ru: Serwer Deathmatch Manual]]

IT/Manuale del Client

2022-01-23T17:10:57Z

Turret001: replaced IRC with Discord

{{IT/MainP}}
[[Category:100%]]
[[Category:IT/Guide e tutorial]]
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via [https://discord.com/invite/mtasa Discord].

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:MENU_ServerBrowser.jpg|280px]]</center>

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostrandoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Avviare il gioco via ASE (The All-Seeing Eye)===

Se non sei soddisfatto della lista di server MTA:San Andreas, potresti provare '''The All-Seeing Eye''', che ti permettere di scorrere la lista di server fuori del gioco, e può applicare dei filtri particolari. Questo tutorial ti aiuterà a installare ASE e ad entrare in un server con il doppio click.
# Scarica ASE da http://videogames.yahoo.com/multiplayer , e installalo.
# '''Questo è un bug di MTA:SA up fino alla versione dp2, e probabilmente sarà risolto successivamente.''' <br /> Scarica [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] ed estrai ASELauncher.exe nella tua cartella di MTA (di default C:\Programmi\MTA San Andreas). Questo piccolo programma converte i comandi di ASE in un formato che MTA può comprendere.
# Adesso aggiungi MTA:SA alla tua lista di giochi di ASE:
#* In ASE, clicca ''Tools'' -> ''Options'', e seleziona la tabella ''Games''
#* Apri la categoria ''Not installed'' e seleziona ''Multi Theft Auto'' nella lista
#* Seleziona ''Visible in filter list'', clicca ''Browse'' e scegli '''ASELauncher.exe''' nella tua cartella MTA
#* Lascia vuoto il campo ''Player name'', e chiudi la finestra premendo ''OK''
# Un nuovo gioco '''Multi Theft Auto''' è apparso. Quando clicchi su ''Refresh'' nella barra in alto, vedrai tutti i server per tutte le versioni di MTA. Adesso aggiungiamo un filtro per mostrare solo la versione attuale, '''1.0 dp2'''
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''MTA:SA 1.0 dp2'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo la versione attuale di MTA, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Potete poi configurare tutti i filtri che volete: eccone uno, per esempio, per vedere solo i server che contengono ITA nel nome:
# Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
# Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
# Inserisci un nome per il filtro nel campo ''Name'', per esempio '''ITA'''
# Inserisci il codice per il filtro seguente (con il numero della linea):<syntaxhighlight lang="lua">1 if hostname ~!= "*ITA*" remove</syntaxhighlight> (puoi sostituire "ITA" con quello che vuoi)
# Clicca su ''OK''
# Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo i server che contengono ITA nel nome, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Nel caso in cui vogliate creare un filtro ancora più particolare, ecco un [http://www.udpsoft.com/eye/wizard.html wizard per creare un vostro filtro personalizzato]: dovete inserire le righe di codice che vi dà nella finestra in basso al posto del codice del filtro che state inserendo (quarto punto nella guida di sopra).

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===
* '''F8''' (o '''~''', '''\''' sulla tastiera italiana) - Apre la Console
* '''F9''' - Mostra una finestra di aiuto ingame
* '''F11''' - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**'''+, -''' del tastierino numerico - Zoom avanti e indietro
**'''4, 8, 6, 2''' del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**'''0'' del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* '''F12''' - Salva uno screenshot dello schermo in ''C:\Programmi\MTA San Andreas\screenshots''
* '''T''' - Chat
* '''Y''' - Chat del team
* '''TAB''' - Lista dei player (se la risorsa [[Resource:IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
===Errori di download [Download error]===
*'''0''': UNKNOWN_ERROR
*'''1''': INVALID_FILE_DESCRIPTORS
*'''2''': INVALID_MAX_FILE_DESCRIPTOR
*'''3''': INVALID_SELECT_RETURN
*'''4''': INVALID_INITIAL_MULTI_PERFORM
*'''5''': INVALID_MULTI_PERFORM_CODE
*'''6''': INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
*'''7''': UNEXPECTED_CURL_MESSAGE
*'''8''': UNABLE_TO_CONNECT
*'''9''': UNABLE_TO_DOWNLOAD_FILE
*'''10''': FAILED_TO_INITIALIZE_DOWNLOAD

===Errori fatali [Fatal error]===
#Nessun modello del player locale nell'evento
#Nessun modello del player nell'evento
#Download delle risorse dal server disabilitato
#Nessun modello del player locale nel pacchetto player-list
#Nessun modello del player nel pacchetto player-list
#Lunghezza dei dati personalizzati non valida nel pacchetto entity-add
#Bitstream non valido nel pacchetto entity-add
#Entità di sistema nel pacchetto entity-add
#Creazione dell'oggetto fallita nel pacchetto entity-add
#Creazione del pickup fallita nel pacchetto entity-add
#Creazione del veicolo fallita nel pacchetto entity-add
#Lunghezza del nome del team non valida nel pacchetto entity-add
#Lunghezza del nome dell'evento non valida nel pacchetto lua-event
#Lunghezza del nome della resource non valida nel pacchetto resource-start

===Errori 'impossibile entrare nel veicolo'===
#Script annullato
#Script annullato (jack)
#L'occupante attuale sta uscendo/entrando
#Sedile non valido
#Distanza eccessiva
#Già in un veicolo
#Già in entrata/uscita
#Veicolo non valido (rimorchio)

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

PL/Client Manual

2022-01-23T17:10:34Z

Turret001: replaced IRC with Discord

==Zanim zaczniesz==

Zanim zainstalujesz Multi Theft Auto: San Andreas upewnij się, że nie masz zainstalowanych modów do GTA:SA. Mody będą kolidować z MTA:SA. Jeżeli mimo wszystko chcesz zachować mody z singleplayer'a, możesz zainstalować GTA:SA po raz drugi w innej lokalizacji na dysku twardym.

Dodatkowo upewnij się, że masz system '''Windows XP''', '''Windows Vista''' (32-bitowe lub 64-bitowe), '''Windows 7''' (32-bitowe lub 64-bitowe) lub '''Windows 8''' (32-bitowe lub 64-bitowe) oraz, że gra GTA:SA będzie działać na twoim sprzęcie. Weź pod uwagę to, że jeżeli grałeś w singleplayer'a na najniższych ustawieniach, to MTA będzie Ci działało wolniej, ponieważ ma większe wymagania.

{{Note|
* MTA:SA działa tylko z GTA:SA '''v1.0'''. Jeśli kupiłeś grę niedawno, jest prawdopodobieństwo, że masz nowszą wersje.''' [[PL/Known_Issues_-_FAQ#Czy_MTA:SA_pracuje_z_wersj.C4.85_1.01_lub_2.00_GTA_San_Andreas.3F| (Więcej informacji)]]
* Jeżeli masz wersję Steam GTA: San Andreas powinieneś [[PL/Known_Issues_-_FAQ#Mam_wersj.C4.99_steam_GTA_San_Andreas._Czy_mog.C4.99_gra.C4.87_w_MTA:SA.3F|najpierw to przeczytać]].
}}

===Wymagania Sprzętowe===
====Minimalne wymagania sprzętowe====
Minimalne wymagania sprzętowe dla Multi Theft Auto: San Andreas są '''nieco większe''', niż najmniejsze wymagania dla Grand Theft Auto: San Andreas.
* Procesor Intel Pentium 4 lub AMD Athlon XP
* 512MB DDR RAM
* Czysta instalacja gry Grand Theft Auto: San Andreas, wersja 1.0 (Amerykańska lub Europejska)
* 3.7GB wolnej przestrzeni na dysku twardym (3.6GB dla instalacji minimalnej Grand Theft Auto)(Pamiętaj, że MTA:SA pobiera pliki z serwerów, które wymagają miejsca na dysku.
* nVidia GeForce seria 4 lub ATI Radeon seria 8xxx (64MB RAM i kompatybilność z DirectX 9.0)
* Karta dźwiękowa kompatybilna z DirectX 9.0
* Klawiatura i mysz
* Połączenie do internetu
====Zalecane wymagania sprzętowe====
* Procesor Intel Core 2 Duo lub odpowiednik AMD
* 1GB DDR RAM
* Czysta instalacja gry Grand Theft Auto: San Andreas, wersja 1.0 (Amerykańska lub Europejska)
* >5GB wolnego miejsca na dysku twardym
* nVidia GeForce z serii FX lub nowsza, ATI Radeon z serii 9xxx lub nowsza.(Kompatybilność z Pixel Shader 2.0)
* Karta dźwiękowa zgodna z DirectX 9.0
* Klawiatura i mysz
* Połączenie do internetu
====Uwagi====
* Minimalne wymagania sprzętowe są uważane za niezbędne minimum dla MTA: San Andreas, wydajność może zależeć od trybów gry oraz liczby graczy.
* Na dodatkową wydajność ładowania, zaleca się więcej pamięci RAM.
* Upewnij się, że system Windows jest w pełni aktualny.
* Zanim zgłosisz problem sprawdź czy nie ma go tutaj: [[PL/Known_Issues_-_FAQ|Znane problemy - FAQ]]. Jeżeli nie znalazłeś problemu w FAQ dołącz do nas na [https://discord.com/invite/mtasa Discord]

==Instalacja gry==

# Jeżeli jeszcze nie masz klienta MTA:SA, pobierz go ze strony [http://mtasa.com mtasa.com].
# Uruchom instalator. Na Windows Vista i 7 będzie wymagane uruchomienie tego z prawami administratora. (Instalator poprosi.)
# Musisz zaakceptować licencję.
# Pojawi się pytanie, które składniki chcesz zainstalować:
#* '''Utwórz grupę w menu Start''' tworzy grupę w menu start dla zainstalowanych składników.
#* '''Utwórz ikonę na pulpicie''' tworzy ikonę na pulpicie dla klienta.
#* '''Zarejestruj protokół mtasa://''' rejestruje protokół mtasa:// w przeglądarkach.
#* '''Dodaj do Eksploratora Gier''' dodaje MTA:SA do eksploratora gier jeśli jest dostępny.
#* '''Klient gry''' główny interface gry, który jest potrzebny do działania multiplayera.
#** '''Podstawowe komponenty''' są wymagane do uruchomienia MTA:SA.
#** '''Moduł gry''' pozwala grać online.
#* '''Serwer dedykowany''' pozwala na utworzenie serwera na własnym PC.
#** '''Podstawowe komponenty''' są wymagane do uruchomienia serwera dedykowanego.
#** '''Moduł gry''' modyfikacja MTA:SA dla serwera.
#** '''Podstawowe zasoby''' są wymagane dla serwera dedykowanego.
#** '''Opcjonalne zasoby''' dodatkowe zasoby na serwer, mapy i tryby gier.
#** '''Edytor map''' jest używany do tworzenia nowych map.
#* '''Narzędzia programistów''' pomocniczy kod oraz narzędzia, które pomogą ci w tworzeniu modyfikacji do MTA:SA.
#** '''Moduł SDK''' służy do tworzenia własnych modułów serwera MTA, moduł ten wymaga znajomości C++.
# Zostaniesz poproszony o wskazanie folderu, w którym ma zostać zainstalowany MTA:SA. Nie musi być w folderze San Andreas.
# Następnie zostaniesz poproszony o wskazanie lokalizacji zainstalowanej gry San Andreas. Standardowo jest to: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# Po zakończeniu instalacji wyświetli Ci się opcja uruchomienia MTA: San Andreas. Zaznacz ją lub odznacz i kliknij '''Zakończ'''.
# Od teraz możesz grać w MTA San Andreas.

==Uruchomienie gry==
# Uruchom Multi Theft Auto klikając na ikonkę multiplayera podpisaną '''MTA:San Andreas''' w Menu Start.
# GTA: San Andreas się uruchomi i po załadowaniu się niezbędnych elementów ujrzysz główne menu MTA:SA. Tutaj znajdziesz kilka opcji:

{| border="0" align="center"
| width="188" |
[[Image:PL_QuickConnect.png|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Szybkie łączenie''' – Przy pomocy tej opcji możesz połączyć się z serwerem gry, którego adres IP lub URL oraz Port znasz. opcja jest bardzo przydatna, jeżeli znasz adres i port serwera i nie chce Ci się szukać go pośród innych serwerów w wyszukiwarce.</font>

<br />
|-
| width="188" |
[[Image:PL_Server_Browser.png|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Przeglądarka serwerów''' – Dzięki tej opcji masz dostęp do listy wszystkich działających serwerów. </font>

<br />
|-
| width="188" |
[[Image:PL_Host_Game.png|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Utwórz serwer''' – Dzięki tej opcji możesz założyć własny serwer. </font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Edytor map''' – Tutaj możesz tworzyć własne mapy, wstawiać checkpointy, rampy, pickupy i inne obiekty. Później możesz to dodać do plików serwera i grać z innymi graczami na świeżo zrobionych mapach.</font>

<br />
|-
| width="188" |
[[Image:PL_Menu_Settings.png|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Ustawienia''' – Tutaj możesz zmienić m.in: swój nick używany w grze, klawisze, opcje grafiki i kilka innych rzeczy.</font>

<br /><br />
|-
| width="188" |
[[Image:PL_About_Menu.png|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Autorzy''' – Tutaj są wymienieni wszyscy, którzy mieli wkład w rozwój projektu.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Wyjście''' – Wybranie tej opcji spowoduje zamknięcie MTA i powrót do pulpitu.</font>

<br /><br />
|}

Najprostszym sposobem by grać, jest wybranie opcji '''Przeglądarka serwerów''' z menu. Jeżeli serwery się nie wyświetlają kliknij przycisk '''Odśwież''', a MTA zacznie szukać serwerów, a następnie je wyświetli w formie listy.

* W kolumnie '''Nazwa''' są wyświetlane nazwy serwerów.
* W kolumnie '''Gracze''' wyświetla się liczba graczy grających i maksymalna mogąca wejść na serwer w formacie [Liczba slotów zajętych] / [Liczba maksymalna slotów].
* W kolumnie '''Ping''' jest wyświetlany Ping (opóźnienie) miedzy Twoją maszyną, a maszyną serwera. Ping to miara czasu, w jakim "pakiety" danych są przesyłane od Ciebie na serwer i z powrotem, czyli większy ping oznacza dłuższy czas wędrówki pakietów, a tym samym lagi. Generalnie serwery usytuowane bliżej Ciebie mają mniejsze pingi.
* W kolumnie '''Tryb gry''' jest wyświetlana nazwa trybu włączonego na danym serwerze.
* W kolumnie '''Host''' jest podany adres IP serwerów. możesz używać tego adresu by później łączyć się z danym serwerem przy pomocy opcji '''Quick connect''' z głównego menu.

Listę serwerów możesz segregować wg każdej z kolumn rosnąco i malejąco.

Do optymalnej rozgrywki szukaj najlepszego balansu między ilością graczy online, a pingiem danego serwera.

Jeżeli już wybierzesz interesujący Cię serwer, zaznacz go i kliknij przycisk '''Połącz''' usytuowany w górnym prawym rogu okienka. Jeżeli wszystko jest dobrze to powinno Cię połączyć z serwerem i dołączyć do rozgrywki.

==Jak grać==

MTA:SA oferuje kompleksowy system skryptowy, który umożliwia twórcom map dostosować wiele elementów gry, aby stworzyć własne innowacyjne tryby gry.

W MTA:SA jest ChatBox, który pozwala na komunikowanie się z innymi graczami. Czat włączamy klawiszem '''T''', a gdy gramy na trybie z drużynami mamy możliwość komunikowania się ze swoją drużyną używając czatu pod klawiszem '''Y'''.

Edytor map MTA pozwala twórcom map na dodawanie obiektów do GTA, w tym dróg, wybuchających beczek, ramp, budynków, wzgórz i więcej.

Trzymanie lub wciśnięcie (zależy od ustawień serwera) '''Tab''' wyświetli wynik. Domyślnie wyświetlane są tylko nazwy graczy i ping, ale skrypty mogą dodać dodatkowe kolumny dla danych trybów gry, np. w trybie deathmatch gra na pewno umieści kolumnę z listą fragów.

==Sterowanie==

===Klawisze w grze===

* F8 (lub przycisk tylda) - Konsola
* F11 - Pokazuje mapę SA ''(Poniższa lista jest do użytku, gdy mapa jest włączona)''
**numpad -/+ - Powiększanie i pomniejszanie
**numpad /* - zmiana przezroczystości mapy
**numpad 4, 8, 6, 2 - ruszanie mapa w lewo, gorę, prawo, dół
**numpad 0 - przełączanie się między podążaniem za graczem (mapa podąża za blip'em gracza), a swobodnym ruchem (możliwość przemieszczania się po mapie)
* F12 - Zrzut ekranu
* T - Rozmowa
* Y - Rozmowa w zespole
===Klawisze określone przez zasoby===
Klawisze te zależą od skryptów, które są uruchomione na serwerze.
* F9 - Pomoc (jeżeli [[Helpmanager]] jest uruchomiony na serwerze)
* V - Komunikacja głosowa. Naciśnij i mów jeśli skrypt jest włączony na serwerze.
* TAB - Lista graczy (jeśli [[Scoreboard]] jest uruchomiony na serwerze)

==Komendy konsoli==
'''Defaults bind''' Przywraca domyślne ustawienia sterowania w menu

Naciśnij klawisz ~ '''(tylda)''' lub '''F8''', aby uzyskać dostęp do konsoli, a następnie wpisz polecenie po wszelkie niezbędne parametry (jeśli dotyczy), a następnie naciśnij klawisz Enter.

;'''maps''': Wyświetla listę wszystkich map dostępnych na serwerze.

;'''nick [nazwa gracza]''': Zmienia twój nick podczas gry na serwerze.

;'''msg [nazwa gracza] [wiadomość] lub pm [nazwa gracza] [wiadomość]: Wysyła graczowi prywatną wiadomość, którą widzi tylko gracz do którego została wysłana. Zarówno '''msg''' jak i '''pm''' pełnią tę samą funkcję.

;'''quit or exit''': Rozłącza cię z serwerem i wraca do pulpitu.

;'''ver''': Wyświetla numer wersji i informacje o prawach autorskich do oprogramowania.

;'''sver''': Wyświetla numer wersji serwera na którym jesteś.

;'''time''': Wyświetla aktualną godzinę.

;'''disconnect''': Rozłącza cię z serwera i wraca do głównego menu.

;'''say [tekst]''': Możliwość pisania na czacie, gdy masz włączoną konsolę.

;'''ignore [nazwa gracza]''': Nie wyświetla wiadomości gracza, którego wpisałeś. Aby ponownie widzieć wiadomości gracza wpisz tę samą komendę.
{{Tip|Możesz użyc tych poleceń w czacie umieszczając / (ukośnik) przed nimi}}
Listę poleceń konsoli można zobaczyć wpisując '''help''' w konsoli i naciskając Enter. Aktualna mapa może mieć również dodatkowe polecenia, które można uzyskać, wpisując '''commands''' w konsoli.

Aby uzyskać informacje na temat większej liczby poleceń zobacz [[Client Commands|Komendy klienta]]

==Kody błędów i ich znaczenie==
=== Błędy pobierania ===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Kod
!scope="col" class="unsortable" | Błąd
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}
===Błędy krytyczne===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Kod
!scope="col" class="unsortable" | Błąd
|-
|1
|no local player model on ingame event
|-
|2
|no local player on ingame event
|-
|3
|server downloads disabled
|-
|4
|no local player model on player-list packet
|-
|5
|no local player on player-list packet
|-
|6
|invalid custom data length on entity-add packet
|-
|7
|invalid bitstream data on entity-add packet
|-
|8
|system entity on entity-add packet
|-
|9
|failed to create object on entity-add packet
|-
|10
|failed to create pickup on entity-add packet
|-
|11
|failed to create vehicle on entity-add packet
|-
|12
|invalid team-name length on entity-add packet
|-
|13
|invalid lua-event name length in lua-event packet
|-
|14
|invalid resource name length in resource-start packet
|}

===Błędy 'Nie można wejść do pojazdu'===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Kod
!scope="col" class="unsortable" | Błąd
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

==Specjalne: Granie w MTA na Linux'ie?==
Jeśli jesteś jednym z tych, którzy posiadają Linux'a jako systemu operacyjnego i chcą mieć klient działający na Linux'ie, proszę przeczytać [[Client_on_Linux_Manual|MTA na Linux'ie]]

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

DE/MTA DM Client Anleitung

2022-01-23T17:10:00Z

Turret001: replaced IRC with Discord

__TOC__

==Einführung==
Multi Theft Auto San Andreas Deathmatch ist einer der neuesten Multiplayer in einer Reihe von Multiplayern für Grand Theft Auto (PC Version). Multiplayer für GTA Vice City und GTA III findest Du auf [http://www.multitheftauto.com/ www.multitheftauto.com]. MTA:SA ist ein inoffizieller, von Fans programmierter Multiplayer, der von Rockstar Games weder genehmigt noch verboten wurde.

Die aktuelle Version ist eine sogenannte '''Developer Preview''' Version. Das bedeutet, dass sie eine Vorabversion (Beta-Version) ist und es somit zu Abstürzen und Fehlern kommen kann.

==Vor der Installation==
Stelle bitte vor der Installation von MTA:SA DM sicher, dass Du keine GTA San Andreas Modifikationen installiert hast, da diese mit MTA in Konflikt geraten könnten. Wenn Du Deine Einzelspielermodifikationen behalten willst, kannst Du einfach eine „saubere“ Installation zusätzlich installieren.
Sollte GTA San Andreas bei dem Versuch einer zweiten Installation nur die Option „Deinstallieren“ anbieten, kannst Du den Ordner „Grand Theft Auto San Andreas“ in ein anderes Verzeichnis '''kopieren''' (z.B. auf eine andere Festplatte) und GTA dann deinstallieren. Nun sollte es möglich sein, eine „saubere“ Version von GTA zu installieren. Wenn Du diese dann installiert hast, kannst Du den zuvor kopierten GTA Ordner mit den Modifikationen umbenennen (z.B. in „Grand Theft Auto San Andreas Modded“) und ihn in den Rockstar Games Ordner verschieben. Von jetzt an kannst Du sowohl einen gemoddeten Einzelspieler weiter modden oder spielen als auch MTA. (Je nach dem mit welcher exe Du spielst)

Um MTA spielen zu können, sollte Dein Rechner '''Windows 2000''', '''2003''', '''XP''' oder '''Vista''' installiert haben und die Leistungsanforderungen von GTA San Andreas erfüllen. Solltest Du bereits mit den niedrigsten Einstellungen spielen, kann es sein, dass MTA Dein Spiel verlangsamt, da es zusätzliche Prozessorleistung beansprucht.

'''Wichtig: MTA:SA funktioniert nur mit GTA San Andreas v1.0!''' Wenn Du das Spiel erst kürzlich erworben hast, ist es wahrscheinlich, dass Du eine neuere Version hast. Mit dem [http://grandtheftauto.filefront.com/file/GTA_SA_Downgrader_Patch;74661 GTA SA Downgrader Patch] kannst Du Deine Version auf 1.0 bringen.

Wenn Du auf Probleme stößt, kannst Du in den [[Known_Issues_-_FAQ|bekannten Problemen]] suchen oder uns im [https://discord.com/invite/mtasa Discord] besuchen.

===Systemvorraussetzungen===
Die Mindestanforderungen von MTA San Andreas sind ein klein wenig höher als die von GTA San Andreas.
* Intel Pentium 4 oder AMD Athlon XP
* 512 MB DDR RAM
* „Saubere“ GTA San Andreas Installation (Version 1.0 oder 1.1, Amerikanisch oder Europäisch)
* 3,7 GB freier Festplattenspeicher (3,6 GB für GTA San Andreas)
* nVidia GeForce 4 Serie oder ATI Radeon 8xxx Serie (64 MB RAM und DirectX 9.0 kompatibel)
* Tastatur und Maus
* Breitband Internetverbindung (DSL 1000 oder höher empfohlen)

Für Extra-Effekte wird eine Pixel Shader 2.0 kompatible Grafikkarte ( nVidia GeForce FX Serie oder ATI Radeon 9xxx) empfohlen.
Je mehr Arbeitsspeicher Du hast, desto schneller kann das Spiel geladen werden.

==Installation==
# Lade Dir den aktuellen MTA:SA DM Client von [http://www.mtasa.com/deathmatch.html www.mtasa.com] herunter, falls Du dies nicht schon getan hast.
# Starte den Installer und klicke auf „Next“. Akzeptiere anschließend die Lizenzbestimmungen mit einem Klick auf „I Agree“.
# Wähle als nächstes die oberste Option, falls Du noch keinen Account auf [http://www.mtabeta.com/ www.mtabeta.com] registriert hast, ansonsten die zweite und gib dort Deine Daten ein.
# Du wirst nun gefragt, welche Komponenten Du installieren möchtest.
#* Der '''Client''' ist das, was Du zum Spielen brauchst. Mit ihm kannst Du mit MTA Servern eine Verbindung aufbauen und so mit anderen Spielern online spielen.
#* Der '''Server''' ist nur notwendig, wenn Du einen eigenen Server hosten willst.
# Zuletzt kannst Du noch festlegen, in welches Verzeichnis MTA:SA DM installiert werden soll. Standardmäßig ist das '''C:\Programme\MTA San Andreas'''. MTA muss '''nicht''' in das GTA San Andreas Verzeichnis installiert werden.
# Ein letzter Klick auf „Next“ startet nun endlich die Installation. Nach Abschluss dieser kannst Du noch wählen, ob MTA gestartet werden soll oder nicht. Mit einem Klick auf „Finish“ ist die Installation dann endgültig abgeschlossen.

==Das MTA Menü==
# Starte Multi Theft Auto San Andreas Deathmeatch durch einen Doppelklick auf die '''Multi Theft Auto.exe'', über die Verknüpfung auf dem Desktop oder über das Startmenü.
# GTA San Andreas wird nun gestartet und nach dem Ladevorgang kommst Du in's MTA Menü. Sollte Dein Rechner aufgrund des Hintergrundvideos ruckeln oder überlastet sein, kannst Du dieses unter Settings -> Video ausschalten, indem Du den Haken bei '''Dynamic Scene Rendering''' entfernst. Folgende Menüoptionen findest Du im MTA Menü vor:

{| border="0" align="center"
| width="188" |
[[Image:Mta_quick_connect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – Mit dieser Option kannst Du direkt mit einem Server verbinden, dessen IP und Port Du bereits kennst. Außerdem wird hier automatisch die IP des Servers, auf dem Du zuletzt warst, eingetragen und gespeichert, sodass Du schnell reconnecten kannst, wenn nötig.</font>
<br/>
|-
| width="188" |
[[Image:Mta_browse_servers.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – Hier bekommst Du eine Liste mit allen MTA Servern, die zurzeit online verfügbar sind. Du hast hier auch diverse Möglichkeiten zum Filtern und Sortieren der Server.</font>
<br/>
|-
| width="188" |
[[Image:Mta_settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings''' – In den Optionen kannst Du Deinen Nicknamen festlegen, einige Grafikeinstellungen einstellen sowie die Steuerung konfigurieren.</font>
<br />
|-
| width="188" |
[[Image:Mta_about.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About''' – Hier findest Du eine Liste mit den Programmierern und sonstigen Mitwirkenden von MTA.</font>
<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map Editor Preview''' – Diese Funktion ist momentan noch nicht verfügbar, da der MTA SA DM Map Editor noch nicht fertiggestelt wurde. In Zukunft wirst Du dann mit dem Map Editor bequem und einfach Maps für Deinen MTA Server erstellen können.</font>
<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit''' – Mit Quit beendest Du MTA und gelangst zurück auf den Desktop.</font>
|}

==Der Server-Browser==
Mit einem Klick auf '''Browse Servers''' öffnet sich das Server-Browser Fenster.
Sollten dort noch keine Server angezeigt werden, klicke auf '''Refresh''' und warte, bis MTA die Serverliste heruntergeladen hat. In der Liste werden nun folgende Daten angezeigt:
* Der '''Name''' des Servers, der vom Serverbetreiber gewählt wurde und vermutlich den Gamemode des Servers beschreibt. (z.B. Rollenspiel, Mini Missions, etc.)
* Bei '''Players''' stehen die Anzahl der Spieler, die aktuell auf diesem Server spielen sowie die Kapazität des Servers. Die erste Zahl ist dabei die aktuelle Spieleranzahl und die zweite nach dem / die maximale Anzahl an Spielern, die auf dem Server sein können.
* Der '''Ping''' zeigt an, wie gut Deine Verbindung zu dem jeweiligen Server ist. Er beschreibt die Anzahl in Millisekunden, die ein Datenpaket von Dir zum Server und zurück braucht. Gute Pings liegen unter 60, schlechte über 500.
* Der '''Host''' ist die IP Adresse des Servers. Eine solche kannst Du zum Beispiel später bei Quick Connect verwenden, um direkt auf den Server zu gelangen.

Mit einem Klick auf den Button '''Add to Favourites''' kannst Du Deine Lieblingsserver in Deine Favoritenliste legen. Zu dieser gelangst Du durch einen Klick auf die Registerkarte '''Favourites''' oben im Server Browser. Unter '''Recently Played''' findest Du alle Server, auf denen Du zuletzt gespielt hast. Der Vorteil von den beiden anderen Registerkarten ist, dass sie viel schneller geladen sind, als die gesamte Serverliste.

Über der Serverliste findest Du außerdem drei verschiedene Filter, die Du aktivieren oder deaktivieren kannst:
* Wenn '''Include Empty''' aktiviert ist, werden Dir auch Server mit 0 Spielern angezeigt, ansonsten nur Server mit einem oder mehreren Spielern.
* '''Include Full''' bewirkt, dass auch Server angezeigt werden, die voll sind, d.h. deren Maximum an Spielern erreicht ist.
* Mit '''Include Locked''' kannst Du bestimmen, ob Server mit Passwortschutz auch angezeigt werden sollen oder nicht. Wenn es aktiviert ist, werden diese auch angezeigt.
Die Filter können die Ladezeit der Serverliste verkürzen, wenn Du bestimmte Servergruppen ausschließt. (z.B. alle leeren)

==MTA Spielen==
MTA:SA verfügt über ein umfangreiches Scriptsystem, welches es Scriptern und Mappern ermöglicht, viele Elemente individuell zu verändern oder zu gestalten, sodass die ihre eigenen Gamemodes erstellen können. Es wurde so viele Einzelspieler-Features übernommen, wie nur möglich, jedoch ist es natürlich nicht möglich, alle zu übernehmen.

Zu Beispiel gibt es keine Fußgänger und keinen computergesteuerten Verkehr in MTA. Die einzigen Personen, die Du sehen kannst, sind andere Spieler, die MTA benutzen, um online zu spielen. Über das Chatfenster oben links kannst Du Dich mit ihnen unterhalten. Um etwas in das Chatfenster zu schreiben, musst Du '''T''' drücken, dann Deinen Text eingeben und ihn mit Enter abschicken. Während der Eingabe ist die Steuerung Deines Charakters deaktiviert. Mit '''Z''' kannst Du Nachrichten an Dein Team senden.

Mit dem MTA Map Editor kann man beliebige GTA Objekte - ob nun Straßen, explosive Fässer, Rampen, Gebäude, Berge oder sonst was - zu der bestehenden GTA Map hinzufügen (oder sogar eine ganz eigene erstellen). Mithilfe des Scriptsystems können hinzugefügte Objekte dann bewegt, verändert oder entfernt (und natürlich auch neue hinzugefügt) werden. Das System bietet nahezu unendlich viele Möglichkeiten.

Mit der '''Tabulator'''-Taste kannst Du Dir die Spielerliste des aktuellen Servers anschauen. Standardmäßig werden dort Namen und Pings der Spieler angezeigt. Per Script ist es jedoch möglich, zusätzliche Spalten hinzuzufügen oder zu entfernen. Zum Beispiel wird ein Deathmatch-Server zusätzlich noch anzeigen, wieviele Spieler ein Spieler schon gekillt hat und der Scripter könnte beispielsweise auch noch einen Zähler hinzufügen, der anzeigt, wie oft ein Spieler schon gestorben ist.

==Hotkeys==
* F8 oder ^ - Konsole (mit Chatlog und der Möglichkeit, Befehle einzugeben)
* F9 - Hilfefenster
* F11 - San Andreas Karte (folgende Steuerungen gibt es, wenn die Karte angezeigt wird)
**Numpad +/- - Rein- und Rauszoomen
**Numpad 4, 8, 6, 2 - auf der Karte nach links, oben, rechts oder unten bewegen
**Numpad 0 - hiermit kann man bestimmen, ob die Karte dem Spieler folgen soll (sodass der Kartenausschnitt immer die Umgebung des Spielers anzeigt) oder ob die Karte frei beweglich sein soll
* F12 - Screenshot (wird im MTA San Andreas Ordner als *.png Datei abgespeichert)
* T - Chat
* Z - Team Chat
* TAB - Spielerliste (wenn der Server die [[Scoreboard]] Resource benutzt)

==Konsolenbefehle==
Drücke '''^''' oder '''F8''', um die Konsole zu öffnen. Dort kannst Du dann einen Befehl (ohne /) gefolgt von den Parametern eingeben. Die Parameter werden vom Befehl und untereinander mit einem Leerzeichen getrennt. (Bsp: ''befehl param1 param2 param3'')

;'''bind defaults''':setzt die Steuerung im Settings Menü auf die Standardeinstellungen zurück.

;'''maps''':zeigt eine Liste mit allen verfügbaren Maps auf dem Server.

;'''nick [Spielername]''':ändert Deinen aktuellen Nicknamen in den, den Du angegeben hast.

;'''msg [Spielername] [Nachricht]''' oder '''pm [Spielername] [Nachricht]''':senden eine private Nachricht an einen Spieler auf dem Server.

;'''quit''' oder '''exit''':haben den selben Effekt wie die „Quit“-Option im MTA Menü, beenden also MTA.

;'''ver''':zeigt die Version und die Copyright-Informationen zu Deinem MTA Clienten an.

;'''time''':zeigt die aktuelle Zeit an.

;'''disconnect''':beendet Deine Verbindung zum Server.

;'''say [Nachricht]''':schreibt eine Nachricht in den normalen Chat, während Du die Konsole geöffnet hast.

;'''ignore [Spielername]''':verhindert das Anzeigen aller Nachrichten, die der Spieler schreibt. Um diese wieder anzeigen zu lassen muss der Befehl einfach nochmal eingegeben werden.

'''Tipp:''' Du kannst diese Befehle auch in der normalen Chatbox verwenden, wenn Du einen Schrägstrich (/) davor schreibst.

Eine Liste aller Konsolenbefehle bekommst Du mit '''help'''. Mit '''commands''' kannst Du Dir eine Liste mit gamemodespezifischen Befehlen anzeigen lassen.

==Fehlernummern und ihre Bedeutung==
'''Downloadfehler'''<br>
0: UNKNOWN_ERROR (Unbekannter Fehler)<br>
1: INVALID_FILE_DESCRIPTORS (Ungültige Dateibeschreibung)<br>
2: INVALID_MAX_FILE_DESCRIPTOR (Ungültige Höchstzahl von Dateibeschribungen)<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT (Konnte keine Verbindung aufbauen)<br>
9: UNABLE_TO_DOWNLOAD_FILE (Konnte Datei nicht herunterladen)<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD (Download konnte nicht gestartet werden)<br>

'''Kritische Fehler'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: Serverdownloads deaktiviert<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Konnte Fahrzeug nicht betreten'-Fehler'''<br>
1: Scriptabbruch<br>
2: Scriptabbruch (bei der Fahrzeugaufgabe)<br>
3: Aktueller Fahrer steigt gerade ein/aus<br>
4: Ungültiger Sitzplatz<br>
5: Nicht nah genug<br>
6: Bereits in einem Fahrzeug<br>
7: Bereits am Ein-/Aussteigen<br>
8: Ungültiges Fahrzeug (Anhänger)<br>

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

AT/MTA DM Client Anleitung

2022-01-23T17:09:46Z

Turret001: replaced IRC with Discord

__TOC__

==Einführung==
Multi Theft Auto San Andreas Deathmatch ist einer der neuesten Multiplayer in einer Reihe von Multiplayern für Grand Theft Auto (PC Version). Multiplayer für GTA Vice City und GTA III findest Du auf [http://www.multitheftauto.com/ www.multitheftauto.com]. MTA:SA ist ein inoffizieller, von Fans programmierter Multiplayer, der von Rockstar Games weder genehmigt noch verboten wurde.

Die aktuelle Version ist eine sogenannte '''Developer Preview''' Version. Das bedeutet, dass sie eine Vorabversion (Beta-Version) ist und es somit zu Abstürzen und Fehlern kommen kann.

==Vor der Installation==
Stelle bitte vor der Installation von MTA:SA DM sicher, dass Du keine GTA San Andreas Modifikationen installiert hast, da diese mit MTA in Konflikt geraten könnten. Wenn Du Deine Einzelspielermodifikationen behalten willst, kannst Du einfach eine „saubere“ Installation zusätzlich installieren.
Sollte GTA San Andreas bei dem Versuch einer zweiten Installation nur die Option „Deinstallieren“ anbieten, kannst Du den Ordner „Grand Theft Auto San Andreas“ in ein anderes Verzeichnis '''kopieren''' (z.B. auf eine andere Festplatte) und GTA dann deinstallieren. Nun sollte es möglich sein, eine „saubere“ Version von GTA zu installieren. Wenn Du diese dann installiert hast, kannst Du den zuvor kopierten GTA Ordner mit den Modifikationen umbenennen (z.B. in „Grand Theft Auto San Andreas Modded“) und ihn in den Rockstar Games Ordner verschieben. Von jetzt an kannst Du sowohl einen gemoddeten Einzelspieler weiter modden oder spielen als auch MTA. (Je nach dem mit welcher exe Du spielst)

Um MTA spielen zu können, sollte Dein Rechner '''Windows 2000''', '''2003''', '''XP''' oder '''Vista''' installiert haben und die Leistungsanforderungen von GTA San Andreas erfüllen. Solltest Du bereits mit den niedrigsten Einstellungen spielen, kann es sein, dass MTA Dein Spiel verlangsamt, da es zusätzliche Prozessorleistung beansprucht.

'''Wichtig: MTA:SA funktioniert nur mit GTA San Andreas v1.0!''' Wenn Du das Spiel erst kürzlich erworben hast, ist es wahrscheinlich, dass Du eine neuere Version hast. Mit dem [http://grandtheftauto.filefront.com/file/GTA_SA_Downgrader_Patch;74661 GTA SA Downgrader Patch] kannst Du Deine Version auf 1.0 bringen.

Wenn Du auf Probleme stößt, kannst Du in den [[Known_Issues_-_FAQ|bekannten Problemen]] suchen oder uns im [https://discord.com/invite/mtasa Discord] besuchen.

===Systemvorraussetzungen===
Die Mindestanforderungen von MTA San Andreas sind ein klein wenig höher als die von GTA San Andreas.
* Intel Pentium 4 oder AMD Athlon XP
* 512 MB DDR RAM
* „Saubere“ GTA San Andreas Installation (Version 1.0 oder 1.1, Amerikanisch oder Europäisch)
* 3,7 GB freier Festplattenspeicher (3,6 GB für GTA San Andreas)
* nVidia GeForce 4 Serie oder ATI Radeon 8xxx Serie (64 MB RAM und DirectX 9.0 kompatibel)
* Tastatur und Maus
* Breitband Internetverbindung (DSL 1000 oder höher empfohlen)

Für Extra-Effekte wird eine Pixel Shader 2.0 kompatible Grafikkarte ( nVidia GeForce FX Serie oder ATI Radeon 9xxx) empfohlen.
Je mehr Arbeitsspeicher Du hast, desto schneller kann das Spiel geladen werden.

==Installation==
# Lade Dir den aktuellen MTA:SA DM Client von [http://www.mtasa.com/deathmatch.html www.mtasa.com] herunter, falls Du dies nicht schon getan hast.
# Starte den Installer und klicke auf „Next“. Akzeptiere anschließend die Lizenzbestimmungen mit einem Klick auf „I Agree“.
# Wähle als nächstes die oberste Option, falls Du noch keinen Account auf [http://www.mtabeta.com/ www.mtabeta.com] registriert hast, ansonsten die zweite und gib dort Deine Daten ein.
# Du wirst nun gefragt, welche Komponenten Du installieren möchtest.
#* Der '''Client''' ist das, was Du zum Spielen brauchst. Mit ihm kannst Du mit MTA Servern eine Verbindung aufbauen und so mit anderen Spielern online spielen.
#* Der '''Server''' ist nur notwendig, wenn Du einen eigenen Server hosten willst.
# Zuletzt kannst Du noch festlegen, in welches Verzeichnis MTA:SA DM installiert werden soll. Standardmäßig ist das '''C:\Programme\MTA San Andreas'''. MTA muss '''nicht''' in das GTA San Andreas Verzeichnis installiert werden.
# Ein letzter Klick auf „Next“ startet nun endlich die Installation. Nach Abschluss dieser kannst Du noch wählen, ob MTA gestartet werden soll oder nicht. Mit einem Klick auf „Finish“ ist die Installation dann endgültig abgeschlossen.

==Das MTA Menü==
# Starte Multi Theft Auto San Andreas Deathmeatch durch einen Doppelklick auf die '''Multi Theft Auto.exe'', über die Verknüpfung auf dem Desktop oder über das Startmenü.
# GTA San Andreas wird nun gestartet und nach dem Ladevorgang kommst Du in's MTA Menü. Sollte Dein Rechner aufgrund des Hintergrundvideos ruckeln oder überlastet sein, kannst Du dieses unter Settings -> Video ausschalten, indem Du den Haken bei '''Dynamic Scene Rendering''' entfernst. Folgende Menüoptionen findest Du im MTA Menü vor:

{| border="0" align="center"
| width="188" |
[[Image:Mta_quick_connect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – Mit dieser Option kannst Du direkt mit einem Server verbinden, dessen IP und Port Du bereits kennst. Außerdem wird hier automatisch die IP des Servers, auf dem Du zuletzt warst, eingetragen und gespeichert, sodass Du schnell reconnecten kannst, wenn nötig.</font>
<br/>
|-
| width="188" |
[[Image:Mta_browse_servers.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – Hier bekommst Du eine Liste mit allen MTA Servern, die zurzeit online verfügbar sind. Du hast hier auch diverse Möglichkeiten zum Filtern und Sortieren der Server.</font>
<br/>
|-
| width="188" |
[[Image:Mta_settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings''' – In den Optionen kannst Du Deinen Nicknamen festlegen, einige Grafikeinstellungen einstellen sowie die Steuerung konfigurieren.</font>
<br />
|-
| width="188" |
[[Image:Mta_about.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About''' – Hier findest Du eine Liste mit den Programmierern und sonstigen Mitwirkenden von MTA.</font>
<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map Editor Preview''' – Diese Funktion ist momentan noch nicht verfügbar, da der MTA SA DM Map Editor noch nicht fertiggestelt wurde. In Zukunft wirst Du dann mit dem Map Editor bequem und einfach Maps für Deinen MTA Server erstellen können.</font>
<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit''' – Mit Quit beendest Du MTA und gelangst zurück auf den Desktop.</font>
|}

==Der Server-Browser==
Mit einem Klick auf '''Browse Servers''' öffnet sich das Server-Browser Fenster.
Sollten dort noch keine Server angezeigt werden, klicke auf '''Refresh''' und warte, bis MTA die Serverliste heruntergeladen hat. In der Liste werden nun folgende Daten angezeigt:
* Der '''Name''' des Servers, der vom Serverbetreiber gewählt wurde und vermutlich den Gamemode des Servers beschreibt. (z.B. Rollenspiel, Mini Missions, etc.)
* Bei '''Players''' stehen die Anzahl der Spieler, die aktuell auf diesem Server spielen sowie die Kapazität des Servers. Die erste Zahl ist dabei die aktuelle Spieleranzahl und die zweite nach dem / die maximale Anzahl an Spielern, die auf dem Server sein können.
* Der '''Ping''' zeigt an, wie gut Deine Verbindung zu dem jeweiligen Server ist. Er beschreibt die Anzahl in Millisekunden, die ein Datenpaket von Dir zum Server und zurück braucht. Gute Pings liegen unter 60, schlechte über 500.
* Der '''Host''' ist die IP Adresse des Servers. Eine solche kannst Du zum Beispiel später bei Quick Connect verwenden, um direkt auf den Server zu gelangen.

Mit einem Klick auf den Button '''Add to Favourites''' kannst Du Deine Lieblingsserver in Deine Favoritenliste legen. Zu dieser gelangst Du durch einen Klick auf die Registerkarte '''Favourites''' oben im Server Browser. Unter '''Recently Played''' findest Du alle Server, auf denen Du zuletzt gespielt hast. Der Vorteil von den beiden anderen Registerkarten ist, dass sie viel schneller geladen sind, als die gesamte Serverliste.

Über der Serverliste findest Du außerdem drei verschiedene Filter, die Du aktivieren oder deaktivieren kannst:
* Wenn '''Include Empty''' aktiviert ist, werden Dir auch Server mit 0 Spielern angezeigt, ansonsten nur Server mit einem oder mehreren Spielern.
* '''Include Full''' bewirkt, dass auch Server angezeigt werden, die voll sind, d.h. deren Maximum an Spielern erreicht ist.
* Mit '''Include Locked''' kannst Du bestimmen, ob Server mit Passwortschutz auch angezeigt werden sollen oder nicht. Wenn es aktiviert ist, werden diese auch angezeigt.
Die Filter können die Ladezeit der Serverliste verkürzen, wenn Du bestimmte Servergruppen ausschließt. (z.B. alle leeren)

==MTA Spielen==
MTA:SA verfügt über ein umfangreiches Scriptsystem, welches es Scriptern und Mappern ermöglicht, viele Elemente individuell zu verändern oder zu gestalten, sodass die ihre eigenen Gamemodes erstellen können. Es wurde so viele Einzelspieler-Features übernommen, wie nur möglich, jedoch ist es natürlich nicht möglich, alle zu übernehmen.

Zu Beispiel gibt es keine Fußgänger und keinen computergesteuerten Verkehr in MTA. Die einzigen Personen, die Du sehen kannst, sind andere Spieler, die MTA benutzen, um online zu spielen. Über das Chatfenster oben links kannst Du Dich mit ihnen unterhalten. Um etwas in das Chatfenster zu schreiben, musst Du '''T''' drücken, dann Deinen Text eingeben und ihn mit Enter abschicken. Während der Eingabe ist die Steuerung Deines Charakters deaktiviert. Mit '''Z''' kannst Du Nachrichten an Dein Team senden.

Mit dem MTA Map Editor kann man beliebige GTA Objekte - ob nun Straßen, explosive Fässer, Rampen, Gebäude, Berge oder sonst was - zu der bestehenden GTA Map hinzufügen (oder sogar eine ganz eigene erstellen). Mithilfe des Scriptsystems können hinzugefügte Objekte dann bewegt, verändert oder entfernt (und natürlich auch neue hinzugefügt) werden. Das System bietet nahezu unendlich viele Möglichkeiten.

Mit der '''Tabulator'''-Taste kannst Du Dir die Spielerliste des aktuellen Servers anschauen. Standardmäßig werden dort Namen und Pings der Spieler angezeigt. Per Script ist es jedoch möglich, zusätzliche Spalten hinzuzufügen oder zu entfernen. Zum Beispiel wird ein Deathmatch-Server zusätzlich noch anzeigen, wieviele Spieler ein Spieler schon gekillt hat und der Scripter könnte beispielsweise auch noch einen Zähler hinzufügen, der anzeigt, wie oft ein Spieler schon gestorben ist.

==Hotkeys==
* F8 oder ^ - Konsole (mit Chatlog und der Möglichkeit, Befehle einzugeben)
* F9 - Hilfefenster
* F11 - San Andreas Karte (folgende Steuerungen gibt es, wenn die Karte angezeigt wird)
**Numpad +/- - Rein- und Rauszoomen
**Numpad 4, 8, 6, 2 - auf der Karte nach links, oben, rechts oder unten bewegen
**Numpad 0 - hiermit kann man bestimmen, ob die Karte dem Spieler folgen soll (sodass der Kartenausschnitt immer die Umgebung des Spielers anzeigt) oder ob die Karte frei beweglich sein soll
* F12 - Screenshot (wird im MTA San Andreas Ordner als *.png Datei abgespeichert)
* T - Chat
* Z - Team Chat
* TAB - Spielerliste (wenn der Server die [[Scoreboard]] Resource benutzt)

==Konsolenbefehle==
Drücke '''^''' oder '''F8''', um die Konsole zu öffnen. Dort kannst Du dann einen Befehl (ohne /) gefolgt von den Parametern eingeben. Die Parameter werden vom Befehl und untereinander mit einem Leerzeichen getrennt. (Bsp: ''befehl param1 param2 param3'')

;'''bind defaults''':setzt die Steuerung im Settings Menü auf die Standardeinstellungen zurück.

;'''maps''':zeigt eine Liste mit allen verfügbaren Maps auf dem Server.

;'''nick [Spielername]''':ändert Deinen aktuellen Nicknamen in den, den Du angegeben hast.

;'''msg [Spielername] [Nachricht]''' oder '''pm [Spielername] [Nachricht]''':senden eine private Nachricht an einen Spieler auf dem Server.

;'''quit''' oder '''exit''':haben den selben Effekt wie die „Quit“-Option im MTA Menü, beenden also MTA.

;'''ver''':zeigt die Version und die Copyright-Informationen zu Deinem MTA Clienten an.

;'''time''':zeigt die aktuelle Zeit an.

;'''disconnect''':beendet Deine Verbindung zum Server.

;'''say [Nachricht]''':schreibt eine Nachricht in den normalen Chat, während Du die Konsole geöffnet hast.

;'''ignore [Spielername]''':verhindert das Anzeigen aller Nachrichten, die der Spieler schreibt. Um diese wieder anzeigen zu lassen muss der Befehl einfach nochmal eingegeben werden.

'''Tipp:''' Du kannst diese Befehle auch in der normalen Chatbox verwenden, wenn Du einen Schrägstrich (/) davor schreibst.

Eine Liste aller Konsolenbefehle bekommst Du mit '''help'''. Mit '''commands''' kannst Du Dir eine Liste mit gamemodespezifischen Befehlen anzeigen lassen.

==Fehlernummern und ihre Bedeutung==
'''Downloadfehler'''<br>
0: UNKNOWN_ERROR (Unbekannter Fehler)<br>
1: INVALID_FILE_DESCRIPTORS (Ungültige Dateibeschreibung)<br>
2: INVALID_MAX_FILE_DESCRIPTOR (Ungültige Höchstzahl von Dateibeschribungen)<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT (Konnte keine Verbindung aufbauen)<br>
9: UNABLE_TO_DOWNLOAD_FILE (Konnte Datei nicht herunterladen)<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD (Download konnte nicht gestartet werden)<br>

'''Kritische Fehler'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: Serverdownloads deaktiviert<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Konnte Fahrzeug nicht betreten'-Fehler'''<br>
1: Scriptabbruch<br>
2: Scriptabbruch (bei der Fahrzeugaufgabe)<br>
3: Aktueller Fahrer steigt gerade ein/aus<br>
4: Ungültiger Sitzplatz<br>
5: Nicht nah genug<br>
6: Bereits in einem Fahrzeug<br>
7: Bereits am Ein-/Aussteigen<br>
8: Ungültiges Fahrzeug (Anhänger)<br>

[[de:Client Manual]]
[[en:Client Manual]]
[[es:Manual del Cliente]]
[[it:Manuale del Client]]
[[nl:Client Manual]]
[[ru:Client Manual]]
[[hu:Client Manual]]

RU/Server Manual

2022-01-23T17:08:23Z

Turret001: replaced IRC with Discord

{{DISPLAYTITLE:Руководство по серверу}}
__TOC__

==Начало==
Поднять и поддерживать сервер для своих LAN или интернет-друзей намного легче, чем кажется; просто следуйте этой статье и, надеюсь, вы быстро разберетесь, как хостить свой собственный MTA:SA сервер!

==Установка сервера==
Приложение для выделенного сервера доступно в разных редакциях, зависящих от платформы севрера.

===Linux===
Есть несколько путей поднять и запустить сервер на Linux:
* [http://linux.mtasa.com Прекомпилированный пакет]
* [[RU/Building MTASA Server on GNU Linux|Сборка сервера MTASA на GNU/Linux]]

Если у вас возникли проблемы с ошибками при старте сервера, то некоторые распространенные проблемы и пути их решения изложены здесь:
* [[RU/Building MTASA Server on GNU Linux#Поиск и устранение неисправностей]]

===FreeBSD===

Вы можете запустить MTA:SA и на FreeBSD, воспользовавшись Linux-эмуляцией.
* Включите [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu-lbc-install.html двоичную (бинарную) совместимость с Linux].
* Установите следующие пакеты или скомпилируйте их из портов: hs-terminfo, linux_base-f10, linux-f10-sqlite3
* Установите [http://linux.mtasa.com/ прекомпилированный пакет для Linux]

===Windows===
Установка сервера MTA:SA на Windows очень проста.
*Перейдите на [http://mtasa.com/ страницу закачки] и скачайте установщик.
*Когда установщик закачан, запустите его.
*Выберите папку, куда вы хотели бы установить сервер.
*Нажмите Install.
*Все!

''Для полной инструкции по acl.xml (access control list - лист контроля над правами) читайте: [[RU/Access_Control_List|Access Control List]]''<br/><br/>

==Настройка сервера==
Выделенный сервер Multi Theft Auto изначально поддается настройке через окно консоли, прямо из игры и через браузер. Чтобы активировать последние две опции, необходимо добавить хотя бы одного администратора в ваш конфигурационный файл.

===Основная настройка===
Все основные опции настройки находятся в файле 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и могут быть заданы через обычный текстовый редактор.

Этот файл очень прост; каждая переменная имеет [[RU/Server_mtaserver.conf|описание своего назначения и информацию по ее изменению]].

===Проброс портов===
Если вы запускаете сервер на своем личном компьютере и у вас есть роутер, вам понадобится пробросить 3 порта.

Для начала откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и найдите следующие строки:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Эти порты нужны для правильной установки сервера. Позже мы объясним как их задавать, но сначала, если вы хотите, чтобы ваш сервер появился в браузере серверов, то есть еще один нужный нам порт - порт ASE.
(краткий пример по включению / выключению ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Теперь нам нужно пробросить порты на вашем роутере, что не понадобится, если у вас уже открыты все порты, или если у вас нет роутера с фаерволлом. Если так оно и есть, пропустите эту часть.

Если вы не знаете, как пробросить порты на вашем роутере, пройдите [http://portforward.com/ на сайт по проброске портов], найдите там модель своего роутера и следуйте инструкциям.

Почти в каждом роутере можно задать тип порта: UDP или TCP. Этот список объяснит, какой тип порта и для чего нужен:

Главный порт сервера: UDP

HTTP порт: TCP

ASE порт: UDP (он понадобится, если вы захотите появления своего сервера в браузере серверов)

ASE порт легко вычислить:

ASE порт = главный порт сервера + 123

Итак, если главный порт вашего сервера - 22003, ASE порт будет 22126.

Удачи!

''В последней версии сервера вы можете проверить статус портов через следующую серверную команду [[RU/Server_Commands#openports|openports]].''

===Проверки клиента===

При желании, анти-чит MTA сервера может быть отключен. В нем можно также разрешить определенным или всем файлам быть измененными (напр. carmods.dat) или задать минимально допустимую версию клиента.

Все эти настройки расположены внутри файла 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]'. Смотрите [[Anti-cheat_guide|Anti-cheat guide]] для получения дополнительной информации.<br/>

Если вы хотите задать минимальную версию клиента, найдите следующую строку:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Правильные значения выглядят наподобие: 1.1.1-9.02320

===Добавление администраторов===
Крайне рекомендуется добавить хотя бы одного администратора на сервер, чтобы воспользоваться встроенным веб-сервером для несложной поддержки и настройки сервера. Этот администратор также сможет логиниться прямо из игры и контролировать сервер.

Чтобы добавить администратора, следуйте этим шагам:<br>
<ol>
<li>Если сервер запущен, добавьте новый аккаунт через ввод команды '''[[RU/Server_Commands#addaccount|addaccount name password]]''' в окно севрера. Например, чтобы добавить пользователя VasyaPupkin, вам понадобится набрать:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount VasyaPupkin 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Заметка: Если у вас нет доступа к окну сервера, а ресурс 'admin' запущен, вы можете добавить аккаунт-образец через ввод '''/register VasyaPupkin 123password''''' в чат.
</div>
<li>Сервер должен будет отобразить сообщение о том, что аккаунт добавлен.
<li>Затем выключите сервер, введя '''shutdown''' в окне сервера.
<li>Удостоверьтесь, что сервер выключен; если он все еще запущен, изменения, которые вы вносите, будут перезаписаны</li>
<li>Откройте файл 'mods/deathmatch/acl.xml' любым текстовым редактором</li>
<li>Добавьте аккаунт в группу ''Admin'', используя XML-синтаксис, как это сделано ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.VasyaPupkin" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Вообще, можно добавлять пользователей в какие угодно группы. Каждая из групп связана с ACL ([[RU/Access Control List|Access Control List]]). Каждый ACL содержит специфический список разрешенных и запрещенных прав. Группы существуют для того, чтобы разным пользователям могли соответствовать разные права. Группа ''Admin'' связана с ''Admin''ским ACL, который пуст (стало быть, разрешены все права). Группа ''Everyone'' связана с ''Default''ным ACL, который накладывает список ограничений на доступные команды (чтобы не позволять обычным пользователям пользоваться админскими командами).
</li>
<li>
Это все! Вы можете добавлять столько администраторов и пользователей этим способом столько, сколько захотите, еще посмотрите на другие группы и ACL'ы, например. ACL также доступен через [[RU/Access_Control_List|скриптовый движок Lua]].<br>

Рекомендуется взглянуть на веб-интерфейс, как это сделать мы опишем ниже.
</li>
</ol>
'''Заметка''': Для сервера, когда он запущен, есть другие способы добавлять аккаунты и редактировать права. "[[RU/Server_Commands#addaccount|addaccount <user> <password>]]" - внутренняя команда для добавления аккаунтов, но вам придется воспользоваться веб-интерфейсом, чтобы добавить эти аккаунты в специфические группы/ACLы!<br />

===Использование веб-интерфейса===
Выделенный сервер поставляется с некоторыми Lua [[RU/Resources|ресурсами]], которые предоставляют хороший простой веб-интерфейс для управления сервером. Это легко может быть использовано для поддержки сервера, так как позволяет вам добавлять пользователей, запускать/останавливать ресурсы и другое.

Ресурсы веб-интерфейса по умолчанию включены и обслуживаются через встроенный HTTP веб-сервер. Чтобы убедиться, что встроенный HTTP веб-сервер запущен на нужном вам порту (22005 по умолчанию), следуйте данной инструкции:
<ol>
<li>Убедитесь, что сервер выключен
<li>Откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' любым текстовым редактором</li>
<li>Проверьте, что HTTP сервер включен:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Измените порт HTTP сервера на свое усмотрение:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Сохраните изменения и закройте файл конфигурации</li>
<li>Запустите сервер</li>
<li>Если вы меняли список автозапускаемых ресурсов в конфигурационном файле, убедитесь, что следующие ресурсы запущены:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Они автоматически стартуют согласно стандартному файлу, в случае, если вы только что установили свой сервер.
</li>
<li>Откройте веб-браузер (Internet Explorer 6 or 7 НЕ поддерживаются; используйте [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] или другие) и перейдите по URL HTTP server'а: '''http://server:port/'''. Например, если у вас запущен локальный сервер на HTTP порту 22005, используйте '''http://127.0.0.1:22005/'''.</li>
<li>Введите имя пользователя и пароль администратора, которого вы добавили в предыдущей секции.</li>
</ol>

<br />
Теперь вы способны управлять своим сервером через веб-интерфейс.

=== Настройка внешнего веб-сервера ===
Встроенный веб-сервер также используется для обслуживания файлов ресурсов, запущенных на вашем сервере, и нужен всем подключенным к серверу игрокам. Например, если запущен игровой скрипт с графическим пользовательским интерфейсом или специфическими моделями, они должны быть переданы каждому вновь подключающемуся игроку для правильного функционирования. Это выполняется либо встроенным веб-сервером, либо внешним веб-сервером (который, как правило, чуть быстрее), его нужно настраивать отдельно.

Из-за быстродействия или по ряду причин, вы можете решить создать внешний веб сервер, если такая возможность есть. Внешний веб сервер должен быть публично доступен, чтобы любой игрок мог скачать необходимые для подключения и игры на вашем сервере клиентские файлы.

Чтобы включить скачивание с внешнего веб-сервера, вам следует настроить тег [[RU/Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] в конфигурации своего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

С тех пор, как все стандартные ресурсы, поставляемые с выделенным сервером, упакованы в zip-архивы, и обычно автоматически распаковываются благодаря встроенному веб серверу, теперь вам понадобится предоставить клиентам возможность закачивать себе сжатые файлы. Чтобы настроить MTA на поддержание копии только распакованных клиентских ресурсов, установите [[RU/Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] в конфигурации вашего сервера:

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

Теперь, когда вы запускаете сервер, папка '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' будет содержать действительные клиентские файлы для хостинга на внешнем веб-сервере. Если веб сервер расположен на том же компьютере, что и сервер, вы можете просто связать директорию надлежащего веб-сервера с '''http-client-files'''. Если веб-сервер расположен на отдельном компьютере, убедитесь, что у него есть доступ к '''http-client-files''' по сети, или поддерживайте удаленную копию с помощью синхронизационного ПО.

'''Заметка 1''': Пожалуйста, избегайте спецсимволов (напр. ~, !) в ваших URL закачки.<br />
'''Заметка 2''': Пожалуйста, не ставьте слеш в конце URL закачки (напр., используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')<br />
'''Заметка 3''': Веб-сервер должен использовать 'ContentType: application/octet-stream' для Lua-файлов. Большинство веб-серверов так и делают по умолчанию, если же нет, вы можете добавить следующую строку в файл .htaccess:<br />
<div style="padding: 10px">
<syntaxhighlight lang="xml">AddType application/octet-stream .lua
</syntaxhighlight></div>

==Запуск сервера==
Начнем с того, что убедимся, что мы закончили все конфигурирование сервера, ведь старт сервера - последний шаг, так что все должно быть готово!

Чтобы запустить сервер, выполните двойной щелчок по MTA Server.exe, убедитесь, что добавили его в исключение фаерволлов и пробросили порты, если это необходимо.

==Установка/Обновление ресурсов сервера==
Ресурсы могут быть двух видов, либо в формате ZIP-архива, либо просто обычной папкой со скриптами внутри. MTA:SA сервер поддерживает оба метода.

# Переместите или скопируйте новый ресурс в вашу папку <SERVER>\mods\deathmatch\resources.
# В окне сервера введите команду [[RU/Server_Commands#refresh|refresh]], эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

==Удаление ресурсов==
Ресурсы могут запросто удалены с сервера, если более не нужны.

# Удалить ZIP-файл или папку ресурса, если хотите его удалить
# В окне сервера введите команду "refresh" (без кавычек), эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

==Администрирование сервера==
Вы можете запускать ресурсы, введя команда "start resourcename" в консоли сервера, или останавливать их, введя "stop resourcename".

Также возможно выполнять эти или другие админ-команды из игровой консоли (которую можно вызвать по кнопке ` или F8); чтобы это сработало, для начала нужно залогиниться командой "[[RU/Server_Commands#login|login username password]]". К тому же, вы можете нажать кнопку p (англ.), чтобы вызвать админ-панель: это графический интерфейс, позволяющий с легкостью кикать или банить игроков-нарушителей среди других.

Для других команд, введите [[RU/Server_Commands#help|help]] в консоли.

==Запуск карты/мода==
Смотрите секцию команд у [[RU/Resource:Map manager|mapmanager]] для дальнейшей информации.

==Полезные заметки==

# Вы можете также обновлять ресурсы прямо из игры, если у вас есть соответствующие права, введя "refresh" в клиентской консоли или "/refresh" в чате. Это может вызвать секундное подлагивание, если ресурсов много.
# В инструкциях выше, <SERVER> - путь к главной директории сервер. В большинстве случаев это C:\Program Files\MTA San Andreas\server
# Вы можете выбрать к использованию сервером другой конфигурационный файл, добавив его в командной строке после аргумента --config, напр. mtaserver.exe --config anotherconfig.cfg.
# Не пугайтесь предупреждения об анализе файла settings.xml. Это происходит, когда ваша установка сервера все еще чиста и не была задействована.

====Нужна помощь?====
Почему бы не посетить [http://forum.mtasa.com/ форум] или присоединиться к нам на [https://discord.com/invite/mtasa Discord]

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

[[Category:Поддержка]]

ES/Manual del Cliente

2022-01-23T17:07:49Z

Turret001: replaced IRC with Discord

__TOC__

==Introducción==

Multi Theft Auto: San Andreas es el último de una serie de modificaciones multijugador creadas por fans de Grand Theft Auto (Solamente para versiones de PC). Para versiones de GTA3 y Vice City que se ejecutan en el antiguo núcleo, visita [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Esta modificación no es respaldada por Rockstar Games o Take Two Interactive.

==Antes de empezar==

Antes de instalar Multi Theft Auto: San Andreas, primero asegúrate de que no hay modificaciones de GTA:SA instaladas. Pueden provocar conflictos con MTA. Si deseas mantener tus mods, puedes crear dos instalaciones de GTA:SA, reinstalando San Andreas a una segunda carpeta en el disco duro.

Asimismo, asegúrese de que está ejecutando '''Windows XP''', '''Windows 2000''', '''Windows Vista''', '''Windows 7''' o '''Windows Server 2003''' y que tu computador es capaz de ejecutar el juego en un solo jugador. Ten en cuenta que si estás ejecutando el juego de un jugador al mínimo de los requisitos, es probable que experimentes demoras al jugar MTA, ya que ocupa poder de procesamiento adicional.

'''Nota: MTA:SA solo funcionara en GTA:SA v1.0.''' Si has comprado el juego recientemente, es probable que tengas una versión posterior.

Asegúrese de ir a la pagina de [[ES/Problemas_Conocidos_-_FAQ|Problemas Conocidos]] si tienes problemas, o únete a nosotros en [https://discord.com/invite/mtasa Discord]

===Requisitos del sistema===
Los requisitos mínimos del sistema para Multi Theft Auto: San Andreas son ligeramente superiores a los originales de los requisitos mínimos de Grand Theft Auto: San Andreas.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Instalación limpia de Grand Theft Auto: San Andreas, la versión 1.0 o 1.1 (Americana o Europea)
* 3.7GB de espacio libre en el disco duro (3.6GB de la instalación mínima de Grand Theft Auto )
* nVidia GeForce 4 series o ATI Radeon 8xxx series (64MB RAM y DirectX 9.0 compatible)
* DirectX 9.0 Tarjeta de sonido compatible
* Teclado y ratón
* Acceso a Internet de banda ancha (para el buen juego en línea)

Para características extra, se recomienda una tarjeta de vídeo compatible con Pixel Shader 2.0 (nVidia GeForce serie FX o superior, ATI Radeon 9xxx series o superior).

Para aumentar el rendimiento del juego, se recomienda instalar más RAM en tu computador.

==Instalando el Multijugador==

'''Descargar el instalador'''

# Puede registrarse en http://www.mtabeta.com (Opcional)
# Si todavía no tienes el instalador, ve a http://www.mtasa.com y descarga la versión mas reciente del cliente para MTA:SA
# Ejecuta el Instalador. Se te preguntara que componentes instalar:
#* '''Client''' interfaz del juego, componente requerido.
#* '''MTA Server''' te permite alojar tu propio servidor en casa.
#* '''MTA Server > Editor''' es usado para crear nuevos mapas, este componente es opcional.
# Se te preguntara donde quieres instalar el mod. Puede ser en cualquier parte y no es necesario que sea la carpeta de instalación de tu San Andreas.
# Luego, se te preguntara donde esta instalado tu San Andreas. La carpeta predeterminada es: '''C:\Archivos de Programa\Rockstar Games\GTA San Andreas\'''.
# Cuando la instalación finalice, tendras la opción de ejecutar MTA: San Andreas inmediatamente o no ejecutar. Elige una opción y presiona '''Finish'''.
# Para Ejecutar MTA:DM basta con ir a su escritorio y hacer doble click en el Icono de MTA San Andreas, si este icono no fue creado valla a Inicio, Todos los Programas, MTA San Andreas y finalmente haga click en Play MTA San Andreas.

==Ejecutando el juego==
# Inicia Multi Theft Auto haciendo clic en el icono situado en el escritorio de windows (MTA San Andreas) o en Inicio, Todos los Programas, MTA San Andreas y finalmente haga click en Play MTA San Andreas. .
# GTA:San Andreas se iniciará, una vez que se carga, se le presentará el menú principal de MTA:SA. Aquí encontrarás varias opciones:

<center>[[Image:main_menu.jpg]]</center>

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – esto te permite conectarse a un servidor del cual ya conoces la dirección IP o URL y el puerto. Esto es útil si sabes con precisión a que servidor deseas unirte, a fin de que no tengas que desplazarte por toda la lista de servidores.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – esto te permite recibir una lista de servidores disponibles para jugar. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – esto te permite crear un servidor local para que tus amigos se conecten a el. NOTA: Si te desconectas del servidor, este se cierra y todos los jugadores que estaban en tu server serán desconectados. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– esto te permite cambiar tu apodo en el juego, personalizar los controles y ajustar la configuración de la pantalla.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– esto te da una lista de personas que contribuyen al proyecto.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– esto te permite crear tus propios mapas, con puestos de control, rampas, vehiculos y otros objetos. Estos pueden ser cargados a un servidor para que puedas jugar con otras personas.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– salir del juego y volver al escritorio de Windows.</font>

<br /><br />
|}

La forma más fácil de jugar es hacer clic en '''Browse Servers''' en el menu. Aparecerá una nueva ventana:

<center>[[Image:manual_image006a.jpg]]</center> '''Tendrá que ser actualizada'''

Si los servidores no han aparecido ya, presione el boton '''Refresh''' y MTA escaneara los servidores, mostrándolos en una lista.

* La ficha '''Name''' muestra los nombres de los servidores.
* La ficha '''Players''' muestra el número de jugadores y la capacidad máxima del servidor, en formato de [Espacios Usados] / [Espacios Totales].
* La ficha '''Ping''' muestra el ping, o latencia, entre su computador y el servidor. Muchas veces se utiliza para medir la latencia o tiempo que tardan en comunicarse dos puntos remotos, y por ello, se utiliza el término PING para referirse al lag o latencia de la conexión en los juegos en red. Un mayor ping significa que tendrás más retraso en el servidor. En general, los servidores más cercanos a tu ubicación deberían tener menor ping.
* La ficha '''Game''' muestra el tipo de juego que se esta desarrollando en el servidor.
* La ficha '''Map''' muestra el mapa que se esta jugando.
* La ficha '''Host''' muestra la ip servidor.

Puede hacer clic en cada ficha para organizar las respectivas columnas en orden ascendente o descendente.

Para obtener un rendimiento óptimo de juego, buscar el mejor equilibrio entre los jugadores y ping.

Una vez que hayas elegido un servidor, seleccionelo y haga clic en el botón '''Connect''' en la esquina superior derecha del cuadro de diálogo o doble clic en el nombre del servidor. Si todo va bien, debería conectarse con el servidor y automáticamente unirse al juego.

==Cómo jugar==

MTA:SA ofrece un sistema de scripting que permite a los creadores de mapas personalizar muchos de los elementos del juego para crear sus propios e innovadores modos de juego. El juego incorpora el mayor número de elementos de un solo jugador como sea posible, pero algunos aspectos son diferentes

No hay peatones ni tráfico de Inteligencia Artificial en el camino. Las únicas otras personas en el mapa son sus adversarios, o aliados, si se trata de un juego en equipo. Puede hablar con ellos utilizando el chatbox situado en la esquina izquierda de la pantalla pulsando '''T'''. Para chatear sólo con miembros de su equipo, pulsa '''Y'''.

El editor de mapas de MTA permite añadir varios objetos a sus mapas, ya sean carreteras, barriles, rampas, edificios, colinas y mucho más. No sólo eso, los objetos de secuencias de comandos se puede mover, cambiar el modelo y desaparecer. Esto ofrece una gran cantidad de variedad y diversión en el juego.

Apretando la tecla TAB se mostrara la tabla de puntajes. De forma predeterminada, sólo los nombres y los pings se muestran, pero los scripts puede añadir columnas adicionales que son específicos al juego que se está desarrollando. Por ejemplo, un modo de juego Deathmatch sin duda tiene columna que cuenta el total de muertes, a fin de poner en perspectiva su puntaje.

==Controles==

===Teclas Universales===

* F8 (o tecla Tilde) - Consola
* F9 - Ayuda en el juego
* F11 - Muestra el mapa de San Andreas ''(la siguiente lista de controles es cuando el mapa se muestra)''
**teclado numerico +/- - Zoom
**teclado numerico 4, 8, 6, 2 - moverse en el mapa hacia arriba, abajo, izquierda, derecha.
**teclado numerico 0 - alternar entre seguir al jugador (el mapa sigue al jugador) y el movimiento libre (el mapa permanece estacionario)
* F12 - Tomar una Impresión de Pantalla (Screenshot)
* T - Chat
* Y - Chat Equipo
* TAB - Lista de Jugadores (si el recurso [[Scoreboard]] se esta ejecutando en el servidor)

<center>[[Image:gameplay_image001.jpg]]</center>

==Consola de comandos==

'''bind defaults''' Se usa los controles por defecto en el menú de configuración

Presionar '''~ (tilde)''' o '''F8''' para acceder a la consola, a continuación, escriba un comando seguido por cualquier parámetros necesarios (si procede) y luego pulse Intro.

;'''maps''' :Esto muestra una lista de todos los mapas disponibles en el servidor.

;'''nick [nickname]''' :Esto cambia tu apodo, a lo que especifique en los parámetros.

;'''msg [nickname] [mensaje]''' o '''pm [nickname] [mensaje]''' :Esto envía un mensaje privado a la persona que usted especifique en el parametro [nickname]. Sólo la persona que usted especifique puede ver el mensaje. '''msg''' y '''pm''' cumplen la misma funcion.

;'''quit''' o '''exit''' :Esto te desconecta del servidor y te devuelve al escritorio de Windows. Realiza la misma función que el botón '''Quit''' en el menú principal.

;'''ver''' :Esto muestra el número de versión y los derechos de autor para el software.

;'''sver''' :Esto muestra el número de versión del servidor donde juegas.

;'''time''' :Esto muestra la hora actual.

;'''disconnect''' :Esto te desconecta del servidor y vuelves al menú principal.

;'''say [texto]''' :Esto te permite seguir hablando con la gente por la ventana de chat, mientras que la consola está abierta.

;'''me [texto]''' :Esto te permite destacar el mensaje que escribes, para que los demas jugadores lo vean destacado.

;'''ignore [nickname]''' :Esto bloquea cualquier texto escrito por el jugador que deseas pasar por alto. Para dejar de ignorar a un jugador, escriba '''ignore [nickname]''' nuevamente.

;'''window''' :Esto pasa el MTA de estar maximizado a estar en una ventana y poder ver el escritorio de windows. (Obsoleto, solo funcional en versiones antiguas de MTA DP 2.3)

'''Sugerencia:''' Puedes utilizar estos comandos en el chatbox poniendo un / (barra) delante de ellas.

Para ver una lista de comandos de consola escribe '''help''' en la consola y pulsa Intro. El actual mapa también puede tener más comandos que se pueden ver escribiendo '''commands''' en la consola.

==Códigos de error y sus significados==
'''Download errors'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

==Jugar MTA en Linux==
Si usas Linux como sistema operativo, y quieres jugar MTA, lee el [[Client_on_Linux_Manual|Manual de Cliente de Linux]]

==Traductores==

*Brijido XD/Brijido 1989
*Gothem
*Benxamix2/The Kid

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

Obsługa Klienta

2022-01-23T17:06:44Z

Turret001: replaced IRC with Discord

==Zanim zaczniesz==

Zanim zainstalujesz Multi Theft Auto: San Andreas upewnij się, że nie masz zainstalowanych modów do GTA:SA. Mody będą kolidować z MTA:SA. Jeżeli mimo wszystko chcesz zachować mody z singleplayer'a, możesz zainstalować GTA:SA po raz drugi w innej lokalizacji na dysku twardym.

Dodatkowo upewnij się, że masz system '''Windows XP''', '''Windows Vista''' (32-bitowe lub 64-bitowe), '''Windows 7''' (32-bitowe lub 64-bitowe) lub '''Windows 8''' (32-bitowe lub 64-bitowe) oraz, że gra GTA:SA będzie działać na twoim sprzęcie. Weź pod uwagę to, że jeżeli grałeś w singleplayer'a na najniższych ustawieniach, to MTA będzie Ci działało wolniej, ponieważ ma większe wymagania.

{{PL/Note|
* MTA:SA działa tylko z GTA:SA '''v1.0'''. Jeśli kupiłeś grę niedawno, jest prawdopodobieństwo, że masz nowszą wersje.''' [[PL/Known_Issues_-_FAQ#Czy_MTA:SA_pracuje_z_wersj.C4.85_1.01_lub_2.00_GTA_San_Andreas.3F| (Więcej informacji)]]
* Jeżeli masz wersję Steam GTA: San Andreas powinieneś [[PL/Known_Issues_-_FAQ#Mam_wersj.C4.99_steam_GTA_San_Andreas._Czy_mog.C4.99_gra.C4.87_w_MTA:SA.3F|najpierw to przeczytać]].
}}

===Wymagania Sprzętowe===
====Minimalne wymagania sprzętowe====
Minimalne wymagania sprzętowe dla Multi Theft Auto: San Andreas są '''nieco większe''', niż najmniejsze wymagania dla Grand Theft Auto: San Andreas.
* Procesor Intel Pentium 4 lub AMD Athlon XP
* 512MB DDR RAM
* Czysta instalacja gry Grand Theft Auto: San Andreas, wersja 1.0 (Amerykańska lub Europejska)
* 3.7GB wolnej przestrzeni na dysku twardym (3.6GB dla instalacji minimalnej Grand Theft Auto)(Pamiętaj, że MTA:SA pobiera pliki z serwerów, które wymagają miejsca na dysku.
* nVidia GeForce seria 4 lub ATI Radeon seria 8xxx (64MB RAM i kompatybilność z DirectX 9.0)
* Karta dźwiękowa kompatybilna z DirectX 9.0
* Klawiatura i mysz
* Połączenie do internetu
====Zalecane wymagania sprzętowe====
* Procesor Intel Core 2 Duo lub odpowiednik AMD
* 1GB DDR RAM
* Czysta instalacja gry Grand Theft Auto: San Andreas, wersja 1.0 (Amerykańska lub Europejska)
* >5GB wolnego miejsca na dysku twardym
* nVidia GeForce z serii FX lub nowsza, ATI Radeon z serii 9xxx lub nowsza.(Kompatybilność z Pixel Shader 2.0)
* Karta dźwiękowa zgodna z DirectX 9.0
* Klawiatura i mysz
* Połączenie do internetu
====Uwagi====
* Minimalne wymagania sprzętowe są uważane za niezbędne minimum dla MTA: San Andreas, wydajność może zależeć od trybów gry oraz liczby graczy.
* Na dodatkową wydajność ładowania, zaleca się więcej pamięci RAM.
* Upewnij się, że system Windows jest w pełni aktualny.
* Zanim zgłosisz problem sprawdź czy nie ma go tutaj: [[PL/Known_Issues_-_FAQ|Znane problemy - FAQ]]. Jeżeli nie znalazłeś problemu w FAQ dołącz do nas na [https://discord.com/invite/mtasa Discord]

==Instalacja gry==

# Jeżeli jeszcze nie masz klienta MTA:SA, pobierz go ze strony [http://mtasa.com mtasa.com].
# Uruchom instalator. Na Windows Vista i 7 będzie wymagane uruchomienie na prawach administratorskich.
# Wybierz język gry.
# Ty musisz zaakceptować licencje MTA:SA
# Ty będziesz zapytany o elementy instalacji:
#* '''Klient i serwer''' główny interface gry, który jest potrzebny do działania multiplayera.
#* '''Tylko serwer''' pozwala na stawianie własnego serwera.
#* '''Użytkownika''' użytkownik sam wybiera sobie elementy instalacji.
# Później zostaniesz zapytany o lokalizację, w której chcesz zainstalować MTA:SA. Możesz zainstalować gdziekolwiek chcesz i nie musi to być w folderze głównym gry GTA:SA.
# Następnie zostaniesz poproszony o wskazanie lokalizacji zainstalowanej gry GTA:SA. Standardowo jest to: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# Po zakończeniu instalacji wyświetli Ci się opcja do uruchomienia MTA: San Andreas. Zaznacz ją lub odznacz i kliknij '''Finish'''.
# Od tej pory będziesz mógł uruchamiać multiplayer MTA:DM z menu Start jak też ze skrótu na Pulpicie.

==Uruchomienie gry==
# Uruchom Multi Theft Auto klikając na ikonkę multiplayera podpisaną '''MTA:San Andreas''' w Menu Start.
# GTA: San Andreas się uruchomi i po załadowaniu się niezbędnych elementów ujrzysz główne menu MTA:SA. Tutaj znajdziesz kilka opcji:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – Przy pomocy tej opcji możesz połączyć się z serwerem gry, którego adres IP lub URL oraz Port znasz. opcja jest bardzo przydatna, jeżeli znasz adres i port serwera i nie chce Ci się szukać go pośród innych serwerów w wyszukiwarce.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – Dzięki tej opcji masz dostęp do listy wszystkich działających serwerów. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – Dzięki tej opcji możesz założyć własny serwer. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– Tutaj możesz zmienić m.in: swój nick używany w grze, klawisze, opcje grafiki i kilka innych rzeczy.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– Tutaj są wymienieni wszyscy, którzy mieli wkład w rozwój projektu.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– Tutaj możesz tworzyć własne mapy, wstawiać checkpointy, rampy, pickupy i inne obiekty. później możesz to dodać do plików serwera i grać z innymi graczami na świeżo zrobionych mapach.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– Wybranie tej opcji spowoduje zamknięcie MTA i powrót do pulpitu.</font>

<br /><br />
|}

Najprostszym sposobem by grać, jest wybranie opcji '''Browse Servers''' z menu. Jeżeli serwery się nie wyświetlają kliknij przycisk '''Refresh''', a MTA zacznie szukać serwerów, a następnie je wyświetli w formie listy.

* W kolumnie '''Name''' są wyświetlane nazwy serwerów.
* W kolumnie '''Players''' wyświetla się liczba graczy grających i maksymalna mogąca wejść na serwer w formacie [Liczba slotów zajętych] / [Liczba maksymalna slotów].
* W kolumnie '''Ping''' jest wyświetlany Ping (opóźnienie) miedzy Twoją maszyną, a maszyną serwera. Ping to miara czasu, w jakim "pakiety" danych są przesyłane od Ciebie na serwer i spowrotem, czyli większy ping oznacza dłuższy czas wędrówki pakietów, a tym samym lag. Generalnie serwery usytuowane bliżej Ciebie mają mniejsze pingi.
* W kolumnie '''Host''' jest podany adres IP serwerów. możesz używać tego adresu by później łączyć się z danym serwerem przy pomocy opcji '''Quick connect''' z głównego menu.

Listę serwerów możesz segregować wg każdej z kolumn rosnąco i malejąco.

Do optymalnej rozgrywki szukaj najlepszego balansu między ilością graczy online, a pingiem danego serwera.

Jeżeli już wybierzesz interesujący Cię serwer, zaznacz go i kliknij przycisk '''Connect''' usytuowany w górnym prawym rogu okienka. Jeżeli wszystko jest dobrze to powinno Cię połączyć z serwerem i dołączyć do rozgrywki.

==Jak grać==

Edytor map MTA pozwala na dodawanie nowych obiektów do gry takich jak drogi, eksplodujące beczki, rampy, budynki, nowe tereny (i wiele, wiele więcej). Obiekty te mogą się poruszać, pojawiać i znikać, zmieniać wygląd. Dzięki temu każdy serwer może zaskoczyć nas swoją oryginalnością, nowymi efektami, naprawdę przyjemną i ciekawą rozgrywką.

Przytrzymując '''tab''' wyświetlona zostaje tablica wyników. Domyślnie znajdują się na niej informacje takie jak nazwa gracza, jego ping, ilość zabójstw, jednak są skrypty, które pozwalają na dodanie (lub modyfikowanie istniejących) danych tam wyświetlanych. Na przykład na serwerze typu DM wyświetlana będzie ilość zabójstw. Na serwerze typu RPG ilość posiadanych pieniędzy.

==Sterowanie==

===Klawisze w grze===

* F8 (lub przycisk tylda) - Konsola
* F9 - Pomoc (jeżeli [[Helpmaneger]] jest uruchomiony na serwerze)
* F11 - Pokazuje mapę SA ''(Poniższa lista jest do użytku, gdy mapa jest do góry)''
**numpad /- - Powiększanie i pomniejszanie
**numpad 4, 8, 6, 2 - ruszanie mapa w lewo, gorę, prawo, dół
**numpad 0 - przełączać się między dołączyć do lokalnych graczy (z mapą blip player) i swobodny ruch (map pozostaje nieruchomy)
* F12 - Robienie screenshotów
* T - Rozmowa
* Y - Rozmowa w zespole
* TAB - Lista graczy (jeśli [[Scoreboard]] jest uruchomiony na serwerze)

==Komendy konsoli==
Defaults bind''' Wiąże domyślne ustawienia sterowania w menu

''Naciśnij "~ (tylda)'''lub'''''F8", aby uzyskać dostęp do konsoli, a następnie wpisz polecenie po wszelkie niezbędne parametry (jeśli dotyczy), a następnie naciśnij klawisz Enter.

;'''Mapy''': To wyświetla listę wszystkich map dostępnych na serwerze.

;'''Nick [''] nick ": zmienia swój nick, podczas gdy w grze do tego, co należy określić w parametrach.

;'''Msg [nick] [wiadomość''] "lub''' [pseudonim pm] [komunikat'']": Ten wysyła prywatną wiadomość do osoby, którą określa się w [parametr] nick. Tylko osoby, z którą określić można zobaczyć tą wiadomość. Zarówno'''msg''' i'''''pm "tę samą funkcję.

;'''Quit''' lub'''''wyjścia ": Ten rozłącza się z serwera i powrót do pulpitu Windows. Wykonuje tę samą funkcję jak przycisk Zamknij w menu głównym.

;'''''Ver ": Wyświetla numer wersji i prawach autorskich do oprogramowania.

;'''''Sver ": Wyświetla numer wersji serwera jesteś podłączony.

;'''time''', to wyświetla aktualny czas.

;'''discconet''', to rozłącza się z serwera i powrót do głównego menu.

;'''Say [tekst]''': Funkcja ta pozwala na kontynuowanie rozmów z ludźmi na czacie przy oknie konsoli jest otwarta.

;'''Ignore [nick]''': To nie będzie wyświetlać dowolny tekst wpisany przez gracza, który chcesz ignorować. Aby zatrzymać ignorowanie gracza, typ'''ignore [nick]''' ponownie.

'''Wskazówka:''' Możesz używać tych poleceń w chat przez umieszczenie / (ukośnik) przed nimi.

Lista komend konsoli można zobaczyć wpisując'''''help' w konsoli i naciskając Enter. Aktualną mapę może mieć również dodatkowe komendy, które będą dostępne po wpisaniu'''polecenia''' w konsoli.

==Kody błędów i ich znaczenie==
=== Błędy pobierania ===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}
===Błędy krytyczne===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|no local player model on ingame event
|-
|2
|no local player on ingame event
|-
|3
|server downloads disabled
|-
|4
|no local player model on player-list packet
|-
|5
|no local player on player-list packet
|-
|6
|invalid custom data length on entity-add packet
|-
|7
|invalid bitstream data on entity-add packet
|-
|8
|system entity on entity-add packet
|-
|9
|failed to create object on entity-add packet
|-
|10
|failed to create pickup on entity-add packet
|-
|11
|failed to create vehicle on entity-add packet
|-
|12
|invalid team-name length on entity-add packet
|-
|13
|invalid lua-event name length in lua-event packet
|-
|14
|invalid resource name length in resource-start packet
|}

===Błędy 'Nie można wejść do pojazdu'===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

[[en:Client Manual]]

ES/Manual del Servidor

2022-01-23T17:01:00Z

Turret001: replaced IRC with Discord

__TOC__

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

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

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

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

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

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

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

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

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

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

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

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

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

Puerto principal del servidor: UDP

Puerto HTTP: TCP

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

El puerto ASE debe ser de la siguiente manera:

Puerto ASE = Puerto principal del servidor + 123

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

Buena suerte!

===Comprobación de Cliente===

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

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

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

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

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

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

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

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

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

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

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

<br />

Ahora puedes manejar tu servidor desde un navegador web.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

==Notas Útiles==

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

====¿Necesitas más ayuda?====
Por qué no te acercas a nuestro foro [http://forum.mtasa.com/ Forums] o te unes a nuestro [https://discord.com/invite/mtasa Discord]

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

Client Manual

2022-01-23T17:00:05Z

Turret001: replaced IRC with Discord

==Before you start==
Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single-player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.

Also, make sure that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.
{{Note|
* MTA:SA will only work on GTA:SA '''v1.0'''. If you bought the game recently, it is likely that you have a later version.''' [[Known_Issues_-_FAQ#Does_MTASA_work_with_v1.01_or_v2.00_of_GTA_San_Andreas.3F| (More info)]]
* If you have a Steam copy of GTA: San Andreas you should [[Known_Issues_-_FAQ#I_have_the_Steam_version_of_GTA_San_Andreas._How_can_I_play_MTASA.3F|read this first]].
}}

===System requirements===
====Minimum system requirements====
The minimum system requirements for Multi Theft Auto: San Andreas are '''slightly higher''' than the original minimum requirements for Grand Theft Auto: San Andreas:
* Windows 7 or newer (Microsoft supported) operating system ([[Compatibility FAQ|XP and Vista do not work and are obsolete]])
* Intel Pentium 4 or AMD Athlon XP
* 1 GB RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation; remember that MTA caches files from the servers that you play on and require disk space)
* Nvidia GeForce 4 series or ATI Radeon 8xxx series (64MB VRAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Internet access

====Recommended system requirements====
* Windows 10 operating system
* Intel Core 2 Duo Processor or AMD equivalent
* 2 GB RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* >5GB of free hard disk space (Remember that MTA caches files from the servers that you play on and require disk space)
* Nvidia GeForce FX series or higher, ATI Radeon 9xxx series or higher, Pixel Shader 2.0 compatible
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

====Notes====
* The minimum system requirements are considered the bare minimum for MTA: San Andreas, the performance can depend on the game modes that are running and the player count.
* For extra loading performance, more RAM is recommended.
* Make sure Windows is fully up to date.
* Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on [https://discord.com/invite/mtasa Discord] and do so in the #help-support channel.

==Installing the game==
# If you haven't already, download the MTA:SA client from the download page at [http://mtasa.com mtasa.com].
# Run the installer, for Windows Vista and 7 it is required to run this with administrator rights. (The installer will ask.)
# You need to accept the license that comes with MTA:SA (GPLv3).
# You will be asked which components to install:
#* '''Game Client''' interfaces with the game and is a required component.
#* '''Dedicated Server''' enables you to host your own home-brew server.
#** '''Core components''' and '''Game module''' are required components for the dedicated server.
#** '''Core resources''' required resources for dedicated server.
#** '''Optional resources''' additional resources for your dedicated server, gamemodes and maps.
#** '''Editor''' is used to create new maps, this is an optional component.
#* '''Development''' development tools.
#** '''Module SDK''' development SDK for creating your own MTA server modules, this component requires C++ knowledge.
#* '''Start menu group''' creates a start menu group for the installed components.
#* '''Desktop icon''' creates a desktop icon for the client.
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch ''MTA San Andreas'' from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options (you could also watch a how-to tutorial [http://www.youtube.com/watch?v=ShiqnOazNYw here]):

{| border="0" align="center"

| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – this allows you to start a local server. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

==How to Play==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==Default Controls==

===In-Game Keys===

* F8 (or Tilde Key) - Console
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat

===Resource Specific Keys===
These keys depend on the scripts that are running on the server.

* F9 - In-game help (Help manager resource)
* Z - Push to talk, if voice is enabled on the server.
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any necessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''sver''' :This displays the version number of the server you are connected to.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.
{{Tip|You can use these commands in the chatbox by putting a / (forward slash) in front of them.}}

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

For information on more commands see: [[Client Commands]]

==Error codes and their meanings==
=== Download errors ===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}
===Fatal errors===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|no local player model on ingame event
|-
|2
|no local player on ingame event
|-
|3
|server downloads disabled
|-
|4
|no local player model on player-list packet
|-
|5
|no local player on player-list packet
|-
|6
|invalid custom data length on entity-add packet
|-
|7
|invalid bitstream data on entity-add packet
|-
|8
|system entity on entity-add packet
|-
|9
|failed to create object on entity-add packet
|-
|10
|failed to create pickup on entity-add packet
|-
|11
|failed to create vehicle on entity-add packet
|-
|12
|invalid team-name length on entity-add packet
|-
|13
|invalid lua-event name length in lua-event packet
|-
|14
|invalid resource name length in resource-start packet
|}

==='Unable to enter vehicle' errors===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

==Special: Playing MTA on Linux or macOS?==
If you're one of those who use other precious systems, and want to have the client working on your computer,
please read the [[Client on Linux Manual]] or [[Client on Mac OS X Manual]].

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

[[Category:Support]]

ZH-CN/服务端手册

2022-01-23T16:57:01Z

Turret001: replaced IRC with Discord and added a translate tag.

__TOC__
{{translate}}

==Getting started==
It is much easier than it looks to get a server up and running for your internet or LAN buddies; follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA server in no time!

==Installing the server==
The dedicated server application is available in different flavours depending on the platform of the server.

===Linux installation===
There are different ways of getting a Linux server up and running:
* [http://linux.mtasa.com Getting a precompiled package]
* [[Installing and Running MTASA Server on GNU Linux]]
* [[Building MTASA Server on GNU Linux]]

Should you have any problems with errors when starting the server some common problems and solutions are listed here:
* [[Building MTASA Server on GNU Linux#Troubleshooting]]

===FreeBSD installation===

You can run MTA:SA under FreeBSD using Linux emulation.
* Enable [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu-lbc-install.html Linux binary compatibility]
* Install following packages or compile them from ports: hs-terminfo, linux_base-f10, linux-f10-sqlite3
* Install [http://linux.mtasa.com/ Linux precompiled package]

===Windows installation===
Installation of the MTA:SA server on Windows is easy as pie.
*Go to the [http://mtasa.com/ download page] and download the installer.
*Once the installer is downloaded, open it.
*Select a folder where you want to install the server.
*Click Install.
*Done!

''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/>

==Configuring your server==
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.

===General configuration===
All general configuration options can be found in the 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' file and can be opened by any regular text editor.

This file is fairly straightforward; every variable has a [[Server_mtaserver.conf|description of what to do with it and how to change it]].

===Port forwarding===
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.

First of all open the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' and search for the next lines:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

The ports are needed to setup the server correctly. We explain later how to set them, but first if you want your server to appear in the server browser there is another port we need, and that is the ASE port.
(quick example for how to turn ASE on or off):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Now we going to forward the ports in your router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.

If you don't know how port forwarding works in your router, go to the [http://portforward.com/ Port Forward website], find your router model there, and follow the instructions there.

In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:

Main server port: UDP

HTTP Port: TCP

ASE Port: UDP (this is needed if you want your server to appear in the server list)

The ASE port is also simple to get:

ASE port = Main server port + 123

So, if you have the main server port set to 22003, then the ASE port will be 22126.

Good luck!

''In the latest version of the server, you can check the port status by using the server command [[Server_Commands#openports|openports]].''

===Client Checks===

The MTA server can be configured to disable the anti-cheat. It can also allow specific or all files to be modified (e.g. carmods.dat), and make sure clients are of a minimum version.

All of these settings are within the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]'. See the [[Anti-cheat_guide|Anti-cheat guide]] for more details.<br/>

If you want to force a minimum client version, search for the following line:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Accepted values look like: 1.1.1-9.02320

===Adding administrators===
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.

To add an administrator to your server, follow these steps:<br>
<ol>
<li>While the server is running, add a new account by typing '''[[Server_Commands#addaccount|addaccount name password]]''' into the server window. For example, to add user BennyLava you could type:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount BennyLava 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Note: If you do not have access to the server window, and the 'admin' resource is running, you can add the example account by issuing the client console (F8) command '''register BennyLava 123password'''''
</div>
<li>The server should display a message confirming the account has been added.
<li>Next, shutdown the server by typing '''shutdown''' into the server window.
<li>Make sure your server is stopped; if your server is still running, the following changes you make will be overwritten</li>
<li>Open the file 'mods/deathmatch/acl.xml' with any text editor</li>
<li>Add the account to the ''Admin'' group by using the XML-syntax below
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.BennyLava" />
</group>
...
</acl>
</syntaxhighlight>
</div>

You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br>

It is recommended to take a look at the web interface, we will explain how to do this below.
</li>
</ol>
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "[[Server_Commands#addaccount|addaccount <user> <password>]]" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br />

===Using the web interface===
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.

The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:
<ol>
<li>Make sure your server is stopped
<li>Open the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' with any text editor</li>
<li>Verify that the HTTP server is enabled:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Change the HTTP server port to your liking:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Save and close the configuration file</li>
<li>Start your server</li>
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

These are automatically started in the default configuration file, in case you just installed your server.
</li>
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported; use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li>
<li>Enter the username and password of the administrator you added in the previous section.</li>
</ol>

<br />
You should now be able to maintain your server from the web interface.

=== Configuring an external web server ===

The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.

For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.

To enable downloading off an external web server, you should configure the [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] tag in your server configuration:

<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

When you launch the server, the directory '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' will contain the correct client files for hosting on an external web server. If the web server is on the same machine, you can simply link the appropriate web server directory to '''http-client-files'''. If the web server is on a separate machine, ensure it has access to '''http-client-files''' via a network path, or maintain a remote copy using synchronization software.

'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''<nowiki>http://www.myserver.tld/directory</nowiki>'' rather than ''<nowiki>http://www.myserver.tld/directory/</nowiki>'')<br />
'''Note 3''': The web server must use 'ContentType: application/octet-stream' for Lua files. Most web servers will do this by default, or you can add the following line to the .htaccess file:<br />
<div style="padding: 10px">
<syntaxhighlight lang="xml">AddType application/octet-stream .lua
</syntaxhighlight></div>

Instructions on how to install and configure Nginx as an external web server for MTA is here: [[Installing and Configuring Nginx as an External Web Server]]

==Starting your server==
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!

To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where necessary.

==Installing/Updating resources on your server==
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA server supports both these methods.

# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.
# In the server window type in the command [[Server_Commands#refresh|refresh]], this will re-scan the resources folder and update the live resources where necessary.

==Uninstalling resources==
Resources can easily be removed from your server if you no longer want them.

# Delete the ZIP file or the folder of the resource you wish to uninstall
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.

==Administrating your server==
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".

It's also possible to execute these and other admin commands from the in-game console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "[[Server_Commands#login|login username password]]". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.

For further commands, type [[Server_Commands#help|help]] in a console.

==Starting a map/gamemode==
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.

==Useful Notes==

# You may also update the resources while in-game as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.

====Need further help?====
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [[Discord]]

[[es:Manual del Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[ru:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[hu:Server Manual]]

[[Category:Support]]

IT/Manuale del Server

2022-01-23T16:55:43Z

Turret001: replaced IRC with Discord

{{IT/MainP}}
[[Category:75%]]
[[Category:IT/Guide e tutorial]]
Avviare un server per giocare in internet o in LAN con i tuoi amici è molto più semplice di quanto sembri: seguendo questa pagina riuscirai a creare il tuo server MTA:SA:DM e renderlo operativo in pochissimo tempo!

==Installare il server==
L'applicazione per il server è disponibile in numerose versioni a seconda del sistema operativo in cui dovrà girare(Windows, Linux, ecc.).

===Linux installation===
Io ho installato il server su ubuntu 6.06 LTS. Aggiungero le instruzioni per installare le versioni linux del server possimamente.
Questa installazione è stata fatto su os fresco e quindi c'è bisogno di installare alcune cose prima.
Prima di tutto installa il client ssh che vuoi. Io preferisco putty.
Comincia scrivendo: '''sudo apt-get upgrade''' Ti chiederà di inserire la password del tuo utente. quando la installazione è andata a buon fine digita:
'''sudo apt-get install pico''' Questo installerà Pico,un editor txt che userai per modìficare la configurazione del tuo server.
Quando l'installazione è andata a buon fine avrai bisogno di una copia di libcurl3 per il server per farlo partire così nella console digita: '''sudo apt-get install libcurl3'''
Un'altra volta ti chiederà di inserire la password. quando questo è finito abbiamo bigosno del programma del server per il tuo server Linux. Ci sono 5 metodi per fare questo. Tu puoi installare un FTP server. Puoi usare putty per trasferire i file. Se conosci qualcuno che ha un sito puoi chiedergli di mettere i file nel suo sito, cosi usa: '''wget http://wwww.websitename.com/file.tar''' Logicamente il nome del sito è diverso da questo ma è quello del tuo amico. La 5° via che hai per estrarre il file tar nel tuo server è di estrarre usando questo comando '''tar -zxvf filename.tar'''

===Installazione su Windows===
Installare un server MTA:SA DM su Windows è facilissimo:
*Scarica [http://mtasa.com/dp.html qui] l'autoinstallante per piattaforma Windows.
*Installa il server nella cartella che preferisci.

==Configurare il server==
Iniziamo aprendo il file ''mtaserver.conf'', che si trova nella cartella <SERVER>/mods/deathmatch, usando un qualsiasi editor di testo.
Il contenuto del file è autodescrittivo: ogni variabile ha una descrizione su cosa si tratti e come modificare una determinata variabile.

===Aggiungere degli admin===
''Per una spiegazione completa riguardo il file ''acl.xml'' ([[IT/ACL|Access Control List]])''

Per aggiungere degli admins al server:
*Cerca il file ''Accounts.xml'' all'interno della cartella ''deathmatch'' ed aprilo.
*Aggiungi un nuovo account seguendo al sintassi sottostante:
<syntaxhighlight lang="xml">
<account name="Nickname" password="Password" />
</syntaxhighlight>
*Salva il file.
*Apri il file ''acl.xml''.
*Scegli il gruppo di permessi in cui inserire il nuovo account tra Moderator, SuperModerator e Admin.
*Aggiungi l'account appena creato all'interno del gruppo interessato seguendo la seguente sintassi:
<syntaxhighlight lang="xml">
<object name="resource.Nickname"/>
</syntaxhighlight>

Alla fine avrai qualcosa di simile a questo:
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Nickname" />
</group>
</syntaxhighlight>

Finito! In questo modo puoi aggiungere tutti gli admin che preferisci.

'''Nota''': Per rendere effettive le modifiche a questi file dovrai riavviare il server.
'''Nota 2''': Ci sono dei modi per aggiungere e modificare gli accounts anche metre il server è acceso, ad esempio il comando "addaccount <nick> <password>", che permette di aggiungere un account mentre il server è avviato. (Opzione consigliata per i neofiti, o in caso non funzionasse il metodo principale.)

=== Configurare un web server esterno ===
Per prestazioni migliori o altri motivi, puoi scegliere di utilizzare un altro server web già funzionante, al posto del server web incorporato. Il server web esterno deve essere accessibile al pubblico, per cui ogni client potrà scaricare il necessario sul proprio computer per giocare sul server.

Al fine di consentire il download di fuori un altro server web, vanno configurate le opzioni '''httpdownload''' e '''httpdownloadurl''' nel file '''settings.xml''' del server:
<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mioserver.dom/directory/qui</httpdownloadurl>
</syntaxhighlight></div>

Dato che tutte le resources fornite con il server sono compresse, e vengono normalmente estratte dal server incorporato, è necessario permettere ai client di scaricare i file decompressi. I file decompressi sono sempre disponibili nella cartella '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Lancia il server e chiudilo, in questo modo si estrarranno i file nella cartella '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Vai nella cartella sopra descritta e carica i file sul server remoto; può essere fatto in molti modi:
<ul>
<li>Se non ti importa di '''rendere pubbliche le resources''' del tuo server: fai semplicemente l'upload dei file contenuti in '''resourcecache''' sulla cartella del tuo server remoto.</li>
<li>Se non vuoi invece che le tue resources vengano rese pubbliche: vai nella cartella '''resourcecache''' e copia manualmente le cartelle sul tuo server, eliminando i file (che non sono necessari per giocare) che non vuoi vengano scaricati.<br />
<br />
Non c'è ancora nessun modo di rendere sicuri i file sul server rapidamente.
</ul>
</li>
</ol>

'''Nota''': Evita qualsiasi carattere speciale (es. ~, !) negli URL di ''httpdownloadurl''.<br />
'''Note 2''': Non terminare gli URL con degli slash finali (es. ''hxxp://www.mioserver.dom/directory/'' invece di ''hxxp://www.mioserver.dom/directory'')

==Avviare il server==
Per prima cosa controlla di aver finito di configurare il tuo server, avviare il server è l'ultima cosa, quindi tutto deve già essere pronto!

Per avviare il server apri il file '''MTA Server.exe''', e assicurati che sia autorizzato da tutti i firewall e le porte del router.

==Installare/aggiornare le risorse sul server==
Le risorse possono presentarsi in due formati, o un '''archivio .zip''' o semplicemente una '''cartella''' contenente i file dello script. Il server MTA:SA DM supporta entrambi questi formati.

#Sposta o copia la nuova risorsa nella cartella <syntaxhighlight lang="lua"><SERVER>\mods\deathmatch\resources</syntaxhighlight>.
#Avvia da console il comando '''refresh''', questo aggiornerà la lista delle risorse e le risorse in esecuzione dove necessario.

==Disinstallare le risorse==
Se non vuoi più una risorsa, puoi semplicemente eliminarla dal server se vuoi.

#Cancella la cartella o l'archivio ZIP che contiene la risorsa.
#Avvia da console il comando refresh, questo aggiornerà la lista delle risorse e le risorse in esecuzione dove necessario.

==Amministrare il server==
Puoi avviare le risorse eseguendo il comando <syntaxhighlight lang="lua">start [nomerisorsa]</syntaxhighlight> nella console del server, o fermarle con <syntaxhighlight lang="lua">stop [nomerisorsa]</syntaxhighlight>.

È anche possibile eseguire questi e altri comandi admin dalla console in-game (che puoi aprire tramite i tasti '''F8''' o '''\'''); per poterlo fare, devi prima effettuare il login con il comando <syntaxhighlight lang="lua">login [username] [password]</syntaxhighlight>. In più, puoi visualizzare il pannello admin premendo il tasto '''P''': questa è un'interfaccia grafica che comprenderà diversi comandi admin, tra cui quelli per effettuare kick e ban.

Per altri comandi, esegui il comando <syntaxhighlight lang="lua">help</syntaxhighlight> in console.

==Avviare una mappa/gamemode==
Per maggiori informazioni consulta la sezione comandi della pagina [[Resource:IT/Map manager|map manager]].

==Amministrare in remoto il server==
Questa sezione presume che tu abbia già impostato un account funzionante con privilegi da Admin, ed hai le seguenti risorse avviate:
#ResourceBrowser
#ResourceManager
#WebAdmin
#WebMap

Puoi accedere a questi importanti strumenti di amministrazione da <syntaxhighlight lang="lua">http://<IPSERVER>:<PORTA>/resourcebrowser</syntaxhighlight> con [http://www.mozilla-europe.org/it/products/firefox/ Firefox].

'''NOTA: Internet Explorer NON funzionerà, non visualizzerà il browser delle risorse, mentre altri browser (come Opera) avranno vari risultati'''. Se vuoi che funzioni su Internet Explorer, sentiti libero di riscriptare le risorse.

==Note utili==

#Puoi anche aggiornare le risorse durante il gioco finché eseguirai il comando <syntaxhighlight lang="lua">refresh</syntaxhighlight> nella console client o <syntaxhighlight lang="lua">/refresh</syntaxhighlight> nella chat dopo ogni modifica. Questo potrebbe causare qualche secondo di lag se hai molte risorse.
#Nelle istruzioni sopra, '''<SERVER>''' è il percorso della cartella del tuo server. Nella maggiro parte dei casi è <syntaxhighlight lang="lua">C:\Program Files\MTA San Andreas\server</syntaxhighlight>.

====Hai bisogno di altro aiuto?====
Perché non fare un salto sul [http://forum.mtasa.com/ forum] (inglese) o sul [[Discord]]?

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

PT-BR/Compilando o MTASA no Linux

2022-01-23T16:55:10Z

Turret001: replaced IRC with Discord and updated bug tracker link

== Instalando e rodando o servidor do MTASA no Linux ==
{{Dica|Este artigo é destinado a desenvolvedores os quais editaram o código fonte do servidor. Se você estiver procurando por um servidor pré-compilado, que é a maioria dos casos; viste o sítio [http://linux.mtasa.com/ linux.mtasa.com] e leia o artigo [[Installing and Running MTASA Server on GNU_Linux|deste link]] (Em Inglês)}}

== Compilando em um Linux 64 bit ==
Há passos adicionais a serem feitos em sistemas de arquitetura 64-bits:
===Instale as livrarias de 32 bit===
Para o Debian 64 bit, pode-se fazer assim:

apt-get install ia32-libs

===Soluções de Problemas===
* Caso o problema "libreadline.so.5: cannot open shared object file: No such file or directory." for apresentado, pode ser resolvido no Debian Squeeze 64 bit com:

apt-get install lib32readline5

* Caso o problema "libncursesw.so.5 cannot open shared object file: No such file or directory" for apresentado, pode ser resolvido no Debian Squeeze 64 bit com:

apt-get install lib32ncursesw5

* Se você possuir o Cent OS e estiver aparecendo algo como "/usr/lib/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by xmll.so)", isso pode ser resolvido ao baixar o arquivo comprimido [[http://archives.fedoraproject.org/pub/archive/fedora/linux/releases/9/Fedora/i386/os/Packages/libstdc++-4.3.0-8.i386.rpm aqui]] e descompacta-lo com o seguinte comando:

rpm2cpio libstdc++-4.3.0-8.i386.rpm | cpio -i --make-directories

* Há mais soluções relacionados aos sistemas Linux 64 bit disponíveis em nossos [http://forum.mtasa.com/viewtopic.php?f=106&t=35328#p367282 fóruns]

== Preparando seu sistema ==

Para configurar o servidor dedicado do Multi Theft Auto, é preciso munir seu sistema com as ferramentas e livrarias corretas. Dependendo da sua distribuição Linux, a maneira como isso será feito será diferente.

O módulo de rede (net.dll ou net.so) é distribuído como uma livraria binária pré-compilada. Esta pode ser encontrada para GNU/Linux dentro da [http://nightly.mtasa.com/ última nightly]. Use o net.so da versão 1.4 se estiver compilando a partir do ''trunk'' ou net.so de 1.3.x se estiver compilando da ''branch'' 1.3.x. Certifique-se de ler o ''MTA10_Server/version.h'' porque contém sugestões de como fazer isso em diferentes versões do programa.

=== Debian Linux ===
Isso também inclui as distribuições derivadas como o Ubuntu.

Você precisará de ferramentas de compilação, ''headers'' e livrarias, que são distribuídos através dos seguintes pacotes do Debian (ex: Debian Lenny):

* '''build-essential:''' contém as ferramentas necessárias, ''headers'' e livrarias para se fazer programas
* '''automake:''' contém as ferramentas para o chamado ''automake''
* '''libtool:''' contém o software "libtool" necessário para se fazer livrarias
* '''libcurl3-dev:''' contém a versão 3 da livraria cURL (sem suporte a SSL)
* '''libpcre3-dev:''' contém a versão 3 da livraria PCRE
* '''libsqlite3-dev:''' contém a versão 3 da livraria SQLite
* '''libreadline5-dev:''' contém a versão 5 da livraria ''readline''
* '''subversion:''' contém o cliente SVN usado para se atualizar com nosso repositório
* '''libncurses5-dev:''' contém o software para gerenciar escritas na janela do console
* '''libncursesw5-dev:''' adiciona suporte para mais tipos de caracteres
* '''libsparsehash-dev:''' contém suporte ao Google's hash-map (para não ser necessário compilar o sparehash!)
* '''libmysqlclient-dev:''' contém a livraria MySQL
Para instalar os pacotes mencionados anteriormente através do apt, credencie-se como ''root'' e digite: apt-get install <lista acima>; como demonstra o exemplo:

apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev
apt-get install libsqlite3-dev libreadline5-dev subversion libncurses5-dev
apt-get install libncursesw5-dev libsparsehash-dev libmysqlclient-dev

=== Gentoo Linux ===
Você precisará só de algumas ferramentas de compilação, ''headers'' e livrarias. Isso porque o sistema ''portage'' incluido no Gentoo já consegue compilar qualquer pacote por padrão, dispensando a instalação dos mesmos. O restante a ser instalado está mencionado abaixo:

* '''sqlite:''' contém a livraria SQLite
* '''subversion:''' contém o cliente SVN usado para se atualizar com nosso repositório
* '''curl:''' contém a livraria cURL. Para compilar com suporte a SSL, use o parâmetro "net-misc/curl ssl USE"
Para compilar e instalar esses pacotes através do emerge, use o comando: emerge -v <lista acima>. O parâmetro "-v" lhe disponibiliza informações adicionais e pode ser omitido, caso lhe for conveniente.
Se desejar usar algum parâmetro USE, inicie o comando digitando: USE="seus-parâmetros-aqui". Podes utilizar também a opção "-pv" para verificar se esses estão corretos. Para mais informações sobre a utilização do emerge, dê uma olhada no [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Livro de bolso Gentoo] ou seu manual.

Exemplos:

emerge -v subversion sqlite
USE=“net-misc/curl ssl” emerge -v curl

=== Fedora ===

Será necessário instalar os seguintes pacotes para conseguir compilar o servidor do MTA no Fedora:
* '''glibc-devel:'''
* '''curl-devel:''' contém a livraria cURL
* '''pcre-devel:''' contém a livraria PCRE
* '''sqlite3-devel:''' contém a livraria SQLite
* '''readline-devel:''' contém a livraria "readline"
* '''lua-devel:''' contém as livrarias do Lua
* '''subversion:''' contém o cliente SVN usado para atualizar o código fonte
Para instala-los pelo yum, credencie-se como ''root'', e use o comando: yum install <lista acima>; como o exemplo abaixo:

yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion

== Compilando em 64-bit ==
O servidor do MTA:SA não pode ser compilado no modo 64-bit. Em contra partida, é possível fazer isso no modo 32-bit ao usar o parâmetro de compatibilidade oferecido: -m32 .
É recomendado também garantir se estão instalados os compiladores cruzados. Para se fazer isso no Debian, use:

apt-get install gcc-multilib g++-multilib

''obs'': Um Compilador cruzado (cross compiler) é aquele capaz de produzir um código executável para diferentes plataformas

== Guia geral para versão {{Current Version|full}} ==

=== Fazendo o Download do código fonte ===

Primeiro é preciso fazer o download do código fonte com o comando:

svn checkout <nowiki>http</nowiki>://mtasa-blue.googlecode.com/svn/branches/{{Current Version|full}}/ mtasa-blue
cd mtasa-blue

=== Compilando e Rodando o servidor ===

Para fazer isto, entre com os comandos abaixo:

autoreconf -fiv
export PKG_CONFIG_PATH=/usr/lib32/pkgconfig
./configure LDFLAGS="-m32" CPPFLAGS="-m32" CFLAGS="-m32" CXXFLAGS="-m32" $@
make
make -C MTA10_Server install
make -C Shared/XML install

Agora, adquira o ''net.so'':

wget <nowiki>http</nowiki>://nightly.mtasa.com/?multitheftauto_linux-{{Current Version|full}}-rc-latest -O multitheftauto_linux-{{Current Version|full}}-latest.tar.gz
tar -xzf multitheftauto_linux-{{Current Version|full}}-latest.tar.gz --transform 's:[^/]*:latest_nightly:'
mv latest_nightly/net.so MTA10_Server/output/
rm -rf latest_nightly multitheftauto_linux-{{Current Version|full}}-latest.tar.gz

Ponha os arquivos no lugar:

cp MTA10_Server/mods/deathmatch/acl.xml MTA10_Server/output/mods/deathmatch/acl.xml
cp MTA10_Server/mods/deathmatch/mtaserver.conf MTA10_Server/output/mods/deathmatch/mtaserver.conf

Baixe os recursos:

svn export <nowiki>http</nowiki>://mtasa-resources.googlecode.com/svn/trunk/ MTA10_Server/output/mods/deathmatch/resources

Pronto, o servidor pode ser iniciado na pasta: ''MTA10_Server/output''

=== '''Soluções de Problemas''' ===

Qualquer erro durante a compilação do ''jason-c'' pode ser resolvido usando o comando "autoreconf -fi" na pasta dele.

Para outros tipos de problemas quando for compilar, sinta-se a vontade de dar uma passada em nosso [https://github.com/multitheftauto/mtasa-blue/issues Bug tracker] ou [https://discord.com/invite/mtasa Discord]

[[en:Building MTASA Server on GNU Linux]]
[[ru:Building MTASA Server on GNU Linux]]
[[Category: Development]]

RU/Building MTASA Server on GNU Linux

2022-01-23T16:54:44Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{Note|Эта статья предназначена только для тех владельцев, кто внес изменения в код сервера. Если вам нужен прекомпилированный сервер (для обычных владельцев серверов), перейдите на [http://linux.mtasa.com/ linux.mtasa.com]}}

== Подготовка системы ==

Чтобы собрать выделенный сервер Multi Theft Auto, вам понадобится снабдить свою систему определенными библиотеками и инструментами. Как их устанавливать, зависит от вашего дистрибутива.

Наш сетевой модуль (net.dll или net.so) поставляется как прекомпилированная двоичная библиотека. Файл для GNU/Linux можно получить из новейшего nightly-билда для Linux, то есть [http://nightly.mtasa.com/ отсюда]. Используйте net.so от 1.4, если компилируете из trunk, или net.so от 1.3.x, если компилируете ветвь 1.3.x. Удостоверьтесь, что вы прочитали верхнюю часть ''MTA10_Server/version.h'', так как там содержатся указания по компилированию билдов разного типа.

'''Debian Linux'''

Включает производные дистрибутивы типа Ubuntu.

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки, поставляемые через соответствующие пакеты Debian (напр. Debian Lenny):

* '''build-essential:''' содержит необходимые инструменты, заголовки и библиотеки для сборки приложений
* '''automake:''' содержит инструменты automake (автосборка)
* '''libtool:''' содержит программное обеспечение libtool, нужное для сборки библиотек
* '''libcurl3-dev:''' содержит библиотеку cURL (версия 3 без поддержки SSL)
* '''libpcre3-dev:''' содержит библиотеку PCRE (версия 3)
* '''libsqlite3-dev:''' содержит библиотеку SQLite (версия 3)
* '''libreadline5-dev:''' содержит библиотеку readline (версия 5)
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''libncurses5-dev:''' содержит программное обеспечение для контроля над записью в окне консоли
* '''libncursesw5-dev:''' содержит поддержку для широких символов
* '''libsparsehash-dev:''' содержит поддержку для Google hash-map '''(Так что вам не придется компилировать sparehash!)'''
* '''libmysqlclient-dev:''' содержит библиотеку MySQL
Чтобы установить эти пакеты через apt, используйте команду apt-get install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev libsparsehash-dev libmysqlclient-dev</syntaxhighlight>

'''Gentoo Linux'''

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки. Но так как система портирования Gentoo сделана так, что компиляция любых пакетов происходит внтури самой системы, необходимые инструменты для сборки будут итак предустановелены. Все, что остается - установить необходимые библиотеки:

* '''sqlite:''' содержит библиотеку SQLite
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''curl:''' содержит библиотеку cURL; чтобы скомпилировать с поддержкой SSL, примените флаг net-misc/curl ssl USE
Чтобы скомпилировать и установить эти пакеты через emerge, используйте команду emerge -v <package list>. Опция -v показывает дополнительную * * информацию и может быть опущена. (Если вы хотите задействовать какие-либо флаги USE, пре-запустите emerge с USE="здесь пишите флаги". Вы также можете использовать опцию -pv для проверки на предмет использования правильных флагов.) Ссылайтесь на [http://www.gentoo.org/doc/ru/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] или руководство для получения более подробной информации по emerge.

Образец:

<syntaxhighlight lang="lua">emerge -v subversion sqlite
USE=“net-misc/curl ssl” emerge -v curl
</syntaxhighlight>

'''Fedora'''

Для успешной компиляции MTA сервера на Fedora вам понадобятся следующие пакеты:
* '''glibc-devel:'''
* '''curl-devel:''' содержит библиотеку cURL
* '''pcre-devel:''' содержит библиотеку PCRE
* '''sqlite3-devel:''' содержит библиотеку SQLite
* '''readline-devel:''' содержит библиотеку readline
* '''lua-devel:''' содержит Lua-библиотеки
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
Чтобы установить эти пакеты через yum, воспользуйтесь командой yum install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion</syntaxhighlight>

'''Замечание для x64'''

На данный момент сервер MTA:SA не может быть корректно скомпилирован в 64-битном режиме. Вместо этого, скомпилируйте его в 32-битном режиме и запустите в режиме 32-битной совместимости (используйте флаг -m32).

== Общее руководство для {{Current Version|full}} ==

'''Получение исходного кода.'''

Для начала вам понадобится скачать исходный код.

svn checkout <nowiki>http</nowiki>://mtasa-blue.googlecode.com/svn/branches/{{Current Version|full}}/ mtasa-blue
cd mtasa-blue

Затем вот так его скомпилировать:
autoreconf -fiv
export PKG_CONFIG_PATH=/usr/lib32/pkgconfig
./configure LDFLAGS="-m32" CPPFLAGS="-m32" CFLAGS="-m32" CXXFLAGS="-m32" $@
make
make -C MTA10_Server install
make -C Shared/XML install

Получить net.so так:
wget <nowiki>http</nowiki>://nightly.mtasa.com/?multitheftauto_linux-{{Current Version|full}}-rc-latest -O multitheftauto_linux-{{Current Version|full}}-latest.tar.gz
tar -xzf multitheftauto_linux-{{Current Version|full}}-latest.tar.gz --transform 's:[^/]*:latest_nightly:'
mv latest_nightly/net.so MTA10_Server/output/
rm -rf latest_nightly multitheftauto_linux-{{Current Version|full}}-latest.tar.gz

Скопировать конфигурационные файлы:
cp MTA10_Server/mods/deathmatch/acl.xml MTA10_Server/output/mods/deathmatch/acl.xml
cp MTA10_Server/mods/deathmatch/mtaserver.conf MTA10_Server/output/mods/deathmatch/mtaserver.conf

Получить ресурсы:
svn export <nowiki>http</nowiki>://mtasa-resources.googlecode.com/svn/trunk/ MTA10_Server/output/mods/deathmatch/resources

И готовый сервер будет лежать по адресу MTA10_Server/output

=== '''Поиск и устранение неисправностей''' ===

Любые ошибки в процессе компиляции json-c могут быть разрешены через вызов autoreconf -fi из директории json-c.

Если вы получили какие-либо неожиданные ошибки в процессе компиляции, пожалуйста, посетите наш [https://github.com/multitheftauto/mtasa-blue/issues багтрекер] или [https://discord.com/invite/mtasa Discord]

== '''Вылеты сервера''' ==

Если ваш Linux-сервер вылетает, получите backtrace и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace:====
===Есть ли у вас файл дампа ядра (core dump) в директории с MTA сервером?===
Обычно он называется 'core', его размер свыше 100МБ, сам он выглядит примерно так:
[[Image:Core.png]]
====Если да, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*И из директории, в которую установлена MTA, выполните команду
gdb mta-server -c core
*Когда gdb запустится, введите следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

====Если нет, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь вылета. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда вылет произойдет, выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Зависания сервера''' ==

Если ваш Linux-сервер зависает, получите backtrace с thread-информацией и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace с thread-информацией:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера, запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь зависания. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда зависание произойдет, нажмите ctrl-c для запуска gdb
*Затем выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*Затем выполните следующую команду для получения thread-информации:
info threads
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Запуск на 64-битном Linux''' ==
* Установите 32-битные библиотеки для вашего дистрибутива
Если вы получаете ошибку типа "libreadline.so.5: cannot open shared object file: No such file or directory.", то на Debian она может быть разрешена следующим способом:
<syntaxhighlight lang="lua">
wget http://ftp.uk.debian.org/debian/pool/main/r/readline5/libreadline5_5.2-7_i386.deb
dpkg -X libreadline5_5.2-7_i386.deb temp
cp -d temp/lib/libreadline.so.5* /usr/lib32/
</syntaxhighlight>

[[en:Building MTASA Server on GNU Linux]]

Compiling MTASA

2022-01-23T16:54:06Z

Turret001: replaced IRC with Discord and updated bug tracker link

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

Please read the instructions carefully and do not skip parts of it, if you have no experience.

== Prerequisites ==

Compiling the Multi Theft Auto client is only supported on Windows 10.

Make sure you have the following software and SDKs installed:

=== Visual Studio 2022 ===
[[File:Visual_Studio_Community.PNG|right|150px|link=https://www.visualstudio.com/vs/]]
# '''[https://visualstudio.microsoft.com/vs/ Download Microsoft Visual Studio 2022]''' - make sure you get the Community Edition, that one is free.
# On the installation checklist, [[:File:VsFoundationClasses.png|make sure you tick these 2 items]]:
## ''Desktop development with C++''
## Optional component ''C++ MFC for latest v143 build tools (x86 & x64)''

If you don't enable MFC, you will get the following error: <code>cannot open include file 'afxres.h'</code>.

If you've made a mistake, you can run the ''Visual Studio Installer'' app to modify your current installation. There is no need to uninstall and reinstall.

=== Microsoft DirectX SDK ===
[[File:DirectX_SDK.jpg|right|150px|link=http://web.archive.org/web/20200804044856/https://www.microsoft.com/en-us/download/details.aspx?id=23549]]
'''Download Microsoft DirectX SDK (August 2009) (DXSDK_Aug09.exe):'''
* [https://archive.org/download/dxsdk_aug09/DXSDK_Aug09.exe Mirror 1]
* [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe Mirror 2]

{| class="wikitable" style="margin-top: 0px; width: 70%; word-break: break-all;"
|+ File verification
|- style="vertical-align:bottom;"
! colspan="2" | Algorithm and variant
! Hash
! Hash file
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-3}}''' || ''SHA3-224'' || 8bfcdc03518d7edd34689534fd4d21291469ff2f2eb10437ad648c58 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-224 DXSDK_Aug09.exe.sha3-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-256'' || 45bf3e08da3b3636ddb4f4a74243430f8d65759c074c0d79756ef810c4701c5a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256 DXSDK_Aug09.exe.sha3-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-384'' || b358e529963d6f5fd7f8bd4b530fb18f6a2e6a442009a54e981b2f9967589ed48150af310f283640d56f9b60d41100c9 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-384 DXSDK_Aug09.exe.sha3-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-512'' || 43522187053af744250059ef69c0f3083cecd1157fe56daac16b9497ebc6fb5b525875144e42898367c55f757cffd3526f37074d544470578602a5a944a45a75 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-512 DXSDK_Aug09.exe.sha3-512]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE128'' || 2a7c81bde9e867cbb5ef00b72ad8de66a3ee64c1d59f16465fa712479b6a84d28a02cc5ed08afa1d51e72011657453dbd4656cc9340d32e18179c39d03982dfc35c8f0c2a5c99e11dc74d0e23ed21b1e55f19c809a5a152bde39a2d46fcd12421f373f2d691ade1b57faf6c2ab7aded5a7d174f1f1c77127c0d6a1523b4775c569c5e1b4efa2da4bf2f708a96707a709e245a7f507382e69a81777919c90e95a091c0b699ce7f517 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-128000 DXSDK_Aug09.exe.sha3-128000]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE256'' || 9c100dac5245a61774f3a2752bf9e941bdcd5654b18035155161c63b20936dfc9bd7334feb9a6fe9a99a65491161083b39ac3bd578e2cf4f90cba3c786e9924fa0611f65a725331b77b63e7c8b552e1637bc77531ba0f2c9cac72115b28e523929ede4e5b246a0755e8d5c4089d94bf16627fb08672cfffa523bba3d976489a0eec60d3c6a96ca2b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256000 DXSDK_Aug09.exe.sha3-256000]
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-2}}''' || ''SHA-224'' || a3a74b89cccfe314b79418d5598aac5e94800221e5d945c74f15c004 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-224 DXSDK_Aug09.exe.sha2-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-256'' || 4ab1de69312f10f6b41310a5218d80c478bbd823bc0f86627318d690b128fb9f || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-256 DXSDK_Aug09.exe.sha2-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA-384'' || 254ed29c6ad2cadc6f013d2d51c0ac78a6bbe236a2c94ca99610eba8b2c1200d1a62c445ca9ee51bb09354875d5eca8a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-384 DXSDK_Aug09.exe.sha2-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512'' || style="width: 60%;" | 736393c0dfa32221e229890f87eb330174d70dd2a02fa0cace303816d3e7a10a332a44129748de39665d1b339e627d6028c2080268f7afdd5240c447fec8ff0b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512 DXSDK_Aug09.exe.sha2-512]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/224'' || 7e23d9ba916000782a17e23abf48e25237f45590cfe767aed9d79f10 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512224 DXSDK_Aug09.exe.sha2-512224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/256'' || 0c833a56046fe7e4213fcb1862c730acf313d1b8f60b51eebf64dc3e79730c1c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512256 DXSDK_Aug09.exe.sha2-512256]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''MD5''' || 66e5379ecf46b014688779621bcc677c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.md5 DXSDK_Aug09.exe.md5]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''{{nowrap|SHA-1}}''' || 5b9b969ed7b6cf5534bb7350e44c09b3573b0e71 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha1 DXSDK_Aug09.exe.sha1]
|}
CRC32 e9f5c61d ([https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sfv DXSDK_Aug09.exe.sfv])<br>

'''NOTE:''' Restart your computer after installing ''Microsoft DirectX SDK'', because otherwise the environment variable '''DXSDK_DIR''' won't be available yet. After restarting it re-run '''create-projects.bat'''

'''Cant find d3dx9.h'''<br>
Add the '''$(DXSDK_DIR)Include;''' to the VC++ Directories in DirectX9GuiRenderer, GUI and Client Core projects.
You can find the VC++ Directories list by selecting a project, then pressing the shortcut ALT + ENTER (without the +), then under the 'Configuration properties' you can find 'VC++ Directories', and in there you can find the 'Include Directories' field, click on it and add ''';$(DXSDK_DIR)Include;''' at the end of it.
'''Note: You need to do the same thing in Release mode as well'''

'''Cant find d3dx9.lib'''<br>
Do do same as in the error above, but instead of ''';$(DXSDK_DIR)Include;''' you must add ''';$(DXSDK_DIR)Lib/x86;''' to the '''Library directories''' field
'''Note: You need to do the same thing in Release mode as well'''

'''S1023 Error'''<br>
[https://support.microsoft.com/en-us/kb/2728613 "S1023" error when you install the DirectX SDK (June 2010)]<br style="clear:both">

'''Cannot open source file "xxx.h" after upgrading to Visual Studio 2022'''<br>
If you've just upgraded to Visual Studio 2022 and were working on MTA using a previous version, you may receive errors about header files not being found (stdio.h, stddef.h, etc) when building the project.

Make sure you have the latest Windows 10 SDK installed (via the Visual Studio Installer) and restart your PC.

If that doesn't work - close Visual Studio, go into the `Build` folder (where your mtasa-blue is located) and delete the `.vs` folder. Start Visual Studio and everything should be fixed.

=== Git Client ===
[[File:Git_logo.png|left|32px|link=https://git-scm.com/]]

If you would like to contribute to MTA, you should install Git. This will allow you to collaborate with us by creating branches and pushing to your own fork. If you are not comfortable with the command line, we recommend you to download and install [https://desktop.github.com/ GitHub Desktop].

If you only want to compile the source code and are not interested in contributing to MTA, you can download the source directly (see below).

== Getting the latest source code ==

To get the latest code, you will have to download the latest copy of our Git repository.<br>
We recommend cloning the repository in your Git client because you can pull any updates from there easily.

* '''Repository:''' [https://github.com/multitheftauto/mtasa-blue multitheftauto/mtasa-blue]
* '''.zip:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.zip master.zip]
* '''.tar.gz:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz master.tar.gz]

== Compiling the code ==
# Execute the script '''win-create-projects.bat'''
# Open the solution file '''MTASA.sln''' in the '''Build''' directory
# If you are asked to upgrade the project, click '''Cancel'''
# Select '''Debug''' - '''Win32''' configuration in Visual Studio, then press Build > Build Solution... (may take some minutes)
# Execute the script '''win-install-data.bat'''

= Running the software =

== Running the client ==

You can start your client in the '''Bin''' directory. You might find there a ''Multi Theft Auto.exe'' and/or ''Multi Theft Auto_d.exe'' executable. The ''_d'' suffix indicates a debug build of the software.<br>
Furthermore, you can also run your client inside the debugger from Visual Studio if you want to investigate a stack trace or set breakpoints in interesting code regions (read more in the section Debugging below).

== Running the dedicated server ==

If you already have run step 5 (''Install resources'') in ''Compiling the code'' to install resources then you can go to ''Starting the server''.

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

Our official resources repository is [https://github.com/multitheftauto/mtasa-resources hosted on GitHub]. You can download the latest resources from there or [http://mirror.mtasa.com/mtasa/resources/ download a zipped version]. Make sure that you have the latest resources package.

=== Starting the server ===
To run the server, open the ''MTA Server.exe'' executable in the '''Bin/server''' directory. The ''_d'' suffix indicates a debug build of the software.<br>
You can also run the debug build ''MTA Server_d.exe'' with the Visual Studio Debugger (as of writing, you can do that by right-clicking on the Server's Launcher project and selecting ''Start a local instance'' in the ''Debugger'' menu), but you can also attach to a running debug build MTA server (see more in the section Debugging below).

== Debugging ==
If you already compiled the code in the '''Debug''' configuration then continue reading, if not, then go up to ''Compiling the code'' and follow the steps for a ''Debug'' build.<br>
You can either launch MTA yourself and attach any debugger you want to use (also applies to the Visual Studio debugger) or you start a local debugging session in Visual Studio.<br>
[[File:Local_Windows_Debugger.PNG]]

=== How to enable breakpoints ===
If you choose to run MTA with Visual Studio then you should also attach the debugger to the executable '''gta_sa.exe''' (press ''CTRL + ALT + P'' in Visual Studio) - otherwise, your
breakpoints will not work for anything besides the MTA Launcher project.<br>
[[File:Attach_to_Process.png|600px]]

=== Extending timeout duration ===
When you use breakpoints during debugging, you may get kicked by the server due to timeout, because the client is frozen. To prevent this, create the '''timeout.longtime''' file in your ''Bin/server/'' directory.
The content of the file is the new timeout duration in seconds, so make sure you type a huge number in there. If you keep the file empty, the timeout will be set to 120 seconds.

=== ReAttach for Visual Studio ===
You can use [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach ReAttach] to re-attach the debugger to the '''gta_sa.exe''' executable whenever you start your local debugger in Visual Studio.<br>
[[File:ReAttach_to_GTASA.PNG]]

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

= Additional information =
If you need more information, try our [https://github.com/multitheftauto/mtasa-blue/issues bug tracker] or [https://discord.com/invite/mtasa Discord].

= Errors =
== CL38 error. [netc_d.dll not found] ==
Solution: Delete '''Multi Theft Auto_d.exe''' and hit compile again.

== After cloning the repository, it doesn't compile the project ==
Solution: Execute '''win-create-projects.bat''' in main directory.

== CL17 Load field. Please ensure that the latest data files have been installed correctly ==
Solution: Execute '''win-install-data.bat''' in main directory.

== ERROR: Loading network library (net_d.dll) failed! ==
Solution: Execute '''win-install-data.bat''' in main directory.

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

Kompilowanie MTASA

2022-01-23T16:53:18Z

Turret001: replaced IRC with Discord and updated bug tracker link

Aby pomyślnie skompilować Multi Theft Auto z kodu źródłowego, niezbędne jest wykonanie kilku kroków, które przedstawimy poniżej.

Przeczytaj uważnie poniższe instrukcje i nie pomijaj żadnej z nich, jeśli nie masz doświadczenia.

== Podstawowe Wymagania ==

Powinieneś używać systemu Windows 7 lub nowszego, zanim będziesz mógł skompilować klienta Multi Theft Auto.

Upewnij się czy masz zainstalowane następujące programy i zestawy SDK:

=== Visual Studio 2019 ===
[[File:Visual_Studio_Community.PNG|left|150px|link=https://www.visualstudio.com/vs/]]
'''Pobieranie'''
[https://visualstudio.microsoft.com/vs/ Microsoft Visual Studio 2019] (Edycja Community jest darmowa).<br>
Upewnij się czy instalujesz także inne elementy podczas instalacji, patrz poniżej.
(Możesz ponownie uruchomić instalator, aby zmodyfikować aktualną instalację bez konieczności odinstalowywania i instalowania.)<br>

'''Missing #include "afxres.h"'''<br>
[[Media:VsFoundationClasses.png|Upewnij się, że masz zainstalowane wsparcie dla MFC i ATL.]] MFC/ATL musi być w wersji 141 (v141).<br>

'''Problemy z zestawem narzędzi'''<br>
[[Media:VsFoundationClasses.png|Upewnij się, że masz zainstalowane ''VC++ 2015 toolset''.]]<br>
(Możesz ponownie uruchomić instalator, aby zmodyfikować aktualna instalację bez konieczności odinstalowywania i instalowania.)

'''Dodatek: ReAttach''' (opcjonalnie)<br>
Pobierz: [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach ReAttach]<br>
(ReAttach daje łatwy sposób na ponowne dołączenie (re-attach) wcześniejszych celów debugowania)

=== Microsoft DirectX SDK ===
[[File:DirectX_SDK.jpg|left|150px|link=https://www.microsoft.com/en-us/download/details.aspx?id=23549]]
'''Pobierz'''<br>
[https://www.microsoft.com/en-us/download/details.aspx?id=23549 Microsoft DirectX SDK (August 2009)]<br>

'''S1023 Error'''<br>
[https://support.microsoft.com/en-us/kb/2728613 "S1023" błąd podczas instalacji DirectX SDK (June 2010)]<br style="clear:both">

=== Klient Git ===
[[File:Git_logo.png|left|32px|link=https://git-scm.com/]]
Masz trzy możliwości. Możesz zainstalować '''JEDEN''' z klientów poniżej (do współpracy) albo pobierz całe repozytorium kodu źródłowego [https://github.com/multitheftauto/mtasa-blue/archive/master.zip .ZIP] (Jeśli chcesz tylko skompilować kod źródłowy i nie zamierzasz współpracować razem z nami). Możesz także używac wiersza poleceń Git'a do kontrolowania repozytorium. <br style="clear:both">

==== GitHub Desktop ====
[[File:GitHub_Desktop.png|left|150px]]
'''Pobierz:'''<br>
[https://windows.github.com/ GitHub dla systemu Windows]<br style="clear:both">

==== SourceTree ====
[[File:Atlassian_SourceTree.png|left|150px]]
'''Pobierz:'''<br>
[https://www.sourcetreeapp.com/ SourceTree]<br style="clear:both">

==== GitKraken ====
[[File:GitKraken_Logo.png|left|150px]]
'''Pobierz:'''<br>
[https://www.gitkraken.com/ GitKraken]<br style="clear:both">

== Zdobycie najświeższego kodu źródłowego ==

Aby zdobyć najświeższy kod źródłowy, będziesz musiał pobrać ostatnią kopie naszego repozytorium Git.<br>
Zalecamy sklonować nasze repozytorium w twoim kliencie Git, ponieważ możesz łatwo pobierać z niego dowolne aktualizacje.

* '''Repozytorium:''' [https://github.com/multitheftauto/mtasa-blue multitheftauto/mtasa-blue]
* '''.zip:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.zip master.zip]
* '''.tar.gz:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz master.tar.gz]

== Kompilacja kodu ==
# Uruchom skrypt (otwórz plik) '''win-create-projects.bat'''
# Otwórz plik rozwiązania '''MTASA.sln''' w folderze '''Build'''
# Jeśli zostaniesz zapytany o aktualizacje projektu, kliknij '''Anuluj'''
# Skompiluj kod w Visual Studio na konfiguracji '''Debug''' (może to potrwać kilka minut)
# Uruchom skrypt (otwórz plik) '''win-install-data.bat'''

= Uruchamianie programu =

== Uruchamianie klienta MTA ==

Możesz uruchomić swojego klienta w folderze '''Bin'''. Możesz znaleźć tutaj pliki ''Mutli Theft Auto.exe'' i/lub ''Multi Theft Auto_d.exe''. Przyrostek ''_d'' oznacza kompilacje developerską (konfiguracja debug) programu.
Ponadto, możesz także uruchomić swojego klienta w debuggerze z Visual Studio jeśli chcesz przeanalizować układ stosu lub ustawić punkty przerwania w interesujących regionach kodu (przeczytaj więcej poniżej w sekcji Debugowanie).

== Uruchamianie dedykowanego serwera ==

Jeśli już wykonałeś krok 5 (''Instalacja zasobów'') w sekcji ''Kompilacja kodu'' aby zainstalować zasoby, możesz przejść do sekcji ''Uruchamianie serwera lokalnego''.

=== Instalacja najświeższych zasobów ===
Jeśli chcesz uruchomić dedykowany serwer Multi Theft Auto, musisz zainstalować wymagane zasoby. Są one niezbędne, ponieważ dodają podstawowe funkcje (np. odradzanie graczy) aby móc grać.

Nasze oficjalne repozytorium zasobów: [https://github.com/multitheftauto/mtasa-resources znajdujące się w serwisie GitHub]. Możesz pobrać najświeższe zasoby z tego repozytorium lub [http://mirror.mtasa.com/mtasa/resources/ pobierz archiwum .zip]. Upewnij się, że masz najnowszą paczkę zasobów.

=== Uruchamianie serwera ===
Aby uruchomić serwer, otwórz plik ''MTA Server.exe'' w folderze '''Bin/server'''. Przyrostek ''_d'' oznacza kompilację developerską (konfigurację debug) programu.<br>
Możesz także uruchomić serwer w wersji developerskiej (debug); ''MTA Server_d.exe'' przy pomocy debuggera Visual Studio (jak przy pisaniu, możesz zrobić to poprzez kliknięcie prawego przycisku myszki na projekcie ''Launcher'', po stronie serwera (Rozwiń projekt Server) i wybranie ''Uruchom lokalną instancję'' w zakładce ''Debugger''), ale możesz także dołączyć do działającego debuggera serwera MTA (zobacz więcej niżej, w sekcji ''Debuggowanie'').

== Debugging ==
If you already compiled the code in the '''Debug''' configuration then continue reading, if not, then go up to ''Compilling the code'' and follow the steps for a ''Debug'' build.<br>
You can either launch MTA yourself and attach any debugger you want to use (also applies to the Visual Studio debugger) or you start a local debugging session in Visual Studio.<br>
[[File:Local_Windows_Debugger.PNG]]

=== How to enable breakpoints ===
If you choose to run MTA with Visual Studio then you should also attach the debugger to the executable '''gta_sa.exe''' (press ''CTRL + ALT + P'' in Visual Studio) - otherwise your
breakpoints will not work for anything beside the MTA Launcher project.<br>
[[File:Attach_to_Process.png|600px]]

=== Extending timeout duration ===
When you use breakpoints during debugging, you may get kicked by the server due to timeout, because the client is frozen. To prevent this, create the '''timeout.longtime''' file in your ''Bin/server/'' directory.
The content of the file is the new timeout duration in seconds, so make sure you type a huge number in there. If you keep the file empty, the timeout will be set to 120 seconds.

=== ReAttach for Visual Studio ===
You can use [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach ReAttach] to re-attach the debugger to the '''gta_sa.exe''' executable whenever you start your local debugger in Visual Studio.<br>
[[File:ReAttach_to_GTASA.PNG]]

= Chęci współpracy =
Prosimy, sprawdź nasze [[Coding guidelines]] po więcej informacji o praktykach kodowania.

= Dodatkowe informacje =
Jeśli potrzebujesz więcej informacji, sprawdź nasz [https://github.com/multitheftauto/mtasa-blue/issues bug tracker] lub [https://discord.com/invite/mtasa Discord].

= Błędy =
== CL38 error. [nie znaleziono netc_d.dll] ==
Rozwiązanie: Usuń '''Mutli Theft Auto_d.exe''' i naciśnij 'Kompiluj ponownie' w Visual Studio.

== Po sklonowaniu repozytorium, nie można skompilować projektu ==
Rozwiązanie: Otwórz plik '''win-create-projects.bat''' w głównym katalogu.

== CL17 Load field. Prosimy, upewnij się, że najnowsze pliki danych zostały zainstalowane poprawnie ==
Rozwiązanie: Otwórz plik '''win-install-data.bat''' w głównym katalogu.

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

NL/Server Manual

2022-01-23T16:52:04Z

Turret001: removed a bracket (oops)

{{outdatedtr}}
__TOC__

==Beginnen==
Het is veel makkelijker dan het lijkt om een server te gebruiken voor je internet- of LAN-vrienden: volg deze instructies en je zal hopelijk snel op weg zijn naar het hosten van je eigen MTA:SA server!

==De server installeren==
Er zijn verschillende serverapplicaties beschikbaar voor verschillende platformen.

===Linux installatie===
Er zijn verschillende manieren om een Linux server draaiende te krijgen:
* [http://wiki.github.com/multitheftauto/multitheftauto/building-on-gnulinux Een server maken op GNU/Linux (Engels)]
* [http://linux.mtasa.com Een voorgecompileerd paket downloaden (Engels)]

===Windows installatie===
Installatie van de Windows server is heel makkelijk:
*Download MTA:SA en installeer het pakket ''inclusief'' de server.
*Start, zodra de download klaar is, de installer.
*Kies de map waar je de server wilt installeren.
*Klik op installeren.
*Je bent klaar!

==Configureren van de server==

''Voor een volledige uitleg over acl.xml (access control list) lees: [[Access_Control_List|Access Control List]]''.

Begin door ''''mtaserver.conf'''', in de map <SERVER>/mods/deathmatch, te openen in een tekstverwerker, bijvoorbeeld kladblok.

Het bestand is duidelijk: elke variabele heeft een beschrijving van wat het doet of wat je er mee moet doen, en hoe je het moet veranderen. Let op: deze beschrijvingen zijn Engels!

===Administrators toevoegen===
''Voor een volledige uitleg van acl.xml (access control list (toegangsbeheerlijst)) lees: [[Access_Control_List|Toegangsbeheerlijst]]''<br/><br/>
Volg deze stappen om admins toe te voegen::<br>
<ol>
<li>Ga naar de 'deathmatch' map van je server, en open Accounts.xml</li>
<li>Voeg een nieuwe account toe met de volgende syntax:
<div style="padding: 10px">
''''Accounts.xml syntax''''
<syntaxhighlight lang="xml">
<account name="Gebruikersnaam" password="Wachtwoord" />
</syntaxhighlight>
</div>
<li>Sla het bestand op, en sluit het af.</li>
<li>Open acl.xml</li>
<li>Kies de rechten van de admin, moderator, of supermoderator</li>
<li>Voeg de account toe in de gekozen groep op de volgende manier:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Gebruikersnaam" />
</syntaxhighlight>
</div>

Je eindigt met iets als:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Gebruikersnaam" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Je bent klaar! Je kan zoveel admins toevoegen als je wilt op deze manier, blijf gewoon accounts onder elkaar zetten, en doe hetzelfde met de ACL rechten.<br>
</li>
</ol>
'''Notitie''': Je moet de server herstarten voordat het veranderen van deze bestanden effect heeft.<br />
'''Notitie 2''': Er zijn andere manieren om dit te doen terwijl de server draait. "addaccount <gebruikersnaam> <wachtwoord>" is een intern commando om accounts toe te voegen, en met de web interface kun je ACL rechten veranderen terwijl de server draait. Deze optie is misschien beter, als het eerste niet werkte.

=== Configureren van een externe webserver ===
Je kan een een externe webserver gebruiken, in plaats van de ingebouwde webserver. De externe server moet voor iedereen beschikbaar zijn, zodat de client de client-side bestanden kan downloaden, zodat er op je server gespeelt kan worden.

Om het downloaden vanaf een externe server aan te zetten, moet je de ''httpdownload'' en de ''httpdownloadurl'' tags in je server configuratie veranderen:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mijnserver.tld/map/hier</httpdownloadurl>
</syntaxhighlight></div>

Omdat alle standaard resources gezipt zijn, en normaal uitgepakt worden door de ingebouwde webserver, moet je nu de uitgepakte bestanden op je server zetten. Deze bestanden zijn beschikbaar in de '''<SERVER>/mods/deathmatch/resourcecache''' map.

<ol>
<li>Start de server, en sluit hem weer af. Dit zal de bestanden uitpakken in '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Ga naar deze map en kopieer de bestanden naar de map op je webserver, dit kan op meerdere maniere gedaan worden:
<ul>
<li>Als het je niet uitmaakt dat je '''server-side bestanden voor iedereen beschikbaar zijn''': maak een symbolic link (Linux), een junction (Windows) of kopieer alle bestanden van de '''resourcecache''' map naar je webserver.</li>
<li>Als je niet wilt dat alle bestanden beschikbaar zijn, moet je alle server-side bestanden verwijderen voordat je de mappen op je webserver zet. Server-side bestanden zijn niet nodig voor de client.<br />
<br />
Een snelle manier om je server-side bestanden te beschermen is er momenteel niet. Er word misschien een 'tool' gemaakt dat automatisch alleen de client-side bestanden kopieert.</ul>
</li>
</ol>

'''Notitie''': Vermijd speciale tekens als ~ en ! in je download URLs.<br />
'''Notitie 2''': Gebruik geen slash op het einde van je url (bijv. ''hxxp://www.myserver.tld/directory'' in plaats van ''hxxp://www.myserver.tld/directory/'')

==Het opstarten van je server==
Begin door er zeker van te zijn dat je alle configuratie gedaan hebt, het opstarten van je server is het laatste wat je doet, dus alles moet klaar zijn!

Om je server op te starten, klik dubbel op MTA Server.exe, zorg ervoor dat je het door firewalls heen laat, en alle benodigde poorten 'forward'.

==Installeren/Updaten van resources op je server==
Resources kunnen in twee formaten komen, een ZIP bestand, of een gewone map met de scripten erin. De server support beide deze formaten.

# Verplaats of kopiëer de resource naar je <SERVER>\mods\deathmatch\resources map.
# In de server, type "refresh" (zonder aanhalingstekens), de server zal dan kijken of er nieuwe resources zijn, en zo nodig deze installeren/updaten.

==Resources verwijderen==
Resources kunnen eenvoudig verwijderd worden van je server als je ze niet langer wilt.

# Verwijder het ZIP bestand, of de map van de resource die je verwijderen wilt.
# In de server, type "refresh" (zonder aanhalingstekens), de server zal dan kijken of er resources verwijderd zijn, en zo nodig deze verwijderen.

==Administreren van je server==
Je kan resources starten met "start resourcenaam", en stoppen met "stop resourcenaam", deze commando's moet je intypen in de server.

Het is ook mogelijk dit te doen vanuit het spel zelf, met de ingame console (` toets of F8), of door een / voor je tekst te zetten; om dit te doen, moet je inloggen met het commando "login gebruikersnaam wachtwoord". Als je dat heb gedaan kan je ook op de p toets drukken om de 'admin panel' te krijgen: dit is een grafische interface waarmee je eenvoudig spelers kan kicken of bannen [en vele andere dingen].

Voor meer informatie, gebruik het "help" commando.

==Starting a map/gamemode==
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.

==Remotely administrating your server==
This article assumes you have setup a working account with 'Admin' user rights, and have these resources started:
# resourcebrowser
# resourcemanager
# webadmin
# webmap

Please make sure that you have followed the steps above, involving creating your administrator account and setting it's right before you can access these tools.

You're able to access these great remote admin tools by visiting <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> in your Firefox.
'''NOTE: Internet Explorer will NOT work, it will not display the resource browser, other browsers (Opera namely) will have mixed results'''. If you want it to work in Internet Explorer, feel free to recode the resource :)

==Useful Notes==

# You may also update the resources while ingame as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server

====Need further help?====
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [[Discord]]

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

NL/Server Manual

2022-01-23T16:51:11Z

Turret001: replaced IRC with Discord

{{outdatedtr}}
__TOC__

==Beginnen==
Het is veel makkelijker dan het lijkt om een server te gebruiken voor je internet- of LAN-vrienden: volg deze instructies en je zal hopelijk snel op weg zijn naar het hosten van je eigen MTA:SA server!

==De server installeren==
Er zijn verschillende serverapplicaties beschikbaar voor verschillende platformen.

===Linux installatie===
Er zijn verschillende manieren om een Linux server draaiende te krijgen:
* [http://wiki.github.com/multitheftauto/multitheftauto/building-on-gnulinux Een server maken op GNU/Linux (Engels)]
* [http://linux.mtasa.com Een voorgecompileerd paket downloaden (Engels)]

===Windows installatie===
Installatie van de Windows server is heel makkelijk:
*Download MTA:SA en installeer het pakket ''inclusief'' de server.
*Start, zodra de download klaar is, de installer.
*Kies de map waar je de server wilt installeren.
*Klik op installeren.
*Je bent klaar!

==Configureren van de server==

''Voor een volledige uitleg over acl.xml (access control list) lees: [[Access_Control_List|Access Control List]]''.

Begin door ''''mtaserver.conf'''', in de map <SERVER>/mods/deathmatch, te openen in een tekstverwerker, bijvoorbeeld kladblok.

Het bestand is duidelijk: elke variabele heeft een beschrijving van wat het doet of wat je er mee moet doen, en hoe je het moet veranderen. Let op: deze beschrijvingen zijn Engels!

===Administrators toevoegen===
''Voor een volledige uitleg van acl.xml (access control list (toegangsbeheerlijst)) lees: [[Access_Control_List|Toegangsbeheerlijst]]''<br/><br/>
Volg deze stappen om admins toe te voegen::<br>
<ol>
<li>Ga naar de 'deathmatch' map van je server, en open Accounts.xml</li>
<li>Voeg een nieuwe account toe met de volgende syntax:
<div style="padding: 10px">
''''Accounts.xml syntax''''
<syntaxhighlight lang="xml">
<account name="Gebruikersnaam" password="Wachtwoord" />
</syntaxhighlight>
</div>
<li>Sla het bestand op, en sluit het af.</li>
<li>Open acl.xml</li>
<li>Kies de rechten van de admin, moderator, of supermoderator</li>
<li>Voeg de account toe in de gekozen groep op de volgende manier:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Gebruikersnaam" />
</syntaxhighlight>
</div>

Je eindigt met iets als:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Gebruikersnaam" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Je bent klaar! Je kan zoveel admins toevoegen als je wilt op deze manier, blijf gewoon accounts onder elkaar zetten, en doe hetzelfde met de ACL rechten.<br>
</li>
</ol>
'''Notitie''': Je moet de server herstarten voordat het veranderen van deze bestanden effect heeft.<br />
'''Notitie 2''': Er zijn andere manieren om dit te doen terwijl de server draait. "addaccount <gebruikersnaam> <wachtwoord>" is een intern commando om accounts toe te voegen, en met de web interface kun je ACL rechten veranderen terwijl de server draait. Deze optie is misschien beter, als het eerste niet werkte.

=== Configureren van een externe webserver ===
Je kan een een externe webserver gebruiken, in plaats van de ingebouwde webserver. De externe server moet voor iedereen beschikbaar zijn, zodat de client de client-side bestanden kan downloaden, zodat er op je server gespeelt kan worden.

Om het downloaden vanaf een externe server aan te zetten, moet je de ''httpdownload'' en de ''httpdownloadurl'' tags in je server configuratie veranderen:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mijnserver.tld/map/hier</httpdownloadurl>
</syntaxhighlight></div>

Omdat alle standaard resources gezipt zijn, en normaal uitgepakt worden door de ingebouwde webserver, moet je nu de uitgepakte bestanden op je server zetten. Deze bestanden zijn beschikbaar in de '''<SERVER>/mods/deathmatch/resourcecache''' map.

<ol>
<li>Start de server, en sluit hem weer af. Dit zal de bestanden uitpakken in '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Ga naar deze map en kopieer de bestanden naar de map op je webserver, dit kan op meerdere maniere gedaan worden:
<ul>
<li>Als het je niet uitmaakt dat je '''server-side bestanden voor iedereen beschikbaar zijn''': maak een symbolic link (Linux), een junction (Windows) of kopieer alle bestanden van de '''resourcecache''' map naar je webserver.</li>
<li>Als je niet wilt dat alle bestanden beschikbaar zijn, moet je alle server-side bestanden verwijderen voordat je de mappen op je webserver zet. Server-side bestanden zijn niet nodig voor de client.<br />
<br />
Een snelle manier om je server-side bestanden te beschermen is er momenteel niet. Er word misschien een 'tool' gemaakt dat automatisch alleen de client-side bestanden kopieert.</ul>
</li>
</ol>

'''Notitie''': Vermijd speciale tekens als ~ en ! in je download URLs.<br />
'''Notitie 2''': Gebruik geen slash op het einde van je url (bijv. ''hxxp://www.myserver.tld/directory'' in plaats van ''hxxp://www.myserver.tld/directory/'')

==Het opstarten van je server==
Begin door er zeker van te zijn dat je alle configuratie gedaan hebt, het opstarten van je server is het laatste wat je doet, dus alles moet klaar zijn!

Om je server op te starten, klik dubbel op MTA Server.exe, zorg ervoor dat je het door firewalls heen laat, en alle benodigde poorten 'forward'.

==Installeren/Updaten van resources op je server==
Resources kunnen in twee formaten komen, een ZIP bestand, of een gewone map met de scripten erin. De server support beide deze formaten.

# Verplaats of kopiëer de resource naar je <SERVER>\mods\deathmatch\resources map.
# In de server, type "refresh" (zonder aanhalingstekens), de server zal dan kijken of er nieuwe resources zijn, en zo nodig deze installeren/updaten.

==Resources verwijderen==
Resources kunnen eenvoudig verwijderd worden van je server als je ze niet langer wilt.

# Verwijder het ZIP bestand, of de map van de resource die je verwijderen wilt.
# In de server, type "refresh" (zonder aanhalingstekens), de server zal dan kijken of er resources verwijderd zijn, en zo nodig deze verwijderen.

==Administreren van je server==
Je kan resources starten met "start resourcenaam", en stoppen met "stop resourcenaam", deze commando's moet je intypen in de server.

Het is ook mogelijk dit te doen vanuit het spel zelf, met de ingame console (` toets of F8), of door een / voor je tekst te zetten; om dit te doen, moet je inloggen met het commando "login gebruikersnaam wachtwoord". Als je dat heb gedaan kan je ook op de p toets drukken om de 'admin panel' te krijgen: dit is een grafische interface waarmee je eenvoudig spelers kan kicken of bannen [en vele andere dingen].

Voor meer informatie, gebruik het "help" commando.

==Starting a map/gamemode==
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.

==Remotely administrating your server==
This article assumes you have setup a working account with 'Admin' user rights, and have these resources started:
# resourcebrowser
# resourcemanager
# webadmin
# webmap

Please make sure that you have followed the steps above, involving creating your administrator account and setting it's right before you can access these tools.

You're able to access these great remote admin tools by visiting <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> in your Firefox.
'''NOTE: Internet Explorer will NOT work, it will not display the resource browser, other browsers (Opera namely) will have mixed results'''. If you want it to work in Internet Explorer, feel free to recode the resource :)

==Useful Notes==

# You may also update the resources while ingame as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server

====Need further help?====
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [[Discord]])

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

NL/Startpagina

2022-01-23T16:50:18Z

Turret001: replaced IRC with Discord

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Laatste stable version van '''Multi Theft Auto: San Andreas''' is '''{{Current Version|full}}'''. Ga naar [http://mtasa.com/ main page] en pak het.
<p>
Je kan ook een [http://nightly.mtasa.com/ nightly build] Halen..
</p>
</div>
__NOTOC__
Welkom bij de nederlandse Multi Theft Auto wiki. Op deze wiki vind je veel informatie over Multi Theft Auto.

Er is veel [[How you can help|om MTA te helpen]] maak MTA beter! - Maak een map, een gamemode, help door document scripting functions, schrijf example codes, maak tutorials of speel MTA en report de bugs.

Als je vragen hebt over scripting zeg het in de [[Discord]] (Engels).
<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Hoe starten====

* [[Client_Manual|Client Manual]]
* [[Server_Manual|Server Manual]]
* [[Known_Issues_-_FAQ|Known Issues]]
* [[Upgrading_from_MTA:Race|Migrating from MTA:Race to MTA:SA 1.0.x]]
* [[Map_manager|Map Manager]]

</div>

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

====Scripting====

* [[Scripting Introduction|Introduction to Scripting]]
* [[Introduction to Scripting the GUI]]
* [[Debugging|Debugging Tutorial]] - Hoe vind je errors in je scripts. (Engels)
* [[Resources|Introduction to Resources]]
** [[Resource Web Access]] - Hoe je websites kan maken met resources. (Eng.)
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

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

====Databases====
This section outlines all the Lua capabilites MTA or resources provide.
* [[:Category:Resource|Resource Catalogue]] - You must learn these to make proper scripts
* [[Client side scripts]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Algemeen Lua Help====
Deze paginas zijn gemaakt om je Lua te leren! (Engels!)
*[http://www.lua.org/pil/index.html "Programming in Lua" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Manual]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|FAQ Map Editor (Engels)]]
</div>

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

====Developing Multi Theft Auto====
* [[Compiling_MTASA|Compiling MTASA on Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[Roadmap]]
</div>

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

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

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

====[[Id|ID Lists]]====
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Weapons|Weapons]]
*[[Weather]]
</div>

|-
| colspan="2" |
|}
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Startpagina]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

== MTA Beta ==
Hier komen de nieuwste beta versions!

----

Página Inicial

2022-01-23T16:49:41Z

Turret001: added Discord

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

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

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

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

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

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

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Como você pode nos ajudar</h3>
* Documentar funções ou eventos
* Criar exemplos funcionais e eficientes de funções e eventos
* Examinar e corrigir as páginas
* Escrever tutoriais para ajudar novatos
* Ajudar a traduzir as páginas da Wiki para outras linguagens
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png|link=]]</div>
<h3>Comunidade</h3>
* [[File:iUS.png|Em Inglês|20px]] [http://forum.multitheftauto.com/ Fóruns]
* [[File:iUS.png|Em Inglês|20px]] [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>]

É 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}}

TR/Nasıl yardımcı olabilirsiniz

2022-01-23T16:48:58Z

Turret001: replaced IRC with Discord

__NOTOC__
[[Category:TR/Türkçe Sayfalar]]
Multi Theft Auto bize yardım edebileceğiniz yollarla dolu. Sahip olduğunuz fikirleri geliştirmeye yardım etmek bizi mutludan öte edecektir, onları test etmeye yardım etmek - eğer yeterince iyi ise - ve onları tüm toplulukla paylaşmak. Bu sayfa yardım edebileceğiniz şeyler hakkında ipuçları vermektedir, tabi ki düşünemediğimiz birçok şey de var. Onlar da size kalmış!

==MTA:SA için kodlama==
* İstenmiş özellikler içeren bugsuz modlar için kaynak yamaları oluşturun. ([[Coding guidelines|Kodlama Kuralları]])
* MTA:SA'yı kendi dilinize çevirin - http://translate.multitheftauto.com/

==Script Yazmak==
* Bir oyun modu yaratın
**[[Scripting Introduction|Scripting Tanışma/Başlama]]
**[http://www.lua.org/pil/index.html "Lua'da Program Yapımı" Manual]
* HTTP sunucusunda yönetim paneli oluşturun.
**[[Resource Web Access]]
* Diğer kaynaklara kullanışlı fonksiyonlar sağlayan genel bir amaç edinin.

==Harita(Map) Yapımı==
* Mevcut bir oyun modu için harita düzenleyicisi(map editor) kullanarak yeni bir harita yapın .
**[[Resource:Editor|Map Editor Manual]]

==Web Geliştirme==
* community.mtasa.com'a yeni özellikler ve geliştirmeler eklemek için lil_Toady ile birlikte çalışın.
* İstatistikler için kendi sisteminizi oluşturun -[[PHP SDK]] temel olarak kullanabilirsiniz. Yardım için eAi veya jbeta'a başvurun.

==Döküman==
Değişiklik yapmadan önce bunu inceleyin: [[Help:Editing Guidelines|Editing Guidelines]]
* Bitmiş dökümanlar için [[:Category:Incomplete|Incomplete functions]] - emin olmadığınız şeyler var ise #mta.scripting dan sorabilirsiniz.
* [[:Category:Needs Example|functions & events missing examples]]'e örnekler ekleyin - lütfen onları test edin, ve tekrar, yardıma ihtiyacınız olursa sorun.
* Gözden geçirin ve doğrulayın [[:Category:Needs Checking|pages that need checking]] - kategoriden silmeden önce vurgulanmış sorunların çözüldüğünden emin olun.
* Sayfaları açıklayıcı şekilde genişletin [[:Category:Scripting_Concepts|MTA core concepts]].
* Yeni kişilere yardımcı olmak için öğretici dersler yazın.
* Diğer ülkelerdeki kişilerin MTA'ya başlaması için MTA wiki'yi başka dillere çevirin.
* Dökümanları çıkartılmamış fonksiyon ve eventlerin dökümanlarını çıkarın [[Undocumented Items]]

==Belirli/Özel Görevler==
* Scripting fonksiyonlarındaki hataları/bozulmaları incelemek için bir fuzzer yaratın.
* Mevcut oyun modlarının geliştirilmesine ve sorunlarının giderilmesine yardımcı olun. Birlikte çalışabileceğinizi söylemek için Discord'dan orijinal yazara ulaşın (veya bir geliştiriciye sorun).

[[pl:Jak możesz pomóc]]
[[ru:How you can help]]
[[uk:How you can help]]
[[es:Cómo puedes ayudar]]
[[hu:How you can help]]
[[en:How you can help]]

ZH-CN/客户端手册

2022-01-23T16:45:54Z

Turret001: replaced IRC with Discord

==开始前==
在你开始安装 Multi Theft Auto: San Andreas 之前，首先要确保 GTA:SA 的安装没有任何修改，否则可能会与 MTA 冲突。如果你想保持原来的单人模式，你可以创建两个安装，重新安装 San Andreas 到你的硬盘第二个文件夹中。

此外还需确认你的操作系统是 '''Windows XP''', '''Windows Vista''' (32位或64位), '''Windows 7''' (32位或64位) 或者更高版本并且你的机器有能力运行单人游戏模式。如果你单人游戏模式运行在最低需求下，你的 MTA 体验将变慢因为它运行需要额外的处理资源。
{{ZH-CN/注|
* MTA:SA 只能在 GTA:SA '''v1.0''' 中工作。如果你最近才买的游戏，它很有可能是更高的版本。''' [[ZH-CN/已知问题_-_常见问题#MTASA_.E4.BC.9A.E5.90.8C_v1.01_.E6.88.96_v2.00_.E7.89.88.E6.9C.AC.E7.9A.84_GTA_San_Andreas_.E5.B7.A5.E4.BD.9C.E5.90.97.EF.BC.9F| (更多相关信息)]]
* 如果你有一个 Steam 的 GTA: San Andreas 副本你应该[[ZH-CN/已知问题_-_常见问题#.E6.88.91.E6.9C.89.E4.B8.80.E4.B8.AA_Steam_.E7.89.88.E6.9C.AC.E7.9A.84_GTA_San_Andreas.EF.BC.8C.E4.BD.86.E6.98.AF.E6.80.8E.E4.B9.88.E7.8E.A9_MTASA_.E5.91.A2.EF.BC.9F|先读这里]].
}}

===系统需求===
====最小系统需求====
Multi Theft Auto: San Andreas 最低系统配置需求'''略高于''' Grand Theft Auto: San Andreas 原来的最小系统需求:
* 英特尔奔腾4（Intel Pentium 4）或 AMD速龙XP（AMD Athlon XP）
* 512MB DDR RAM
* 纯净安装的 Grand Theft Auto: San Andreas 1.0 版本 (美国或欧洲)
* 3.7GB 磁盘空间 (3.6GB 是 Grand Theft Auto 最小安装需求) (请记住 MTA 缓冲文件磁盘空间需求取决于你玩的服务器)
* Nvidia GeForce 4 系列或 ATI Radeon 8xxx 系列的显卡 (64MB RAM 并兼容 DirectX 9.0)
* 兼容 DirectX 9.0 的声卡
* 键盘和鼠标
* 互联网宽带接入 (对于多人联机)

====建议系统需求====
* Intel Core 2 Duo 或 AMD 等同的处理器
* 1GB DDR RAM
* 纯净安装的 Grand Theft Auto: San Andreas 1.0 版本 (美国或欧洲)
* >5GB 磁盘空间
* nVidia GeForce FX 系列或更高, ATI Radeon 9xxx 系列或更高. (兼容 Pixel shader 2.0)
* 兼容 DirectX 9.0 的声卡
* 键盘和鼠标
* 互联网宽带接入 (对于多人联机)

====注意====
* 最低系统需求是考虑在 MTA: San Andreas 最低需求，性能可以取决于运行的游戏模式和玩家数量。
* 为了额外的性能负荷，建议添加更多的内存。
* 确保 Windows 有很好的更新。
* 如果你有问题确保你已经参阅过[[ZH-CN/已知问题_-_常见问题|已知问题]]页面或加入我们的 Discord @ https://discord.com/invite/mtasa

==安装游戏==
# 如果你还没有下载 MTA:SA 客户端请去 [http://mtasa.com mtasa.com] 下载。
# 运行安装程序，在 Windows Vista/7/8 中安装时它需要管理员权限。(安装时将会询问)
# 你需要接受 MTA:SA (GPLv3) 许可证。
# 选择你将要安装的组件:
#* '''Game Client (游戏客户端)''' 与游戏接口所需的组件。
#* '''Dedicated Server (专有服务器)''' 使你可以架设一个你自己制作的服务器。
#** '''Core components (核心组件)''' 与 '''Game module (游戏模块)''' 是专有服务器所需的组件。
#** '''Core resources (核心资源)''' 专有服务器所需的资源。
#** '''Optional resources (可选资源)''' 为你的专有服务器添加更多的游戏模式和地图。
#** '''Editor (编辑器)''' 可以创建一个新地图，这是一个可选组件。
#* '''Development (开发)''' 开发工具。
#** '''Module SDK (SDK 模块)''' 创建你自己的 MTA 服务器模块开发使用的 SDK，使用这个组件需要 C++ 相关知识。
#* '''Start menu group (开始菜单项)''' 为已安装的组件创建一个开始菜单项。
#* '''Desktop icon (桌面图标)''' 创建一个客户端的桌面启动图标。
# 然后选择你要安装 mod 的文件夹。这可以是任何文件夹不必安装到你 San Andreas 游戏目录中。
# 下一步，你要选择安装了 San Andreas 游戏目录。默认路径是: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''。
# 当安装完成后，会给你一个马上启动 MTA: San Andreas 选项，选择选项然后点击 '''Finish (完成)'''。
# 以后如果你想玩，从启动菜单项中找到 ''MTA San Andreas'' 运行即可。

==运行游戏==
# 点击位于开始菜单中的 '''MTA:San Andreas''' 启动 Multi Theft Auto。
# GTA: San Andreas 启动并加载后，你将看到 MTA:SA 主菜单。这里你将找到几个选项 (你也可以观看怎么做的 YouTube 视频教程 [http://www.youtube.com/watch?v=ShiqnOazNYw 这里]):

{| border="0" align="center"

| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – 这里你可以获取到服务器列表。</font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – 你可以使用这启动一个本地服务器 </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– 可以更改你游戏中的昵称，配置控制器和调整显示设置。</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– 向你展示项目贡献者的列表</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– 这使你可以创建一个你自己的地图。完成一个包含检查站，斜坡，拾取物件和其他东西地图，之后你可以上传到一个服务器，这样你就可以同其他人一起玩了。</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– 退出到桌面。</font>

<br /><br />
|}

最简单开始玩游戏的方法是点击菜单中的 '''Browse Servers'''。如果服务器列表没有出现，请按 '''Refresh''' 按钮，MTA 将会扫描可用服务器并显示一个服务器列表。

* 下面的 '''Name''' 选项卡，显示每个服务器的名称。
* 下面的 '''Players''' 选项卡，显示在线玩家数量和服务器最大可承载的玩家数量，显示格式为 [在线玩家数量] / [最大可承载玩家数量]。
* '''Ping''' 选项卡显示的是你的电脑与服务器之间的 ping ，或称延迟。ping 是数据包发送后从服务器返回接收到所用时间的一个衡量，所以在高 ping 的服务器你将会有滞后的感觉。通常，服务器离你越近 ping 越低。
* '''Host''' 是这个服务器的 IP 地址。将来你可以使用这个地址通过主菜单中 '''Quick Connect''' 选项连接到相同的服务器。

点击每个选项卡，都可以按照各自的列进行升序或降序排列。

为了获取最好的游戏体验，找到 ping 和人数最为合适的服务器。

一旦你选中了一个服务器，选择并点击对话框右上角的 '''Connect''' 按钮。如果一切顺利，你应该连接到服务器并自动加入游戏。

==怎么玩==

MTA:SA 提供了一个完善的脚本系统使地图制作者可以自定义许多游戏元素用于创建他们自己的游戏模式。游戏尽可能多的包含单人游戏元素尽管这样但是一些方面还是不同的。

在地图中其他人是你的对手，如果是一个团队游戏中则可能是你的盟友。你可以按下 '''T''' 位于屏幕右上角聊天框中同他们聊天，如果你只想和团队成员交谈请按 '''Y'''。

MTA 地图编辑器允许地图制作者添加各种 GTA 对象到他们的地图中包括道路，爆炸桶，坡道，建筑物，小山等。虽然这没什么，但是游戏对象可以通过脚本移动，更改和删除，这提供了多种多样的游戏玩法和乐趣。

按住 '''Tab''' 键将显示得分板。默认情况下只有名称和 ping 显示，但脚本可以扩展特定的列到特定的游戏模式中。例如，一个死亡竞赛游戏模式肯定会有一列记录杀敌数，但是地图制作者可能选择你死了多少次，你玩了多久放入到扩展列，来排列你的分数。

==预定义控制==

===游戏中的按键===

* F8 (或 Tilde 按键，Esc 下面那个按键) - 控制台
* F11 - 展示 SA 地图 ''(使用在下面按键之前)''
**numpad /- - 放大和缩小
**numpad 4, 8, 6, 2 - 向左，向上，向右，向下移动地图
**numpad 0 - 本地玩家(map follows player blip)和自由移动(map stays stationary)之间切换。
* F12 - 截图
* T - 聊天
* Y - 团队聊天

===资源定义的按键===
这些按键取决于服务器运行的脚本。

* F9 - 游戏中的帮助 (帮助资源管理器)
* V - 按下语音交谈，如果服务器启用了语音。
* TAB - 玩家列表 (如果是在服务器上运行记分板资源，请参阅[[Scoreboard|关于记分板]])

==控制台指令==

按下 '''~ (tilde)''' 或 '''F8''' 打开控制台输入命令，如果指令有参数请加上必要的参数，最后按下回车。

;'''maps''' : 这将显示服务器上全部可用的地图列表。

;'''nick [nickname]''' :这会更改你的昵称但是在游戏中无论什么参数都是无效的。

;'''msg [nickname] [message]''' 或 '''pm [nickname] [message]''' :发送一条私人消息到 [nickname] 指定的人那里，只有你和指定人能看到这条消息。'''msg''' 和 '''pm''' 功能是一样的。

;'''quit''' 或 '''exit''' :这将退出服务器返回到桌面，与执行主菜单上的 '''Quit''' 按钮功能是一样的。

;'''ver''' :这将显示软件的版本号和版权信息。

;'''sver''' :这将显示你连接到服务器的版本号。

;'''time''' :这将显示当前的时间。

;'''disconnect''' :这将断开你与服务器的连接返回到主菜单。

;'''say [text]''' :在控制台打开的时候使用这个指令可以与服务器中的人交谈。

;'''ignore [nickname]''' :这将屏蔽 '''[nickname]''' 指定玩家的消息，如果想取消请重复输入同样的指令.
{{ZH-CN/提示|你也可以在聊天输入框中使用这些指令只要在指令前加 / (正斜杠)。}}

可以在控制台中键入 '''help''' 查看全部的控制台指令列表。当前地图也可能有额外的命令可以通过键入 '''commands''' 来查看.

更多指令相关的信息请看: [[Client Commands|客户端指令]]

==错误代码的含义==
=== 下载错误 ===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!错误代码
!scope="col" class="unsortable" | 含义
|-
|0
|UNKNOWN_ERROR
|-
|1
|INVALID_FILE_DESCRIPTORS
|-
|2
|INVALID_MAX_FILE_DESCRIPTOR
|-
|3
|INVALID_SELECT_RETURN
|-
|4
|INVALID_INITIAL_MULTI_PERFORM
|-
|5
|INVALID_MULTI_PERFORM_CODE
|-
|6
|INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS
|-
|7
|UNEXPECTED_CURL_MESSAGE
|-
|8
|UNABLE_TO_CONNECT
|-
|9
|UNABLE_TO_DOWNLOAD_FILE
|-
|10
|FAILED_TO_INITIALIZE_DOWNLOAD
|}

===致命错误===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!错误代码
!scope="col" class="unsortable" | 含义
|-
|1
|在游戏事件中没有本地玩家的模型
|-
|2
|在游戏事件中没有本地玩家
|-
|3
|服务端下载被禁用
|-
|4
|在玩家列表数据包中没有本地玩家模型
|-
|5
|在玩家列表数据包中没有本地玩家
|-
|6
|在实体数据添加包中有无效的自定义数据包长度
|-
|7
|在实体数据添加包中有无效的比特流数据
|-
|8
|系统实体在实体添加数据包
|-
|9
|在实体数据添加包中创建物体失败
|-
|10
|在实体数据添加包中创建拾取点失败
|-
|11
|在实体数据添加包中创建车辆失败
|-
|12
|在实体数据添加包中有无效的团队名长度
|-
|13
|在lua事件数据包中有无效的lua事件名字长度
|-
|14
|在资源启动数据包中有无效的资源名字长度
|}

==='不能进入交通工具'相关错误===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!错误代码
!scope="col" class="unsortable" | 含义
|-
|1
|由脚本取消
|-
|2
|由脚本取消（被抢）
|-
|3
|当前载具占用者正在进入/离开载具
|-
|4
|不可用的座位
|-
|5
|距离载具不够近
|-
|6
|已经在一辆载具中
|-
|7
|正在进入/离开载具
|-
|8
|不可用的载具（拖挂车厢）
|}

==如何在 Linux 操作系统上玩 MTA ?==
如果你是那些使用 Linux 操作系统，并且想在 Linux 上运行客户端的人请阅读[[Client_on_Linux_Manual| Linux 客户端手册]]

[[en:Client Manual]]

[[Category:Translated/Support]]

[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

Building MTASA Server on GNU Linux

2022-01-23T16:44:48Z

Turret001: replaced IRC with Discord and updated bug tracker link

{{Needs Checking|Confirm steps work.}}

== Installing and Running MTASA server on Linux ==
{{Note|This article is only for developers who changed the server code. If you are looking for the precompiled server (for normal server owners). Go to: [http://linux.mtasa.com/ linux.mtasa.com] and see [[Installing and Running MTASA Server on GNU_Linux]]}}


== Preparing your system ==

In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution.

Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from [http://nightly.mtasa.com/ here]. Use the net.so from {{Current Version|master}} if you are compiling from the trunk, or the net.so from {{Current Version|full}} if you are compiling the {{Current Version|full}} branch. Be sure the read the top of ''Server/version.h'' as it contains directions on how to compile the different build types.

=== Debian Linux ===

Includes derivative distributions such as Ubuntu.

You will need the necessary build tools, headers and libraries, which are distributed through the following Debian packages (e.g. Debian Lenny):

* '''build-essential:''' contains the necessary tools, headers and libraries to build applications
* '''automake:''' contains the automake tools
* '''libtool:''' contains the libtool software required to build libraries

* '''libreadline-gplv2-dev:''' contains the readline library (version 5)
* '''libncurses5-dev:''' contains software for controlling writing to the console screen
* '''libncursesw5-dev:''' contains support for wide characters

* '''default-libmysqlclient-dev:''' contains the MySQL library
* '''git:''' contains the git client used to check out our code repository
* '''unzip:''' contains archive unpacker
To install these packages through apt, use the apt-get install <package list> command as in the following example (execute as root):

apt-get install build-essential automake libtool
apt-get install libreadline-gplv2-dev libncurses5-dev libncursesw5-dev
apt-get install default-libmysqlclient-dev git unzip

Note: On Debian 8 systems please use this: '''apt-get install build-essential automake libtool libreadline-gplv2-dev libncurses5-dev libncursesw5-dev libmysqlclient-dev git unzip'''

=== Gentoo Linux ===
You will need the necessary build tools, headers and libraries. Because Gentoo’s portage system is designed to compile any packages on your own system, the necessary build tools will have already been installed. This only leaves you to install the necessary libraries:


* '''git:''' contains the git client used to check out our code repository
To compile and install these packages through ''emerge'', use the '''emerge -v <package list>''' command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge.

Example:

emerge -v git sqlite
USE=“net-misc/curl ssl” emerge -v curl

=== Fedora ===

You will need these packages to be able to successfully compile a MTA server on Fedora:
* '''glibc-devel:'''

* '''readline-devel:''' contains the readline library

* '''git:''' contains the git client to check out the source code
To install these packages through yum, use the yum install <package list> command as in the following example (execute as root):

yum install glibc-devel readline-devel git

== General instructions for {{Current Version|master}} ==

'''Downloading the source.'''

First, you need to download the source. Either clone as shown below or [https://github.com/multitheftauto/mtasa-blue/archive/master.zip download a zip snapshot]

git clone <nowiki>https</nowiki>://github.com/multitheftauto/mtasa-blue.git mtasa-blue
cd mtasa-blue

Then compile it thus:

./linux-build.sh

Then copy the configuration files, network module and resources into '''Bin/server''' by running this command:

./linux-install-data.sh

And the resources and stuff should be downloaded and stuff. As well as the net_d.dll file.

=== '''Troubleshooting''' ===

If you’re getting any unexpected errors while compiling, please check our [https://github.com/multitheftauto/mtasa-blue/issues Bug tracker] or our [https://discord.com/invite/mtasa Discord server].

[[ru:Building MTASA Server on GNU Linux]]
[[Category: Development]]

RU/Up-to-date

2022-01-23T16:42:57Z

Turret001: replaced IRC with Discord

Если вы испытываете проблемы при запуске Multi Theft Auto:San Andreas, вам обязательно следует убедиться, что все обновлено.

== MTA:San Andreas ==
Multi Theft Auto сама по себе должна быть обновлена до последней версии либо посредством внутриигрового обновления, либо посредством закачки новой версии с сайта [http://www.mtasa.com Multi Theft Auto].

== Драйвера ==
Всегда приветствуется иметь новейшие драйвера для вашего оборудования, это положительным образом сказывается на стабильности и/или быстродействии и по отношению к оборудованию, и к программному обеспечению.

=== Драйвера видеокарты ===

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Производитель
!Ссылка
|-
|AMD / ATI
|http://support.amd.com/us/Pages/AMDSupportHub.aspx
|-
|Intel
|http://downloadcenter.intel.com/Default.aspx?lang=rus
|-
|nVidia
|http://www.nvidia.ru/Download/index.aspx?lang=ru
|-
|VIA (Chrome9)
|http://www.via.com.tw/en/support/drivers.jsp
|}

=== Чипсет ===
{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Производитель
!Ссылка
|-
|AMD / ATI
|http://support.amd.com/us/Pages/AMDSupportHub.aspx
|-
|Intel
|http://downloadcenter.intel.com/Default.aspx?lang=rus
|-
|nVidia
|http://www.nvidia.ru/Download/index.aspx?lang=ru
|-
|VIA
|http://www.via.com.tw/en/support/drivers.jsp
|}

=== Драйвера звуковой карты ===
{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Производитель
!Ссылка
|-
|Asus
|http://support.asus.com.tw/Default.aspx?SLanguage=ru-ru
|-
|Creative
|http://support.creative.com/Products/Products.aspx?catid=1
|-
|Realtek
|http://www.realtek.com/downloads/
|}

Если ваш производитель не указан выше, вам следует посетить сайт поддержки сборщика вашей системы или материнской платы. (Наиболее популярные указаны ниже)

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
|+ Производители материнских плат
|-
!Производитель
!Ссылка
|-
|Asrock
|http://www.asrock.com/support/download.ru.asp
|-
|Asus
|http://support.asus.com/ServiceHome.aspx?SLanguage=ru
|-
|Biostar
|http://www.biostar-russia.ru/app/ru/support/download.php
|-
|EVGA
|http://www.evga.com/support/download/default.aspx
|-
|Gigabyte
|http://www.gigabyte.us/support-downloads/support-downloads.aspx
|-
|Intel
|http://downloadcenter.intel.com/Default.aspx?lang=rus
|-
|MSI
|http://ru.msi.com/service/download/
|-
|Zotac
|http://www.zotac.com/index.php?option=com_docman_2&view=docman&Itemid=218&lang=ru
|-
|}

== Операционная система ==
С помощью Windows Update удостоверьтесь, что ваша система обновлена.

== Дополнительное программное обеспечение ==
Дополнительное ПО для Multi Theft Auto.

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Имя
!Ссылка
|-
|Microsoft Visual C++ 2008 Redistributable
|[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=9b2da534-3e03-4391-8a4d-074b9f2bc1bf 32-бит (x86)] [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=bd2a6171-e2d6-4230-b809-9a8d7548c1b6 64-бит (x64)]
|-
|Microsoft Visual C++ 2008 SP1 Redistributable
|[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=a5c84275-3b97-4ab7-a40d-3802b2af5fc2 32-бит (x86)] [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=ba9257ca-337f-4b40-8c14-157cfdffee4e 64-бит (x64)]
|-
|DirectX 9.0c Веб-установщик/Обновитель
|[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 32-бит (x86)/64-бит (x64)]
|}

== Также смотрите ==
* [[RU/Known Issues - FAQ]]
* [[Discord]]
* [http://bugs.mtasa.com Multi Theft Auto Багтрекер]

[[en:Up-to-date]]

[[Category:Поддержка]]

Up-to-date

2022-01-23T16:42:04Z

Turret001: /* See also */ replaced IRC with Discord

If you have Multi Theft Auto:San Andreas issues you should always make sure that everything is up-to-date.

== MTA:San Andreas ==
Multi Theft Auto itself should be up-to-date with the latest version either by updating in game or by downloading the latest version from the [http://www.mtasa.com Multi Theft Auto] website.

== Drivers ==
It is always wise to install the latest drivers for your hardware, this improves stability and/or performance for both your hardware and software.

=== Graphics Drivers ===

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Manufacturer
!Link
|-
|AMD / ATI
|http://support.amd.com/us/Pages/AMDSupportHub.aspx
|-
|Intel
|http://downloadcenter.intel.com/default.aspx?lang=eng
|-
|nVidia
|http://www.nvidia.co.uk/Download/index.aspx?lang=en-uk
|-
|VIA (Chrome9)
|http://www.viaarena.com/Drivers.aspx
|}

=== Chipset ===
{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Manufacturer
!Link
|-
|AMD / ATI
|http://support.amd.com/us/Pages/AMDSupportHub.aspx
|-
|Intel
|http://downloadcenter.intel.com/default.aspx?lang=eng
|-
|nVidia
|http://www.nvidia.co.uk/Download/index.aspx?lang=en-uk
|-
|VIA
|http://www.viaarena.com/Drivers.aspx
|}

=== Audio Drivers ===
{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Manufacturer
!Link
|-
|Asus
|https://www.asus.com/support/download-center
|-
|Creative
|https://support.creative.com/Products/Products.aspx?catid=1
|-
|Realtek
|https://www.realtek.com/downloads/
|}

If your manufacturer is not listed above, you should check the support website from the manufacturer that assembled your system or your motherboard manufacturer. (Common listed below)

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
|+ Motherboard Manufacturers
|-
!Manufacturer
!Link
|-
|Asrock
|https://www.asrock.com/support/download.asp
|-
|Asus
|https://www.asus.com/support/download-center
|-
|Biostar
|https://www.biostar.com.tw/app/en/support/download.php
|-
|EVGA
|https://www.evga.com/support/download/default.aspx
|-
|Gigabyte
|https://www.gigabyte.us/support-downloads/support-downloads.aspx
|-
|Intel
|https://downloadcenter.intel.com/default.aspx?lang=eng
|-
|MSI
|https://msi.com/service/download/
|-
|Zotac
|https://www.zotac.com/index.php?option=com_docman&Itemid=100032
|-
|}

== Operating System ==
Make sure your system is up to date with Windows Update.

== Additional Software ==
Additional software required for Multi Theft Auto.

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
!Name
!Link
|-
|Microsoft Visual C++ 2008 Redistributable
|[http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29 32bits] [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=15336 64bits]
|-
|Microsoft Visual C++ 2008 SP1 Redistributable
|[http://www.microsoft.com/download/en/details.aspx?id=5582&WT 32bits] [https://www.microsoft.com/en-us/download/details.aspx?id=26368 64bits]
|-
|DirectX 9.0c Web Installer/Updater
|[http://www.microsoft.com/download/en/details.aspx?id=35 32bits/64bits]
|}

== See also ==
* [[Known Issues - FAQ]]
* [[Discord]]
* [http://bugs.mtasa.com Multi Theft Auto Bugtracker]

[[ru:Up-to-date]]

[[Category:Support]]

PT-BR/Compilando o MTASA

2022-01-23T16:41:18Z

Turret001: replaced IRC with Discord

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

= Informações Adicionais =
Se precisar de mais alguma coisa, tente entrar no [http://bugs.mtasa.com/ bug tracker] ou em nosso [https://discord.com/invite/mtasa Discord]

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

Page d'accueil

2022-01-23T16:40:44Z

Turret001: added Discord

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;">
[[File:Mtalogo.png|left|100px|link=http://wiki.multitheftauto.com/]]'''Bienvenue sur le wiki de ''Multi Theft Auto'' !''' Sur ce wiki, vous trouverez toutes les informations concernant ''Multi Theft Auto'', appelé aussi ''MTA'', un mod du jeu ''Grand Theft Auto: San Andreas'' permettant de jouer en ligne.

Vous voulez participer à ce projet ? Tant mieux ! Il y a [[How you can help|différents moyens de nous aider]] : vous pouvez, en tant que joueur ou programmeur, créer une ''map'', un mode de jeu, des articles sur des fonctions, des exemples, des tutoriels pour aider d'autres joueurs ou bien juste jouer à ''MTA'' et nous rapporter les [[FR/Problemes_connus|bugs trouvés]].

Si vous avez une question ou un problème lié à la programmation, prenez contact avec nous sur notre [[IRC Channel|canal IRC]].
<br/><br/>[ Arrêtez de jouer tout seul ]
</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>
=== Jouer ===
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Télécharger ''Multi Theft Auto: San Andreas {{Current Version|full}}'']'''</div>
* [[Where to buy GTASA|Acheter ''Grand Theft Auto: San Andreas'']]
* [[FR/Manuel_Client|Manuel d'utilisation de ''Multi Theft Auto'']]<ref>Merci à [[User:DrawKiie|DrawKiie]] pour la traduction.</ref>

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}|Améliorations apportées par la version {{padleft:|5|{{Current Version|full}}}}]]
* [[FR/Problemes_connus|Problèmes connus]]<ref>Merci à [[User:Rouche|Rouche]] pour la traduction.</ref>
* [[FR/Migrer_de_MTARace_a_MTASA_1.0.x|Passer de ''MTA: Race'' à ''MTA: San Andreas {{padleft:|3|{{Current Version|full}}}}'']]<ref>Merci à [[User:Rouche|Rouche]] pour la traduction.</ref>
* [[FR/Manuel_Serveur|Manuel pour la configuration d'un serveur]]<ref>Merci à [[User:Rouche|Rouche]] pour la traduction.</ref>
* [[FR/A propos des Map|À propos des ''maps'']]<ref>Merci à [[User:Rouche|Rouche]] pour la traduction.</ref>

=== Éditer des ''maps'' ===
* [[Resource:Editor|Manuel d'utilisation de l'éditeur]]
* [[Resource:Editor/EDF|Editor Definition Format]]
* [[Resource:Editor/Plugins|Plug-ins]]
* [[Resource:Editor#FAQ|Foire Aux Questions]]
</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>
=== Bases de données ===
Cette section décrit toutes les capacités fournies par le LUA/MTA ou par les ressources.
* [[:Category:Resource|Catalogue des ressources]] - Vous devriez le lire pour réaliser un script approprié.
* [[Client side scripts|Les scripts clients]]
* [[Modules]]
</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>
=== Développer ''Multi Theft Auto'' ===
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[Compiling MTASA|Compiler ''MTA: San Andreas'' avec Windows]]
* [[Building_MTASA_Server_on_GNU_Linux|Compiler ''MTA: San Andreas'' avec GNU / Linux]]
* [[Coding guidelines|Directives de codage]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[Roadmap]]
* [http://bugs.mtasa.com/ Bugtracker]
* [[Branches]]
</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>

=== Participer au wiki ===
* Finir la documentation des [[:Category:Incomplete|fonctions incomplètes]].
* [[:Category:Needs_Example|Ajouter des exemples pour les fonctions et événements]].
* Relire et vérifier [[:Category:Needs Checking|les pages qui en ont besoin]].
* Écrire des tutoriels pour les débutants.
* Traduire les pages du wiki anglais vers celui-ci.
</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>

=== Communauté ===
* [http://forum.multitheftauto.com/ Forum officiel de ''Multi Theft Auto'']
* [https://discord.com/invite/mtasa Official MTA Discord server]
* Canal IRC : [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [http://community.mtasa.com/ MTA Community] - Partage et téléchargement de ressources.
* [http://twitter.com/#!/MTAQA/ Twitter] - [http://www.youtube.com/user/MTAQA Youtube] - [http://plus.google.com/102014133442331779727/ Google+] - [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>
=== Programmer ===
* [[FR/Introduction_Programmation|Introduction à la programmation]]
* [[FR/Ressources|Introduction aux ressources]]<ref>Merci à [[User:Myk3L|Myk3L]] pour la traduction.</ref>
* [[FR/Introduction_GUI|Introduction à l'interface utilisateur graphique]]<ref>Merci à [[User:FatalTerror|FatalTerror]] pour la traduction.</ref>
* [[FR/Debugage|Tutoriel : Le débugage]] - Comment trouver les erreurs dans son script
** [[FR/Ressource_Acces_Internet|Accès depuis le web]] - Comment créer un site à partir d'une ressource<ref>Merci à [[User:Myk3L|Myk3L]] pour la traduction.</ref>
** [[:Category:Resource|Catalogue des ressources]]
** [[FR/Meta.xml|Meta.xml]] - Derrière chaque ressource se trouve une meta pour la définir
** [[FR/ACL|ACL]] - Access Control List, pour définir les autorisations
* [[Créer un mode de jeu]]<ref>Merci à [[User:Rouche|Rouche]] pour la traduction.</ref>

==== Ressources du forum officiel ====
* [http://forum.mtasa.com/viewforum.php?f=91 Section Programmation du forum]
* [http://forum.mtasa.com/viewforum.php?f=148 Section Programmation - Sous-partie des tutoriels]
* [http://forum.mtasa.com/viewtopic.php?f=13&t=29363 Section Copies hors-ligne du wiki]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>

=== Aide générale pour le Lua ===
Des pages conçues pour améliorer votre compréhension du Lua :
* [http://www.lua.org/pil/index.html "Programming in Lua"] ;
** [http://www.lua.org/manual/5.1/#index Les fonctions en Lua] ;
* [http://lua-users.org/wiki/TutorialDirectory wiki Lua] ;
* [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Un guide général au Lua de Nixstaller].
</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>
=== Ressources principales ===
* [[Client Scripting Functions|Fonctions client]]
* [[FR/Client Scripting Events|Événements client]]<ref>Merci à [[User:Wartax|Wartax]] pour la traduction.</ref>
* [[Server Scripting Functions|Fonctions serveur]]
* [[FR/Server Scripting Events|Événements serveur]]<ref>Merci à [[User:Wartax|Wartax]] pour la traduction.</ref>
* [[Useful Functions|Fonctions utiles]]

* [[MTA Classes|MTA Classes]] - Les descriptions détaillées de tous les types personnalisés MTA
** [[Element|MTA Elements]] / [[Element tree]]
</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>

=== [[Id|Listes des numéros d'ID]] ===
* [[Animations|Animations]]
* [[FR/Skins_Personnages|Skins de personnages]]
* [[FR/Vetements_CJ|Vêtements pour CJ]]
* [[Garage|Garage IDs]]
* [[Interior IDs|Intérieurs IDs]]
* [[Material IDs|Matériel IDs]]
* [[Projectiles|Projectiles]]
* [[Radar Blips|Radar Blips]]
* [[Sounds|Sons]]
* [[Vehicle_IDs|ID des véhicules]]
* [[FR/Vehicule_Couleurs|Couleurs véhicules]]
* [[Vehicle_Upgrades|Tuning IDs]]
* [[Weapons|Armes]]
* [[Weather|Météo]]
</div>

<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/|left]]
'''''Multi Theft Auto'' est ''Open Source'''''.
<br/>Cela signifie que chacun peut contribuer à améliorer ''Multi Theft Auto'' !
</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>'''À propos de ''[[Multi Theft Auto]]'''''</li>
<li>[[Archive]]</li>
<li>[[Press Coverage|Médias]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Développeurs]</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|Téléchargement]]</li>
<li>[[MTA 0.5r2 Known Issues|Problèmes connus]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Statistiques du wiki'''</li>
<li>{{NUMBEROFARTICLES}} Articles</li>
<li>{{NUMBEROFPAGES}} Pages</li>
<li>{{NUMBEROFUSERS}} Utilisateurs enregistrés</li>
</ul>
</div>
|}

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div>
== Remerciements particuliers ==
<references />
</div>
|}

__NOTOC__
{{Languages list|fr}}

NL/Main Page

2022-01-23T16:39:35Z

Turret001: replaced IRC with Discord

__NOTOC__
[[File:Mtalogo.png|left|100px|link=http://wiki.multitheftauto.com/]]Welkom bij de Multi Theft Auto: San Andreas ontwikkelaars-wiki. Op deze wiki zul je een rijkdom aan informatie vinden, voor het maken van maps en gamemodes voor Multi Theft Auto.

Er zijn veel [[How you can help|dingen waar je ons bij kunt helpen]] zoals resources maken, maps, etc..

Wees zo vrij om ons te contacteren op het [[Discord|Discord]], met vragen over of problemen met scripten.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Beginnen====
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Download Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}| Veranderingen in {{padleft:|5|{{Current Version|full}}}}]]
* [[NL/Deathmatch_Client_Manual|Client Gebruiksaanwijzing]]
* [[NL/Deathmatch_Server_Manual|Server Gebruiksaanwijzing]]
* [[Known_Issues_-_FAQ|Bekende problemen]]
* [[Upgrading_from_MTA:Race|Upgraden van MTA:Race]]
* [[Map_manager|Map Manager]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
====Scripting====
* [[Scripting Introduction|Scripting introductie]]
* [[Introduction to Scripting the GUI|De GUI scripting introductie]]
* [http://robhol.net/guide/basics De basis van het scripten]
* [[Debugging|Debugging Tutorial]] - Hoe fouten te vinden in je script
* [[Resources|Resources introductie]]
** [[Resource Web Access]]
** [[:Category:Resource|Resource Catalogus]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Gamemodes maken]]
* [[Useful_Functions|Handige Functies]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
====Databases====

Deze sectie benadrukt alle LUA mogelijkheden die MTA en resources geven.
* [[:Category:Resource|Resource Catalogus]] - Je moet deze leren om goede scripts te maken
* [[Client side scripts]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
====Algemene Lua Hulp====
Pagina's ontworpen om je te helpen LUA te begrijpen
*[http://www.lua.org/pil/index.html "Programming in Lua" Gebruiksaanwijzing (Engels)]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki (Engels)]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Een algemene gids voor Lua van Nixstaller (Engels)]
</div>

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

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
====Map Editor====
*[[Resource:Editor|Handleiding]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Veel gestelde vragen]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
====Multi Theft Auto ontwikkelen====
* [[Compiling_MTASA|MTASA compileren op Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA compileren op Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA compileren op GNU/Linux]]
* [[Coding guidelines|Voorschriften voor programmeren]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[Roadmap]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
====Referentie====
* [[Client Scripting Functions|Client-side functies]]
* [[Client Scripting Events|Client-side events]]
* [[Server Scripting Functions|Server-side functies]]
* [[Server Scripting Events|Server-side events]]
* [[MTA Classes]] - Uitgebreide beschrijving van alle types
** [[Element|MTA Elements]] / [[Element tree]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
====Modules====
* [[Modules|Overzicht]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
====ID Lijsten====
*[[Animations|Animatie's]]
*[[Character Skins|Personage skins]] ([[All Skins Page|Alle skins weergeven]])
*[[CJ_Clothes|CJ kleding stijl]]
*[[Garage|Garage IDs]]
*[[Interior IDs|Interieur IDs]]
*[[Projectiles|Projectielen]]
*[[Radar Blips|Radar icoontjes]]
*[[Sounds|Geluiden]]
*[[Vehicle IDs|Voertuig IDs]]
*[[Vehicle Colors|Voertuig kleuren]]
*[[Vehicle Upgrades|Voertuig upgrades]]
*[[Weapons|Wapens]]
*[[Weather|Weer]]
</div>

|-
| colspan="2" |
|}
{{Languages list|nl}}

HU/Places To Chat

2022-01-23T16:35:04Z

Turret001: added Discord and updated IRC part. Please make sure the content matches the ones in English version of this page.

Nagyon sok módon tudsz chatelni más MTA játékosokkal. Ha játéktechnikákat akarsz megbeszélni, alapítani egy új klánt, vagy akár csak közvetlenül bármiről szeretnél csevegni, mindig lesz megfelelő hely rá.
Természetesen a játékon belül is tudsz beszélgetni társaiddal - de vannak helyek, ahol az egész MTA közösség összegyűlik.

== Fórumok ==
Az első hely, ahova érdemes felmenned, a hivatalos MTA fórum. Ezt megtalálhatod a[http://forum.mtasa.com http://forum.mtasa.com] oldalon. Szabadon olvashatod a fórumot, de regisztrálhatsz, és beszálhatsz a beszélgetésekbe, akár saját témákat is létrehozhatsz! Ez természetesen ingyenes, és az oldal tetején meg is teheted.

Minden topiknak van egy fő fóruma, ami összegyűjti az adott témához tartozó lapokat. Mindig figyelj, hogy a megfelelő résznél hozd létre a témádat! Azonban mielőtt bármit is csinálnál, mindenképpen olvasd el a [http://forum.mtasa.com/viewtopic.php?f=15&t=15740#p219286 szabályzatot].

== Discord ==
For an instant response to whatever you have to say, the best place is Discord. Compared to IRC, it offers a built-in chat history buffer, so even if you are offline, you can still catch up with what happened in the channels then. IRC also offers that, but only through an IRC Bouncer that you either need to pay for, or have someone host it for you.
It also has a modern look and features such as URL embedding (regular websites, but also pictures and videos), handy syntax colouring for pasted code snippets, emojis (also custom ones), chat messages reactions, [http://store.steampowered.com/about/ Steam] integration, and more.
We currently have some channels created, including:
#general - for general MTA and offtopic chats
#scripting-help - for Lua scripting-related queries
#help-support - for any problems related to MTA:SA client or server
#announcements - for all important messages from us
...and a lot more, including non-English sections!
The invitation link is [https://discord.com/invite/mtasa here]. All you need is a [https://discordapp.com/ Discord] account. You can use Discord from your web browser or you can download the client.
You can find the official forum post [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ here].

=== Scripting Help ===
There is a Discord channel available for help with MTA Scripting. You can find it under the MTA:SA Help category on our Discord.

==== How To Get Help ====
* Try to find your answer on the [[Main Page]], especially on its upper part
* Ask your question once and only repeat it after a reasonable amount of time, given the channel is busy (like 10 minutes). NOT after 10 seconds.
* Your question should at least contain:
** What are you trying to do.
** What have you done so far.
** What exactly doesn't work/is your problem. What errors are occurring.
** Maybe a code snippet with an explanation using [https://pastebin.mtasa.com pastebin.mtasa.com] or [https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline- code blocks] on Discord. (''code snippet means the relevant parts, NOT the whole script'')

== IRC (Internet Relay Chat) ==
Even though it's not being used by many people (compared to old times) these days, IRC is a chat network similar to any other chat rooms you find on the internet. The best Windows client for IRC is mIRC, which you can find [http://www.mirc.com here]. Download, install, configure the settings and you are ready to go.
The connection information you need is:<br>
'''Server -''' [irc://irc.gtanet.com/mta irc.gtanet.com/mta]<br>
'''Port -''' 6667<br>
Once you have connected and received the MOTD (message of the day), to join the MTA discussion, type /join #mta
This takes you into the MTA ''channel'', which you would know as a room in other chat networks.
Make sure you read the mIRC help files if you are unsure.
For more specific help for the server commands, go to the window you first had when connecting, and type /helpop for a list of help categories.

== Más formák ==
Nem csak az MTA közösségen keresztül veheted fel a kapcsolatot más játékosokkal. Nagyon sok más fórum van, például a [http://www.gtaforums.com GTAForums], ami a leglátogatottabb nem hivatalos GTA fórum. Természetesen itt nem csak az MTA - ról van szó, hanem általánosságban az egész online játékról.

Kérlek, ha úgy érzed, valami hiányzik erről a lapról, regisztrálj, és írd le a hiányzó részt!

[[en:Places To Chat]]
[[uk:Places To Chat]]
[[es:Places_To_Chat_ES]]
[[ru:Places To Chat]]

[[Category:Translated/Support]]

PL/Access Control List

2022-01-03T01:18:19Z

Turret001: replaced http links with https

MTA zawiera pełną listę kontroli dostępu (ACL), która pozwala na zabezpieczenie i ograniczenie dostępu do serwera, jego funkcji i zasobów na wiele różnych sposobów.

Kluczową koncepcją ACL w MTA (i ogólnie list ACL) jest to, że nadajesz określonemu obiektowi zestaw praw. W przypadku MTA obiekty to jedna z dwóch rzeczy - zasoby lub użytkownicy. W MTA dostępnych jest wiele praw - dotyczą one głównie funkcji skryptowych po stronie serwera.

Zasadniczo oznacza to, że lista ACL pozwala dokładnie wybrać funkcje, które może wykonywać zasób lub użytkownik. Może to być oczywiście nieocenione - na przykład uniemożliwianie wszystkim graczom na serwerze możliwości blokowania się nawzajem lub uniemożliwienie tym samym nowym, nieprzetestowanym zasobom.

Oczywiście „z wielką mocą wiąże się wielka odpowiedzialność” i bardzo łatwo jest całkowicie zniszczyć zasoby - na przykład wyłączenie [[spawnPlayer]] dla wszystkich zasobów byłoby złą rzeczą. Aczkolwiek są sytuacje, w których możesz to zrobić - jeśli chcesz na przykład zmusić wszystkie swoje zasoby do korzystania z zasobu menedżera odradzania, ale nawet To jest nieco drakońskie.

==Zrozumienie ACL==
Lista ACL ma dwa główne składniki: grupy i listy ACL. Pojawiają się jako sekcje '''<group name = "">''' i '''<acl name = "" />'''. Ich celem jest:
<br \>
'''1.''' Przyznanie użytkownikom uprawnień do kontrolowania serwera i używania poleceń dotyczących zasobów. Przykłady:''<br \>
*Zezwalanie tylko administratorom na używanie funkcji giveweapon zasobu Freeroam
*Zezwalanie wszystkim użytkownikom na uruchamianie zasobu
'''2.''' Przyznaj zasobom uprawnienia do korzystania z funkcji skryptów i funkcji innych zasobów. Przykłady:<br \>
*Zezwalanie zasobowi na używanie funkcji restartResource
*Zezwalanie zasobowi na użycie wywołania (call) w celu użycia funkcji wyeksportowanych z innego skryptu

===Domyślne grupy===
MTA dostarcza do listy ACL domyślne grupy z rosnącymi uprawnieniami. Te grupy to:
*'''Everyone'''
*'''Moderator'''
*'''SuperModerator'''
*'''Admin'''
*'''Console''' - Kontroluje uprawnienia osób, które używają konsoli poprzez '''<object name = "user.Console" />'''
*'''RPC''' - Zdalne wywołanie procedury. W szczególności przyznaje dostęp tylko do [[callRemote]] i wyłącza polecenia zasobów domyślnych. Sprawdź funkcję, aby uzyskać szczegółowe informacje.
<br \>

Aby dokładniej wyjaśnić, użyję grupy 'Everyone' jako przykładu. Domyślnie wygląda to tak:
<syntaxhighlight lang="xml">
<group name="Everyone">
<acl name="Default" />
<object name="user.*" />
<object name="resource.*" />
</group>
</syntaxhighlight>

<br \>
Najpierw zauważysz nazwę ACL wewnątrz grupy. Określa ona, jakie uprawnienia ma dana grupa. Użytkownicy i zasoby w tej grupie będą mieć uprawnienia określone na liście nazw ACL „Default”.
''Uwaga: Zauważysz, że ta grupa jest wyjątkowa, ponieważ obejmuje każdego użytkownika i każdy zasób za pomocą '''symbolu wieloznacznego (*)''', co oznacza każdy element w danym podtypie.''

Teraz przewiń listę ACL dalej w dół, a zobaczysz listę '''<acl name = "Default" />'''.
Uwaga: Drastycznie przyciąłem tę listę ze względu na jej długość.

<syntaxhighlight lang="xml">
<acl name="Default">
<right name="command.start" access="false" />
<right name="command.stop" access="false" />
<right name="command.stopall" access="false" />
...
<right name="function.executeCommandHandler" access="false" />
<right name="function.setPlayerMuted" access="false" />
<right name="function.restartResource" access="false" />
...
<right name="general.adminpanel" access="false" />
<right name="general.tab_players" access="false" />
<right name="general.tab_resources" access="false" />
...
<right name="command.freeze" access="false" />
<right name="command.shout" access="false" />
<right name="command.spectate" access="false" />
...
</acl>
</syntaxhighlight>
<br \>
*'''Functions (Funkcje)''' są domyślnymi funkcjami skryptowymi MTA. Na przykład, jeśli zasób wymagałby użycia restartResource i znajdował się tylko w grupie „Everyone” (z listą „Default”), odmówiono by mu dostępu do restartResource i nie działałby poprawnie.
*'''Commands (Komendy)''' są tworzone, gdy zasób używa funkcji [[addCommandHandler]]. Przykładem może być wpisanie '''/createvehicle [pojazd]''' w oknie czatu dla zasobu freeroam. Określa, czy użytkownicy w grupie używającej tej listy ACL mogą używać tej komendy.
''Uwaga: polecenia nie mają wpływu na zasoby w grupie. Komendy dotyczą tylko użytkowników.''
*'''General (Ogólne)''' to niestandardowa grupa nazw utworzona przez zasób administracyjny, ale działa na tych samych zasadach. Skrypt współpracuje z nimi za pomocą [[hasObjectPermissionTo]]''

Zauważysz, że niektóre grupy, takie jak admin, mają wiele sekcji '''<acl name = "" />'''. Przykładem jest grupa administracyjna (Admin):
<syntaxhighlight lang="xml">
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="resource.admin" />
<object name="resource.webadmin" />
<object name="user.Random" />
</group>
</syntaxhighlight>

W ten sposób uzyskujesz wszystkie permisje zdefioniowane w każdej sekcji '''<acl name="" />''' w kolejności umieszczenia na liście. Na przykład grupa administratorów (Admin) sprawdza czy wszystkie uprawnienia są nadane członkom grupy Administratorzy (Admin) korzystając ze wszystkich list. W przypadku konfliktów wygrywa najniższy wpis. Załóżmy na przykład, że te 2 listy ACL znajdują się w grupie w następującej kolejności:

'''1.''' '''<acl name="Default">''' ustawia <right name="general.ModifyOtherObjects" access="false" /> <br/>
'''2.''' '''<acl name="Admin">''' ustawia <right name="general.ModifyOtherObjects" access="true" /> <br/>
'''3.''' Dla wszystkich użytkowników i zasobów w grupie administratorskiej: <right name="general.ModifyOtherObjects" access="true" /><br/>

<br/>
=== Grupy zasobów i listy ACL ===
Zauważysz, że istnieją jeszcze inne wbudowane grupy. Zostały one zdefiniowane przez zasoby dostarczone z MTA. Jeśli zasób chce wyznaczyć określone prawa ACL, które nie są dostarczane przez domyślne grupy, może utworzyć własną nazwę ACL i grupę, która będzie z niej korzystać. Jako przykład pokażę grupę AMX. AMX jest przeznaczony do emulacji skryptów SA-MP i potrzebuje określonego zestawu uprawnień, który nie pasuje dobrze do grup domyślnych. Jest to pokazane poniżej:

<syntaxhighlight lang="xml">
<group name="AMX">
<acl name="AMX" />
<object name="resource.amx" />
</group>

<acl name="AMX">
<right name="general.ModifyOtherObjects" access="true" />
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="general.adminpanel" access="false" />
...
<right name="command.kick" access="false" />
<right name="command.freeze" access="false" />
<right name="command.mute" access="false" />
...
</acl>
</syntaxhighlight>

=== Prawa dostępu zasobów do innych zasobów ===
Aby zezwolić na dostęp do dowolnego innego zasobu, musisz zezwolić na to w pliku ACL. Reguła '''<code>general.ModifyOtherObjects</code>''' przyznaje pełny dostęp do dowolnego zasobu na serwerze. Zobacz przykład w ostatniej sekcji, jak powinien on wyglądać.

{{New feature/item|3.0156|1.5.5|14166|
Jeśli nie chcesz nadawać zasobowi pełnego dostępu do każdego zasobu na serwerze, możesz dołączyć nazwę zasobu poprzedzoną kropką (.) do reguły '''<code>general.ModifyOtherObjects</code>''':

<syntaxhighlight lang="xml">
<acl name="Custom">
<right name="general.ModifyOtherObjects.resourceName" access="true" />
<right name="general.ModifyOtherObjects.admin" access="true" />
<right name="general.ModifyOtherObjects.runcode" access="true" />
<right name="general.ModifyOtherObjects.mapmanager" access="true" />
</acl>
</syntaxhighlight>

Powyższe definicje ACL przyznają każdemu zasobowi z listą ACL "Custom" dostęp do zasobów "resourceName", "admin", "runcode" i "mapmanager”.
}}

==Modyfikowanie listy ACL==
Istnieją trzy sposoby modyfikowania listy ACL - sposób, w jaki to robisz, zależy od tego, kim jesteś.

===Interfejs HTTP===
Możesz użyć interfejsu HTTP [[Resource/webadmin|webadmin]], aby zmodyfikować ACL w swojej przeglądarce internetowej. Jest to zdecydowanie najłatwiejszy sposób. Po prostu upewnij się, że zasób ''webadmin'' jest uruchomiony na twoim serwerze i przejdź na stronę ''<nowiki>http://ipSerwera:portHTTP/</nowiki>''. Następnie możesz użyć dwóch sekcji - list ACL i grup. Listy ACL umożliwiają tworzenie list kontroli dostępu - list praw. Grupy umożliwiają grupowanie kolekcji użytkowników i przypisywanie im list ACL. Na przykład sekcja ACL umożliwia określenie, że grupa ACL - Admin - ma dostęp do polecenia konsoli ''start''. Możesz przejść do sekcji Grupy i utworzyć ''grupę'' administracyjną, która ma dostęp do administracyjnej listy ''acl''. Następnie możesz dodać użytkowników do ''grupy administratorskiej''.

===Plik XML===
Możesz również ręcznie zmodyfikować plik ACL.xml. Ma to dość prostą składnię, ale czasami może być nieco zagmatwana. Jeśli zrobisz to, gdy serwer jest uruchomiony, nie zapomnij użyć funkcji [[aclReload]] w konsoli serwerowej ("start runcode", "run aclReload ()"), aby nowa lista ACL została załadowana lub w inny sposób zatrzymaj serwer przed zmodyfikowaniem listy ACL. Zapobiega to również przypadkowemu nadpisaniu zmian przez serwer.

===Funkcje skryptów===
Do modyfikowania listy ACL można również użyć wielu funkcji skryptowych ACL. Oczywiście możesz (i naprawdę powinieneś!) ograniczyć dostęp do funkcji ACL za pomocą tej listy. Zauważ, że '''zasób Admin''', który jest dostarczany z MTA, może być używany do zarządzania listą ACL z karty zasobów. Aby korzystać z panelu administracyjnego, musisz być skonfigurowany jako administrator.
<br/>
[https://wiki.multitheftauto.com/wiki/Admin Kliknij tutaj, aby uzyskać instrukcje konfiguracji administratora].

==Ważne informacje==
Jeżeli wyczyści się całego ACL'a i nie wpisze się żadnych permisji to <b>każdy zasób/gracz ma permisje do wszystkiego</b>.<br/>
Nawet jeśli gracz nie jest zalogowany to może przeładowywać zasoby bez najmniejszego problemu,<br/>
a zasoby mogą bez żadnych przeszkód wyrzucać, banować graczy lub zmieniać ustawienia serwerowe.

==Zobacz także==
{{ACL functions}}

[[Category:Translated/Scripting Concepts]]
[[Category:Tutorials]]

Server mtaserver.conf

2022-01-03T01:17:22Z

Turret001: replaced http links with https

This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''.

====servername====
:''<servername>Default MTA Server</servername>''
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.

====owner_email_address====
:''<owner_email_address></owner_email_address>''
:This parameter specifies the contact email addresses for the owner(s) of this server.
:The email addresses will not be publicly available, and only used by MTA administrators to contact the server owner.
:Note: Missing or incorrect owner_email_address can affect visibility in the master server list.
:Values: Comma separated list of email addresses

====serverip====
:''<serverip>auto</serverip>
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING''' - it is generally only needed for complex network topologies and should be left at the default value otherwise.
: This parameter specifies the public IP address that the server will announce to the MTA servers, for the purposes of registering itself in the master server list and receiving some internal status updates. Usually, setting this parameter is only useful for some specialized scenarios, like servers that can be reached by multiple public addresses, or when a firewall is used for controlling incoming connections. If set to auto, the public IP address the requests originate from will be used as the server IP for communicating with MTA servers, which works fine in most cases.
:Values: auto or x.x.x.x ; default value: auto
:SERVERIP SHOULD BE LEFT SET TO auto UNLESS YOU ARE SURE OF WHAT YOU ARE DOING
:WARNING: SETTING serverip AND THEN ASKING FOR SUPPORT CAN CAUSE DEATH OR INJURY

====serverport====
:''<serverport>22003</serverport>
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;
:default value: 22003. It is a required parameter.

====maxplayers====
:''<maxplayers>32</maxplayers>
:This parameter specifies the number of maximum player slots available on the server;
:default value: 32. It is a required parameter.

====httpserver====

:''<httpserver>1</httpserver>
:This parameter specifies whether the built-in http server will be used.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpport====
:''<httpport>22005</httpport>
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.
:Available range: 1 to 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:This parameter limits the number http connections that an IP can initiate over a short period of time.
:Available range: 1 to 100. default value: 20

====http_dos_exclude====
:''<http_dos_exclude></http_dos_exclude>
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.
:e.g. 88.11.22.33,101.2.3.4

====allow_gta3_img_mods====
:''<allow_gta3_img_mods>none</allow_gta3_img_mods>
:By default, the server will block the use of locally customized gta3.img player skins
:This setting can be used to allow such mods. Not recommended for competitive servers.
:Values: none, peds ; default value: none

====client_file====
:''<nowiki></nowiki>
:By default, the server will block the use of customized GTA:SA data files.
:To allow specific client files, add one or more of the above lines.
:More information: [[Anti-cheat_guide#.3Cclient_file_name.3D.22data.2Fcarmods.dat.22_verify.3D.220.22.2F.3E|Anti-cheat guide]]

====disableac====
:''<disableac></disableac>
:Comma separated list of disabled anti-cheats.
:e.g. To disable anti-cheat #2 and #3, use: 2,3
:More information: [[Anti-cheat_guide#.3Cdisableac.3E.3C.2Fdisableac.3E|Anti-cheat guide]]

====enablesd====
:''<enablesd>31,32</enablesd>
:Comma separated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications.
:Competitive servers may wish to enable certain special detections, but most servers should leave this setting on its default.
:Values: special detection (SD) codes ; default value: 31,32 (e.g. enables special detections #31 and #32)
:More information: [[Anti-cheat_guide#.3Cenablesd.3E.3C.2Fenablesd.3E|Anti-cheat guide]]

====minclientversion====
:''<minclientversion></minclientversion>
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[https://nightly.mtasa.com/ver highest available]].'''

====minclientversion_auto_update====
:''<minclientversion_auto_update>1</minclientversion_auto_update>
:This parameter specifies if/when the <minclientversion> setting is automatically updated.
:Keeping <minclientversion> updated can help reduce cheating.
:Note: The instant setting (2) is only recommended for competitive servers.
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[https://nightly.mtasa.com/ver highest available]].'''

====ase====
:''<ase>1</ase>
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the in-game server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:This parameter allows you to disable LAN broadcasting.

====password====
:''<password></password>
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:This parameter reduces the server's bandwidth usage by using various optimizations.
:Values: none, medium or maximum ; default value: medium
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====unoccupied_vehicle_syncer_distance====

:''<unoccupied_vehicle_syncer_distance>130</unoccupied_vehicle_syncer_distance>
:This parameter determines the distance limit for remote synced unoccupied vehicles
:Available range: 50 - 400; default value: 130
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====ped_syncer_distance====

:''<ped_syncer_distance>100</ped_syncer_distance>
:This parameter determines the distance limit for remote synced peds
:Available range: 50 - 400; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:This parameter determines the time in milliseconds between player sync packets.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:This parameter determines the time in milliseconds between lightweight (player) sync packets.
:Available range: 200 - 4000; default value: 1500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:This parameter determines the time in milliseconds between camera sync packets.
:Available range: 200 - 400; default value: 500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>400</ped_sync_interval>
:This parameter determines the time in milliseconds between ped sync packets.
:Available range: 200 - 4000; default value: 400
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>400</unoccupied_vehicle_sync_interval>
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.
:Available range: 200 - 4000; default value: 400
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>1</bullet_sync>
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.
:Values: 0 - disabled , 1 - enabled ; default value: 1.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====vehext_percent====
:''<vehext_percent>0</vehext_percent>
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles.
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.
:Depending on the gamemode, an incorrect prediction may have a negative effect.
:Therefore this setting should be considered experimental.
:Available range: 0 to 100. Default - 0

====vehext_ping_limit====
:''<vehext_ping_limit>150</vehext_ping_limit>
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.
:Only relevant if <vehext_percent> is greater than zero.
:Available range: 50 to 500. Default - 150

====latency_reduction====
:''<latency_reduction>0</latency_reduction>
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).
:Due to the impact this may have on shot lag compensation, it should be considered experimental.
:Values: 0 - disabled , 1 - enabled ; default value: 0.
:Bugs caused by enabling latency_reduction: https://bugs.mtasa.com/view.php?id=8191 + https://bugs.mtasa.com/view.php?id=8226

====threadnet====

:''<threadnet>1</threadnet>
:This parameter specifies whether or not to run the network synchronization on another thread.
:Enabling will make the sync smoother, but may increase CPU usage slightly.
:Values: 0 - disabled , 1 - enabled ; default value: 1.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers.
:Keep a backup of this file in a safe place. Default value: server-id.keys
:More information about client private files: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.

====loadstringfile====
:''<nowiki></nowiki>
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.

====acl====
:''<acl>acl.xml</acl>
:This parameter specifies the location and name of the Access Control List settings file. If left
:blank, server will use acl.xml file, located in the same folder as this configuration file.

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Specifies the level of the html debug. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====filter_duplicate_log_lines====
:''<filter_duplicate_log_lines>1</filter_duplicate_log_lines>
:Specifies whether or not duplicate log lines should be filtered. Available values: 0 or 1, defaults to 1.

====fpslimit====
:''<fpslimit>36</fpslimit>
:Specifies the frame rate limit that will be applied to connecting clients.
:Available range: 25 to 100. Default: 36.
:When running the map editor locally (i.e. from the client), the default FPS limit is 50.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====voice====
:''<voice>0</voice>
:This parameter specifies whether or not to enable player voice chat in-game
:Values: 0 - disabled , 1 - enabled

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat
:Available range: 0 to 10. Default - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.

====backup_path====
:''<backup_path>backups</backup_path>
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups
:Available range: 0 to 30. Default - 3

====backup_copies====
:''<backup_copies>10</backup_copies>
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups
:Available range: 0 to 100. Default - 10

====compact_internal_databases====
:''<compact_internal_databases>1</compact_internal_databases>
:This parameter specifies when the internal sqlite databases should be defragmented.
:For more info see: https://www.sqlite.org/lang_vacuum.html
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1

====crash_dump_upload====
:''<crash_dump_upload>1</crash_dump_upload>
:This parameter specifies whether server crash dump files should be sent to MTA HQ.
:Values: 0 - Off, 1 - On. Default - 1

====fakelag====

:''<fakelag>0</fakelag>
:This parameter specifies whether the [[Command fakelag|fakelag and sfakelag]] commands are enabled
:Values: 0 - Off, 1 - On. Default - 0

====auth_serial_groups====
:''<auth_serial_groups>Admin</auth_serial_groups>
:This parameter lists the ACL groups that are protected by serial authorization.
:Login attempts to a protected account from a second serial are blocked until the serial is manually authorized via the authserial command.
:For more info see: https://mtasa.com/authserial
:Note: This is security critical feature and disabling auth_serial_groups can affect visibility in the master server list.
:Values: Comma separated list of ACL groups. Default - Admin

====auth_serial_http====
:''<auth_serial_http>1</auth_serial_http>
:This parameter specifies if the authorized serial login checks should also apply to the http interface.
:Protected account login attempts to the http interface will only succeed if the IP address matches one recently used by the account holder in-game.
:For more info see: https://mtasa.com/authserialhttp
:Note: This is security critical feature and disabling auth_serial_http can affect visibility in the master server list.
:Values: 0 - Off, 1 - Enabled. Default - 1

====auth_serial_http_ip_exceptions====
:''<auth_serial_http_ip_exceptions>127.0.0.1</auth_serial_http_ip_exceptions>
:This parameter specifies which IP addresses should always pass auth_serial_http checks.
:Values: Comma separated list of IP addresses

====database_credentials_protection====
:''<database_credentials_protection>1</database_credentials_protection>
:This parameter specifies if extra security measures are applied to resources which use [[dbConnect]] with MySQL.
:The extra measures are:
: - script files cannot be accessed with [[fileOpen]]
: - [[meta.xml]] is read-only
:'''NOTE:''' This only protects resources which use [[dbConnect]] with MySQL.
:Values: 0 - Off, 1 - Enabled. Default - 1

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.

====resource====
:''<resource src="admin" startup="1" protected="0" />
:''<resource src="defaultstats" startup="1" protected="0" />
:''<resource src="helpmanager" startup="1" protected="0" />
:''<resource src="joinquit" startup="1" protected="0" />
:''<resource src="mapcycler" startup="1" protected="0" />
:''<resource src="mapmanager" startup="1" protected="0" />
:''<resource src="parachute" startup="1" protected="0" />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true" />
:''<resource src="resourcemanager" startup="1" protected="1" />
:''<resource src="scoreboard" startup="1" protected="0" />
:''<resource src="spawnmanager" startup="1" protected="0" />
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0" />
:''<resource src="webadmin" startup="1" protected="0" />
:''<resource src="play" startup="1" protected="0" />
:''<resource src-"resources" startup"1" protected="0"
:Specifies persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.

:In addition, there are several flags which control how the server deals with each resource:

:* '''src''': the resource name. This is the only mandatory flag.
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.

==Deprecated settings==

The following settings have been deprecated in the production version of MTA:SA and no longer work.

====networkencryption====

:''<networkencryption>1</networkencryption>
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]

====autologin====

:''<autologin>0</autologin>
:Specifies whether or not players should automatically be logged in based on their IP adresses.
:Values: 0 - disabled , 1 - enabled ; default value: 0.

[[Category: Support]]
[[ru:Server mtaserver.conf]]

Lista de Controle de Acesso

2022-01-03T01:16:09Z

Turret001: replaced http links with https

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

...

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

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

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

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

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

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

RU/Access Control List

2022-01-03T01:12:48Z

Turret001: replaced http links with https

MTA включает в себя полноценный Access Control List (ACL, список контроля доступа), позволяющий вам обезопашивать и ограничивать доступ к серверу, его функциям и ресурсам любыми способами, которыми вы пожелаете.

Ключевая концепция MTA'шного ACL (и ACL в целом) - то, что вы даете определенному объекту набор прав. В случае с MTA, объекты - это одно из двух: либо ресурсы, либо пользователи. В MTA доступно множество ''прав'' - они в основном сфокусированы на скриптинговых функциях серверной стороны.

По сути это значит, что ACL позволяет вам выбирать к использованию каких в точности функций могут иметь доступ ресурс или игрок. Очевидно, что эта возможность бесценна - например, можно не допустить возможность рядовых игроков сервера банить друг друга, или не дать вашим новым непротестированным ресурсам это делать.

Конечно, ''большая сила влечет за собой большую ответственность'', и очень легко можно сломать ресурсы полностью - например, отключение [[spawnPlayer]] для всех ресурсов будет ОЧЕНЬ плохой идеей. В то же время, есть ситуации, когда вам может захотеться это сделать - если вы хотите принудить все свои ресурсы использовать ресурс spawn manager, например, но даже это несколько драконовские меры.

==Понимание ACL==
ACL состоит из двух важных компонентов: групп и ACL-списков. Они фигурируют как узлы '''<group name="">''' и '''<acl name="" />'''. Их назначение:<br \>
'''1.''' Предоставить пользователям полномочия контролировать сервер и пользоваться командами ресура. Примеры:''<br \>
*Позволить только админам использовать функцию giveweapon мода freeroam
*Позволить всем пользователям запускать ресурс
'''2.''' Предоставить ресурсам полномочия использовать функции скриптинга и функции других ресурсов. Примеры:<br \>
*Позволить ресурсу использовать функцию restartResource
*Позволить ресурсу использовать функцию call для использования экспортированных из другого скрипта функций

===Группы по умолчанию===
MTA предоставляет некоторые группы по умолчанию, в списке они по возрастанию полномочий. Эти группы:
*'''Everyone'''
*'''Moderator'''
*'''SuperModerator'''
*'''Admin'''
*'''Console''' - Эта контролирует полномочия людей, которые используют консоль, через '''<object name="user.Console" />'''
*'''RPC''' - Remote Procedure Call (Удаленный Вызов Процедуры). Конкретно эта предоставляет доступ только к [[callRemote]] и отключает команды ресурсов по умолчанию. Для подробностей смотрите саму функцию.
<br \>

Для дальнейших объяснений, я воспользуюсь группой Everyone в качестве образца. По умолчанию это выглядит так:
<syntaxhighlight lang="lua"> <group name="Everyone">
<acl name="Default" />
<object name="user.*" />
<object name="resource.*" />
</group>
</syntaxhighlight>
<br \>
Сначала вы заметите имя ACL-списка внутри группы. Он обозначает, какие у группы полномочия. Пользователи и ресурсы, принадлежные данной группе, будут иметь полномочия, указанные в acl-списке с названием "Default". ''Заметка: Вы увидите, что эта группа - особенная, в нее входит любой пользователь и ресурс, это благодаря использованию '''шаблона (*)''' на месте, где должно быть название пользователя или ресурса.''

Теперь прокрутите далее вниз ACL'а и вы увидите acl-список '''<acl name="Default" />'''. Заметьте, что я значительно обрезал данный список из-за его длины.

<syntaxhighlight lang="lua"> <acl name="Default">
<right name="command.start" access="false" />
<right name="command.stop" access="false" />
<right name="command.stopall" access="false" />
...и т.д. и т.д...
<right name="function.executeCommandHandler" access="false" />
<right name="function.setPlayerMuted" access="false" />
<right name="function.restartResource" access="false" />
...и т.д. и т.д...
<right name="general.adminpanel" access="false" />
<right name="general.tab_players" access="false" />
<right name="general.tab_resources" access="false" />
...и т.д. и т.д...
<right name="command.freeze" access="false" />
<right name="command.shout" access="false" />
<right name="command.spectate" access="false" />
...и т.д. и т.д...
</acl>
</syntaxhighlight>
<br \>
*'''Function'''-записи регулируют скриптинговые функции MTA. Например, если ресурсу понадобилось воспользоваться restartResource, а он лишь в группе 'Everyone' (с acl-списком 'Default'), ему будет отказано в доступе к restartResource и он откажется полноценно работать.
*'''Command'''-записи регулируют использование команд, которые создаются при использовании ресурсом [[addCommandHandler]]'ов. Примером использования команды служит ввод в чате '''/createvehicle [vehicle]''' при ресурсе freeroam. Данные записи контролируют, могут ли пользователи группы, использующей данный ACL-список, использовать эту команду. ''Заметка: команды не влияют на ресурсы внутри группы. Команды связаны только с пользователями.''
**''General - самостоятельно придуманная группа записей, созданная ресурсом admin, хотя она работает по схожим принципам. Скрипт работает с ними через использование [[hasObjectPermissionTo]]''

Вы заметите, что некоторые группы, такие как Admin, имеют несколько узлов '''<acl name="" />'''. Образцом далее служит группа Admin:
<syntaxhighlight lang="lua">
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="resource.admin" />
<object name="resource.webadmin" />
<object name="user.Ransom" />
</group>
</syntaxhighlight>

Это дает все полномочия, описанные в каждом из узлов '''<acl name="" />''', по порядку списка. Так что, например, группа Admin благодаря использованию всех ACL-списков удостоверяется, что администраторам даются все полномочия. Если получается слишком много конфликтов, приоритет отдается самой нижней записи. В образце выше:

'''1.''' '''<acl name="Default">''' устанавливает <right name="general.http" access="false" /> <br\>
'''2.''' '''<acl name="Admin">''' устанавливает <right name="general.ModifyOtherObjects" access="true" /> <br\>
'''3.''' Для всех пользователей и ресурсов в группе admin будет: <right name="general.ModifyOtherObjects" access="true" /><br\>
<br\>

=== Группы и ACL ресурсов ===
Вы заметите, что вместе с использованием MTA появляются и некоторые другие группы. Они определены ресурсами, которые идут вместе с MTA. Если ресурс хочет обозначить собственные ACL-права, не предоставляемые группами MTA по умолчанию, он может создать ACL со своими собственными названием и группой и использовать его. Я покажу это на примере AMX. AMX предназначен для эмуляции SA-MP скриптов, и ему нужен определенный набор полномочий, который, в том числе, не входит в рамки групп по умолчанию. Он покан ниже:

<syntaxhighlight lang="lua">
<group name="AMX">
<acl name="AMX" />
<object name="resource.amx" />
</group>

<acl name="AMX">
<right name="general.ModifyOtherObjects" access="true" />
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="general.adminpanel" access="false" />
...и т.д. и т.д...
<right name="command.kick" access="false" />
<right name="command.freeze" access="false" />
<right name="command.mute" access="false" />
...и т.д. и т.д...
</acl>
</syntaxhighlight>

==Изменение ACL==
Есть три способа изменения ACL - как это делать зависит от вас.

===HTTP-интерфейс===
Вы можете воспользоваться http-интерфейсом [[RU/Resource:Webadmin|webadmin]] для изменения ACL через ваш веб-браузере. Это наиболее легкий способ. Просто удостоверьтесь, что на сервере запущен ресурс ''webadmin'' и посетите ''<nowiki>http://IPсервера:Httpпорт/</nowiki>''. Затем вам будут доступны две секции - ACLs и Groups. ACLs позволяет вам создавать ваш Access Control List - список прав. Groups позволяет вам вместе группировать скопления пользователей и назначать им ACL-список. Например, секция ACLs позволяет вам указывать, что пользователи группы с ACL-списком Admin имеет доступ к консольной команде ''start''. Затем вы можете зайти в секцию Groups и создать ''группу'' Admin, имеющую доступ к вашему ''acl-списку'' Admin. Потом вы сможете добавлять в вашу ''группу'' Admin пользователей.

===XML-файл===
Вы можете вручную изменять файл ACL.xml. Он обладает довольно простым синтаксисом, но может временами немного вводить в заблуждение. Если вы редактируете его, когда сервер запущен, либо потом не забудьте вызвать скриптинговую функцию [[aclReload]] ("start runcode", "run aclReload()"), чтобы новый ACL загрузился, либо перед внесением изменений остановите сервер. Это также предотвратит случайную перезапись ваших изменений сервером.

===Функции скриптинга===
Вы можете использовать огромное количество скриптинговых ACL-функций для его изменения "на лету". Конечно, можно (и на самом деле нужно!) ограничивать доступ к ACL-функциям через сам ACL. Заметьте, что '''ресурс admin''', идущий вместе с MTA, может использоваться для распоряжения ACL (из вкладки "resources"). Вы должны быть админом сервера для использования этого. [https://wiki.multitheftauto.com/wiki/Admin Нажмите здесь для инструкций по установке admin].

==Также смотрите==
{{ACL functions}}
[[Category:Понятия скриптинга]]
[[en:Access Control List]]

Server Manual

2022-01-03T01:12:04Z

Turret001: replaced http links with https

__TOC__

==Getting started==
It is much easier than it looks to get a server up and running for your internet or LAN buddies; follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA server in no time!

==Installing the server==
The dedicated server application is available in different flavours depending on the platform of the server.

===Linux installation===
There are different ways of getting a Linux server up and running:
* [https://linux.mtasa.com Getting a precompiled package]
* [[Installing and Running MTASA Server on GNU Linux]]
* [[Building MTASA Server on GNU Linux]]

Should you have any problems with errors when starting the server some common problems and solutions are listed here:
* [[Building MTASA Server on GNU Linux#Troubleshooting]]

===FreeBSD installation===

You can run MTA:SA under FreeBSD using Linux emulation.
* Enable [https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu-lbc-install.html Linux binary compatibility]
* Install following packages or compile them from ports: hs-terminfo, linux_base-f10, linux-f10-sqlite3
* Install [https://linux.mtasa.com/ Linux precompiled package]

===Windows installation===
Installation of the MTA:SA server on Windows is easy as pie.
*Go to the [https://mtasa.com/ download page] and download the installer.
*Once the installer is downloaded, open it.
*Select a folder where you want to install the server.
*Click Install.
*Done!

''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/>

==Configuring your server==
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.

===General configuration===
All general configuration options can be found in the 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' file and can be opened by any regular text editor.

This file is fairly straightforward; every variable has a [[Server_mtaserver.conf|description of what to do with it and how to change it]].

===Port forwarding===
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.

First of all open the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' and search for the next lines:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

The ports are needed to setup the server correctly. We explain later how to set them, but first if you want your server to appear in the server browser there is another port we need, and that is the ASE port.
(quick example for how to turn ASE on or off):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Now we going to forward the ports in your router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.

If you don't know how port forwarding works in your router, go to the [https://portforward.com/ Port Forward website], find your router model there, and follow the instructions there.

In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:

Main server port: UDP

HTTP Port: TCP

ASE Port: UDP (this is needed if you want your server to appear in the server list)

The ASE port is also simple to get:

ASE port = Main server port + 123

So, if you have the main server port set to 22003, then the ASE port will be 22126.

Good luck!

'''If you somehow get stuck while forwarding ports''' (and have looked for the aforementioned [https://portforward.com/ portforward.com] page designed for your router model, you can give this extended (generic) forwarding guide a try:
<br/>
[https://forum.mtasa.com/topic/115141-guide-port-forwarding-in-order-to-run-a-mta-server/ '''Port forwarding for MTA servers''']

''In the latest version of the server, you can check the port status by using the server command [[Server_Commands#openports|openports]].''

===Client Checks===

The MTA server can be configured to disable the anti-cheat. It can also allow specific or all files to be modified (e.g. carmods.dat), and make sure clients are of a minimum version.

All of these settings are within the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]'. See the [[Anti-cheat_guide|Anti-cheat guide]] for more details.<br/>

If you want to force a minimum client version, search for the following line:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Accepted values look like: 1.1.1-9.02320

===Adding administrators===
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.

To add an administrator to your server, follow these steps:<br>
<ol>
<li>While the server is running, add a new account by typing '''[[Server_Commands#addaccount|addaccount name password]]''' into the server window. For example, to add user BennyLava you could type:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount BennyLava 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Note: If you do not have access to the server window, and the 'admin' resource is running, you can add the example account by issuing the client console (F8) command '''register BennyLava 123password'''''
</div>
<li>The server should display a message confirming the account has been added.
<li>Next, shutdown the server by typing '''shutdown''' into the server window.
<li>Make sure your server is stopped; if your server is still running, the following changes you make will be overwritten</li>
<li>Open the file 'mods/deathmatch/acl.xml' with any text editor</li>
<li>Add the account to the ''Admin'' group by using the XML-syntax below
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.BennyLava" />
</group>
...
</acl>
</syntaxhighlight>
</div>

You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br>

It is recommended to take a look at the web interface, we will explain how to do this below.
</li>
</ol>
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "[[Server_Commands#addaccount|addaccount <user> <password>]]" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br />

===Using the web interface===
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.

The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:
<ol>
<li>Make sure your server is stopped
<li>Open the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' with any text editor</li>
<li>Verify that the HTTP server is enabled:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Change the HTTP server port to your liking:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Save and close the configuration file</li>
<li>Start your server</li>
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

These are automatically started in the default configuration file, in case you just installed your server.
</li>
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported; use [https://www.mozilla.com/firefox Mozilla Firefox], [https://www.google.com/chrome Google Chrome], [https://www.apple.com/safari/download Apple Safari], [https://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li>
<li>Enter the username and password of the administrator you added in the previous section.</li>
</ol>

<br />
You should now be able to maintain your server from the web interface.

=== Configuring an external web server ===

The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.

For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.

To enable downloading off an external web server, you should configure the [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] tag in your server configuration:

<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

When you launch the server, the directory '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' will contain the correct client files for hosting on an external web server. If the web server is on the same machine, you can simply link the appropriate web server directory to '''http-client-files'''. If the web server is on a separate machine, ensure it has access to '''http-client-files''' via a network path, or maintain a remote copy using synchronization software.

'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''<nowiki>http://www.myserver.tld/directory</nowiki>'' rather than ''<nowiki>http://www.myserver.tld/directory/</nowiki>'')<br />
'''Note 3''': The web server must use 'ContentType: application/octet-stream' for Lua files. Most web servers will do this by default, or you can add the following line to the .htaccess file:<br />
<div style="padding: 10px">
<syntaxhighlight lang="xml">AddType application/octet-stream .lua
</syntaxhighlight></div>

Instructions on how to install and configure Nginx as an external web server for MTA is here: [[Installing and Configuring Nginx as an External Web Server]]

==Starting your server==
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!

To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where necessary.

==Installing/Updating resources on your server==
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA server supports both these methods.

# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.
# In the server window type in the command [[Server_Commands#refresh|refresh]], this will re-scan the resources folder and update the live resources where necessary.

==Uninstalling resources==
Resources can easily be removed from your server if you no longer want them.

# Delete the ZIP file or the folder of the resource you wish to uninstall
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.

==Administrating your server==
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".

It's also possible to execute these and other admin commands from the in-game console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "[[Server_Commands#login|login username password]]". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.

For further commands, type [[Server_Commands#help|help]] in a console.

==Starting a map/gamemode==
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.

==Keeping your server alive==



To keep your server stable, you should avoid letting your server run unmanaged after you launched it.

* It is good to keep an eye on the process memory usage in Task manager, use performancebrowser/ipb, if the MTA Server process starts using more than 1.2 gb you're close to an Out Of Memory (OOM) error. At this point, you should:
** Restart the server
** Start checking for memory leaks in your code
* An OOM happens your server runs out of memory.
* Like with every process or application, not all elements and function calls can get efficiently freed.
* For example, if you start the server, you will have average memory usage of 50mb. If you have some players on it for a while, and all of them disconnected, you will have increased memory usage on the MTA Server process, even if the server returned to 0 players. This known as [https://www.google.com/search?q=software+aging ''software aging''].
* It is the leftover from the server's running time and can eventually increase until the server process can become unreliable and has chance of failure, memory exception or in other words, server crashes.
* To keep it short and simple: Always keep an eye on your servers and restart them once in a while to prevent this from happening, 50% of all server crashes asked support for are caused by it and it's better to be aware that you need this kind of mainentance to ensure stability!
* In other words: If you launch your server and leave it unmanaged for a long period, it won't hold out and it will crash at a certain point without the mainentance as described above. That means you cannot just start a server and not check back on it, because at one point you'll find it crashed if it gains memory usage over (very) long periods, depending on server load, player counts and other variables.

==Useful Notes==

# You may also update the resources while in-game as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.

====Need further help?====
Why not pop over to our [https://forum.mtasa.com/ Forums] or join us on [https://discord.com/invite/mtasa Discord].

[[de:Server Anleitung]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

[[Category:Support]]

ES/ACL

2022-01-03T01:11:28Z

Turret001: replaced http links with https

''Multi Theft Auto'' incluye una completa y útil Lista de Control de Acceso (''ACL'') la que te permite asegurar y limitar el acceso a distintas funciones, recursos del servidor de múltiples maneras.

El concepto en ''Multi Theft Auto'' de ''ACL'' es el de dar a un objeto especifico una serie de derechos. En el caso de ''Multi Theft Auto'', los objetos son una de dos cosas - recursos o usuarios. Hay numerosos derechos disponibles en ''Multi Theft Auto'' - estos están enfocados principalmente en las funciones del lado del servidor.

Lo que esto significa, esencialmente es que el ''ACL'' te permite escoger con exactitud a que funciones (un recurso o un usuario) pueden acceder. Esto, por ejemplo, puede prevenir que los jugadores de tu servidor sean capaces de ''banearse'' mutuamente o prevenir que errores en recursos aun no probados causen daños y problemas en tu servidor.

Por supuesto ''un gran poder conlleva una gran responsabilidad'' y es muy sencillo causar graves problemas con los recursos, por ejemplo, deshabilitar la función [[spawnPlayer]] para cada recurso causaría que los jugadores ya no puedan ''spawnear''. Por supuesto, existen situaciones en las que se busca hacer esto. (Si deseas hacer que un solo recurso se encargue de ''spawnear'' a los jugadores, por ejemplo.)

==Entiendido el funcionamiento==
Existen dos grandes componentes en el ''ACL'': grupos y listas ''ACL''. Estos aparecen como '''<group name="">''' y '''<acl name="" />'''.
Cuyo propósito es:<br \>
'''1.''' Garantizar a los usuarios el permiso de controlar el servidor y utilizar comandos. Ejemplos:''<br \>
*Permitir solo a los administradores utilizar la función [[giveWeapon]] en ''freeroam''.
*Permitir a todos los jugadores iniciar un recurso.
'''2.''' Garantizar a los recursos el permiso de utilizar una función o funciones de otros recursos. Ejemplos:<br \>
*Permitir a un recurso utilizar la funcion [[restartResource]].
*Permitir a un recurso llamar funciones exportadas desde otro recurso.

===Grupos por defecto===
''Multi Theft Auto'' trae por defecto algunos grupos con ciertos permisos. Estos son:
*'''Everyone''' - Toda cuenta registrada, por defecto, es añadida a este grupo.
*'''Moderator'''
*'''SuperModerator'''
*'''Admin'''
*'''Console''' - Este grupo controla los permisos del usuario de la Consola '''<object name="user.Console" />'''
*'''RPC''' - Procedimientos Remotos (En ingles, ''Remote Procedure Call''). Garantiza el acceso a [[callRemote]], para mas información revisa la información de la función.
<br \>

A modo de ejemplo, utilizare el grupo ''Everyone''. Por defecto, este luce así:
<syntaxhighlight lang="lua"> <group name="Everyone">
<acl name="Default" />
<object name="user.*" />
<object name="resource.*" />
</group>
</syntaxhighlight>
<br \>

Lo primero que deberías notar es el nombre ''ACL'' (''acl name'') asignado dentro del grupo. Esto define que permisos tiene el grupo en cuestión, usuarios y recursos en este grupo pueden acceder a los permisos especificados dentro de la lista ''ACL'' llamada "Default".
''*Nota: Como notaras, este grupo en especial incluye a todos los usuarios y recursos gracias al uso del '''*'''.''

Ahora, desplácese al final de el ACL y verá la lista '''<acl name="Default" />'''. Tenga en cuenta que he recortado drásticamente esta lista debido a su longitud.

<syntaxhighlight lang="lua"> <acl name="Default">
<right name="command.start" access="false" />
<right name="command.stop" access="false" />
<right name="command.stopall" access="false" />
...etc etc...
<right name="function.executeCommandHandler" access="false" />
<right name="function.setPlayerMuted" access="false" />
<right name="function.restartResource" access="false" />
...etc etc...
<right name="general.adminpanel" access="false" />
<right name="general.tab_players" access="false" />
<right name="general.tab_resources" access="false" />
...etc etc...
<right name="command.freeze" access="false" />
<right name="command.shout" access="false" />
<right name="command.spectate" access="false" />
...etc etc...
</acl>
</syntaxhighlight>
<br \>
*'''Entradas de funcion''' son funciones de scripting de MTA. Por ejemplo, si un recurso necesita utilizar restartResource y fue se encuentra en el grupo 'Everyone' (con la lista 'Default'), se le negaría el acceso a restartResource y no funcionar correctamente.
*'''Comandos''' se crean cuando un recurso utiliza [[addCommandHandler]]. Un ejemplo sería escribiendo '''/ createvehicle [vehículo]''' en la ventana de chat para el recurso Freeroam. Esto si los usuarios del grupo utilizando este ACL pueden utilizar el comando. ''Nota: los comandos no tienen ningún efecto sobre los recursos dentro del grupo. Los comandos sólo están relacionados con los usuarios''.
**''General es un grupo con derechos modificados creado por el recurso de administración pero trabaja en los mismos principios. El script funciona con ellos mediante el uso de [[hasObjectPermissionTo]]''
<br\>

Te darás cuenta que algunos grupos, como ''admin'' tienen múltiples nodos de '''<acl name="" />''' . Un ejemplo es el grupo de ''administracion o Admin'':
<syntaxhighlight lang="lua">
<group name="Admin">
<acl name="Moderator" />
<acl name="SuperModerator" />
<acl name="Admin" />
<acl name="RPC" />
<object name="resource.admin" />
<object name="resource.webadmin" />
<object name="user.Ransom" />
</group>
</syntaxhighlight>
<br\>

Esto le da a todos los permisos definidos en cada nodo '''<acl name="" />''' por orden de lista. Así, por ejemplo, el grupo de administración asegura que todos los permisos se otorgan a los administradores mediante el uso de toda la lista. Si hay algún conflicto, la entrada más baja gana. Por ejemplo, pretenda que estos 2 ACL estaban en un grupo en el siguiente orden:
<br\>
'''1.''' '''<acl name="Default">''' sets <right name="general.ModifyOtherObjects" access="false" /> <br\>
'''2.''' '''<acl name="Admin">''' sets <right name="general.ModifyOtherObjects" access="true" /> <br\>
'''3.''' Para todos los usuarios y recursos en el grupo administrador "''Admin''": <right name="general.ModifyOtherObjects" access="true" /><br\>
<br\>

=== Grupos de recursos y ACLs ===
Usted se dará cuenta que hay algunos otros grupos que vienen con MTA. Estos fueron definidos por los recursos que vienen con MTA. Si un recurso quiere designar algunos derechos de ACL específicos no previstos por los grupos de MTA por defecto, puede crear su propio nombre y grupo en la ACL para usarlo. Voy a mostrar la entrada de AMX como ejemplo. AMX está diseñado para emular scripts de SA-MP y necesita un cierto conjunto de permisos que no se ajusta bien a los grupos predeterminados. Este se muestra a continuación:

<syntaxhighlight lang="lua">
<group name="AMX">
<acl name="AMX" />
<object name="resource.amx" />
</group>

<acl name="AMX">
<right name="general.ModifyOtherObjects" access="true" />
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="general.adminpanel" access="false" />
...etc etc...
<right name="command.kick" access="false" />
<right name="command.freeze" access="false" />
<right name="command.mute" access="false" />
...etc etc...
</acl>
</syntaxhighlight>

==Modificación de la ACL==
Hay tres formas de modificar la ACL - La forma de hacerlo depende de quién eres.

===Interfaz HTTP===
Usted puede utilizar la interfaz http [[Resource/webadmin|webadmin]] para modificar la ACL en su navegador web. Esta es por lejos la forma más fácil de hacerlo. Sólo asegúrese de que el recurso ''webadmin'' se encuentra iniciado en el servidor y visite ''<nowiki>http://ServerIP:HttpPort/</nowiki>''. Usted puede utilizar las dos secciones - ACL y Grupos o "''Group''". ACL le permite crear sus listas de control de acceso - listas de derechos. Grupos o "''Group''" les permiten agrupar colecciones de usuarios y asignar las ACLs para ellos. Por ejemplo, la seccion ACLs le permite especificar que la ACL de administración o "''Admin''" tiene acceso a el comando ''start'' en la consola. Usted puede ir a la sección de Grupos y crear un ''Group'' de administración que tiene acceso a la administración de su ''acl''. Entonces usted podrá añadir usuarios a su ''Group'' de Administración.

===Archivo XML===
Usted puede modificar el archivo ACL.xml manualmente. Este tiene una sintaxis bastante sencilla, pero puede ser un poco confuso a veces. Si lo hace mientras el servidor está en ejecución, no se olvide de llamar a la función [[aclReload]] ("start runcode", "run aclReload()") así el nuevo ACL será cargado, o de lo contrario detener el servidor antes de realizar las modificaciones. Esto también evita que los cambios sean sobrescritos accidentalmente por el servidor.

===Funciones de Scripting===
Usted puede utilizar un gran número de funciones de script de ACL para modificar la ACL en la marcha. Por supuesto, usted puede (y de verdad Debe!) limitar el acceso a las funciones de ACL con la ACL. Tenga en cuenta que el '''admin resource''' que viene con MTA se puede utilizar para administrar la ACL en la ficha recursos. Usted debe ser configurado como administrador para utilizar el panel de administración. [https://wiki.multitheftauto.com/wiki/Admin Haga clic aquí para obtener instrucciones de configuración de administración].

==Vea también==
{{ACL functions}}
[[Category:Translated/Scripting Concepts]]
[[ru:Access Control List]]

==Traductores==

*
[[en:Scripting Introduction]]

*Rockero
[[en:Scripting Introduction]]