Multi Theft Auto: Wiki - User contributions [en]

Modules/cURL/curl init

2010-06-13T20:34:13Z

Mrdejong:

{{Modules/cURL/func_page|
description = Initialize the curl engine.|
syntax = <syntaxhighlight lang="lua">curl curl_init(string url)</syntaxhighlight>|
required_arguments = * '''url''' The url which you want to connect too.|
returns = A valid curl handler on succes, otherwise it returns false|
example = <syntaxhighlight lang="lua">
curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
// lets do something here.
end
</syntaxhighlight>
}}

[[Category:Modules]]

Template:Modules/cURL/func page

2010-06-13T20:33:32Z

Mrdejong:

__NOTOC__
{{ModuleFunction|cURL}}
{{{description}}}

==Syntax==
{{{syntax}}}

==Required arguments==
{{{required_arguments}}}

==Returns==
{{{returns}}}

==Example==
{{{example}}}

==See also==
{{Modules/cURL/functions}}

Modules/cURL/curl init

2010-06-13T20:31:43Z

Mrdejong:

{{Modules/cURL/func_page|
description = Initialize the curl engine.|
syntax = curl curl_init(string url)|
required_arguments = * '''url''' The url which you want to connect too.|
returns = A valid curl handler on succes, otherwise it returns false|
example = curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
// lets do something here.
end
}}

[[Category:Modules]]

Template:Modules/cURL/func page

2010-06-13T20:30:58Z

Mrdejong: Created page with '__NOTOC__ {{ModuleFunction|cURL}} {{{description}}} ==Syntax== <syntaxhighlight lang="lua"> {{{syntax}}} </syntaxhighlight> ==Required arguments== {{{required_arguments}}} ==Returns== {{{returns}}} ==…'

__NOTOC__
{{ModuleFunction|cURL}}
{{{description}}}

==Syntax==
<syntaxhighlight lang="lua">
{{{syntax}}}
</syntaxhighlight>

==Required arguments==
{{{required_arguments}}}

==Returns==
{{{returns}}}

==Example==
<syntaxhighlight lang="lua">
{{{example}}}
</syntaxhighlight>

==See also==
{{Modules/cURL/functions}}

Modules/cURL/curl init

2010-06-13T20:29:41Z

Mrdejong:

{{Modules/cURL/func_page|
description = Initialize the curl engine.
syntax = curl curl_init(string url)|
required_arguments = * '''url''' The url which you want to connect too.|
returns = A valid curl handler on succes, otherwise it returns false|
example = curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
// lets do something here.
end
}}

[[Category:Modules]]

Modules/cURL/curl setopt

2010-06-13T20:23:42Z

Mrdejong:

__NOTOC__
{{ModuleFunction|cURL}}
Set an curl option.

==Syntax==
<syntaxhighlight lang="lua">
curlcode curl_setopt(curl handler, curloption option, bool/number/string value)
</syntaxhighlight>

==Required arguments==
* '''handler''' The curl handler.
* '''option''' An curl option, al the options are found [[Modules/cURL/CURLOPT|here]]
* '''value''' The value, this can be a string, number or boolean. At the [[Modules/cURL/CURLOPT|curl option list]] you can find wich option needs a string, number or boolean.

==Returns==
Returns a curlcode. Nevermind it for now, i even don't know what it is. But it returns it.

==Example==
<syntaxhighlight lang="lua">
curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
curl_setopt(curl, CURLOPT_POST, true);
curl_close(curl);
end
</syntaxhighlight>

==See also==
{{Modules/cURL/functions}}

[[Category:Modules]]

Modules/cURL/curl close

2010-06-13T20:23:24Z

Mrdejong:

__NOTOC__
{{ModuleFunction|cURL}}
Closes the curl engine.

==Syntax==
<syntaxhighlight lang="lua">
curl_close(curl handler)
</syntaxhighlight>

==Required arguments==
* '''curl''' The curl handler

==Returns==
True on succes, false otherwise

