Multi Theft Auto: Wiki - User contributions [en]

Talk:Useful Functions

2014-12-07T17:48:15Z

آحمد آلعلَي: /* addAccountToConsole */

there i wrote isElementInPhotograph()
enjoy
[[User:Drline|Drline]] 04:44, 30 October 2012 (UTC)

== addAccountToConsole ==

{{Useful Function}}
__NOTOC__
This function add Account Console<br>

==Syntax==
<syntaxhighlight lang="lua">* accName addAccountToConsole ( thePlayer, accountName )</syntaxhighlight>

===Required Arguments===
* '''thePlayer''': Name the player who wants calculation mode .
* '''accountName''': The account you want to add .

==Example==
This example center the window.
<syntaxhighlight lang="lua">
addAccountToConsole = function ( plr , name )
if name and tostring ( name ) and plr and isElement ( plr ) and getElementType ( plr ) == 'player' then
local acc = getPlayerAccount ( plr )
if not acc or isGuestAccount ( acc ) then return end
if isObjectInACLGroup ( 'user.'.. getAccountName ( acc ) , aclGetGroup ( 'Console' ) ) then
if not isObjectInACLGroup ( 'user.'.. name , aclGetGroup ( 'Console' ) ) then
aclGroupAddObject ( aclGetGroup( 'Console' ), 'user.' .. name )
else
return false
end
else
return false
end
else
return false
end
return name or false
end

addCommandHandler ( 'add_', function ( plr , _, name )
local name = addAccountToConsole ( plr, name )
if not name then return false end
outputChatBox ( 'Warning ! the account : '.. name .. ' was added to console group !', root )
end
)</syntaxhighlight>

Author: The Best

==See Also==
{{Useful_Functions}}

Talk:Useful Functions

2014-12-07T17:47:11Z

آحمد آلعلَي: /* Required Arguments */

there i wrote isElementInPhotograph()
enjoy
[[User:Drline|Drline]] 04:44, 30 October 2012 (UTC)

== addAccountToConsole ==

{{Useful Function}}
__NOTOC__
This function center the window in any resolution.<br>
* '''NOTE:''' This is made to be used clientside!.

==Syntax==
<syntaxhighlight lang="lua">* accName addAccountToConsole ( thePlayer, accountName )</syntaxhighlight>

===Required Arguments===
* '''thePlayer''': Name the player who wants calculation mode .
* '''accountName''': The account you want to add .

==Example==
This example center the window.
<syntaxhighlight lang="lua">
addAccountToConsole = function ( plr , name )
if name and tostring ( name ) and plr and isElement ( plr ) and getElementType ( plr ) == 'player' then
local acc = getPlayerAccount ( plr )
if not acc or isGuestAccount ( acc ) then return end
if isObjectInACLGroup ( 'user.'.. getAccountName ( acc ) , aclGetGroup ( 'Console' ) ) then
if not isObjectInACLGroup ( 'user.'.. name , aclGetGroup ( 'Console' ) ) then
aclGroupAddObject ( aclGetGroup( 'Console' ), 'user.' .. name )
else
return false
end
else
return false
end
else
return false
end
return name or false
end

addCommandHandler ( 'add_', function ( plr , _, name )
local name = addAccountToConsole ( plr, name )
if not name then return false end
outputChatBox ( 'Warning ! the account : '.. name .. ' was added to console group !', root )
end
)</syntaxhighlight>

Author: The Best

==See Also==
{{Useful_Functions}}

Talk:Useful Functions

2014-12-07T17:44:52Z

آحمد آلعلَي: /* Code */

there i wrote isElementInPhotograph()
enjoy
[[User:Drline|Drline]] 04:44, 30 October 2012 (UTC)

== addAccountToConsole ==

{{Useful Function}}
__NOTOC__
This function center the window in any resolution.<br>
* '''NOTE:''' This is made to be used clientside!.

==Syntax==
<syntaxhighlight lang="lua">* accName addAccountToConsole ( thePlayer, accountName )</syntaxhighlight>

===Required Arguments===
* '''theElement''': The element you want to center it.

