Multi Theft Auto: Wiki - User contributions [en]

FormatDate

2011-01-29T11:35:15Z

XiP3rfectx ~: /* Example */

{{Useful Function}}
__NOTOC__
This function formats a date according to the given format string.

==Syntax==
<syntaxhighlight lang="lua">string FormatDate( string format, [ string escaper = "'", int timestamp = GetTimestamp() ] )</syntaxhighlight>

===Required Arguments===
* '''format''': Format string that determines how the date should be formatted. It provides the following wildcards:
** d: day (01-31)
** h: hour (00-23)
** i: minute (00-59)
** m: month (01-12)
** s: second (00-59)
** w: shortened day of the week (Su-Mo)
** W: day of the week (Sunday-Monday)
** y: shortened year (e.g. 09)
** Y: year (e.g. 2009)

===Optional Arguments===
{{OptionalArg}}
* '''escaper''': Escape character that determines the beginning or end of a non-format-area, where the wildcards aren't replaced with their corresponding value. Note that the escapers get lost.
* '''timestamp''': Timestamp of the date that should be formatted.

===Returns===
Returns a string containing the formatted date.

==Code==
{{RequiredFunctions|Check}}
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
local gWeekDays = { "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" }
function FormatDate(format, escaper, timestamp)
Check("FormatDate", "string", format, "format", {"nil","string"}, escaper, "escaper", {"nil","string"}, timestamp, "timestamp")

escaper = (escaper or "'"):sub(1, 1)
local time = getRealTime(timestamp)
local formattedDate = ""
local escaped = false

time.year = time.year + 1900
time.month = time.month + 1

local datetime = { d = ("%02d"):format(time.monthday), h = ("%02d"):format(time.hour), i = ("%02d"):format(time.minute), m = ("%02d"):format(time.month), s = ("%02d"):format(time.second), w = gWeekDays[time.weekday+1]:sub(1, 2), W = gWeekDays[time.weekday+1], y = tostring(time.year):sub(-2), Y = time.year }

for char in format:gmatch(".") do
if (char == escaper) then escaped = not escaped
else formattedDate = formattedDate..(not escaped and datetime[char] or char) end
end

return formattedDate
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example outputs the actual date to a joining player.
<syntaxhighlight lang="lua">
-- get the root element
local _root = getRootElement()
-- define the onPlayerJoin handler function
function OnPlayerJoin()
-- output the formatted date
outputChatBox(FormatDate("'You joined our server on' "..m.."/"..d.."/"..Y.." at "..h..":"..m.."."))
end
-- add the event handler
addEventHandler("onPlayerJoin", _root, OnPlayerJoin)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Table.size

2011-01-29T11:31:26Z

XiP3rfectx ~: /* Example */

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function returns the total size of a table and not only the highest numerical index like table.maxn or the number of fields that have a numerical index like the #-operator.

==Syntax==
<syntaxhighlight lang="lua">int table.size( table tab )</syntaxhighlight>

===Required Arguments===
* '''tab''': The table to retrieve the total size of.

===Returns===
Returns the total number of fields the table contains.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function table.size(tab)
local length = 0
for _ in pairs(tab) do length = length + 1 end
return length
end
</syntaxhighlight>
</section>

