Multi Theft Auto: Wiki - User contributions [en]

AR/getPlayerNametagColor

2012-10-18T11:23:52Z

Talal07: Created page with "__NOTOC__ {{Server client function}}  هذه الوظيفة تقوم با..."

__NOTOC__
{{Server client function}}

هذه الوظيفة تقوم باحضار الوان تاج الاعب.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int getPlayerNametagColor ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' الاعب الذي تريد احضار الوان تاجه.

===Returns===
Returns ''red'', ''green'' and ''blue'' values if an existent player was specified, ''false'' otherwise.

==Example==
This console command will tell the player what his tag color is. The color is composed of a red, a green and a blue component, each ranging from 0-255.
<syntaxhighlight lang="lua">
function tagInfoCommand ( thePlayer, commandName )
-- store the RGB data about the player who activated the command handler into the local variables r, g, b.
local r, g, b = getPlayerNametagColor ( thePlayer )
-- Display the RGB values in the chatbox
outputChatBox ( "Your tag color is: R:" .. r .. " G:" .. g .. " B:" .. b, thePlayer )
end
addCommandHandler ( "retrievetagcolor", tagInfoCommand )
</syntaxhighlight>

==See Also==

{{Player_functions}}

AR/getPlayerCount

2012-10-17T20:32:43Z

Talal07: Created page with "{{Server function}} __NOTOC__ هذه الوظيفة تقوم باحضار عدد الاعبين الموجودين في السيرفر {{Note|#getElementsByType("player") works t..."

{{Server function}}
__NOTOC__
هذه الوظيفة تقوم باحضار عدد الاعبين الموجودين في السيرفر
{{Note|#getElementsByType("player") works the same as this function but also works client side unlike this function.}}

==Syntax==
<syntaxhighlight lang="lua">
int getPlayerCount ( )
</syntaxhighlight>

===Returns===
Returns the number of players connected to the server as an [[int]].

==Example==
This example displays a chat message with the number of players connected to the server when a player joins or quits.
<syntaxhighlight lang="lua">
function playerCount ( )
outputChatBox ( "There are now " .. getPlayerCount() .. " players on this server!" )
end
addEventHandler ( "onPlayerJoin", getRootElement(), playerCount )
addEventHandler ( "onPlayerQuit", getRootElement(), playerCount )
</syntaxhighlight>

==See Also==
{{Player functions}}

AR/getPlayerMoney

2012-10-17T20:29:45Z

Talal07: Created page with "__NOTOC__ {{Server client function}} هذه الوظيفة تقوم باحضار مال الاعب ==Syntax== <syntaxhighlight lang="lua"> string getPlayerMoney ( player thePlayer ) </syntaxhighlight> =..."

__NOTOC__
{{Server client function}}
هذه الوظيفة تقوم باحضار مال الاعب

==Syntax==
<syntaxhighlight lang="lua">
string getPlayerMoney ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
* '''thePlayer:''' الاعب الذي تريد احضار اسمه

===Returns===
Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("mymoney",
function(playerSource)
outputChatBox("Your money: "..getPlayerMoney(playerSource), playerSource)
end
)
</syntaxhighlight>
</section>

==See Also==
{{Server player functions}}

GetPlayerName

2012-10-17T20:26:18Z

Talal07: /* Required Arguments */

__NOTOC__
{{Server client function}}
This function returns a string containing the name of the specified player.

==Syntax==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
* '''thePlayer:''' the Player that you want to get his name

===Returns===
Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.

===Limits===
* Player name can consist of ASCII characters between 33 and 126 are allowed (basic latin):
<nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* Minimal player name length is 1 character.
* Maximum player name length is 22 characters.
* Player names are case-insensitive. It is not possible to have two clients with same name but different character case.

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function(playerSource)
outputChatBox("Your name: "..getPlayerName(playerSource), playerSource)
end
)
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
This example outputs the local player name to the chatbox.
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function()
local localPlayerName = getPlayerName(getLocalPlayer())
--and we output it to the chatbox
outputChatBox(localPlayerName)
end
)
</syntaxhighlight>
</section>

==See Also==
{{Client player functions}}

AR/createBlip

2012-10-17T20:23:27Z

Talal07:

__NOTOC__
{{Server client function}}
هذه الوظيفة تقوم بعمل علامة في الخريطة تراها في الرادار مثل العلامات الموجوده على الاعبين

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icon=0, int size=2, int r=255, int g=0, int b=0, int a=255,
int ordering=0, float visibleDistance=99999.0, visibleTo = getRootElement()] )
</syntaxhighlight>

