Multi Theft Auto: Wiki - User contributions [en]

RU/setPlayerName

2010-07-14T08:46:11Z

KGB: Перевод примера

{{RU/Server function}}
__NOTOC__
Эта функция изменяет имя указанного игрока ([[player]]).

==Синтаксис==
<syntaxhighlight lang="lua">
bool setPlayerName ( player thePlayer, string newName )
</syntaxhighlight>

===Обязательные аргументы===
*'''thePlayer:''' [[player|игрок]], которому нужно изменить имя.
*'''newName:''' устанавливаемое имя.

===Вывод===
Возвращает ''true'' если имя было успешно изменено, ''false'' если были переданы некорректные аргументы.

==Пример==
<section name="Server" class="server" show="true">
Этот пример позволяет добавлять перед именем игрока дополнительный текст по команде /changetag
<syntaxhighlight lang="lua">

-- Определяем функцию для команды (/changetag, она определена далее)
-- source = игрок, который вызвал команду
-- command = команда, передаваемая в функцию (changetag)
-- thePlayer = игрок, перед именем которого будет добавлен текст
-- tag = текст, добавляемый перед именем
function tagPlayer ( source, command, thePlayer, tag )
--Попытка получить элемент из имени.
local sPlayerElement = getPlayerFromName ( thePlayer )
-- Проверка, существует ли такой игрок.
if ( sPlayerElement ) then
-- Проверка, имеет ли полученный элемент тип [[player]]
if getElementType ( sPlayerElement ) == "player" then
-- сохраняем текущее имя игрока,
local oldName = getPlayerName ( sPlayerElement )
-- добавляем перед ним переданный в функцию текст
local taggedName = tag .. oldName
-- затем устанавливаем полученную строку в качестве нового имени игрока
setPlayerName ( sPlayerElement, taggedName )
-- Сообщаем игроку, вызвавшему команду, что она выполена успешно
outputChatBox ( "Player " .. thePlayer .. "'s tag changed to " .. taggedName, source )
end
else
-- Сообщаем игроку, вызвавшему команду, что не найден игрок для замены имени
outputChatBox ( "Unable to change player tag: Player " .. thePlayer .. " not found", source )
end
end
-- Добавляем обработчик команды для консоли/чата
-- Пример: /changetag <имя> <текст>
addCommandHandler ( "changetag", tagPlayer )
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Player functions}}
[[en:setPlayerName]]

RU/GetPlayerName

2010-07-14T08:37:42Z

KGB: moved RU/GetPlayerName to RU/getPlayerName

#REDIRECT [[RU/getPlayerName]]

RU/getPlayerName

2010-07-14T08:37:42Z

KGB: moved RU/GetPlayerName to RU/getPlayerName

__NOTOC__
{{Server client function}}
Функция возвращает строку, содержащую имя указанного игрока.

==Синтаксис==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Обязательные параметры===
* '''thePlayer:''' Игрок, имя которого необходимо получить.

===Возвращаемое значение===
Возвращает строку, содержащую имя указанного игрока, или ''false'', если параметр (игрок), переданный в функцию - неверный.

==Пример==
<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>

==Смотрите также==
{{RU/Player functions}}
[[en:getPlayerName]]

Template:RU/Player functions

2010-07-14T08:36:38Z

KGB:

* [[canPlayerUseFunction]]{{RU/EN}}
* [[forcePlayerMap]]{{RU/EN}}
* [[getAlivePlayers]]{{RU/EN}}
* [[getDeadPlayers]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerAmmoInClip]]{{RU/EN}}
}}
{{New feature|3.0004|1.0.4|
* [[getPlayerAnnounceValue]]{{RU/EN}}
}}
* [[getPlayerBlurLevel]]{{RU/EN}}
* [[getPlayerCount]]{{RU/EN}}
* [[getPlayerMoney]]{{RU/EN}}
* [[getPlayerNametagColor]]{{RU/EN}}
* [[getPlayerNametagText]]{{RU/EN}}
* [[getPlayerPing]]{{RU/EN}}
* [[getPlayerTeam]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerTotalAmmo]]{{RU/EN}}
}}
{{New feature|3.0004|1.0.4|
* [[getPlayerVersion]]{{RU/EN}}
}}
* [[getPlayerWantedLevel]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerWeapon]]{{RU/EN}}
}}
* [[getRandomPlayer]]{{RU/EN}}
* [[givePlayerMoney]]{{RU/EN}}
* [[isPlayerMapForced]]{{RU/EN}}
* [[isPlayerMuted]]{{RU/EN}}
* [[isPlayerNametagShowing]]{{RU/EN}}
{{New feature|3.0004|1.0.4|
* [[setPlayerAnnounceValue]]{{RU/EN}}
}}
* [[setPlayerBlurLevel]]{{RU/EN}}
* [[setPlayerMoney]]{{RU/EN}}
* [[setPlayerMuted]]{{RU/EN}}
* [[setPlayerNametagColor]]{{RU/EN}}
* [[setPlayerNametagShowing]]{{RU/EN}}
* [[setPlayerNametagText]]{{RU/EN}}
* [[setPlayerTeam]]{{RU/EN}}
* [[setPlayerWantedLevel]]{{RU/EN}}
* [[showPlayerHudComponent]]{{RU/EN}}
* {{RUFull}} [[RU/spawnPlayer|spawnPlayer]]
* {{RUFull}} [[RU/takePlayerMoney|takePlayerMoney]]
* {{RUFull}} [[RU/getPlayerAccount|getPlayerAccount]]
* {{RUFull}} [[RU/getPlayerFromName|getPlayerFromName]]
* [[getPlayerIP|getPlayerIP]]{{RU/EN}}
* {{RUFull}} [[RU/getPlayerName|getPlayerName]]
* [[redirectPlayer|redirectPlayer]]{{RU/EN}}
* {{RUFull}} [[RU/setPlayerName|setPlayerName]]
{{Deprecated_feature|3|1.0|
* [[addPlayerClothes]]{{RU/EN}}
* [[doesPlayerHaveJetPack]]
* [[getPlayerArmor]]{{RU/EN}}
* [[getPlayerClothes]]{{RU/EN}}
* [[getPlayerContactElement]]{{RU/EN}}
* [[getPlayerFightingStyle]]{{RU/EN}}
* [[getPlayerFromNick]]{{RU/EN}}
* [[getPlayerGravity]]{{RU/EN}}
* [[getPlayerOccupiedVehicle]]{{RU/EN}}
* [[getPlayerOccupiedVehicleSeat]]{{RU/EN}}
* [[getPlayerRotation]]{{RU/EN}}
* [[getPlayerSkin]]{{RU/EN}}
* [[getPlayerStat]]{{RU/EN}}
* [[getPlayerTarget]]{{RU/EN}}
* [[getPlayerWeaponSlot]]{{RU/EN}}
* [[givePlayerJetPack]]{{RU/EN}}
* [[isPlayerChoking]]{{RU/EN}}
* [[isPlayerDead]]{{RU/EN}}
* [[isPlayerDucked]]{{RU/EN}}
* [[isPlayerInVehicle]]{{RU/EN}}
* [[isPlayerInWater]]{{RU/EN}}
* [[isPlayerOnGround]]{{RU/EN}}
* [[killPlayer]]{{RU/EN}}
* [[removePlayerClothes]]{{RU/EN}}
* [[removePlayerFromVehicle]]{{RU/EN}}
* [[removePlayerJetPack]]{{RU/EN}}
* [[setPlayerArmor]]{{RU/EN}}
* [[setPlayerChoking]]{{RU/EN}}
* [[setPlayerFightingStyle]]{{RU/EN}}
* [[setPlayerGravity]]{{RU/EN}}
* [[setPlayerRotation]]{{RU/EN}}
* [[setPlayerSkin]]{{RU/EN}}
* [[setPlayerStat]]{{RU/EN}}
* [[setPlayerWeaponSlot]]{{RU/EN}}
* [[warpPlayerIntoVehicle]]{{RU/EN}}
}}

Template:RU/Player functions

2010-07-14T08:36:10Z

KGB:

* [[canPlayerUseFunction]]{{RU/EN}}
* [[forcePlayerMap]]{{RU/EN}}
* [[getAlivePlayers]]{{RU/EN}}
* [[getDeadPlayers]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerAmmoInClip]]{{RU/EN}}
}}
{{New feature|3.0004|1.0.4|
* [[getPlayerAnnounceValue]]{{RU/EN}}
}}
* [[getPlayerBlurLevel]]{{RU/EN}}
* [[getPlayerCount]]{{RU/EN}}
* [[getPlayerMoney]]{{RU/EN}}
* [[getPlayerNametagColor]]{{RU/EN}}
* [[getPlayerNametagText]]{{RU/EN}}
* [[getPlayerPing]]{{RU/EN}}
* [[getPlayerTeam]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerTotalAmmo]]{{RU/EN}}
}}
{{New feature|3.0004|1.0.4|
* [[getPlayerVersion]]{{RU/EN}}
}}
* [[getPlayerWantedLevel]]{{RU/EN}}
{{Deprecated feature|3.0004|1.0.4|
* [[getPlayerWeapon]]{{RU/EN}}
}}
* [[getRandomPlayer]]{{RU/EN}}
* [[givePlayerMoney]]{{RU/EN}}
* [[isPlayerMapForced]]{{RU/EN}}
* [[isPlayerMuted]]{{RU/EN}}
* [[isPlayerNametagShowing]]{{RU/EN}}
{{New feature|3.0004|1.0.4|
* [[setPlayerAnnounceValue]]{{RU/EN}}
}}
* [[setPlayerBlurLevel]]{{RU/EN}}
* [[setPlayerMoney]]{{RU/EN}}
* [[setPlayerMuted]]{{RU/EN}}
* [[setPlayerNametagColor]]{{RU/EN}}
* [[setPlayerNametagShowing]]{{RU/EN}}
* [[setPlayerNametagText]]{{RU/EN}}
* [[setPlayerTeam]]{{RU/EN}}
* [[setPlayerWantedLevel]]{{RU/EN}}
* [[showPlayerHudComponent]]{{RU/EN}}
* {{RUFull}} [[RU/spawnPlayer|spawnPlayer]]
* {{RUFull}} [[RU/takePlayerMoney|takePlayerMoney]]
* {{RUFull}} [[RU/getPlayerAccount|getPlayerAccount]]
* {{RUFull}} [[RU/getPlayerFromName|getPlayerFromName]]
* [[getPlayerIP|getPlayerIP]]{{RU/EN}}
* {{RUFull}} [[getPlayerName|getPlayerName]]
* [[redirectPlayer|redirectPlayer]]{{RU/EN}}
* {{RUFull}} [[RU/setPlayerName|setPlayerName]]
{{Deprecated_feature|3|1.0|
* [[addPlayerClothes]]{{RU/EN}}
* [[doesPlayerHaveJetPack]]
* [[getPlayerArmor]]{{RU/EN}}
* [[getPlayerClothes]]{{RU/EN}}
* [[getPlayerContactElement]]{{RU/EN}}
* [[getPlayerFightingStyle]]{{RU/EN}}
* [[getPlayerFromNick]]{{RU/EN}}
* [[getPlayerGravity]]{{RU/EN}}
* [[getPlayerOccupiedVehicle]]{{RU/EN}}
* [[getPlayerOccupiedVehicleSeat]]{{RU/EN}}
* [[getPlayerRotation]]{{RU/EN}}
* [[getPlayerSkin]]{{RU/EN}}
* [[getPlayerStat]]{{RU/EN}}
* [[getPlayerTarget]]{{RU/EN}}
* [[getPlayerWeaponSlot]]{{RU/EN}}
* [[givePlayerJetPack]]{{RU/EN}}
* [[isPlayerChoking]]{{RU/EN}}
* [[isPlayerDead]]{{RU/EN}}
* [[isPlayerDucked]]{{RU/EN}}
* [[isPlayerInVehicle]]{{RU/EN}}
* [[isPlayerInWater]]{{RU/EN}}
* [[isPlayerOnGround]]{{RU/EN}}
* [[killPlayer]]{{RU/EN}}
* [[removePlayerClothes]]{{RU/EN}}
* [[removePlayerFromVehicle]]{{RU/EN}}
* [[removePlayerJetPack]]{{RU/EN}}
* [[setPlayerArmor]]{{RU/EN}}
* [[setPlayerChoking]]{{RU/EN}}
* [[setPlayerFightingStyle]]{{RU/EN}}
* [[setPlayerGravity]]{{RU/EN}}
* [[setPlayerRotation]]{{RU/EN}}
* [[setPlayerSkin]]{{RU/EN}}
* [[setPlayerStat]]{{RU/EN}}
* [[setPlayerWeaponSlot]]{{RU/EN}}
* [[warpPlayerIntoVehicle]]{{RU/EN}}
}}

