IT/Manuale del Server

Per iniziare

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

I installed the server on ubuntu 6.05 LTS. I will add installation instructions for other linux distros at a later time. This install was done on a fresh os install so a few things have to be installed first. First of all ssh into your server using whatever client you like. I prefer putty. Start by typing sudo apt-get upgrade It will prompt you to put your password in again. After the upgrade is done running type sudo apt-get install pico this will install the easy to use pico text editor that you will use to edit the config files. After the install is done running you need to get a copy of libcurl3 for the server to run so type sudo apt-get install libcurl3 Once again it will ask you for your password. Once this is done now we have to get the server program onto your Linux server. There are a few methods for doing this. you can install a ftp server. you can use putty file transfer. If you know someone with a website you can ask them to put the file on their website then use wget http://wwww.websitename.com/file.tar Obviously where website name is change to your friends website. Either way once you have the tar file on your server you need to unpack it you do this by using the command tar -zxvf filename.tar

Installazione su Windows

Installare un server MTA:SA DM su Windows è facilissimo:

• Scarica 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 (Access Control List) leggi: 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:

<account name="Nickname" password="Password" />

• 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:

      <object name="resource.Nickname"/>

Alla fine avrai qualcosa di simile a questo:

<group name="Admin">
...
<object name="user.Nickname" />
</group>

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

For performance or consistency reasons, you could choose to make use of an external web server already set up and running, instead of the built-in web server. 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 httpdownload and httpdownloadurl tags in your server configuration:

<httpdownload>1</httpdownload>	
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>

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 unextracted files to their computers. The unextracted files are always available in the <SERVER>/mods/deathmatch/resourcecache directory.

1. Launch the dedicated server once and exit again. This will extract the zip files into the <SERVER>/mods/deathmatch/resourcecache directory.
2. Go into the directory above and copy the resources to your external web server's public directory, this can be done in several ways:
   • If you don't care about your server-side files being publically available: create a symbolic link (Linux), a junction (Windows) or just plain copy the contents of the resourcecache directory to your public web server directory.
   • If you don't want your server files to be publically available through your web server: go into the resourcecache directory and manually copy the folders over to your public web server directory, removing any server-side files (they are not necessary for the client-side downloading) you do not want to be hosting on your web server.
     
     A quick way of securing your server-side files is currently not available. We will investigate into developing a tool that automatically copies only the necessary client-side files for all resources on your server.

Note: Please try to avoid any special characters (e.g. ~, !) in your download URLs.
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 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

You're able to access these great remote admin tools by visiting http://<yourserverip>:<httpport>/resourcebrowser 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

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\MTA San Andreas\server

Need further help?

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