==Example==
<syntaxhighlight lang="lua">
curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
curl_close(curl);
end
</syntaxhighlight>

==See also==
{{Modules/cURL/functions}}

[[Category:Modules]]

Modules/cURL/curl init

2010-06-13T20:23:04Z

Mrdejong:

__NOTOC__
{{ModuleFunction|cURL}}
Initialize the curl engine.

==Syntax==
<syntaxhighlight lang="lua">
curl curl_init(string url)
</syntaxhighlight>

==Required arguments==
* '''url''' The url which you want to connect too.

==Returns==
A valid curl handler on succes, otherwise it returns false

==Example==
<syntaxhighlight lang="lua">
curl = curl_init("http://mtasa.com/");
if not curl then
outputDebugString("Can't connect to http://mtasa.com/ with cURL");
else
// lets do something here.
end
</syntaxhighlight>

==See also==
{{Modules/cURL/functions}}

[[Category:Modules]]

Modules/cURL/curl setopt

2010-06-13T20:20:40Z

Mrdejong: Created page with '__NOTOC__ {{ModuleFunction|cURL}} Set an curl option. ==Syntax== <syntaxhighlight lang="lua"> curlcode curl_setopt(curl handler, curloption option, bool/number/string value) </syntaxhighlight> ==Require…'

Modules/cURL/curl close

2010-06-13T20:14:07Z

