PT-BR/Manual do Servidor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(StanleySathler, adicionei meu progresso também (:. Não vou mais me meter, a página é toda sua!)
Line 1: Line 1:
[[PT-BR/Manual_do_Servidor]]  
[[PT-BR/Manual_do_Servidor]]  
==Introdução==
==Introdução==
Criar um servidor para o MTA é tão fácil quanto parece. Neste artigo estaremos abordando os passos iniciais para que você possa criar o seu próprio servidor para o MTA.
Configurar um servidor e por este online para que seus amigos joguem via internet ou LAN é uma tarefa mais facil do que parece. Neste artigo estaremos abordando os passos iniciais para que você possa criar o seu próprio servidor para o MTA.
 
==Instalando o servidor==
A parte mais simples é instalar o servidor. A seguir há dois tópicos, um ensinando a instalar no Linux e outro ensinando a instalar no 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 (Em Inglês)]]
* [[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 MTASA e baixe o instalador.
:*Quando o download estiver concluído, abra o arquivo.
:*Clique em Next e depois em "I Agree".
:*Nesta etapa você pode selecionar componentes os quais desejas 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 a qual deseja instalar o servidor. Em seguida, Next.
:*Clique em Install.
:*Pronto!
 
''Qual a função do arquivo acl.xml (access control list)? Para saber mais, leia o artigo em:
* [[Image:iUS.png|Em Inglês|20px]] [[Access_Control_List|Access Control List]]''
 
==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 digitadas pelo usuario.
** Esse programa está localizado em "MTA San Andreas 1.3\server\MTA Server.exe".
** Ele é identico a janela ''cmd'' do windows.
** Enquanto este estiver execultando, o servidor vai permanecer online, caso contrário, o servidor sai do ar.
*'''Do prório 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 que 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.
 
''Para que possa configurar um servidor do MTASA no jogo ou via website é necessário que pelomenos uma conta com privilégios de administrador seja adicionada no '''acl.xml'''.''
 
===Configuração Geral===
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]].
 
===Port forwarding===
 
Se você execulta um servidor em seu computador e há um roteador entre a internet e seu computador, então você tem que configurar 3 portas.
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.
 
Antes de mais nada, abra o arquivo localizado em "mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]" e procure pelas linhas citadas a seguir:
First of all open the file 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' and search for the next lines:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>
 
Estas portas são necessárias para que o servidor inicie corretamente. Explicaremos como configura-las mais adiante.
!Mas se primeiro desejas que o servidor apareça no navegador de internet, então precisaremos configurar mais uma porta chamada ASE.
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.
(um simples exemplo de como ligar e desligar a porta ASE):
(quick example for how to turn ASE on or off):
<syntaxhighlight lang="xml">
<ase>1</ase> <!-- 0 = desligada, 1 = ligada -->
</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.
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.
 
Se você não sabe como port forwarding funciona em seu roteador, viste [http://portforward.com/ este site], procure pelo modelo de seu roteador e siga as instruções.
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.
 
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 o que:
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:
 
Porta principal do servidor: UDP
Main server port: UDP
 
Porta HTTP: TCP
HTTP Port: TCP
 
Porta ASE: UDP (esta é necessária caso deseje que o servidor apareça na lista de servidores do gamemonitor.com).
ASE Port: UDP (this is needed if you want your server to appear in the server list)
 
A porta ASE é simples para se obter:
The ASE port is also simple to get:
 
Porta ASE = Porta principal do servidor + 123
ASE port = Main server port + 123
 
Então se a porta de seu servidor for 22003, então a porta ASE será no caso 22126.
So, if you have the main server port set to 22003, then the ASE port will be 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.''
''In the latest version of the server, you can check the port status by using the server command [[Server_Commands#openports|openports]].''
 
===Client Checks===
Todo jogador que entra em um servidor passa por várias "avaliações", também conhecido 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.
Toda essas "avaliações" são dividias 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.
** pertênce 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 iginore ou aja de forma diferente ao relaziar essas avaliações em cada jogador.
 
<!--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 chatbox 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 can actually add your user to any group you want. Each group is linked to an ACL ([[Access Control List]]). Each ACL contains a series of specific allowed or denied rights. These groups exist so different users can be assigned different rights. The ''Admin'' group points to the ''Admin'' ACL, which is empty (thus allowing all possible commands). The ''Everyone'' group points to the ''Default'' ACL that puts a series of restrictions on the available commands (to disallow regular players from using admin commands).
</li>
<li>
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>
 
Since all the default resources provided with the dedicated server are zipped, and are normally automatically extracted by the built-in web server, you now have to provide a way for the clients to download the compressed files to their computers. To configure MTA to maintain a copy of only your unzipped client resources, set [[Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] in your server configuration:
 
<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>
 
Now 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. ''hxxp://www.myserver.tld/directory'' rather than ''hxxp://www.myserver.tld/directory/'')
 
==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 [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com mIRC])
 
[[es:Manual Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[ru:Server Manual]]
[[pl:Server Manual]]
 
[[Category:Support]]

Revision as of 15:39, 20 May 2012

PT-BR/Manual_do_Servidor

Introdução

Configurar um servidor e por este online para que seus amigos joguem via internet ou LAN é uma tarefa mais facil do que parece. Neste artigo estaremos abordando os passos iniciais para que você possa criar o seu próprio servidor para o MTA.

Instalando o servidor

A parte mais simples é instalar o servidor. A seguir há dois tópicos, um ensinando a instalar no Linux e outro ensinando a instalar no Windows.

Instalando no Linux

Há diversas maneiras de instalar, configurar e iniciar um servidor no Linux:

Instalando no Windows

Instalar um servidor do MTA:SA no Windows é bem simples:

  • Vá para página de download do MTASA e baixe o instalador.
  • Quando o download estiver concluído, abra o arquivo.
  • Clique em Next e depois em "I Agree".
  • Nesta etapa você pode selecionar componentes os quais desejas 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 a qual deseja instalar o servidor. Em seguida, Next.
  • Clique em Install.
  • Pronto!

Qual a função do arquivo acl.xml (access control list)? Para saber mais, leia o artigo em:

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 digitadas pelo usuario.
    • Esse programa está localizado em "MTA San Andreas 1.3\server\MTA Server.exe".
    • Ele é identico a janela cmd do windows.
    • Enquanto este estiver execultando, o servidor vai permanecer online, caso contrário, o servidor sai do ar.
  • Do prório 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 que 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.

Para que possa configurar um servidor do MTASA no jogo ou via website é necessário que pelomenos uma conta com privilégios de administrador seja adicionada no acl.xml.

Configuração Geral

Todas as configurações gerais podem ser encontradas no arquivo "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 descrição abordando o que esta faz e como usa-la.

Port forwarding

Se você execulta um servidor em seu computador e há um roteador entre a internet e seu computador, então você tem que configurar 3 portas. 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.

Antes de mais nada, abra o arquivo localizado em "mods/deathmatch/mtaserver.conf" e procure pelas linhas citadas a seguir: First of all open the file 'mods/deathmatch/mtaserver.conf' and search for the next lines: 

<serverport>22004</serverport> 
<httpport>22005</httpport>

Estas portas são necessárias para que o servidor inicie corretamente. Explicaremos como configura-las mais adiante. !Mas se primeiro desejas que o servidor apareça no navegador de internet, então precisaremos configurar mais uma porta chamada ASE. 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. (um simples exemplo de como ligar e desligar a porta ASE): (quick example for how to turn ASE on or off): 

<ase>1</ase> <!-- 0 = desligada, 1 = ligada -->

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. 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.

Se você não sabe como port forwarding funciona em seu roteador, viste este site, procure pelo modelo de seu roteador e siga as instruções. If you don't know how port forwarding works in your router, go to the Port Forward website, find your router model there, and follow the instructions there.

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 o que: 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:

Porta principal do servidor: UDP Main server port: UDP

Porta HTTP: TCP HTTP Port: TCP

Porta ASE: UDP (esta é necessária caso deseje que o servidor apareça na lista de servidores do gamemonitor.com). ASE Port: UDP (this is needed if you want your server to appear in the server list)

A porta ASE é simples para se obter: The ASE port is also simple to get:

Porta ASE = Porta principal do servidor + 123 ASE port = Main server port + 123

Então se a porta de seu servidor for 22003, então a porta ASE será no caso 22126. So, if you have the main server port set to 22003, then the ASE port will be 22126.

Boa Sorte!

Na ultima versão do servidor, ao se digitar o comando "/openports", os status de todas as portas serão mostrados. In the latest version of the server, you can check the port status by using the server command openports.

Client Checks

Todo jogador que entra em um servidor passa por várias "avaliações", também conhecido 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. Toda essas "avaliações" são dividias em diversos parâmetros, os quais são configuráveis através do arquivo 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.
    • pertênce 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.
  • 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.

Cada parâmetro contido no arquivo mtaserver.conf tem um valor atribuido a ele. O que faz que o servidor iginore ou aja de forma diferente ao relaziar essas avaliações em cada jogador.


Retrieved from "https://wiki.multitheftauto.com/wiki/PT-BR/Manual_do_Servidor?oldid=31032"