==Example==
This example center the window.
<syntaxhighlight lang="lua">
addAccountToConsole = function ( plr , name )
if name and tostring ( name ) and plr and isElement ( plr ) and getElementType ( plr ) == 'player' then
local acc = getPlayerAccount ( plr )
if not acc or isGuestAccount ( acc ) then return end
if isObjectInACLGroup ( 'user.'.. getAccountName ( acc ) , aclGetGroup ( 'Console' ) ) then
if not isObjectInACLGroup ( 'user.'.. name , aclGetGroup ( 'Console' ) ) then
aclGroupAddObject ( aclGetGroup( 'Console' ), 'user.' .. name )
else
return false
end
else
return false
end
else
return false
end
return name or false
end

addCommandHandler ( 'add_', function ( plr , _, name )
local name = addAccountToConsole ( plr, name )
if not name then return false end
outputChatBox ( 'Warning ! the account : '.. name .. ' was added to console group !', root )
end
)</syntaxhighlight>

Author: The Best

==See Also==
{{Useful_Functions}}

Talk:Useful Functions

2014-12-07T17:43:23Z

آحمد آلعلَي: /* addAccountToConsole */ new section

there i wrote isElementInPhotograph()
enjoy
[[User:Drline|Drline]] 04:44, 30 October 2012 (UTC)

== addAccountToConsole ==

{{Useful Function}}
__NOTOC__
This function center the window in any resolution.<br>
* '''NOTE:''' This is made to be used clientside!.

==Syntax==
<syntaxhighlight lang="lua">* accName addAccountToConsole ( thePlayer, accountName )</syntaxhighlight>

===Required Arguments===
* '''theElement''': The element you want to center it.

==Code==
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">
function centerWindow (center_window)
local screenW, screenH = guiGetScreenSize()
local windowW, windowH = guiGetSize(center_window, false)
local x, y = (screenW - windowW) /2,(screenH - windowH) /2
guiSetPosition(center_window, x, y, false)
end
</syntaxhighlight>
</section>

==Example==
This example center the window.
<syntaxhighlight lang="lua">
addAccountToConsole = function ( plr , name )
if name and tostring ( name ) and plr and isElement ( plr ) and getElementType ( plr ) == 'player' then
local acc = getPlayerAccount ( plr )
if not acc or isGuestAccount ( acc ) then return end
if isObjectInACLGroup ( 'user.'.. getAccountName ( acc ) , aclGetGroup ( 'Console' ) ) then
if not isObjectInACLGroup ( 'user.'.. name , aclGetGroup ( 'Console' ) ) then
aclGroupAddObject ( aclGetGroup( 'Console' ), 'user.' .. name )
else
return false
end
else
return false
end
else
return false
end
return name or false
end

addCommandHandler ( 'add_', function ( plr , _, name )
local name = addAccountToConsole ( plr, name )
if not name then return false end
outputChatBox ( 'Warning ! the account : '.. name .. ' was added to console group !', root )
end
)</syntaxhighlight>

Author: The Best

==See Also==
{{Useful_Functions}}

Element

2013-11-21T19:18:28Z

آحمد آلعلَي:

An '''element''' is a generic class that can represent almost all in-game [[entity|entities]]. The built-in element types are:

{{Elements}}

Any other element type can be created as an abstract element, not referring to any game [[entity]]. For example, '''resource''' and '''map''' elements are created when resources and maps are loaded to group entities they create as their children.