Mrdejong: Created page with '__NOTOC__ {{ModuleFunction|cURL}} Closes the curl engine. ==Syntax== <syntaxhighlight lang="lua"> curl_close(curl handler) </syntaxhighlight> ==Required arguments== * '''curl''' The curl handler ==Retu…'

Modules/cURL/curl init

2010-06-13T20:03:14Z

Mrdejong: Created page with '__NOTOC__ {{ModuleFunction|cURL}} Initialize the curl engine. ==Syntax== <syntaxhighlight lang="lua"> curl curl_init(string url) </syntaxhighlight> ==Required arguments== * '''url''' The url which you w…'

Template:Modules/cURL/functions

2010-06-13T19:54:54Z

Mrdejong: Created page with '* curl_init * curl_close * curl_setopt'

* [[Modules/cURL/curl_init|curl_init]]
* [[Modules/cURL/curl_close|curl_close]]
* [[Modules/cURL/curl_setopt|curl_setopt]]

Modules/cURL

2010-06-13T19:50:41Z

Mrdejong: Created page with '{{Module_Info| name = MTA Curl | version = 1.0 | author = Alexander de Jong (mrdejong) | module_website = ''Not available'' | …'

{{Module_Info|
name = MTA Curl |
version = 1.0 |
author = [[User:mrdejong|Alexander de Jong (mrdejong)]] |
module_website = ''Not available'' |
download_link = ''Not available'' |
license = [http://www.opensource.org/licenses/bsd-license.php BSD]
}}
MTA Curl module is a handy module to make restful api web calls. You could do everything with it.

The module is based on php cURL module.

==cURL functions==
{{Modules/cURL/functions}}

==cURL events==
{{Modules/cURL/events}}

==cURL variables==
{{Modules/cURL/variables}}

[[Category:Modules]]

PHP SDK

2010-03-02T13:21:11Z

Mrdejong:

__NOTOC__
You can access the MTA Web Interface from almost any programming language that can request web pages using HTTP POST and encode and decode [[JSON]]. PHP can do this very easily.

This SDK provides one function ''call'' that will allow you to call any exported script functions on any server that you have access to.

The download below includes two example pages - one that shows a simple scoreboard, the other that shows the automatic handling of element and resource objects.

If you use this and make any improvements, feel free to send us a copy and we can host it for others to benefit from.

==Functions==
===call===
This function calls an exported function in a specific resource.

'''Syntax:'''
<syntaxhighlight lang="lua" lang="php">
$mtaServer = new mta( $hostname, $port, $username, $password );
$resource = $mtaServer->getResource ( $resourceName );
$returns[] = $resource->call ( "functionName" [,args...] );
</syntaxhighlight>

===getInput===
This function is for use with web pages that are called by [[callRemote]].

'''Syntax:'''
<syntaxhighlight lang="lua" lang="php">
inputData[] = mta::getInput();
</syntaxhighlight>

===doReturn===
Use this function when you want to return data when a page is called with [[callRemote]]. You should '''NOT''' output any other data to the page, e.g. using ''echo'' as this will cause the return to fail.

'''Syntax:'''
<syntaxhighlight lang="lua" lang="php">
mta::doReturn( argument1, argument2 ... argumentN );
</syntaxhighlight>

==Examples==
<syntaxhighlight lang="lua" lang="php">
include( "mta_sdk.php" );
$mtaServer = new mta("bastage.net", 33004);
$resource = $mtaServer->getResource ( "echobot" );
$retn = $resource->call ( "getThisResource" ); // $retn is an array containing the values the function returned
$resourceElement = $retn[0]; // the first returned value is the resource
$retn = $resource->call ( "getResourceName", $resourceElement );
$resourceName = $retn[0]; // contains the name of the resource 'echobot'
</syntaxhighlight>

==Authentication==
If the server you are accessing requires authentication, you must pass the ''http_username'' and ''http_password'' variables to your instantiated instance of the mta() class.

'''Example:'''
<syntaxhighlight lang="lua" lang="php">
include( "mta_sdk.php" );
$mtaServer = new mta("example.com", 33004, "myUsername", "myPassword" );
$mtaServer->getResource("someResource")->call("someFunction");
</syntaxhighlight>

==A page that can be called by [[callRemote]]==
This example just adds two numbers passed to it by a lua script.

'''PHP:''' (for the page that LUA expects to be at ''<nowiki>http://www.example.com/page.php</nowiki>'')
<syntaxhighlight lang="lua" lang="php">
include( "mta_sdk.php" );
$input = mta::getInput();
mta::doReturn($input[0] + $input[1]);
</syntaxhighlight>
'''LUA:'''
<syntaxhighlight lang="lua" lang="lua">
-- result is called when the function returns
function result(sum)
outputChatBox(sum)
end
function addNumbers(number1, number2)
callRemote ( "http://www.example.com/page.php", result, number1, number2 )
end
addNumbers ( 123, 456 ) -- call the function
</syntaxhighlight>

==Caveats==
* This only works with PHP 5.0 and above.
* You cannot currently compare two Element instances that you expect to be identical - you need to do a "deep compare", comparing the "id" fields.

==Download==
=== Node for version 0.4 ===
Online 80 in mta_sdk.php you will find the string:
<syntaxhighlight lang="lua" lang="php">
echo $json_output;
</syntaxhighlight>

Replace that one with:
<syntaxhighlight lang="lua" lang="php">
//echo $json_output;
</syntaxhighlight>

Or remove it completly!

*[http://www.greenhood.nl/mtasa/mtaphpsdk_0.4.zip Download Version 0.4] - Renamed ''public function mta(..)'' to ''public function __construct(..)''.
*[http://code.opencoding.net/mta/mtaphpsdk_0.3_fix.zip Download Version 0.3] - Neater syntax, support functions for [[callRemote]] (fix version makes call work with args).
*[http://misc.opencoding.net/mta/mtaphpsdk_0.2.zip Download Version 0.2] - ''Deprecated - Syntax differs from examples shown above.'' - Adds authentication support.
*[http://misc.opencoding.net/mta/mtaphpsdk_0.1.zip Download Version 0.1] - ''Deprecated - Syntax differs from examples shown above.''

Template:Useful Functions

2010-02-03T20:21:11Z

Mrdejong:

*[[callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any clientside function from the server's side.</span>

*[[callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any server-side function from the client's side.</span>

*[[Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function checks if it's arguments are of the right types and calls the error-function if one isn't.</span>

*[[doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function can be used to execute a specified function for all elements of a specified type.</span>

*[[findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Takes two points and returns the direction from point A to point B.</span>

*[[FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formats a date on the basis of a format string and returns it.</span>

*[[getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds a point based on a starting point, direction and distance.</span>

*[[GetTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].</span>

*[[IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns one of two values based on a boolean expression.</span>

*[[IsYearALeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Checks if the given year is a leap year.</span>

*[[math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Rounds a number whereas the number of decimals to keep and the method may be set.</span>

*[[setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protects a table and makes it read-only.</span>

*[[setVehicleGravityPoint]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.</span>

*[[string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function splits a string at a given separator pattern and returns a table with the pieces.</span>

*[[table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function copies a whole table and all the tables in that table.</span>

*[[table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.</span>

*[[table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds the absolute size of a table.</span>

*[[var_dump]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»This function outputs information about one or more variables using outputConsole(). </span>

*[[getAge]] <span style="color:gray; font-family:'Georgia', sans-serif; font-size:smaller;">»This function calculates the age of a birthday.

[[Category:Useful Functions]]

GetAge

2010-02-03T16:28:53Z

Mrdejong: Created page with '{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ This function maths the age of the given birthday. ==Syntax== <syntaxhighlight lang="lua">int getAge(int day, int month, int yea…'

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function maths the age of the given birthday.

==Syntax==
<syntaxhighlight lang="lua">int getAge(int day, int month, int year)</syntaxhighlight>

===Required Arguments===
* '''day''': The day when the player was born.
* '''month''': The month when the player was born.
* '''year''': The year when the player was born.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function getAge(day, month, year)
local time = getRealTime();
time.year = time.year + 1900;
time.month = time.month + 1;

year = time.year - year;
month = time.month - month;

if month < 0 then
year = year - 1
elseif month == 0 then
if time.monthday < day then
year = year - 1;
end
end

return year;
end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="both" show="true">
<syntaxhighlight lang="lua">
-- A simple example:
addEventHandler("onResourceStart", getRootElement(), function()
print(getAge(09, 04, 1989))
end);
-- that will output:
-- 20
-- Yep, i'm 20 years old!
</syntaxhighlight>
</section>

Function created by '''Alexander de Jong AKA mrdejong'''.

==See Also==
{{Useful_Functions}}

Template:MTA Framework/Work In Progress

2009-05-27T17:45:06Z

Mrdejong: New page: <div style="border: 1px solid red; background-color: #FF8F8F; padding: 5px;"> This is work in progress. If you see functions, classes or anything else that doesn't exists, be aware that it...

<div style="border: 1px solid red; background-color: #FF8F8F; padding: 5px;">
This is work in progress. If you see functions, classes or anything else that doesn't exists, be aware that it ain't been created yet.
</div>

Template:MTA Framework/Template/Language Lua Loader

2009-05-27T12:46:55Z

Mrdejong: New page: * language_lua_loader:init * language_lua_loader:getOutput * [[MTA_Framework/Language_Lua_Loader:...

* [[MTA_Framework/Language_Lua_Loader:init|language_lua_loader:init]]
* [[MTA_Framework/Language_Lua_Loader:getOutput|language_lua_loader:getOutput]]
* [[MTA_Framework/Language_Lua_Loader:addTranslation|language_lua_loader:addTranslation]]

Talk:MTA Framework

2009-05-27T11:49:57Z

Mrdejong:

Ehhh ?? --[[User:Sebassje|Sebas]] 13:44, 27 May 2009 (CEST)

This is an work in progress. --[[User:Mrdejong|mrdejong]] 13:44, 27 May 2009 (CEST)

Talk:MTA Framework

2009-05-27T11:49:25Z

Mrdejong:

Ehhh ?? --[[User:Sebassje|Sebas]] 13:44, 27 May 2009 (CEST)

This is an work in progress.

Server Manual

2009-03-13T13:19:31Z

Mrdejong: /* Configuring your server */

__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 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===
==Ubuntu==
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'''
==Gentoo==
I assume that if people are using Gentoo, they know enough of an operating system to get files from the web to their server theirselves... (otherwise, look above and read the ubuntu part)

