INSTALLATION.md

Installation

amx consists of a binary server module (.dll/.so) and a Lua resource. It will only run on MTA:SA 1.6 and later. Installation steps are lined out below.

Extracting

• All needed binary files are in the archive provided on Releases page. Unpack amx.zip and extract the mods folder into your MTA server directory.

• amx folder located in mods/deathmatch/resources is a place for the mentioned Lua resources. It will be empty at this point, so you need to copy all the latest files of amx folder from this repository into your amx folder.

Pay attention, we suggest to put all resources into [amx] category. But if you use scriptfiles and plugins, put it into mods/deathmatch/resources/amx/scriptfiles and mods/deathmatch/resources/amx/plugins.

Configuration

• Open server/mods/deathmatch/mtaserver.conf in a text editor. Add the following line within the <config> node:

  <module src="king.dll"/>

  (Use "king.so" on Linux systems). This will instruct the MTA server to load the module on startup.

• At this point you can add the amx resource to the autostart list if you want. Doing this will allow you to use SA-MP style rcon commands in the server console as soon as the server is started.

  <resource src="amx" startup="1" protected="0"/>

  Save and close mtaserver.conf.

• After starting the MTA server you should see the following output:

  Resource ‘amx’ requests some acl rights. Use the command ‘aclrequest list amx’

  Run aclrequest list amx to see what ACL rights are needed, and if you are happy with the request, type aclrequest allow amx all.

Running gamemodes and filterscripts

Before you can run sa-mp modes or filterscripts, you need to start the amx resource. Type this command in the server console or as admin in the ingame console:

start amx

Alternatively you can add it to the autostart list of your server, in mtaserver.conf. Once amx is started you can use the following commands to start and stop gamemodes and filterscripts:

start amx-name
stop amx-name
start amx-fs-name
stop amx-fs-name

Alternatively, you can use the SA-MP style changemode and (un)loadfs commands. At most one gamemode can be running at any time, the number of running filterscripts is unlimited.

Go ahead and try starting the example gamemode (amx-test) and filterscript (amx-fs-test).

Finishing up

• If you are planning to compile Pawn scripts that use the new native functions provided by amx, place a_amx.inc in your Pawno "include" directory.

• You are done!

Known problems

• The module does not start. It can depend on sqlite3.dll (you can find it on the releases page and put it into mods/deathmatch/).

• There is only one hardcoded path for scriptfiles and plugins. If you need to work with scriptfiles and plugins, put them into mods/deathmatch/resources/amx/.

• You need exactly x86 (32-bit) MTA server for Windows to be able to use the current module build.