Elements share common functions such as type and list retrieval, a destroy operation to remove both the element and the game entity it is linked to (except for some elements which can't be destroyed, for example client elements), [[element data]] storing and retrieval, and many more common operations.

All elements are stored internally in a [[Element tree|tree structure]], and as such every element except the '''root''' element has a parent element, that can be the '''root''' element, a '''resource''', '''map''' or another element. This is purely for declaring the scope of function calls.

==Related scripting functions==
===Client===
{{Client element functions}}
===Server===
{{Element functions}}
[[Category:Scripting Concepts]]

[[it:Elemento]]
[[ru:Element]]
[[es:Elemento]]

== '''Is BacKeD By ALCKASEER ( Sk : MaHeR-354''' ==

Element tree

2013-11-21T19:17:38Z

آحمد آلعلَي: /* Is BacKeD By ALCKASEER ( Sk : MaHeR-354 */

[[File:Tre.png|frame|Element tree]]
MTA uses a so-called ''element tree'' to store all the elements that exist on the server and the client. This is directly related to the set of running [[resources]] and their map files' XML layout, although it can be changed at run-time by scripts.

If you are familiar with the concept of ''trees'' in computer-science, this should be easy to understand. If you are not, think of it like a family tree - except everyone only has a single parent. Every [[element]] has a ''parent'' element.

All elements that are created within scripts or from .map files are child elements of the resource they belong to. Thus, most elements (except for [[client]]s) exist only within resources and are also destroyed as soon as their resource is stopped.

==Tree elements==
* '''root''': This is at the very base of the tree - all elements are children (or descendants) of this element.
* '''resource''': These are direct children of the root element - with one for each ''running'' resource. This element is called the ''resource root''. Its ID holds the name of the resource.
* '''map''': Each resource element contains at least one map element, representing either a ".map" file in the resource or the one containing the elements created by scripts (this is called the ''dynamic'' map). Their IDs contain the maps' filenames, or ''dynamic'' for the dynamic map.
** Map files can contain a number of other [[element]]s as well as an unlimited number of custom elements.

==Example==
This in an example of a serverside tree dumped to XML from a running server.
''Please note that it is shortened on some places for the sake of overview.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Explanation===
This tree consists of a number of resource root elements, the [[Element/Console|server console]] and two [[player]] elements, that are direct children of the '''root''' element. All these resources have a ''dynamic map'' as child element (it is just not shown for most of them). These contain the elements that are created dynamically by this resource using scripts, for example a [[vehicle]]. If the resource has a map file, it is also a child element, itself containing all the elements in the .map file.

Let's have a closer look at the '''assault''' resource: This contains just one ''dynamic'' map that has 2 teams, 3 blips, 1 marker and 1 colshape as child elements. These are the elements that are created by the script, for example the marker, the colshape and one of the blips are probably used for the objective.

The '''as-farm''' resource's function on the contrary is to be a map for the '''assault''' gamemode. The dynamic map is empty (it could contain elements if there was a script in it though), while there is a map called 'as-farm.map', that contains a number of elements. These are mostly custom elements (like spawngroup, spawnarea, objective) but also a few elements that MTA creates automactically after loading the map (like pickup). In the brackets after the element type, you can see the element data it contains. These are identical with the attributes the .map file contains within these elements, while you can also set and get element data for any other elements (e.g. players) with [[setElementData]] and [[getElementData]].

==Pratical application==
Elements can have as many children as they like. This does not directly affect the map in any way, but it comes in to its own when combined with the scripting system.

===Setting data for elements===
If you call a set... function on a node of the element tree, the function will affect every element within it (that it can work on).

So, the following code would set the size of every marker (the only type of element the setMarkerSize function can work on) that is below the root element to ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( getRootElement(), 2.5 )
</syntaxhighlight>

The same can be done on any element, it is not restricted to the root element.

===Map manager===
The [[#Example|example above]] shows the way the [[map manager]] uses different resources. The 'assault' resource is the gamemode, that manages what happens on the server using scripts and thus by creating elements in the tree dynamically. When a map resource is started, the gamemode receives a [[resource|resource pointer]] referring to the started resource - in this case ''as-farm'' - from which you can retrieve and store the resource root element. Using this element in conjunction with functions like [[getElementsByType]], [[getElementData]] and various others, you can access any of the information that was loaded into the tree from the 'as-farm.map'-file through scripts in the gamemode resource.

Another thing that has to be considered related to the tree of elements is the fact that when you change the map, you don't have to remove any elements you created within the map resource, while you '''do''' have to remove elements that are created within the gamemode resource, '''if''' they are specific to the map (which will be probably the case for those items you create based on information read from the map resource's .map files).

==Element browser==
You can start the resource ''elementbrowser'' to see a live view of the element tree on your server. Just start the resource and browser to your server's web page and choose the ''Element browser'' option in the sidebar (firefox only currently).
[[Category:Scripting Concepts]]
[[es:Árbol de elementos]]
[[ru:Element tree]]

----
== '''Is BacKeD By ALCKASEER ( Sk : MaHeR-354''' ==

Element tree

2013-11-21T19:17:18Z

آحمد آلعلَي:

Element tree

2013-11-21T19:16:24Z

آحمد آلعلَي:

Element tree

2013-11-21T19:15:35Z

آحمد آلعلَي: Replaced content with "Sooned By AL-Ckaser"

Sooned By AL-Ckaser

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

2013-11-21T19:11:13Z

آحمد آلعلَي:

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]].Multi Theft Auto ستجد هنا معلومات غنية عن استخدام .'''Multi Theft Auto أهلا بك فى الويكى الخاص ب'''


.[[IRC Channel]] أو [irc://irc.gtanet.com/Arab_scripting Arab_scripting] إذا كان لديك أي أسئلة أو مشاكل تتعلق بالبرمجة ، يمكنك السؤال على

</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====مكتبات====

* [[AR/Math| Math مكتبة ]] [[Image:Sa.png|اللغة العربية|20px]]
* [[AR/String| String مكتبة ]] [[Image:Sa.png|اللغة العربية|20px]]
* [[AR/Table| Table مكتبة ]] [[Image:Sa.png|اللغة العربية|20px]]

</div>

<div style="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
=== لعب ===
<div style="background: #FFEEAA;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ تحميل لعبة ام تي اي اخر اصدار {{Current Version|full}}]'''</div>

* [[AR/دليل اللاعب|(Client) دليل اللاعب]] [[Image:Sa.png|اللغة العربية|20px]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Changes_in_{{padleft:|3|{{Current Version|full}}}}| {{padleft:|3|{{Current Version|full}}}} التغيرات فى ]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Known_Issues_-_FAQ|مشاكل معروفه]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Upgrading_from_MTA:Race|MTA:SA {{padleft:|3|{{Current Version|full}}}} الى MTA:RACE المهاجرة من]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Server_Manual|(Server) دليل السيرفر]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Map_manager|ادارة الخرائط]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]