These versions I needed for DP2:

Update your gcc version to 4.2.2:
* unmask gcc in /etc/portage/package.unmask)
* emerge gcc
* switch to gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Update your libstdc++ version to 3.3 if you haven't got that version
* emerge libstdc++
Install libcurl:
* emerge libcurl
Unpack mtasa, and run it...

===Windows installation===
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 servers" 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!

''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/'''mtaserver.conf'''' file and can be opened by any regular text editor.

This file is fairly straightforward; every variable has a 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/'''mtaserver.conf'''' and search for the next lines:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

The ports are needed to setup the server right. We explain later how to set them, but first if you want your server to list in the server browser there is an other port we need, and that is the ase port.
(quick example for how to turn ase on or of):
<syntaxhighlight lang="xml">
<ase>1</ase> <!-- 0 = of and 1 = on.
</syntaxhighlight>

Now we going to forward the ports in router.

If you don't know how it works in your router. Please goto: http://portforward.com/ find your router, and folow the instructions there.

I know one thing for sure. In every router you can set the port type: udp or tcp these are very important. The next list will explain wich port type need to set by the port:

serverport: udp
httpport: tcp

Now we need the ase port. The ase port is simple to get:
serverport + 123
So if you have the serverport set to 22004 then the ase port will be 22127.