RU/getPlayerName

2010-07-14T08:33:39Z

KGB:

RU/getPlayerName

2010-07-14T08:32:58Z

KGB:

RU/getPlayerName

2010-07-14T08:32:11Z

KGB:

RU/getPlayerName

2010-07-14T08:26:27Z

KGB: Created page with '__NOTOC__ {{Server client function}} Функция возвращает строку, содержащую имя указанного игрока. ==Синтаксис== <cod…'

Category:Changes in 1.1

2010-07-14T08:16:07Z

KGB: Created page with 'These are scripting functions and events or general pages that are affected by MTA:SA 1.1.'

These are scripting functions and events or general pages that are affected by MTA:SA 1.1.

Category:Элемент

2010-07-02T17:16:51Z

KGB:

[[Element|Элемент]] - общий класс, отражающий почти все внутриигровые [[entity|объекты]]. Встроенными типами элементов являются:

{{RU/Elements}}

Можно создавать любые другие элементы, которые будут абстрактны и не будут относиться к каким-либо конкретным игровым [[entity|объектам]]. Например, элементы '''ресурс''' и '''карта''' создаются когда ресурсы и карты загружают группу объектов, создаваемых ими как дочерние элементы.

Элементы объединяют общие функции, такие как тип и список параметров, операция уничтожения убирает как элемент, так и его игровое представление, с которым он связан (за исключение некоторых элементов, которые не могут быть уничтожены, например, элементы клиентов), хранение и представление [[element data|данных элемента]], и другие общие операции.

Все элементы хранятся в [[Element tree|древовидной структуре]], поэтому все элементы, кроме '''root''' имеют родительский элемент, которым может быть '''root''', '''resource''', '''map''' или другой элемент. Он определяет сферу действия вызываемой функции.

==Связанные функции скриптинга==
===Клиент===
{{Client element functions}}
===Сервер===
{{Element functions}}
[[Category:Scripting Concepts]]

[[it:Elemento]]
[[en:Element]]

RU/Debugging

2010-07-02T17:12:29Z

KGB: Translating

При написании скриптов вы обязательно столкнетесь с проблемами, которые не сможете решить немедленно. Цель этой страницы - показать вам основные способыы нахождения ошибок.

==Консоль отладки==
MTA включает консоль, которая показывает отладочные сообщения, выводимые функциями MTA и скриптами. Вы можете открыть ее введя ''debugscript x'' в консоли, где ''x'' уровень отладки:
* '''1:''' только ошибки
* '''2:''' ошибки и предупреждения
* '''3:''' ошибки, предупреждения и информационные сообщения
Так, введя ''debugscript 3'', вы будете видеть все сообщения, этот или 2 уровень рекомендуется в большинстве случаев. Рекомендуем держать debugscript включенным всё время, пока вы тестируете свой скрипт, это поможет вам обнаружить мелкие ошибки и исправить их.

===Пример===
Этот участок кода содержит две ошибки:
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor")
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
При попытке запуска скрипта, содержащего этот участо кода, debugscript выведет что-то похожее на:
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
Это означает, что скрипт не может быть обработан из-за синтаксической ошибки. Показывается путь к скрипту, поэтому вы можете увидеть, какому ресурсу он принадлежит, ('myResource' в данном случае) и, конечно же, имя скрипта. После имени файла показан номер строки и информация об ошибке. Теперь проблема легко решается, мы просто забыли написать ключевое слово 'then':
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Теперь скрипт загрузится нормально и не будет выводить ошибок пока не выполнится для игрока с ником 'Fedor'. Тогда debugscript выведет:
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
Это значит, вызванная вами функция не существует, оно и понятно, ведь правильное название этой функции ''outputChatBox'' (с заглавной буквы ''B''):
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatBox("Hello Fedor")
end
</syntaxhighlight>

