Reitside at 17:10, 4 December 2017

2017-12-04T17:10:42Z

← Older revision		Revision as of 17:10, 4 December 2017
Line 3:		Line 3:
	Это событие вызывается, когда игрок отправляет сообщение в чат.		Это событие вызывается, когда игрок отправляет сообщение в чат.

	==~~Parameters~~==		==Параметры==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string message, int messageType		string message, int messageType

Reitside: Created page with "NOTOC {{RU/Server event}} Это событие вызывается, когда игрок отправляет сообщение в чат. ==Parameters==
2017-12-04T17:09:40Z

Created page with "NOTOC {{RU/Server event}} Это событие вызывается, когда игрок отправляет сообщение в чат. ==Parameters== <syntaxhighl..."

New page
NOTOC
{{RU/Server event}}
Это событие вызывается, когда игрок отправляет сообщение в чат.

==Parameters==
<syntaxhighlight lang="lua">
string message, int messageType
</syntaxhighlight>

'''message'''. Строка, представляющая собой сообщение, введённое в чат.
'''messageType'''. Целочисленное значение, представляющее тип сообщения:
'''0'''. обычное сообщение;
'''1'''. сообщение о действии (/me);
**'''2'''. командное сообщение.

==Источник==
[[RU/Event system#Источник|Источником]] этого события является [[RU/Element/Player|игрок]], который отправил сообщение в чат.

==Отмена эффекта==
Если это событие [[RU/Event system#Отмена событий|отменено]], система чата игры не будет отправлять сообщения. Вы можете использовать функцию [[RU/outputChatBox|outputChatBox]] для отправки потом сообщений.
Отмена этого события также означает, что чат не будет отображаться в консоли сервера или логах. Если Вы хотите вести логирование чата, Вам нужно будет добавить вызов функции [[RU/outputServerLog|outputServerLog]].

==Примеры==
'''Пример 1'''. В этом примере ограничивается приём сообщений чата сферической области вокруг игрока, который отправил сообщение, а также блокирует действие и текст команды.
<syntaxhighlight lang="lua">
local chatRadius = 20
function sendMessageToNearbyPlayers(message, messageType)
if messageType == 0 then
local posX, posY, posZ = getElementPosition(source)
local chatSphere = createColSphere(posX, posY, posZ, chatRadius)
local nearbyPlayers = getElementsWithinColShape(chatSphere, "player")
destroyElement(chatSphere)
for index, nearbyPlayer in ipairs(nearbyPlayers) do
outputChatBox(message, nearbyPlayer)
end
end
end
addEventHandler("onPlayerChat", getRootElement(), sendMessageToNearbyPlayers)
function blockChatMessage()
cancelEvent()
end
addEventHandler("onPlayerChat", getRootElement(), blockChatMessage)
</syntaxhighlight>

'''Пример 2'''. В этом примере реализованы цветные имена игроков в чате.
<syntaxhighlight lang="lua">
local function playerJoin()
local red, green, blue = math.random(50, 255), math.random(50, 255), math.random(50, 255)
setPlayerNametagColor(source, red, green, blue)
end
addEventHandler("onPlayerJoin", root, playerJoin)
local function playerChat(message, messageType)
if messageType == 0 then
cancelEvent()
local red, green, blue = getPlayerNametagColor(source)
outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
outputServerLog("Чат: "..getPlayerName(source)..": "..message)
end
end
addEventHandler("onPlayerChat", root, playerChat)
</syntaxhighlight>

'''Пример 3'''. В этом примере убивается тот игрок, который отправил в чат сообщение ''kill''.
<syntaxhighlight lang="lua">
function onChat(message, messageType)
if string.find(message, 'kill') then
killPed(source, source)
end
end
addEventHandler("onPlayerChat", getRootElement(), onChat)
</syntaxhighlight>

{{RU/See also/Server event|RU/Player events|События игрока}}

[[en:onPlayerChat]]