==Example==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua" lang="lua">
local tab = { 1, 2, 3, [25] = 4, five = 5, foo = "bar" }
outputChatBox(tostring(#tab)) --prints: 4 (because there are 4 fields with a numerical index)
outputChatBox(tostring(table.maxn(tab))) --prints: 25 (because the highest numerical index is 25)
outputChatBox(tostring(table.size(tab))) --prints: 6 (because the table has 6 fields in total)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

AR/الصفحه الرئيسيه

2011-01-15T17:40:45Z

XiP3rfectx ~: /* Reference */

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[AR/دليل اللاعب|دليل اللاعب (Client)]]
* [[دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====السكريبتات====

* [[مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client-side Functions]]
* [[Client-side Events]]
* [[Server-side Functions]]
* [[Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/الصفحه الرئيسيه

2011-01-15T17:40:29Z

XiP3rfectx ~: /* Reference */

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[AR/دليل اللاعب|دليل اللاعب (Client)]]
* [[دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====السكريبتات====

* [[مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client-side Functions]]
* [[Client-side Events]]
* [[AR/Server-side Functions]]
* [[Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/الصفحه الرئيسيه

2011-01-15T17:36:46Z

XiP3rfectx ~: /* Reference */

AR/مقدمه في البرمجه

2011-01-15T14:29:59Z

XiP3rfectx ~: Created page with "Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resourc..."

Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.

Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else. MTA comes with resources that you can optionally use in your gamemodes, such as maplimits to keep playings within a playing area or deathpickups to create weapon pickups.

'''ينبغي أن الخطوة الأولى لبدء برمجة السكريبتات (Lua Scripting) يكون باستخدام برنامج Lua Editor, لكيَ يسهل عليك البرمجة :)
وكذلك تستطيع استخدام المفكرةَ , واذا كنت تستخدم المفكرة فنوصي باستخدام المفكرة++,
المفكرة++: [http://luaedit.sourceforge.net/ LuaEdit]
Lua Scriptng: [http://luaedit.sourceforge.net/ LuaEdit]
وهناك ايضاً برامج اخرى مثل [[MTASE|MTA Script Editor]].'''

==إنشاء برنامج نصي==
سوف نتعلم اولً كيفية عمل سكربت بسيط التي تسمح للاعب يتجول في المدينة , خطوة بـ خطوة ...
===أين مسار كل البرامج النصية (السكريبتات أو المودات)؟===
الان نتعرف على مجلد المودات أو السكربتات.
اذهب إلى مجلد Multi Theft Auto واتبع المسار التالي:

/Your MTA Server/mods/deathmatch/resources/

سترى الكثير من الملفات. ربما ترى مجلدات صيغتها .zip أو مجلد عادي , وجميعها يقبله الـ MTA ..
ولإنشاء المودات الخاصة بك: قم بعمل مجلد جديد واجعل اسمه كما تريد فمثلاً قم بتسميته "myserver" وهو الذي سنستخدمه بالبرنامج التعليمي
والان يجب أن يكون مسار المجلد الذي قمت بعمله هذا:

/Your MTA Server/mods/deathmatch/resources/myserver/

* myserver: اسم المجلد الذي قمت بتسميته

===تعريف السكربت (إضافة ملف meta.xml)===
حتى يستطيع السيرفر من معرفة المودات, يجب علينا إنشاء ملف meta.xml
" ويكون بداخل مجلد السكربت الذي قمنا بإنشائه وهو "myserver"
ولإنشاء ملف meta.xml : أفتح ملف نصي جديد وقم بتسميته meta.xml وافتحه باستخدام المفكرة =)
ولا تنسى ان يكون بداخل مجلد السكربت .

أدخل الكود التالي في ملف ''meta.xml'':
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA DM server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>

في الـ <info ... /> : هنا معلومات السكريبت , فمثلاً الحقل type وضعناه ''gamemode'' بمعنى ان نوع هذا السكربت هو قيم مود ( مود لعب )
وتستطيع وضع ''map'' أو ''script'' او ''misc''
وفي الـ <script ... /> : هنا تضع ملفات السكربت :)

===إنشاء ملف السكربت Lua===
علماً في ملف meta وضعنا هذا السطر:
<script src="script.lua" />
فهذا يعني ننشئ ملف lua بواسطة Lua Scripting أو نفتح ملف نصي جديد , ونقوم بتسميته script.lua ونضعه بمجلد المود
ملآحظة : اسم ملف السكربت بنفس الاسم الذي وضعناه في ملف الميتا ..
هنا محتوى ملف Lua:
<syntaxhighlight lang="lua">
function joinHandler()
local x = 1959.55
local y = -1714.46
local z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
وصف وشرح الكود اعلاه :
سيقوم السكربت بوضع اللاعب في الاحداثيات (x,y,z) المحدده اعلاه, عند دخوله الى السيرفر
لاحظ انه يجب استخدام وظيفة [ ''fadeCamera'' ] ستكون الشاشة سوداء وأيضاً يجب تعيين الكاميرا ( setTargetCamera ) ..

The '''source''' variable indicates who triggered the event. Since a player has joined when the code is triggered, you use this variable to look which has joined. So it'll spawn that player instead of everyone or a random person.

If we have a closer look on [[addEventHandler]], you can see 3 things: 'onPlayerJoin', which indicates when it's triggered. getRootElement(), which shows by what/who it can be triggered. (getRootElement() is everything/everyone) And joinHandler, which indicates the function that has to be triggered after the event is triggered. Other details will be explained later in another example, now let's just run the server and try it out!

===Running the script===
To get the server started, simply run the executable under the MTA DM directory. A list of server stats will be shown first; note the port number, which you'll need when joining the game. Then the server loads all the resources under the /resource/ directory, and then "ready to accept connections!"

Before you connect to the server, you must run the gamemode. Type "gamemode myserver" and press Enter. The server will start the gamemode you just created, and will also show any errors and warnings from this point on. Now you can start the MTA DM client, and "Quick Connect" using the IP address of your server and the port number you saw earlier. If all goes well, after a few seconds your character will be walking on the streets of Los Santos.

Next we'll add a command to your script that players can use to spawn a vehicle beside their position. You may skip it and check out more advanced scripting with the [[Map manager|Map Manager]], which continues this tutorial. Another branch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA:DM is drawn and scripted.

==Creating a simple command==
Let's go back to the content of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.

<syntaxhighlight lang="lua">
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- create a vehicle and stuff
end

-- create a command handler
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''

====About command handlers====
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.

If you have already experience in scripting, you will know that you call a function like this:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
If we have a closer look on the lower example above, we can see argument1 is thePlayer and argument2 the commandName. thePlayer is simply the one who typed the command, so whatever you call it, the variable will contain the player who activated the command. commandName is simply the command they typed. So if they typed "/greet", this argument will contain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 arguments are standard arguments, but you can name them to anything you want.

We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.

For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:
<syntaxhighlight lang="lua">
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command
</syntaxhighlight>
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).

''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''

====Writing the function====
In order to fill the function we created, we need to think about what we have to do:
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)
* Spawn the vehicle
* Check if it has been spawned successfully, or output a message

In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.

For [[getElementPosition]], the syntax is:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. (x, y and z) Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (local means, the variables only exist in the current scope, in this case, the function)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
end
</syntaxhighlight>

Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.

We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.

Now we have our complete script:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- check if the return value was ''false''
if (createdVehicle == false) then
-- if so, output a message to the chatbox, but only to this player.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself. For more advanced scripting, please check out the [[Map manager|Map Manager]].

==What you need to know==
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.
===Clientside and Serverside scripts===
You may have already noticed these or similiar terms (Server/Client) somewhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.

Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].

===More complex resources===
The previous section showed briefly how to add clientside scripts to the resource, but there is also much more possible. As mentioned at the very top of this page, resources can be pretty much everything. Their purpose is defined by what they do. Let's have some theoretical resources, by looking at the files it contains, the ''meta.xml'' and what they might do:

====First example - A utility script====
<syntaxhighlight lang="xml">
/admin_commands
/meta.xml
/commands.lua
/client.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="admin commands" />
<script src="commands.lua" />
<script src="client.lua" type="client" />
</meta>
</syntaxhighlight>

* The ''commands.lua'' provides some admin commands, like banning a player, muting or something else that can be used to admin the server
* The ''client.lua'' provides a GUI to be able to perform the mentioned actions easily

This example might be running all the time (maybe even auto-started when the server starts) as it's useful during the whole gaming experience and also wont interfere with the gameplay, unless an admin decides to take some action of course.

====Second example - A gamemode====
<syntaxhighlight lang="xml">
/counterstrike
/meta.xml
/counterstrike.lua
/buymenu.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike remake" type="gamemode" />
<script src="counterstrike.lua" />
<script src="buymenu.lua" type="client" />
</meta>
</syntaxhighlight>

* The ''counterstrike.lua'' contains similiar to the following features:
** Let players choose their team and spawn them
** Provide them with weapons, targets and instructions (maybe read from a Map, see below)
** Define the game's rules, e.g. when does the round end, what happens when a player dies
** .. and maybe some more
* The ''buymenu.lua'' is a clientside script and creates a menu to buy weapons

This example can be called a gamemode, since it not only intereferes with the gameplay, but actually defines the rules of it. The ''type'' attribute indicates that this example works with the [[Map manager]], yet another resource that was written by the QA Team to manage gamemodes and map loading. It is highly recommended that you base your gamemodes on the techniques it provides.

This also means that the gamemode probably won't run without a map. Gamemodes should always be as generic as possible. An example for a map is stated in the next example.

====Third example - A Map====
<syntaxhighlight lang="xml">
/cs-airport
/meta.xml
/airport.map
/airport.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike airport map" type="map" gamemodes="counterstrike" />
<map src="airport.map" />
<script src="airport.lua" />
</meta>
</syntaxhighlight>

* The ''airport.map'' in a XML file that provides information about the map to the gamemode, these may include:
** Where the players should spawn, with what weapons, what teams there are
** What the targets are
** Weather, World Time, Timelimit
** Provide vehicles
* The ''airport.lua'' might contain map-specific features, that may include:
** Opening some door/make something explode when something specific happens
** Create or move some custom objects, or manipulate objects that are created through the .map file
** .. anything else map-specific you can think of

As you can see, the ''type'' attribute changed to 'map', telling the [[Map manager]] that this resource is a map, while the ''gamemodes'' attribute tells it for which gamemodes this map is valid, in this case the gamemode from the above example.
What may come as a surprise is that there is also a script in the Map resource. Of course this is not necessarily needed in a map, but opens a wide range of possibilities for map makers to create their own world within the rules of the gamemode they create it for.

The ''airport.map'' file might look similiar to this:
<syntaxhighlight lang="xml">
<map mode="deathmatch" version="1.0">
<terrorists>
<spawnpoint posX="2332.23" posY="-12232.33" posZ="4.42223" skins="23-40" />
</terrorists>
<counterterrorists>
<spawnpoint posX="2334.23443" posY="-12300.233" posZ="10.2344" skins="40-50" />
</counterterrorists>

<bomb posX="23342.23" posY="" posZ="" />

<vehicle posX="" posY="" posZ="" model="602" />
<vehicle posX="" posY="" posZ="" model="603" />
</map>
</syntaxhighlight>

When a gamemode is started with a map, the map resources is automatically started by the mapmanager and the information it contains can be read by the gamemode resource. When the map changes, the current map resource is stopped and the next map resource is started. For a more in-depth explanation and examples of how map resources are utilized in the main script, please visit the [[Writing Gamemodes]] page.

===Events===
Events are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].

This example will output a message with the name of the player who died:
<syntaxhighlight lang="lua">
function playerDied(totalAmmo, killer, killerWeapon, bodypart)
outputChatBox(getPlayerName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

Instead of showing what arguments are needed, the documentation page for Events shows what parameters are passed to the handler function, similiar to the way a [[#About_command_handlers|command handler]] does, just that it is different from event to event. Another important point is the ''source'' variable, that exists in handler functions. It doesn't have to be added to the parameter list of the function, but it still exists. It has a different value from event to event, for player events (as in the example above) it is the player element. As another example, you can take a look at the basic spawning player script in the first section to get an idea how ''source'' is used.

==Where to go from here==
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.

From here we recommend reading the [[debugging]] tutorial. Good debugging skills are an absolute necessity when you are making scripts.

[[ru:Scripting Introduction]]
[[it:Introduzione allo scripting]]
[[es:Introducción a la Programación]]

AR/الصفحه الرئيسيه

2011-01-15T13:51:52Z

XiP3rfectx ~: /* السكربتات */

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[دليل اللاعب (Client)]]
* [[دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====السكريبتات====

* [[مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/الصفحه الرئيسيه

2011-01-15T12:14:34Z

XiP3rfectx ~: /* البدء في العمل */

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[دليل اللاعب (Client)]]
* [[دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====السكربتات====

* [[Scripting Introduction|مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/دليل اللاعب

2011-01-15T12:13:04Z

XiP3rfectx ~:

__TOC__

==مقدمة==
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.

==قبل أن تبدأ==

قبل تثبيت MTA:SA , تأكد أولاً من عدم وجود أي تعديلات لـ GTA:SA وهذه تتعارض مع MTA.
إذا كنت ترغب في الحفاظ على التعديل الخاص بالسينقل بلآير ( لاعب واحد ), تستطيع تثبيتَ GTASA أخر على القرص الاخر بجهازك
وتأكد أيضا من ان تقوم بتشغيل "Windows XP" أوَ "Windows 2000" أوَ "Windows Vista"
أوَ "Windows server 2003" وهذا الجهاز الخاص بك قادر على تشغيل اللعبة بنظام السينقل بلآير ..
لاحظ أنه إذا كنت تقوم بتشغيل ( السينقل بلآير ) على الحد الادنى لمتطلبات تشغيل اللعبة , سوف تؤاجه بطئ في MTA ..

* ملآحظة : MTA:SA تعمل فقط على GTA:SA v1.0.. إذا كنت قد اشتريت اللعبة مؤخراً, فمن المحتمل أن يكون لديك إصدار لاحق

إذا كان للديك مشكلة او استفسار , [[Known_Issues_-_FAQ|Known Issues]]
أو عبر الدخول الى mIRC :
irc://irc.multitheftauto.com/mta

===متطلبات النظام===
متطلبات النظام الادنى:
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

ميزات اضافية: من المستحسن بأن يكون كرت الفيديو:
* nVidia GeForce FX series أو أعلىَ
* ATI Radeon 9xxx series أو اعلى

==تثبيت اللعبة==

'''This section will need to be updated when we get an installer'''

# If you haven't already, download the MTA:SA client from the download page at mtasa.com.
# Run the installer. You will be asked which components to install:
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==شرح تشغيل اللعبة==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – this allows you to start a local server. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

==شرح كيفية اللعب==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==التحكم==

===المفاتيح داخل اللعبة===

* F8 (or Tilde Key) - Console
* F9 - In-game help
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==أوامر الكونسول==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''sver''' :This displays the version number of the server you are connected to.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

==رموز الخطأ ومعانيها==
'''Download errors'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

==Special: Playing MTA on Linux?==
If you're one of those who have Linux as OS, and want to have the client working on Linux,
please read the [[Client_on_Linux_Manual|Client on Linux Manual]]

[[es:Manual Cliente Deathmatch]]
[[de:MTA DM Client Anleitung]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

AR/دليل اللاعب

2011-01-15T12:09:57Z

XiP3rfectx ~:

__TOC__

==Introduction==
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.

==قبل أن تبدأ==

قبل تثبيت MTA:SA , تأكد أولاً من عدم وجود أي تعديلات لـ GTA:SA وهذه تتعارض مع MTA.
إذا كنت ترغب في الحفاظ على التعديل الخاص بالسينقل بلآير ( لاعب واحد ), تستطيع تثبيتَ GTASA أخر على القرص الاخر بجهازك
وتأكد أيضا من ان تقوم بتشغيل "Windows XP" أوَ "Windows 2000" أوَ "Windows Vista"
أوَ "Windows server 2003" وهذا الجهاز الخاص بك قادر على تشغيل اللعبة بنظام السينقل بلآير ..
لاحظ أنه إذا كنت تقوم بتشغيل ( السينقل بلآير ) على الحد الادنى لمتطلبات تشغيل اللعبة , سوف تؤاجه بطئ في MTA ..

* ملآحظة : MTA:SA تعمل فقط على GTA:SA v1.0.. إذا كنت قد اشتريت اللعبة مؤخراً, فمن المحتمل أن يكون لديك إصدار لاحق

إذا كان للديك مشكلة او استفسار , [[Known_Issues_-_FAQ|Known Issues]]
أو عبر الدخول الى mIRC :
irc://irc.multitheftauto.com/mta

===متطلبات النظام===
متطلبات النظام الادنى:
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

ميزات اضافية: من المستحسن بأن يكون كرت الفيديو:
* nVidia GeForce FX series أو أعلىَ
* ATI Radeon 9xxx series أو اعلى

==تثبيت اللعبة==

'''This section will need to be updated when we get an installer'''

# If you haven't already, download the MTA:SA client from the download page at mtasa.com.
# Run the installer. You will be asked which components to install:
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – this allows you to start a local server. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

==How to Play==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==Controls==

===In-Game Keys===

* F8 (or Tilde Key) - Console
* F9 - In-game help
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''sver''' :This displays the version number of the server you are connected to.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

==Error codes and their meanings==
'''Download errors'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

==Special: Playing MTA on Linux?==
If you're one of those who have Linux as OS, and want to have the client working on Linux,
please read the [[Client_on_Linux_Manual|Client on Linux Manual]]

[[es:Manual Cliente Deathmatch]]
[[de:MTA DM Client Anleitung]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

AR/دليل اللاعب

2011-01-15T11:52:48Z

XiP3rfectx ~:

__TOC__

==Introduction==
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.

==Before you start==

Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.

Also make sure that you are running '''Windows XP''', '''Windows 2000''', '''Windows Vista''' or '''Windows Server 2003''' and that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.

'''Note: MTA:SA will only work on GTA:SA v1.0.''' If you bought the game recently, it is likely that you have a later version.

Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on IRC @ irc://irc.multitheftauto.com/mta

===System requirements===
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

For extra features, a pixel shader 2.0 compatible videocard (nVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.

For extra loading performance, more RAM is recommended.

==Installing the game==

'''This section will need to be updated when we get an installer'''

# If you haven't already, download the MTA:SA client from the download page at mtasa.com.
# Run the installer. You will be asked which components to install:
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font>

<br />
|-
| width="188" |
[[Image:Server_Browser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font>

<br />
|-
| width="188" |
[[Image:Host_Game.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – this allows you to start a local server. </font>

<br />
|-
| width="188" |
[[Image:Menu_Settings.JPG|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font>

<br /><br />
|-
| width="188" |
[[Image:About_Menu.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

==How to Play==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==Controls==

===In-Game Keys===

* F8 (or Tilde Key) - Console
* F9 - In-game help
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''sver''' :This displays the version number of the server you are connected to.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

==Error codes and their meanings==
'''Download errors'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

==Special: Playing MTA on Linux?==
If you're one of those who have Linux as OS, and want to have the client working on Linux,
please read the [[Client_on_Linux_Manual|Client on Linux Manual]]

[[es:Manual Cliente Deathmatch]]
[[de:MTA DM Client Anleitung]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

AR/الصفحه الرئيسيه

2011-01-15T11:48:42Z

XiP3rfectx ~: /* البدء في العمل */

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[دليل اللاعب (Client)]]
* [[Server_Manual|دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====السكربتات====

* [[Scripting Introduction|مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/دليل اللاعب

2011-01-15T11:48:08Z

XiP3rfectx ~: /* تجربة */

AR/دليل اللاعب

2011-01-15T11:47:41Z

XiP3rfectx ~: Created page with "== تجربة =="

== تجربة ==

AR/الصفحه الرئيسيه

2011-01-15T10:40:12Z

XiP3rfectx ~: /* قائمة المعرفات */

<div dir="rtl" style="background: #FFCFCF; padding: 5px; font-weight:bold; border: 1px dotted #AAAAAA;padding:10px;margin:10px;"> وضعت هذه الصفحه للتسهيل على المبرمجين العرب بوضع الإوامر والشروحات باللغه العربيه .. برعاية [http://forum.esports.com.sa eSports]&[http://mta-ar.com Mta-AR] </div>

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[Client_Manual|دليل اللاعب (Client)]]
* [[Server_Manual|دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====السكربتات====

* [[Scripting Introduction|مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]

AR/الصفحه الرئيسيه

2011-01-15T10:36:24Z

XiP3rfectx ~:

<div dir="rtl" style="background: #FFCFCF; padding: 5px; font-weight:bold; border: 1px dotted #AAAAAA;padding:10px;margin:10px;"> وضعت هذه الصفحه للتسهيل على المبرمجين العرب بوضع الإوامر والشروحات باللغه العربيه .. برعاية [http://forum.esports.com.sa eSports]&[http://mta-ar.com Mta-AR] </div>

<div dir="rtl" style="background: #FFEEAA; padding: 5px; float:left; width: 30%;">أخر اصدار رسمي لـ '''Multi Theft Auto: San Andreas''' هو '''{{Current Version|full}}'''. قم بزياره [http://mtasa.com/ الصفحه الرئيسيه] والحصول عليه.
يمكنك معرفه اخر الإصدارات التجريبيه عن طريق [http://nightly.mtasa.com/ nightly build] وتحميل اخر نسخه صادره.
</div>
__NOTOC__
<p align="right">
أهلاً وسهلاً بكم في الصفحة العربيه للويكي

هناك العديد من [[كيف يمكنك المساعده|الإشياء الممكن ان تساعدنا بها]] كصنع خريطه وصنع مود

اذا كان لديك اي اسئله ومشاكل تتعلق بالبرمجه لاتتردد بالاتصال بنا عبر [[IRC Channel|قناة الاي ار سي]].
</p>
<div dir="rtl" style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====البدء في العمل====
* [[Client_Manual|دليل اللاعب (Client)]]
* [[Server_Manual|دليل السيرفر (Server)]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]]
* [[Upgrading_from_MTA:Race|المهاجره من MTA:RACE الى MTA 1.x]]
* [[Map_manager|ادارة الخرائط]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====السكربتات====

* [[Scripting Introduction|مقدمه في البرمجه]]
* [[مقدمه في برمجة gui]]
* [[Debugging|دروس التصحيح]] - كيفية البحث عن الاخطاء في السكربت
* [[Resources|مقدمه في Resources]]
** [[Resource Web Access|صلاحية الصفحه للمود]] - كيف يمكنك ان تربط الموقع مع المود
** [[:Category:Resource|Resource Catalogue]]
** [[Meta.xml]]
* [[Writing_Gamemodes|Writing Gamemodes]]
* [[Useful_Functions|Useful functions]]

</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====قواعد البيانات====
يوضح هذا القسم كل امكانيات لغة LUA
* [[:Category:Resource|Resource دليل]] - يجب عليك ان تتعلم لجعل هذه النصوص صحيحه
* [[Client side scripts]]
</div>
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA البرمجه في" Manual]
**[http://www.lua.org/manual/5.1/#index Internal Lua functions reference]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html A general guide to Lua from Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====صنع الخرائط====
*[[Resource:Editor|الدليل]]
*[[Resource:Editor/EDF|EDF صيغة]]
*[[Resource:Editor/Plugins|الاضافات]]
*[[Resource:Editor#FAQ|س/ج]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====تطوير Multi Theft Auto====
* [[Compiling_MTASA|MTASA على Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|MTASA على Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|MTASA على GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue على Google Code SVN]
* [[Roadmap]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[Server Scripting Functions|Server-side Functions]]
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>

<div dir="rtl" style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|المواتر]]
*[[Vehicle Colors|الوان المواتر]]
*[[Vehicle Upgrades|اضافات المواتر]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[de:Hauptseite]]
[[es:Pagina Principal]]