Конечно, это просто пример, есть множество других сообщений и сценариев.

==Ведение лога==
Можно также включить режим дебаггера, отредактировав ''coreconfig.xml'' в папке GTA\MTA. Найдите в нем следующий тэг:
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>

И впишите туда адрес будущего лог-файла (путь указывайте, начиная с папки GTA):
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight>

И теперь все сообщения дебаггера будут записываться в этот файл. Если хотите выключить ведение лога, оставьте содержимое тэга пустым:
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>

==Стратегии отладки==
Есть несколько методов, помогающих в поиске ошибок, кроме проверки всего кода. Большинство из них включает вывод различной информации, зависящей от конкретной ситуации.

===Полезные функции===
Сперва несколько функций, которые можно использовать для отладки.
* [[outputDebugString]] или [[outputChatBox]] для вывода информации
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] для преобразования значений переменных в строки, к примеру когда они содержат булевы значения
* [[getElementType]] для определения типа элемента MTA

===Вывод отладочных сообщений для проверки ''как'', ''когда'' или ''как часто'' выполняется та или иная часть кода===
Простейшим примером является проверка, выполняется ли условие в операторе ''if''. Чтобы выполнить такую проверку, просто добавьте любое сообщение (которое вы сможете узнать впоследствии) внутрь секции, выполняемой при истинном условии в операторе ''if''.
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("entered if")
-- do anything
end
</syntaxhighlight>

{{translate}}
Another application would be to check when variable values are modified. First search for all occurences of the variable being edited and add a message just beside i

===Вывод отладочных сообщений для проверки ''значения'' переменной===
Допустим, вы хотите создать маркер, но он не появляется в ожидаемом месте. Первое, что вы возможно захотите сделать - проверить, выполняется ли функция [[createMarker]].Но одновременно с этим можно также проверить передаваемые а функцию [[createMarker]] параметры.
<syntaxhighlight lang="lua">
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))
createMarker(x,y,z)
</syntaxhighlight>
Этот код выведет 3 переменные - координаты маркера. Можно легко сравнить предполагаемые значения со значениями, выведенными при отладке. [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] преобразует переменные в строки, даже если они имеют, например, логический тип.

{{translate}}
==Пример==
Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
When a player enters the colshape, debugscript outputs the following message:
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
This means you tried to index a table that does not exist. In the example above, this is done when storing the timer id in the table. We need to add a check if the table exists and if not create it.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Now we still get a warning when a player enters the colshape, waits for the message and leaves it again:

{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

Except for that (we will talk about that later) everything seems to work fine. A player enters the colshape, the timer is started, if he stays the message occurs, if he leaves the timer is killed.

===A more inconspicuous error===
But for some reason the message gets outputted twice when you stay in the colcircle while in a vehicle. Since it would appear some code is executed twice, we add debug messages to check this.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a debug message
outputDebugString("colShapeHit")
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a debug message
outputDebugString("colShapeLeave")
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Now we notice that both handler functions get executed twice when we are in a vehicle, but only once when we are on-foot. It would appear the vehicle triggers the colshape as well. To confirm this theory, we check the ''player'' variable that '''should''' contain a player element.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

The debug messages tell us that one of the ''player'' variables is a player, the other one a vehicle element. Since we only want to react when a player enters the colshape, we add an ''if'' that will end the execution of the function if it's '''not''' an player element.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Now the script should work as desired, but will still output the warning mentioned above. This happens because the timer we try to kill when a player leaves the colshape will not exist anymore when it reached the 10 seconds and is executed. There are different ways to get rid of that warning (since you know that the timer might not exist anymore and you only want to kill it if it is there). One way would be to check if the timer referenced in the table really exists. To do this, we need a little help function:
<syntaxhighlight lang="lua">
function isTimer(timer)
local timers = getTimers()
for k,v in ipairs(timers) do
if (v == timer) then
return true
end
end
return false
end
</syntaxhighlight>
Which we will use when we kill the timer:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

So the complete working code would be:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)

function isTimer(timer)
local timers = getTimers()
for k,v in ipairs(timers) do
if (v == timer) then
return true
end
end
return false
end
</syntaxhighlight>

[[Category:Scripting Concepts]]
[[en:Debugging]]
[[it:Guida al Debug]]

RU/Server Scripting Events

2010-06-11T11:12:45Z

KGB:

{{translate}}
<pageclass class="server"></pageclass>
На этой странице перечислены все '''серверные''' скрипты [[RU/Client Scripting Events|события]], которые были реализованы и доступны в Deathmatch моде. Чтобы получить функцию или событие, используйте [[RU/Client Scripting Events|Запрашиваемые функции и события]].

'''События, генерируемые на клиентской стороне, можно найти здесь: [[RU/Client Scripting Events|cобытия, генерируемые на стороне клиента]].

==Клиентские события==
{{Client_events}}

==Colshape события==
{{Colshape_events}}

==События элементов==
{{Element_events}}

==События маркеров==
{{Marker_events}}

==События пикапов==
{{Pickup_events}}

==События игрока==
{{Player_events}}

==События педов==
{{Ped_events}}

==События ресурсов==
{{Resource_events}}

==Серверные события==
{{Server_events}}

==События транспорта==
{{RU/Vehicle_events}}
[[en:Server Scripting Events]]

Getting MTA:SA to work with wine

2009-07-17T15:58:06Z

KGB:

You will need the latest version of Wine to get the installer working.

Install MTA:SA:DM, it does not matter wherever you install MTA, and the GTA:SA path.

You will need the version of Wine greater than 0.9.49 to run MTA:SA:DM.

Once you installed it, download the [http://ijs.bastage.net/mta/mta_unix.zip *nix loader], and extract it to your GTA:SA directory.

Download the fonts [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] and [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] needed by CEGUI, and place them in $HOME/.wine/drive_c/windows/fonts/

Open <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, go to the graphics tab, and uncheck "Allow Pixel Shader".

Remove in your GTA:SA directory MTA/data/menu.mkv

Paste [http://pastebin.com/f4c91e22b this] in MTA/coreconfig.xml (menu_options must be always 7).

Run MTA_SA_unix.exe

[[ru:Getting MTASADM to work with wine]]

Getting MTA:SA to work with wine

2009-07-17T15:56:46Z

KGB:

RU/Getting MTA:SA to work with wine

2009-07-17T15:54:55Z

KGB: New page: Вам понадобится последняя версия Wine. Установите MTA:SA:DM, абсолютно не важно, какой у Вас путь к MTA и к GTA:SA. ...

Вам понадобится последняя версия Wine.

Установите MTA:SA:DM, абсолютно не важно, какой у Вас путь к MTA и к GTA:SA.

Вам нужен Wine версии 0.9.49 или более поздней для запуска MTA:SA:DM.

Как только установите его, скачайте [http://ijs.bastage.net/mta/mta_unix.zip Загрузчик для *nix ], и извлеките его в папку с GTA:SA.

Скачайте шрифты [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] и [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] нужные для CEGUI, и скопируйте их в $HOME/.wine/drive_c/windows/fonts/

Откройте <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, перейдите на вкладку "Графика", и снимите флажок "Разрешить Пиксельные Шейдеры".

Удалите из вашей папки с GTA:SA файл MTA/data/menu.mkv

Вставьте [http://pastebin.com/f4c91e22b это] в MTA/coreconfig.xml (menu_options всегда должен быть равен 7).

Запустите MTA_SA_unix.exe

RU/Server Manual

2009-07-17T15:29:04Z

KGB: /* Установка/обвновление файлов ресурсов на вашем сервере */

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

Этот файл удобно редактировать: каждая переменная имеет описание того, что с помощью нее можно изменить и какие значения она может принимать.

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получиться, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть наилучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера, находится в разработке.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно, то сервер нормально запущен и функционирует!

==Установка/обновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование сервера==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[de:MTA DM Server Anleitung]]
[[en:Deathmatch Server Manual]]
[[it:Manuale del Server]]
[[nl:Deathmatch Server Manual]]