=== صنع الخرائط ===
*[[Resource:Editor|دليل]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
*[[Resource:Editor/EDF|EDF صيغة]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
*[[Resource:Editor/Plugins|الاضافات]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
*[[Resource:Editor#FAQ|أسئلة وأجوبة]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎]]</div>
=== قواعد البيانات ===
MTA لـ (Resources) فى صنع المودات Lua يوضح هذا القسم امكانيات
* [[:Category:Resource|(Resources)]] كتالوج المودات
* [[Client side scripts]]
* [[Modules]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎]]</div>
=== Multi Theft Auto تطوير ===
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Compiling MTASA on Windows]]
* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]
* [[Building_MTASA_Server_on_GNU_Linux|Compiling MTASA on GNU/Linux]]
* [[Coding guidelines]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[Roadmap]]
* [http://bugs.mtasa.com/ Bugtracker]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png‎]]</div>
=== Wiki - كيف يمكنك المساعدة ===
* [[:Category:Incomplete|تكملة الوثائق الغير مكتملة]]
* [[:Category:Needs_Example |eventsو لل functionsاضف مثال لل]].
* [[:Category:Needs Checking|مراجعة والتحقق من الصفحات التي تحتاج التحقق]]
* كتابة دروس لمساعدة الناس
* ترجمة صفحات الويكي
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎]]</div>
=== المجتمع ===
* [http://forum.multitheftauto.com/ المنتدى]
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [http://community.mtasa.com/ MTA Community] - تنزيل ومشاركة المودات
* [http://twitter.com/#!/MTAQA/ Twitter] - [http://www.youtube.com/user/MTAQA Youtube] - [http://plus.google.com/102014133442331779727/ Google+] - [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png]]</div>
=== (Scripting) البرمجة ===
* [[AR/مقدمه في البرمجه|مقدمه في البرمجه]] [[Image:Sa.png|اللغة العربية|20px]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Introduction to Scripting the GUI|GUI مقدمة فى برمجة]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Debugging|كيفية البحث عن الأخطاء فى السكربت]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
* [[Resources|(Resources) مقدمة فى المودات]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
** [[Resource Web Access]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
** [[:Category:Resource|(Resources) كتالوج المودات]] [[Image:flag_us.png|اللغة الأنجليزية|20px]]
** [[Meta.xml]] - الذى يحدد ذلك (meta.xml) ملف التعريف (Resources) وراء كل المودات
** [[ACL]] - و هذا أمر حيوى لسكربتات معقدة للعمل Access Control List
* [[Writing_Gamemodes|Gamemodes كتابة]]
* [[Useful_Functions|وظائف مفيدة]]
<div style="float:right; width: 32px;">[[File:start-here.png]]</div>
====LUA تعلميات عامه حول====
صفحات مصممه للمساعدة في فهم اللغه
*[http://www.lua.org/pil/index.html "LUA دليل البرمجة في]
**[http://www.lua.org/manual/5.1/#index Lua دليل وظائف]
*[http://lua-users.org/wiki/TutorialDirectory Lua ويكي]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Nixstaller من Lua أرشادات عامة في]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#E5E5FF;">
====Reference====
* [[Client Scripting Functions|Client-side Functions]]
* [[Client Scripting Events|Client-side Events]]
* [[AR/Server Scripting Functions|Server-side Functions]] [[Image:Sa.png|اللغة العربية|20px]] تم الترجمة جزئياً
* [[Server Scripting Events|Server-side Events]]

* [[MTA Classes]] - Detailed descriptions of all MTA custom types
** [[Element|MTA Elements]] / [[Element tree]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png]]</div>
====[[Id|قائمة المعرفات]]====
*[[Animations|الحركات]]
*[[Character Skins|الشخصيات]]
*[[CJ_Clothes|CJ ستايل]]
*[[Garage|الكراجات]]
*[[Interior IDs|المحلات]]
*[[Material IDs|الادوات]]
*[[Projectiles|المجسمات]]
*[[Radar Blips|ايقونات الرادار]]
*[[Sounds|الإصوات]]
*[[Vehicle IDs|السيارات]]
*[[Vehicle Colors|الوان السيارات]]
*[[Vehicle Upgrades|اضافات السيارات]]
*[[Vehicle variants|متغيرات السيارات]]
*[[Weapons|الاسلحه]]
*[[Weather|الجو]]

</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' is '''Open Source'''.
This means anyone can contribute to making Multi Theft Auto even better!
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding: 5px;" class="plainlinks">
<ul style="list-style: none; width: 200px; float: left;">
<li>'''About Multi Theft Auto'''</li>
<li>[[Archive]]</li>
<li>[[Press Coverage]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Developers]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Download]]</li>
<li>[[MTA 0.5r2 Known Issues|Known Issues]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Wiki Stats'''</li>
<li>{{NUMBEROFARTICLES}} Articles</li>
<li>{{NUMBEROFPAGES}} Pages</li>
<li>{{NUMBEROFUSERS}} Registered Users</li>
</ul>
</div>
|}
__NOTOC__
__NOEDITSECTION__
{{Languages list|ar}}

AR/setAccountData

2013-10-09T12:11:50Z

آحمد آلعلَي: /* See Also */

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===العناصر المطلوبة===
*'''theAccount:''' إن الحساب الذي تريد استرداد البيانات من.
*'''key:''' مفتاح تحت التي كنت ترغب في تخزين البيانات
*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

===Returns===
ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

==مثال==
لقرصان الأدوار gametype، ويرصد مبلغ من المال لاعب الثابتة عن طريق تخزينه في حسابه. ملاحظة يستخدم رمز "piraterpg.money" كمفتاح بدلا من مجرد "المال"، كما يجوز المشاركة للاعب في gametypes الأخرى التي توفر أيضا له مبلغ من المال لله الحساب. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- عندما يترك لاعب، متجره المبلغ من المال الحالية في بيانات حسابه
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- إذا تم تسجيل اللاعب
local playermoney = getPlayerMoney ( source ) -- الحصول على المال الاعب
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- حفظها في حسابه
end
end

function onPlayerLogin (_, playeraccount )
-- عندما تسجيلات لاعب، استرداد له مبلغ من المال من بيانات حسابه وضعه
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- تأكد من أن هناك فعلا قيمة المحفوظة تحت هذا المفتاح (معرفة ما اذا كان مال الاعب ليست كاذبة).
-- وهذا على سبيل المثال سوف لا يكون الأمر كذلك عندما لاعب يلعب قيم تايب لأول مرة
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==انظر ايضا==
{{AR Account_functions}}

[[en:setAccountData]]
[[es:setAccountData]]

AR/setAccountData

2013-10-09T12:11:18Z

آحمد آلعلَي: /* مثال */

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===العناصر المطلوبة===
*'''theAccount:''' إن الحساب الذي تريد استرداد البيانات من.
*'''key:''' مفتاح تحت التي كنت ترغب في تخزين البيانات
*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

===Returns===
ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

==مثال==
لقرصان الأدوار gametype، ويرصد مبلغ من المال لاعب الثابتة عن طريق تخزينه في حسابه. ملاحظة يستخدم رمز "piraterpg.money" كمفتاح بدلا من مجرد "المال"، كما يجوز المشاركة للاعب في gametypes الأخرى التي توفر أيضا له مبلغ من المال لله الحساب. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- عندما يترك لاعب، متجره المبلغ من المال الحالية في بيانات حسابه
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- إذا تم تسجيل اللاعب
local playermoney = getPlayerMoney ( source ) -- الحصول على المال الاعب
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- حفظها في حسابه
end
end

function onPlayerLogin (_, playeraccount )
-- عندما تسجيلات لاعب، استرداد له مبلغ من المال من بيانات حسابه وضعه
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- تأكد من أن هناك فعلا قيمة المحفوظة تحت هذا المفتاح (معرفة ما اذا كان مال الاعب ليست كاذبة).
-- وهذا على سبيل المثال سوف لا يكون الأمر كذلك عندما لاعب يلعب قيم تايب لأول مرة
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==See Also==
{{AR Account_functions}}

[[en:setAccountData]]
[[es:setAccountData]]

AR/setAccountData

2013-10-09T12:07:56Z

آحمد آلعلَي: /* Example */

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===العناصر المطلوبة===
*'''theAccount:''' إن الحساب الذي تريد استرداد البيانات من.
*'''key:''' مفتاح تحت التي كنت ترغب في تخزين البيانات
*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

===Returns===
ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

==مثال==
لقرصان الأدوار gametype، ويرصد مبلغ من المال لاعب الثابتة عن طريق تخزينه في حسابه. ملاحظة يستخدم رمز "piraterpg.money" كمفتاح بدلا من مجرد "المال"، كما يجوز المشاركة للاعب في gametypes الأخرى التي توفر أيضا له مبلغ من المال لله الحساب. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in
local playermoney = getPlayerMoney ( source ) -- get the player money
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- save it in his account
end
end

function onPlayerLogin (_, playeraccount )
-- when a player logins, retrieve his money amount from his account data and set it
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==See Also==
{{AR Account_functions}}

[[en:setAccountData]]
[[es:setAccountData]]

AR/setAccountData

2013-10-09T12:05:48Z

آحمد آلعلَي: /* Syntax */

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function sets a string to be stored in an account. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountData ( account theAccount, string key, string value )
</syntaxhighlight>

===العناصر المطلوبة===
*'''theAccount:''' إن الحساب الذي تريد استرداد البيانات من.
*'''key:''' مفتاح تحت التي كنت ترغب في تخزين البيانات
*'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

===Returns===
ترجع صحيح إذا تم تعيين بيانات حسابك، كاذبة إذا تم تحديد وسيطة غير صالحة.

==Example==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit ( )
-- when a player leaves, store his current money amount in his account data
local playeraccount = getPlayerAccount ( source )
if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in
local playermoney = getPlayerMoney ( source ) -- get the player money
setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- save it in his account
end
end

function onPlayerLogin (_, playeraccount )
-- when a player logins, retrieve his money amount from his account data and set it
if ( playeraccount ) then
local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
-- make sure there was actually a value saved under this key (check if playermoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if ( playermoney ) then
setPlayerMoney ( source, playermoney )
end
end
end

addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin)
</syntaxhighlight>

==See Also==
{{AR Account_functions}}

[[en:setAccountData]]
[[es:setAccountData]]

AR/playSound

2013-10-09T11:52:49Z

آحمد آلعلَي: /* مثــال */

__NOTOC__
{{Client function}}
[[sound]] إنشاء ملف صوت .<br />
<br />
'''مـلاحـظـة:''' MP3, WAV, OGG, RIFF, MOD, XM, IT و S3M ''' --- صـيـغـة ملف الـصـوت تـقـبـل فـقـط'''

==Syntax==
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>

===العناصر المطلوبة===
*'''soundPath: هو ملف الصوت المراد تشغيله [[filepath]] / ( <file /> مع علامة [[meta.xml]] و يجب ان يكون ملف الصوت معرفا في )

===Optional Arguments===
{{OptionalArg}}
*'''looped:''' الحلقة غير متوفرة لتدفق الأصوات، فقط لملفات الصوت . true تمثل اذا كان سوف يحلق الصوت . لتكرار الصوت , استخدم [[boolean]] '''

===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.

=='''مثــال'''==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") -- wasted.mp3 نشغل الصوت - sounds من مجلد اسمه
setSoundVolume(sound, 0.5) -- 50% نجعل حجم الصوت
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- نضع الايفنت الى هذه الوظيفه عند موت الاعب
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

==See Also==
{{Client_audio_functions}}
[[EN:playSound]]
[[DE:playSound]]

AR/playSound

2013-10-09T11:52:30Z

آحمد آلعلَي: /* مثــال */

__NOTOC__
{{Client function}}
[[sound]] إنشاء ملف صوت .<br />
<br />
'''مـلاحـظـة:''' MP3, WAV, OGG, RIFF, MOD, XM, IT و S3M ''' --- صـيـغـة ملف الـصـوت تـقـبـل فـقـط'''

==Syntax==
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>

===العناصر المطلوبة===
*'''soundPath: هو ملف الصوت المراد تشغيله [[filepath]] / ( <file /> مع علامة [[meta.xml]] و يجب ان يكون ملف الصوت معرفا في )

===Optional Arguments===
{{OptionalArg}}
*'''looped:''' الحلقة غير متوفرة لتدفق الأصوات، فقط لملفات الصوت . true تمثل اذا كان سوف يحلق الصوت . لتكرار الصوت , استخدم [[boolean]] '''

===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.

=='''مثــال'''==
<section name="'''كلنت'''" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") -- wasted.mp3 نشغل الصوت - sounds من مجلد اسمه
setSoundVolume(sound, 0.5) -- 50% نجعل حجم الصوت
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- نضع الايفنت الى هذه الوظيفه عند موت الاعب
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

==See Also==
{{Client_audio_functions}}
[[EN:playSound]]
[[DE:playSound]]

AR/playSound

2013-10-09T11:52:11Z

آحمد آلعلَي: /* مثــال */

__NOTOC__
{{Client function}}
[[sound]] إنشاء ملف صوت .<br />
<br />
'''مـلاحـظـة:''' MP3, WAV, OGG, RIFF, MOD, XM, IT و S3M ''' --- صـيـغـة ملف الـصـوت تـقـبـل فـقـط'''

==Syntax==
<syntaxhighlight lang="lua">element playSound ( string soundPath, [ bool looped = false ] )</syntaxhighlight>

===العناصر المطلوبة===
*'''soundPath: هو ملف الصوت المراد تشغيله [[filepath]] / ( <file /> مع علامة [[meta.xml]] و يجب ان يكون ملف الصوت معرفا في )

===Optional Arguments===
{{OptionalArg}}
*'''looped:''' الحلقة غير متوفرة لتدفق الأصوات، فقط لملفات الصوت . true تمثل اذا كان سوف يحلق الصوت . لتكرار الصوت , استخدم [[boolean]] '''

===Returns===
Returns a [[sound]] element if the sound was successfully created, ''false'' otherwise.

=='''مثــال'''==
<section name="كلنت" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") -- wasted.mp3 نشغل الصوت - sounds من مجلد اسمه
setSoundVolume(sound, 0.5) -- 50% نجعل حجم الصوت
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- نضع الايفنت الى هذه الوظيفه عند موت الاعب
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

==See Also==
{{Client_audio_functions}}
[[EN:playSound]]
[[DE:playSound]]

AR/playSound

2013-10-09T11:51:40Z

آحمد آلعلَي: /* مثال */

Client Scripting Functions

2013-10-09T11:47:57Z

آحمد آلعلَي: /* Blip Functions */

<pageclass class="client"></pageclass>
{{Adding_Pages_to_Categories_and_Templates}}
This page lists all the '''client-side''' scripting functions that have been implemented and are available as native functions from the Deathmatch mod. To request a function or event, use [[Requested Functions and Events]]

For more functions, check the [[Useful_Functions|useful functions page]].
__TOC__

==Audio functions==
{{Client_audio_functions}}

==Blip Function==
{{Client_blip_functions}}

==Camera functions==
{{Client_camera_functions}}

==Clothes and body functions==
{{Client_Clothes and body functions}}

==Collision shape functions==
{{Client_collision_shape_functions}}

==Cursor functions==
{{Client_cursor_functions}}

==Drawing functions==
{{Drawing_functions}}

==Effects functions==
{{Client_Effects_functions}}

==Element functions==
{{Client_element_functions}}

==Engine functions==
{{Engine_functions}}

==Event functions==
{{Client_event_functions}}

==Explosion functions==
{{Client_explosion_functions}}

==File functions==
{{Client file functions}}

==Fire functions==
{{Client fire functions}}

==GUI functions==
{{GUI_functions}}

==Input functions==
{{Client_input_functions}}

==Marker functions==
{{Client_marker_functions}}

==Object functions==
{{Client_object_functions}}

==Output functions==
{{Client_output_functions}}

==Ped functions==
{{Client_ped_functions}}

==Pickup functions==
{{Client_pickup_functions}}

==Player functions==
{{Client_player_functions}}

==Projectile functions==
{{Client_projectile_functions}}

==Radar-area functions==
{{Client_radar-area_functions}}

==Resource functions==
{{Client_resource_functions}}

==Serial functions==
{{Client_serial_functions}}

==Team functions==
{{Client_team_functions}}

==Utility functions==
{{Client_utility_functions}}

==Vehicle functions==
{{Client_vehicle_functions}}

==Water functions==
{{Client_water_functions}}

==Weapon functions==
{{Client_weapon_functions}}

==Weapon Creation functions==
Documentation can be found [http://code.google.com/p/mtasa-blue/source/detail?r=4555 here] and [http://code.google.com/p/mtasa-blue/source/detail?r=4557 here]
{{Client_weapon_creation_functions}}

==World functions==
{{Client_world_functions}}

==XML functions==
{{Client XML functions}}

[[pl:Funkcje po stronie klienta]]
[[it:Funzioni Client-side]]
[[ru:Client Scripting Functions]]
[[de:Clientseitige_Funktionen]]
[[tr:Client Taraflı Fonksiyonlar]]

Client Scripting Functions

2013-10-09T11:47:34Z

آحمد آلعلَي: /* Blip functions */

<pageclass class="client"></pageclass>
{{Adding_Pages_to_Categories_and_Templates}}
This page lists all the '''client-side''' scripting functions that have been implemented and are available as native functions from the Deathmatch mod. To request a function or event, use [[Requested Functions and Events]]

For more functions, check the [[Useful_Functions|useful functions page]].
__TOC__

==Audio functions==
{{Client_audio_functions}}

==Blip Functions==
{{Client_blip_functions}}

==Camera functions==
{{Client_camera_functions}}

==Clothes and body functions==
{{Client_Clothes and body functions}}

==Collision shape functions==
{{Client_collision_shape_functions}}

==Cursor functions==
{{Client_cursor_functions}}

==Drawing functions==
{{Drawing_functions}}

==Effects functions==
{{Client_Effects_functions}}

==Element functions==
{{Client_element_functions}}

==Engine functions==
{{Engine_functions}}

==Event functions==
{{Client_event_functions}}

==Explosion functions==
{{Client_explosion_functions}}

==File functions==
{{Client file functions}}

==Fire functions==
{{Client fire functions}}

==GUI functions==
{{GUI_functions}}

==Input functions==
{{Client_input_functions}}

==Marker functions==
{{Client_marker_functions}}

==Object functions==
{{Client_object_functions}}

==Output functions==
{{Client_output_functions}}

==Ped functions==
{{Client_ped_functions}}

==Pickup functions==
{{Client_pickup_functions}}

==Player functions==
{{Client_player_functions}}

==Projectile functions==
{{Client_projectile_functions}}

==Radar-area functions==
{{Client_radar-area_functions}}

==Resource functions==
{{Client_resource_functions}}

==Serial functions==
{{Client_serial_functions}}

==Team functions==
{{Client_team_functions}}

==Utility functions==
{{Client_utility_functions}}

==Vehicle functions==
{{Client_vehicle_functions}}

==Water functions==
{{Client_water_functions}}

==Weapon functions==
{{Client_weapon_functions}}

==Weapon Creation functions==
Documentation can be found [http://code.google.com/p/mtasa-blue/source/detail?r=4555 here] and [http://code.google.com/p/mtasa-blue/source/detail?r=4557 here]
{{Client_weapon_creation_functions}}

==World functions==
{{Client_world_functions}}

==XML functions==
{{Client XML functions}}

[[pl:Funkcje po stronie klienta]]
[[it:Funzioni Client-side]]
[[ru:Client Scripting Functions]]
[[de:Clientseitige_Funktionen]]
[[tr:Client Taraflı Fonksiyonlar]]