===Required Arguments===
*'''x:''' للعلامه x احداثيات الـ
*'''y:''' للعلامه y احداثيات الـ
*'''z:''' للعلامه z احداثيات الـ

===Optional Arguments===
{{OptionalArg}}
*'''icon:''' شكل العلامة اختارها من التالي
{{Blip_Icons}}
*'''size:''' حجم العلامة و الحجم العادي 2
*'''r:''' لون العلامة الاحمر
*'''g:''' لون العلامة الاخضر
*'''b:''' لون العلامة الازرق
*'''a:''' مقدار الوضوح للعلامة من 0 - 255
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' The maximum distance from the camera at which the blip is still visible
}}
*'''visibleTo:''' What elements can see the blip. Defaults to visible to everyone. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
blip createBlip ( float x, float y, float z, [int icon=0, int size=2, int r=255, int g=0, int b=0, int a=255,
int ordering=0, float visibleDistance ] )
</syntaxhighlight>

===Required Arguments===
*'''x:''' The x position of the blip, in world coordinates.
*'''y:''' The y position of the blip, in world coordinates.
*'''z:''' The z position of the blip, in world coordinates.

===Optional Arguments===
{{OptionalArg}}
*'''icon:''' The icon that the radar blips should be. Valid values are:
{{Blip_Icons}}
*'''size:''' The size of the radar blip. Only applicable to the ''Marker'' icon. Default is 2.
*'''r:''' The amount of red in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
*'''g:''' The amount of green in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''b:''' The amount of blue in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''a:''' The amount of alpha in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' The maximum distance from the camera at which the blip is still visible
}}
</section>

==Returns==
Returns an [[element]] of the [[blip]] if it was created successfully, ''false'' otherwise.

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This example creates a radar blip at a random player's position and makes it so that it is only visible to that player.
<syntaxhighlight lang="lua">
-- Pick a random player
myPlayer = getRandomPlayer ()
-- Retrieve the player's position and store it in the variables x, y and z
x,y,z = getElementPosition ( myPlayer )
-- Create a radar blip at the player's position, with a 'cash' icon and only visible to the player
myBlip = createBlip ( x, y, z, 51, 0, 0, 0, 255, myPlayer )
</syntaxhighlight>

'''Example 2:''' This example attaches a blip to a player. You can attach a blip to an element by just setting the blip's parent to that element.
<syntaxhighlight lang="lua">
-- Pick a random player
myPlayer = getRandomPlayer ()
-- Create a radar blip in the middle of the map
myBlip = createBlip ( 0, 0, 0 )
-- Make the player the parent of the blip, so that the blip follows the player around
setElementParent ( myBlip, myPlayer )
</syntaxhighlight>

'''Example 3:''' This example creates a blip at 0 , 0 , 0
<syntaxhighlight lang="lua">
--creates a blip at 0 , 0 , 0
createBlip ( 0 , 0 , 0 , 37 )
</syntaxhighlight>
</section>

==See Also==
{{AR/Blip_functions}}

[[en:CreateBlip]]

GetPlayerName

2012-08-23T16:51:36Z

Talal07: /* Required Arguments */

__NOTOC__
{{Server client function}}
This function returns a string containing the name of the specified player.

==Syntax==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
* '''thePlayer:''' الاعب الذي تريد احضار اسمه

===Returns===
Returns a string containing the requested player's name, or ''false'' if the player passed to the function is invalid.

===Limits===
* Player name can consist of ASCII characters between 33 and 126 are allowed (basic latin):
<nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~</nowiki>
* Minimal player name length is 1 character.
* Maximum player name length is 22 characters.
* Player names are case-insensitive. It is not possible to have two clients with same name but different character case.

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function(playerSource)
outputChatBox("Your name: "..getPlayerName(playerSource), playerSource)
end
)
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
This example outputs the local player name to the chatbox.
<syntaxhighlight lang="lua">
addCommandHandler("myname",
function()
local localPlayerName = getPlayerName(getLocalPlayer())
--and we output it to the chatbox
outputChatBox(localPlayerName)
end
)
</syntaxhighlight>
</section>

==See Also==
{{Client player functions}}

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

2012-08-23T16:47:19Z

Talal07: /* المفاتيح داخل اللعبة */

__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) لفتح شات الكونسوال
* F9 - In-game الدعم
* F11 - اظهار الخريطة ''(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 - لتصوير الشاشة
* T - للتحدث في الشات
* Y - للتحدث في شات التيم
* TAB - لفتح السكور (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]]