Multi Theft Auto: Wiki - User contributions [en]

Главная страница

2012-01-31T05:37:44Z

OpenIDUser32:

__NOTOC__
__NOEDITSECTION__
{| 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 (в том числе разработке игровых режимов и карт).

Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше: создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.

Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC-канале]].

</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="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
===Играть===
<div style="background: #FFEEAA;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Скачать Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[RU/Client_Manual|Руководство по клиенту]]
* [[Changes_in_1.3|Изменения в версии 1.3]]{{en}}
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]
* [[RU/Upgrading_from_MTA:Race|Миграция с MTA:Race на MTA:SA 1.x]]
* [[RU/Resource:Mapmanager|Менеджер карт]]
* [[RU/Server_Manual|Руководство по серверу]]
====Редактор карт====
*[[RU/Resource:Editor|Руководство]]
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]
*[[RU/Resource:Editor/Plugins|Плагины]]
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]
</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>
====Базы данных====
В этой секции описаны все возможности Lua, предоставляемые MTA и ресурсами.
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты
* [[RU/Client side scripts | Клиентские скрипты]]
* [[:Category:Modules|Модули]]{{en}}
</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>
====Разработка MTA====
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[Compiling_MTASA|Компилирование MTASA на Windows]]{{en}}
* [[Building_MTASA_Server_on_Mac_OS_X|Компилирование MTASA на Mac OS X]]{{en}}
* [[Building_MTASA_Server_on_GNU_Linux|Компилирование MTASA на GNU/Linux]]{{en}}
* [[Coding guidelines]]{{en}}
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[Roadmap|План разработки]]{{en}}
* [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>
=== Вики - Как я могу помочь ===
* Заполнить документацию для [[:Category:Incomplete|незавершенных функций]].
* [[:Category:Needs_Example |Добавить примеры использования функций и событий]].
* Проверить и подтвердить [[: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>
=== Community ===
* [http://forum.multitheftauto.com/ Forum]
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [http://community.mtasa.com/ MTA Community] - Share and download resources.
* [http://www.youtube.com/user/MTAQA Youtube Channel]
</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>
====Скриптинг====

* [[RU/Scripting Introduction|Введение в скриптинг]]
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг пользовательского интерфейса]]
* [[RU/Debugging| Руководство по отладке]]
* [[RU/Resources| Введение в ресурсы]]
** [[RU/Resource Web Access | Ресурс веб-доступа]]
** [[:Category:RU/Resource|Каталог ресурсов]]
** [[RU/Meta.xml | Meta.xml]]
* [[RU/Writing_Gamemodes| Создание игровых режимов]]
* [[Useful Functions|Полезные функции]]
<div style="float:right; width: 32px;">[[File:start-here.png]]</div>
====Основная помощь по Lua====
Страницы, которые могут вам помочь в изучении Lua
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)]
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki (англ.)]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#CCCCFF;">
====Описание====
* [[RU/Client Scripting Functions|Функции клиента]]
* [[RU/Client Scripting Events|События клиента]]
* [[RU/Server Scripting Functions|Функции сервера]]
* [[RU/Server Scripting Events|События сервера]]
* [[RU/MTA Classes|Классы MTA]] - Подробное описания всех специфических типов MTA
** [[RU/Element|Элементы MTA]] / [[RU/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>
====[[RU/Id|Список идентификаторов]]====
*[[RU/Animations|Анимации]]
*[[RU/Character Skins | Скины персонажей]]
*[[RU/CJ_Clothes|Одежда]]
*[[RU/Garage|Идентификаторы гаражей]]
*[[Interior IDs | Интерьеры]]
*[[RU/Projectiles|Снаряды]]
*[[RU/Radar_blips|Метки радара]]
*[[RU/Sounds|Звуки]]
*[[RU/Vehicle IDs|Транспорт]]
*[[RU/Vehicle_colors|Цвета транспорта]]
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]
*[[RU/Weapons|Оружие]]
*[[RU/Weather|Погода]]
</div>

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

Template:IT/Funzioni server client

2011-12-16T08:50:52Z

OpenIDUser32:

<pageclass class="both" subcaption="Funzioni client e server"></pageclass>
<includeonly>[[Category:IT/funzioni server]][[Category:IT/funzioni client]]</includeonly>
<noinclude>[[en:Template:Server client function]]</noinclude>

Template:IT/Funzioni server client

2011-12-16T08:49:55Z

OpenIDUser32:

<pageclass class="both" subcaption="Funzioni client e server"></pageclass>
<includeonly>[[Category:IT/funzioni server]]</includeonly>
<noinclude>[[en:Template:Server client function]]</noinclude>

Template:IT/Funzioni server client

2011-12-16T08:43:21Z

OpenIDUser32:

<pageclass class="both" subcaption="Funzioni client e server"></pageclass>
<includeonly>[[Category:IT/Server-side]]</includeonly>
<noinclude>[[en:Template:Server function]]</noinclude>

IT/getProjectileForce

2011-12-16T08:39:11Z

OpenIDUser32:

{{IT/MainP}}
__NOTOC__
{{IT/Funzioni client}}
Questa funzione restituisce la forza del proiettile specificato.

==Sintassi==
<syntaxhighlight lang="lua">
float getProjectileForce ( projectile theProjectile )
</syntaxhighlight>

==Required Arguments==
*'''theProjectile:''' L'elemento [[IT/Elemento/Proiettile| proiettile]] la quale forza si vuole recuperare.

==Valori restituiti==
Restituisce un [[IT/Float|float]] in caso di successo, altrimenti restituisce ''false''.

==Esempio==
<syntaxhighlight lang="lua">
-- TODO
</syntaxhighlight>

==Vedere anche==
{{IT/Client projectile functions}}
[[Category:Needs_Example]]
[[en:getProjectileForce]]

IT/setBlipColor

2011-12-16T08:38:08Z

OpenIDUser32:

{{IT/MainP}}
__NOTOC__
{{IT/Funzioni server client}}
Questa funzione vi permetterà di cambiare il colore di un segnalino. Questo colore è applicabile solo all'icona di default del segnalino. Tutte le altre icone ignoreranno questo.

==Sintassi==
<syntaxhighlight lang="lua">bool setBlipColor ( blip theBlip, int red, int green, int blue, int alpha )</syntaxhighlight>

===Argomenti richiesti===
*'''theBlip:''' Il segnalino del quale vuoi impostare il colore.
*'''red:''' La quantità di colore rosso nel colore del segnalino (0 - 255).
*'''green:''' La quantità di colore verde nel colore del segnalino (0 - 255).
*'''blue:''' La quantità di colore blu nel colore del segnalino (0 - 255).
*'''alpha:''' La quantità di alpha nel colore del segnalino (0 - 255). L'Alpha decide la trasparenza dove 255 è opaco e 0 è trasparente.

===Valori restituiti===
Restituisce ''true'' se il colore del segnalino è stato impostato con successo. Restituisce ''false'' se il segnalino passato alla funzione non è valido, o uno qualsiasi dei colori è fuori dall'intervallo valido.

==Esempio==
Questo esempio trovare tutti i segnalini che esistono e li imposterà tutti su bianco se non sono già bianchi.
<syntaxhighlight lang="lua">
-- Recuperare una tabella contenente tutti i segnalini che esistono
blips = getElementsByType ( "blip" )
-- Scorre l'elenco, e memorizza il segnalino della tabella nella variabile blipValue
for blipKey, blipValue in blips do
-- Recuperare i colori del segnalino nelle variabili rosso, verde, blu e alfa
red, green, blue, alpha = getBlipColor ( blipValue )
-- Se l'icona del segnalino non è già bianca
if ( red ~= 255 or green ~= 255 or blue ~= 255 or alpha ~= 255 ) then
-- Imposta il coloro del segnalino su bianco
setBlipColor ( blipValue, 255, 255, 255, 255 )
end
end
</syntaxhighlight>

==Vedere anche==
{{IT/Blip functions}}
[[en:setBlipColor]]

IT/getPlayerPing

2011-12-16T08:37:12Z

OpenIDUser32:

{{IT/MainP}}
{{IT/Funzioni server client}}
__NOTOC__
Questa funzione restituisce il ping di un [[IT/Elemento/Player|player]]. Il ping è il numero di millisecondi che i pacchetti di dati impiegano per essere inviati dal server al client o viceversa.

==Sintassi==
<syntaxhighlight lang="lua">int getPlayerPing ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer''': Il [[IT/Elemento/Player|player]] di cui vuoi determinare il ping.

===Valori restituiti===
Ritorna il ping come ''integer'', o ''false'' se il giocatore selezionato non è valido.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio verifica il ping di un giocatore che è appena entrato e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(source) -- ottiene il ping dell'elemento ''source'' (il player appena entrato)
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è alto, abbassalo se possibile.", source) -- mostra un messaggio al player
end
end
addEventHandler("onPlayerJoin", getRootElement(), controllaPing) -- aggiunge l'event handler
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio verifica il ping di un giocatore quando usa il comando ''ping'' e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(getLocalPlayer()) -- ottiene il ping del player del client attuale
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è alto, abbassalo se possibile.", getLocalPlayer()) -- mostra un messaggio al player
end
end
addCommandHandler("ping", controllaPing) -- aggiunge il comando ''ping''
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}
[[en:getPlayerPing]]

IT/getLocalPlayer

2011-12-16T08:36:28Z

OpenIDUser32:

{{IT/MainP}}
{{IT/Funzioni client}}
__NOTOC__
Questa funzione restituisce l'elemento [[IT/player|player]] del client che sta eseguendo lo script.

==Sintassi==
<syntaxhighlight lang="lua">
player getLocalPlayer ( )
</syntaxhighlight>

===Valori restituiti===
Restituisce l'elemento [[IT/Elemento/Player|player]] del client attuale.

==Esempio==
<section name="Client" class="client" show="true">
Questo esempio scrive l'attuale posizione del giocatore nella console.
<syntaxhighlight lang="lua">
local localPlayer = getLocalPlayer ( )

function mostraPosizioneAttuale ( )
-- ottiene l'attuale posizione del giocatore
local px, py, pz = getElementPosition ( localPlayer )
-- la scrive nella console
outputConsole ( "La tua attuale posizione: " .. px .. " " .. py .. " " .. pz )
end
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}
[[en:getLocalPlayer]]

Category:Incomplete Event

2011-12-16T08:03:11Z

OpenIDUser32:

Incomplete events that need to be documented. To list an event as incomplete, add the following to the function's page:

<nowiki>[[Category:Incomplete Event]]</nowiki>

[[Category:Maintenance]]

Category:Maintenance

2011-12-16T07:59:50Z

OpenIDUser32: Created page with "Category:MTA Wiki"

[[Category:MTA Wiki]]

Category:Incomplete

2011-12-16T07:59:05Z

OpenIDUser32:

This is a list of functions that need to be documented. To list a function as incomplete, add the following to the function's page:

<nowiki>[[Category:Incomplete]]</nowiki>

[[Category:Maintenance]]

Category:MTA Wiki:Editing

2011-12-16T07:56:54Z

OpenIDUser32:

General MTA Wiki articles.

[[Category:MTA Wiki]]

PowerupManager

2011-12-16T07:21:29Z

OpenIDUser32:

{{Outdated|}}

The [[PowerupManager|powerupManager]] library was created to ease the use of advanced, more custom pickups (powerups).

It exists out of server and client scripts to create, handle and destroy custom powerup items.

Advanced features contain: custom clientside animations (spin, up-down), custom collision element for triggering, server side triggering (to prevent cheating), change powerup object on the fly (for example triggering such a powerup gives a random advantage based on current modelID), ...

Also since it allows you to set a custom colShape, you can use it to create tripmines, ...
=Used by=
=Exported scripting functions=
==Server==
{{PowerupManager/ExportedServerFunctions}}
==Client==
{{PowerupManager/ExportedClientFunctions}}
=Events=
Events prefixed with pum are ceated for internal usage only. You still can hook them, but we suggest you don't.
==Server==
{{PowerupManager/ServerEvents}}
==Client==
{{PowerupManager/ClientEvents}}

[[Category:Modules]]

MTA General FAQ

2011-12-16T07:17:10Z

OpenIDUser32:

These questions and answers are about MTA in general.

* '''Q: When is the next version going to be released?'''

A: When it is finished.

* '''Q: Where can I find information about the next release?'''

A: Try the [http://www.mtasa.com// site].

* '''Q: Who is building MTA?'''

A: MTA is built by a team of volunteers. Development was started by IJsVogel and the team then slowly started to grow. You can find a list of team members by clicking [http://multitheftauto.com/developers.html here].

* '''Q: Are you guys being paid by Rockstar?'''

A: No, everything we do, we do as volunteers. We are not receiving money from Rockstar or any other sponsor.

* '''Q: Can I help in the development?'''

A: Multi Theft Auto is open-source, anyone can contribute, visit the [http://bugs.multitheftauto.com// bug tracker] to see what needs fixed.

* '''Q: Where can I find the source?'''

A: The source code of MTA is available for download on [http://multitheftauto.googlecode.com the Multi Theft Auto GoogleCode page].

* '''Q: How can I donate?'''

A: You can't; the team does not accept donations.

* '''Q: Can I place a copy on my site?'''

A: Yes, you may provide an MTA download at your site, but you must not alter any files!

* '''Q: Can I give this to a friend?'''

A: Yes, it's freeware!

* '''Q: How do I contact the team?'''

A: You can e-mail the team at admin@multitheftauto.com, or you can use [irc://irc.multitheftauto.com IRC].

* '''Q: What is IRC?'''

A: IRC (Internet Relay Chat) is the most commonly used method of internet chatting.

* '''Q: How do I use IRC?'''

A: Download mIRC from [http://www.mirc.com www.mirc.com] and follow the instructions that you can find [http://forum.mtavc.com/viewtopic.php?t=30 here].

[[Category:Support]]

Previous-car-method

2011-12-16T07:14:05Z

OpenIDUser32:

[[Image:01a.jpg|250px|thumb|Previous car method in action. Notice the lights above the second car.]]

This method was first used in GTA3:AM and after that in GTA3:MTA 0.1a and 0.2a. It was also used by other competing projects. This method is no longer used.

'''What is it?'''

* You enter a car and exit it again (the car gets stored in memory as your previous car)
* You enter a second car
* You hit a key combination on the keyboard.

Now the client syncs your car coordinates with those of the previous car on the other computer and the other players car with your previous car. Therefore you see the other person driving your previously used car.

It is the most basic form of multiplayer. If your previous car does not match the car of the other user then you can see the car make strange moves. Also note that traffic and peds were not synced.

[[Category:GTA3]]
[[Category:Historical]]

MTA General FAQ

2011-12-16T07:13:03Z

OpenIDUser32:

MTA General FAQ

2011-12-16T07:12:03Z

OpenIDUser32:

DetonateSatchels

2011-12-16T07:10:13Z

OpenIDUser32:

{{Server client function}}
__NOTOC__
This function can be used to detonate a players satchels.
{{New feature/item|0110|1.1||
This function is available from version 1.1 onwards.
}}
==Syntax==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool detonateSatchels ( )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool detonateSatchels ( element Player )
</syntaxhighlight>
</section>

==Returns==
Returns true if successful, false otherwise.

==Example==
The below example allows a player to detonate any of their placed satchels via the command /blowsatchels
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function blowMySatchels()
detonateSatchels()
outputChatBox("Satchels blown!", 0, 255, 0)
end
addCommandHandler("blowsatchels", blowMySatchels)
</syntaxhighlight>
</section>

==See also==
{{Client projectile functions}}

[[it:detonateSatchels]]

DetonateSatchels

2011-12-16T07:08:30Z

OpenIDUser32:

{{Server client function}}
__NOTOC__
This function can be used to detonate a players satchels.

This function is available from version 1.1 onwards.

==Syntax==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool detonateSatchels ( )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool detonateSatchels ( element Player )
</syntaxhighlight>
</section>

==Returns==
Returns true if successful, false otherwise.

==Example==
The below example allows a player to detonate any of their placed satchels via the command /blowsatchels
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function blowMySatchels()
detonateSatchels()
outputChatBox("Satchels blown!", 0, 255, 0)
end
addCommandHandler("blowsatchels", blowMySatchels)
</syntaxhighlight>
</section>

==See also==
{{Client projectile functions}}

[[it:detonateSatchels]]

GetProjectileType

2011-12-16T07:07:58Z

OpenIDUser32:

__NOTOC__
{{Client function}}
This function returns the type of the specified projectile.

==Syntax==
<syntaxhighlight lang="lua">
int getProjectileType ( projectile theProjectile )
</syntaxhighlight>

==Required Arguments==
*'''theProjectile:''' The [[Element/Projectile|projectile]] element which type you want to retrieve.

==Returns==
Returns an [[int]]eger over the type of the projectile or ''false'' if invalid arguments were passed.
{{Projectiles}}

==Example==
<syntaxhighlight lang="lua">
function projectileCreation()
local theType = getProjectileType(source)
outputChatBox("A projectile was created! It's type: "..theType)
end
addEventHandler("onClientProjectileCreation", getRootElement(), projectileCreation)
</syntaxhighlight>

==See also==
{{Client projectile functions}}

[[it:getProjectileType]]

GetProjectileTarget

2011-12-16T07:06:23Z

OpenIDUser32:

__NOTOC__
{{Client function}}
This function returns the target of the specified projectile.

==Syntax==
<syntaxhighlight lang="lua">
element getProjectileTarget ( projectile theProjectile )
</syntaxhighlight>

==Required Arguments==
*'''theProjectile:''' The [[projectiles| projectile]] element which target you want to retrieve.

==Returns==
Returns the element which is the projectile's target if the projectile is valid and a HS Rocket Projectile, ''false'' otherwise.

==Example==
This example allows a player to send projectiles at other players

<syntaxhighlight lang="lua">function projectileCreating(command,targetPlayer)
local x,y,z = getElementPosition(getLocalPlayer()) -- Get the position of the player
local target = getPlayerFromName(targetPlayer) or nil -- Get the target, or set it to nil if no target specified
local theProjectile = createProjectile(thePlayer,20,x,y,z+50,1.0,target)
if (target) then
outputChatBox("Created projectile's target: "..getPlayerName(getProjectileTarget(theProjectile)))
else
outputChatBox("Created projectile with no target")
end
end
addCommandHandler("rocket",projectileCreating) -- Bind the 'rocket' command to projectileCreating function
</syntaxhighlight>

==See also==
{{Client projectile functions}}

[[it:getProjectileTarget]]

GetProjectileForce

2011-12-16T07:03:58Z

OpenIDUser32:

__NOTOC__
{{Client function}}
This function returns the force of the specified projectile.

==Syntax==
<syntaxhighlight lang="lua">
float getProjectileForce ( projectile theProjectile )
</syntaxhighlight>

==Required Arguments==
*'''theProjectile:''' The [[projectiles| projectile]] element which force you want to retrieve.

==Returns==
Returns a [[float]] if successful, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- TODO
</syntaxhighlight>

==See also==
{{Client projectile functions}}
[[Category:Needs_Example]]

[[it:getProjectileForce]]

CreateProjectile

2011-12-16T07:03:14Z

OpenIDUser32:

__NOTOC__
{{Client function}}
This function creates a projectile of the specified type on the specified coordinates.

==Syntax==
<syntaxhighlight lang="lua">
projectile createProjectile ( element creator, int weaponType [, float posX, float posY, float posZ, float force = 1.0, element target = nil, float rotX, float rotY, float rotZ, float velX, float velY, float velZ, int model ] )
</syntaxhighlight>

==Required Arguments==
*'''creator:''' The [[element]] representing creator of the projectile. In case you want the projectile to be synced for everybody creator must be [[getLocalPlayer]]().
*'''weaponType:''' [[int]] representing the projectile weaponType (characteristics). Valid IDs are:
{{Projectiles}}

==Optional Arguments==
{{OptionalArg}}
*'''posX''','''posY''','''posZ''': [[float]] starting coordinates for the projectile. They are coordinates of creator by default.
*'''force''': [[float]] representing the starting force of the projectile.
*'''target''': [[element]] target used for heat seeking rockets.
*'''rotX''','''rotY''','''rotZ''': [[float]] starting rotation for the projectile.
*'''velX''','''velY''','''velZ''': [[float]] starting velocity for the projectile.
*'''model''': Integer representing the projectile's model, uses default model for weaponType if not specified.

==Returns==
Returns a ''projectile'' element if projectile creation was succesfull. Returns ''false'' if unable to create a projectile (wrong weapon ID or projectiles limit was reached).

==Example==
This example makes a rocket minigun (minigun shooting with rockets).
<syntaxhighlight lang="lua">
-- This function gets triggered everytime player shoots.
function onClientPlayerWeaponFireFunc(weapon,ammo,ammoInClip,hitX,hitY,hitZ,hitElement)
if weapon == 38 then -- if source is a local player and he uses minigun...
if not createProjectile(getLocalPlayer(),19,getElementPosition(getLocalPlayer()),200) then -- then we either create a projectile...
outputChatBox ( "Rocket minigun overheated! Give it a rest pal!", source ) -- or if projectile limit is reached we output player a chat message
end
end
end

-- Don't forget to add the onClientPlayerWeaponFireFunc function as a handler for onClientPlayerWeaponFire.
addEventHandler("onClientPlayerWeaponFire", getLocalPlayer(), onClientPlayerWeaponFireFunc)
</syntaxhighlight>

==See also==
{{Client projectile functions}}

[[it:createProjectile]]

GetProjectileCreator

2011-12-16T07:01:59Z

OpenIDUser32:

__NOTOC__
{{Client function}}
{{Needs Example}}
This function returns the creator of the specified projectile.

==Syntax==
<syntaxhighlight lang="lua">
element getProjectileCreator ( projectile theProjectile )
</syntaxhighlight>

==Required Arguments==
*'''theProjectile:''' The [[projectiles| projectile]] element which creator you want to retrieve.

==Returns==
Returns the element which created the projectile if successful, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See also==
{{Client projectile functions}}

[[it:getProjectileCreator]]

Category:Disabled Functions and Events

2011-12-16T06:58:54Z

OpenIDUser32: Created page with "Category:Scripting"

[[Category:Scripting]]

Category:Changelog

2011-12-16T06:45:12Z

OpenIDUser32: Created page with "Category:Contents"

[[Category:Contents]]

Category:Events templates

2011-12-16T06:39:03Z

OpenIDUser32:

[[Category:Templates]]

Category:Events templates

2011-12-16T06:38:21Z

OpenIDUser32: Created page with "Category:Scripting"

[[Category:Scripting]]

Template:New feature

2011-12-16T06:12:05Z

OpenIDUser32:

<noinclude>{{delete|to rename <nowiki>{{[[new feature/item]]}}</nowiki>}}</noinclude>

Template:New feature/item

2011-12-16T05:59:56Z

OpenIDUser32:

<includeonly>{{#ifexpr:({{{1|}}})>{{Current Version}}|<div style='font-weight: bold;background:black;color:white;padding:2px; padding-left:8px;'>FROM VERSION {{{2}}} {{#if:{{{3}}}|{{r|{{{3}}}}}|}} ONWARDS</div><div style='border: 2px solid black;padding: 3px;'>{{{4|}}} </div>| {{{4|}}}}}[[Category:Changes in {{{2}}}]]</includeonly><noinclude>Template for using in function and event pages. For functions/events lists please use <nowiki>{{New items}}</nowiki>.

Parameters:
#Version in numeric format
#Version in release format
#Revision
#Description

[[Category:Utility templates]]</noinclude>

Category:Changes in 1.2

2011-12-16T05:43:46Z

OpenIDUser32:

''See also [[Changes in 1.2]]''

[[Category:Changelog]]

OnChatMessage

2011-11-24T05:54:12Z

OpenIDUser32:

{{Server event}}
__NOTOC__
{{New feature/item|3.0120|1.2|3316|
'''Available only in MTA SA 1.2 and onwards'''
}}
This event is triggered when a player uses say, teamsay, me successfully. Or when any message is output to chat using [[outputChatBox]]. It can be used to get the resource responsible for specific [[outputChatBox]] call via the second parameter.

==Parameters==
<syntaxhighlight lang="lua">
string theMessage, resource / element theElement
</syntaxhighlight>
*'''theMessage:''' The text that was output to the chatbox
*'''theElement:''' Player element if chatbox output was done via say, teamsay or me. Resource if it was done via [[outputChatBox]].

==Source==
The [[event system#Event source|source]] of this event is the root element.

==Example==
This example outputs all chat messages to debug view.
<syntaxhighlight lang="lua">
[lua]
function onChatMessageHandler(theMessage, thePlayer)
outputDebugString(theMessage)
end
addEventHandler("onChatMessage", root, onChatMessageHandler)
</syntaxhighlight>

==Requirements==
{{Requirements|1.1.1-9.03316|n/a|}}

{{See also/Server event|Server events}}

RedirectPlayer

2011-11-24T05:50:19Z

OpenIDUser32:

__NOTOC__
{{Server function}}
This function redirects the player to a specified server.<br>

==Syntax==
<syntaxhighlight lang="lua">
bool redirectPlayer ( player thePlayer, string serverIP, int serverPort, [ string serverPassword ] )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you want to redirect
*'''serverIP:''' The ip of the server you want to redirect the player to
*'''serverPort:''' The game port of the server you want to redirect the player to

===Optional Arguments===
*'''serverPassword:''' The password for the server if it's protected

===Returns===
Returns ''true'' if the player was redirected successfully, ''false'' if bad arguments were passed.

==Example==
This example adds a "joinserver" command using the syntax, "/joinserver serverIP serverPort [serverPassword]".
<syntaxhighlight lang="lua">
function joinserverHandlerFunction (playerSource, commandName, serverIP, serverPort, serverPassword)
if serverIP and serverPort then --if IP and Port were specified
if serverPassword then --if also a password was specified
redirectPlayer (playerSource, serverIP, tonumber(serverPort), serverPassword) --redirect the player
else -- else if no password was specified
redirectPlayer (playerSource, serverIP, tonumber(serverPort)) --redirect the player without using the serverPassword parameter
end
else -- if no IP or Port have been specified
outputChatBox ("Error! Correct Syntax: /joinserver IP Port [Password]", playerSource) --output an Error message to the chatbox
end
end

addCommandHandler ("joinserver", joinserverHandlerFunction)
</syntaxhighlight>

{{New feature/item|3.0120|1.2|3429|
This example adds a "rejoin" command like the inbuilt reconnect command.
<syntaxhighlight lang="lua">
function rejoinMe(thePlayer, theCommand)
redirectPlayer(thePlayer) -- This only works in 1.1.1-9.03429 and onwards
end
addCommandHandler("rejoin", rejoinMe) -- Attach rejoin command to our function
</syntaxhighlight>
}}
==See Also==
{{Player_functions}}

Template:IT/Elements

2011-11-23T12:53:56Z

OpenIDUser32:

<noinclude>{{IT/MainP}}</noinclude>
{{IT/Entities}}
* [[IT/Elemento/Collision shape|Collision shape]]
* [[IT/Elemento/Proiettile|Proiettile]]
* [[IT/Elemento/Team|Team]]
* [[IT/Elemento/Console|Console del server]]
* [[IT/Elemento/Admin|Admin remoto]]
* [[IT/Elemento/GUI|Elementi della GUI]]
<ul>{{IT/GUI Elements}}</ul>
* [[IT/Elemento/TXD|TXD]]
* [[IT/Elemento/DFF|DFF]]
* [[IT/Elemento/COL|COL]]
* [[IT/Elemento/Sound|Sound]]
{{New items|3.0110|1.1|
* [[IT/Elemento/Material|Material]]
** [[IT/Elemento/Texture|Texture]]
** [[IT/Elemento/Shader|Shader]]
* [[IT/Elemento/DX font|DX font]]
* [[IT/Elemento/GUI font|GUI font]]
}}

Template:Elements

2011-11-23T12:53:30Z

OpenIDUser32:

* [[Element/Player|Player]]
* [[Element/Ped|Ped]]
* [[Element/Vehicle|Vehicle]]
* [[Element/Object|Object]]
* [[Element/Pickup|Pickup]]
* [[Element/Marker|Marker]]
* [[Element/Collision shape|Collision shape]]
* [[Element/Blip|Blip]]
* [[Element/Radar area|Radar area]]
* [[Element/Projectile|Projectile]]
* [[Element/Team|Team]]
* [[Element/Console|Server console]]
* [[Element/Admin|Remote admin]]
* [[GUI widgets]]:
<ul>{{GUI_widgets}}</ul>
* [[Element/TXD|TXD]]
* [[Element/DFF|DFF]]
* [[Element/COL|COL]]

* [[Element/Sound|Sound]]
{{New items|3.0110|1.1|
* [[Element/Material|Material]]
** [[Element/Texture|Texture]]
** [[Element/Shader|Shader]]
* [[Element/DX font|DX font]]
* [[Element/GUI font|GUI font]]
}}
<noinclude>
[[ru:Template:Elements]]
[[es:Template:Elements]]
</noinclude>

Template:Account events

2011-11-23T12:52:34Z

OpenIDUser32:

{{New items|3.0110|1.1|
*[[onAccountDataChange]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Sound events

2011-11-23T12:52:17Z

OpenIDUser32:

{{New items|3.0110|1.1|
* [[onClientSoundChangedMeta]]
* [[onClientSoundFinishedDownload]]
* [[onClientSoundStream]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Ped events

2011-11-23T12:51:55Z

OpenIDUser32:

{{New items|3|1.0|
*[[onPedWasted]]
*[[onPedWeaponSwitch]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Client ped events

2011-11-23T12:51:30Z

OpenIDUser32:

{{New items|3|1.0|
*[[onClientPedDamage]]
*[[onClientPedWasted]]
*[[onClientPedWeaponFire]]
*[[onClientPedChoke]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Element events

2011-11-23T12:50:34Z

OpenIDUser32:

*[[onElementDestroy]]
*[[onElementDataChange]]
*[[onElementColShapeHit]]
*[[onElementColShapeLeave]]
*[[onElementClicked]]
*[[onElementStartSync]]
*[[onElementStopSync]]
{{New items|3.0120|1.2|
*[[onElementModelChanged]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:GUI events

2011-11-23T12:50:24Z

OpenIDUser32:

*[[onClientGUIClick]]
*[[onClientGUIDoubleClick]]
*[[onClientGUIChanged]]
*[[onClientGUIAccepted]]
*[[onClientGUIScroll]]
*[[onClientClick]]
{{New items|3.0110|1.1|
*[[onClientDoubleClick]]
*[[onClientKey]]
}}
*[[onClientMouseEnter]]
*[[onClientMouseLeave]]
*[[onClientMouseMove]]
*[[onClientMouseWheel]]
*[[onClientCursorMove]]
*[[onClientGUIMouseDown]]
*[[onClientGUIMouseUp]]
*[[onClientGUIMove]]
*[[onClientGUISize]]
*[[onClientGUITabSwitched]]
{{New items|3.0110|1.1|
*[[onClientGUIComboBoxAccepted]]
*[[onClientGUIFocus]]
*[[onClientGUIBlur]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Player events

2011-11-23T12:49:12Z

OpenIDUser32:

*[[onPlayerBan]]
*[[onPlayerChat]]
*[[onPlayerPrivateMessage]]
*[[onPlayerConnect]]
*[[onPlayerChangeNick]]
*[[onPlayerLogin]]
*[[onPlayerLogout]]
*[[onPlayerDamage]]
*[[onPlayerJoin]]
*[[onPlayerQuit]]
*[[onPlayerSpawn]]
*[[onPlayerWasted]]
*[[onPlayerTarget]]
*[[onPlayerVehicleEnter]]
*[[onPlayerVehicleExit]]
*[[onPlayerWeaponSwitch]]
*[[onPlayerMarkerHit]]
*[[onPlayerMarkerLeave]]
*[[onPlayerPickupHit]]
*[[onPlayerPickupUse]]
*[[onPlayerClick]]
*[[onPlayerContact]]
*[[onPlayerStealthKill]]
{{New items|3.0110|1.1|
*[[onPlayerMute]]
*[[onPlayerUnmute]]
*[[onPlayerCommand]]
*[[onPlayerModInfo]]
*[[onPlayerVoiceStart]]
*[[onPlayerVoiceStop]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Resource events

2011-11-23T12:48:40Z

OpenIDUser32:

*[[onResourceStart]]
{{New items|3|1.0|
*[[onResourcePreStart]]
}}
*[[onResourceStop]]
<noinclude>[[Category:Events templates]]</noinclude>

Template:Server events

2011-11-23T12:48:12Z

OpenIDUser32:

*[[onBan]]
*[[onDebugMessage]]
*[[onSettingChange]]
*[[onAccountDataChange]]
*[[onUnban]]
{{New items|3.0120|1.2|
*[[onChatMessage]]
}}
<noinclude>[[Category:Events templates]]</noinclude>

Template:Client other events

2011-11-23T12:47:56Z

OpenIDUser32:

*[[onClientConsole]]
{{New items|3.0110|1.1|
*[[onClientDebugMessage]]
*[[onClientHUDRender]]
*[[onClientMinimize]]
*[[onClientRestore]]
}}
*[[onClientRender]]
*[[onClientExplosion]]
*[[onClientChatMessage]]
*[[onClientPreRender]]
<noinclude>[[Category:Events templates]]</noinclude>

Template:Client vehicle events

2011-11-23T12:47:35Z

OpenIDUser32:

*[[onClientVehicleRespawn]]
*[[onClientVehicleEnter]]
*[[onClientVehicleExit]]
{{New items|3.0110|1.1|
* [[onClientVehicleExplode]]
}}
*[[onClientVehicleStartEnter]]
*[[onClientVehicleStartExit]]
*[[onClientTrailerAttach]]
*[[onClientTrailerDetach]]
<noinclude>[[Category:Events templates]]</noinclude>

Template:Client player events

2011-11-23T12:45:56Z

OpenIDUser32:

*[[onClientPlayerJoin]]
*[[onClientPlayerQuit]]
*[[onClientPlayerWeaponFire]]
*[[onClientPlayerWeaponSwitch]]
*[[onClientPlayerTarget]]
*[[onClientPlayerDamage]]
*[[onClientPlayerSpawn]]
*[[onClientPlayerWasted]]
*[[onClientPlayerVehicleEnter]]
*[[onClientPlayerVehicleExit]]
*[[onClientPlayerChangeNick]]
*[[onClientPlayerStuntStart]]
*[[onClientPlayerStuntFinish]]
{{New items|3|1.0|
*[[onClientPlayerChoke]]
*[[onClientPlayerRadioSwitch]]
}}
{{New items|3.0004|1.0.4|
*[[onClientPlayerStealthKill]]
}}
{{New items|3.0110|1.1|
*[[onClientPlayerVoiceStart]]
*[[onClientPlayerVoiceStop]]
}}

Template:Client element events

2011-11-23T12:45:18Z

OpenIDUser32:

{{New items|3|1.0|
*[[onClientElementDestroy]]
}}

*[[onClientElementColShapeHit]]
*[[onClientElementColShapeLeave]]
*[[onClientElementDataChange]]
*[[onClientElementStreamIn]]
*[[onClientElementStreamOut]]

GetVehicleEngineState

2011-11-23T12:08:32Z

OpenIDUser32:

__NOTOC__
{{Server client function}}
This function returns a vehicle's engine state (on or off).

{{New feature/item|3|1.0}}
==Syntax==
<syntaxhighlight lang="lua">
bool getVehicleEngineState ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The [[vehicle]] you wish to get the engine state of.

===Returns===
Returns '''true''' if the vehicle's engine is started, '''false''' otherwise.

==Example==
<section name="Serverside example" class="server" show="true">
This example will switch the vehicle engine state with the command "/switchengine".
<syntaxhighlight lang="lua">
function switchEngine ( playerSource )
local theVehicle = getPedOccupiedVehicle ( playerSource )

-- Check if the player is in any vehicle and if he is the driver
if theVehicle and getVehicleController ( theVehicle ) == playerSource then
local state = getVehicleEngineState ( theVehicle )
setVehicleEngineState ( theVehicle, not state )
end
end
addCommandHandler ( "switchengine", switchEngine )
</syntaxhighlight>
</section>

==Changelog==
*2008-06-23 - added ({{i|3544}})
*2009-07-24 - fixed {{i|4687}}
*2009-08-22 - fixed {{i|4851}}

==See Also==
{{Vehicle functions}}

Template:New feature/item

2011-11-23T12:04:32Z

OpenIDUser32:

<includeonly>{{#ifexpr:({{{1|}}})>{{Current Version}}|<div style='font-weight: bold;background:black;color:white;padding:2px; padding-left:8px;'>FROM VERSION {{{2}}} {{#if:{{{3}}}|{{r|{{{3}}}}}}]|}} ONWARDS</div><div style='border: 2px solid black;padding: 3px;'>{{{4|}}} </div>| {{{4|}}}}}[[Category:Changes in {{{2}}}]]</includeonly><noinclude>Template for using in function and event pages. For functions/events lists please use <nowiki>{{New Feature}}</nowiki>.

Parameters:
#Version in numeric format
#Version in release format
#Revision
#Description

[[Category:Utility templates]]</noinclude>