The port type for the ase port is: udp.

Good luck with running your server!

===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>Make sure your server is stopped; if your server is still running, all changes you make will be overwritten</li>
<li>Open the file 'mods/deathmatch/'accounts.xml'''' with any text editor</li>
<li>Add a new account into the file by using the XML-syntax below, we use the username "BennyLava" with password "123password" for illustration purposes
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<accounts>
...
<account name="BennyLava" password="123password" />
</accounts>
</syntaxhighlight>
</div>
<li>Save and close the file</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. "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/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 ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<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 unextracted files to their computers. The unextracted files are always available in the '''<SERVER>/mods/deathmatch/resourcecache''' directory.

<ol>
<li>Launch the dedicated server once and exit again. This will extract the zip files into the '''<SERVER>/mods/deathmatch/resourcecache''' directory.</li>
<li>Go into the directory above and copy the resources to your external web server's public directory, this can be done in several ways:
<ul>
<li>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.</li>
<li>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.<br />
<br />
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.
</ul>
</li>
</ol>

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

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

# 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 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 [[Resource:Map manager|mapmanager]] for more information.

==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
# 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])

[[it:Manuale del Server]]

GUI Classes

2009-02-28T17:23:30Z

Mrdejong: New page: <pageclass class="client"></pageclass> This page lists all the gui class objects. This will only work with: http://community.mtasa.com/index.php?p=resources&s=details&id=241 This system i...

<pageclass class="client"></pageclass>
This page lists all the gui class objects. This will only work with: http://community.mtasa.com/index.php?p=resources&s=details&id=241

This system is created by the well none 50p!

GUI Classes made scripting gui objects eisier!
__TOC__

==Window class==
{{GUI_Classes_Window}}

==Window tab class==
{{GUI_Classes_Window_tab}}

==Tab panel class==
{{GUI_Classes_TabPanel}}

==Tab class==
{{GUI_Classes_Tab}}

==Gridlist class==
{{GUI_Classes_Gridlist}}

==Button class==
{{GUI_Classes_Button}}

GetCameraMode

2008-10-27T08:50:56Z

Mrdejong: /* Example */

{{Server client function}}
__NOTOC__
This function returns a [[string]] containing the current mode of the player's camera.
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
string getCameraMode ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player whose camera mode you wish to obtain.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
string getCameraMode ( )
</syntaxhighlight>

===Required Arguments===
''None.''
</section>

===Returns===
Returns a [[string]] with one of two values if successful:
* '''player:''' The camera is attached to a player.
* '''fixed:''' The camera is in a fixed position.

The function will return ''false'' if unsuccessful.

==Example==
This function checks the camera state of a player:
<section name="Server script" class="server" show="true">
<syntaxhighlight lang="lua">
function checkCamera( source, command, targetName )
local targetPlayer = getPlayerFromNick ( targetName ) -- Get the player using his name
outputConsole( getCameraMode( targetPlayer ), source ) -- Output the state of player's camera
end
addCommandHandler( "camera", checkCamera )
</syntaxhighlight>
</section>

<section name="Client script" class="client" show="false">
<syntaxhighlight lang="lua">
function checkCamera( command, targetName )
local targetPlayer = getPlayerFromNick ( getLocalPlayer()) -- Get the player using his name
outputConsole( getCameraMode(), getLocalPlayer()) -- Output the state of player's camera
end
addCommandHandler( "camera", checkCamera )
</syntaxhighlight>
</section>

==See Also==
{{Camera functions}}

GetCameraMode

2008-10-27T08:50:33Z

Mrdejong: /* Example */

BanPlayer

2008-10-24T16:33:39Z

Mrdejong: /* Example */

__NOTOC__
{{Server function}}
This function will ban the specified player from the server by IP.

==Syntax==
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement , string reason ] )
</syntaxhighlight>

===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server

===Optional Arguments===
{{OptionalArg}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root: <syntaxhighlight lang="lua">getRootElement()</syntaxhighlight>
*'''reason:''' The reason the player will be banned from the server

===Returns===
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
-- Example with the player
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromNick ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end

-- Example with the rood element.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
end
addCommandHandler ( "ban", banPlayerCommand )
</syntaxhighlight>

==See Also==
{{Admin_functions}}

BanPlayer

2008-10-24T16:29:48Z

Mrdejong: /* Syntax */

__NOTOC__
{{Server function}}
This function will ban the specified player from the server by IP.

==Syntax==
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement , string reason ] )
</syntaxhighlight>

===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server

===Optional Arguments===
{{OptionalArg}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root: <syntaxhighlight lang="lua">getRootElement()</syntaxhighlight>
*'''reason:''' The reason the player will be banned from the server

===Returns===
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromNick ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )
</syntaxhighlight>

==See Also==
{{Admin_functions}}

BanPlayer

2008-10-24T16:29:28Z

Mrdejong: /* Syntax */

__NOTOC__
{{Server function}}
This function will ban the specified player from the server by IP.

==Syntax==
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement , string reason ] )
</syntaxhighlight>

===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server

===Optional Arguments===
{{OptionalArg}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root (<syntaxhighlight lang="lua">getRootElement()</syntaxhighlight>)
*'''reason:''' The reason the player will be banned from the server

===Returns===
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromNick ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )
</syntaxhighlight>

==See Also==
{{Admin_functions}}

User:Mrdejong

2008-06-27T16:50:28Z

Mrdejong: New page: == This is my page == But nothing '''To see here''' ---- --~~~~

== This is my page ==

But nothing '''To see here'''
----
--[[User:Mrdejong|Mrdejong]] 11:50, 27 June 2008 (CDT)

Talk:Modules/MTA-MySQL/mysql rows

2008-06-27T16:49:17Z

Mrdejong:

Maybe add mysql_affected_rows(handler)
Need to return: 1 if the (insert/update) query had updated/inserted rows in to the database. And 0 other wise.
* Have you seen this function? [[Modules/MTA-MySQL/mysql_affected_rows]] --[[User:Ryden|Ryden]] 23:42, 26 June 2008 (CDT)
* Yes but to late. My apologise for that --[[User:Mrdejong|Mrdejong]] 18:49, 24 June 2008 (GMT)

Talk:Modules/MTA-MySQL/mysql rows

2008-06-26T09:56:21Z

Mrdejong: New page: Maybe add mysql_affected_rows(handler) Need to return: 1 if the (insert/update) query had updated/inserted rows in to the database. And 0 other wise.

Maybe add mysql_affected_rows(handler)

Need to return: 1 if the (insert/update) query had updated/inserted rows in to the database. And 0 other wise.