Server Manual: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 11: Line 11:


===Windows installation===
===Windows installation===
Empty
Installation of the MTA:SA DM server on Windows is easy as pie.
*Go to the [http://mtasa.com/dp.html download page] and scroll down to the "Dedicated server" section
*Click the Windows download link.
*Once the installer is downloaded, open it.
*Select a folder where you want to install the server.
*Click Install.
*Done!


==Configuring your server==
==Configuring your server==

Revision as of 09:58, 3 January 2008

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

Empty

Windows installation

Installation of the MTA:SA DM server on Windows is easy as pie.

  • Go to the download page and scroll down to the "Dedicated server" section
  • Click the Windows download link.
  • Once the installer is downloaded, open it.
  • Select a folder where you want to install the server.
  • Click Install.
  • Done!

Configuring your server

Begin by opening the 'mtaserver.conf' file, which is located in the <SERVER>\mods\deathmatch directory in a text editor, for example Windows Notepad.

This file is fairly straightforward; every variable has a description of what to do with it and how to change it.

Adding admins

To add admins to your sever follow these steps:

  1. Browse to your servers 'deathmatch' folder and open Accounts.xml
  2. Add a new account into the file with the syntax below

    'Accounts.xml syntax'

    <account name="Username" password="UserPassword" />
    
  3. Save and close the file
  4. Open acl.xml
  5. Select the rights of the admin, either Moderator, SuperModerator or Admin
  6. Within the group you have selected add the account you have created above with the syntax below
    <object name="user.Username" />
    

    You will finish with something like this:

    <group name="Admin">
    ...
    <object name="user.Username" />
    </group>
    
  7. You're done! You can add as many admins as you want this way, just keep creating accounts under eachother and the same with the ACL rights.

Note: Changing these files requires a restart of the server
Note 2: There are also ways to add accounts and edit rights for the server while it's running. "addaccount <user> <password>" is an internal command to add accounts, through the web interface you can manage ACL rights while it's running.

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

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 DM server supports both these methods.

  1. Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.
  2. 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.

Uninstalling resources

Resources can easily be removed from your server if you no longer want them.

  1. Delete the ZIP file or the folder of the resource you wish to uninstall
  2. 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 ingame console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "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 "help" in a console.

Starting a map/gamemode

See the commands section of the documentation for 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:

  1. ResourceBrowser
  2. ResourceManager
  3. WebAdmin
  4. WebMap

Your able to access these great remote admin tools by visiting http://<yourserverip>:<httpport>/resourcebrowser in firefox

Useful Notes

  1. 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.
  2. In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files (x86)\MTA San Andreas\server

Need further help?

Why not pop over to our Forums or join us on IRC (irc.multitheftauto.com #mta - MIRC)