Grimes: Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTrySendChat |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player attempts to..."

2021-05-15T00:39:30Z

Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTrySendChat |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player attempts to..."

New page

{{Template:DCS_hooks_callbacks

|fName= onPlayerTrySendChat

|vNum= 2.5.0

|par1= [[DCS_server_hooks|hook]]

|par2=

|par3=

|par4=

|desc= Occurs when a player attempts to send a chat message. This function can be used to suppress or modify the message from appearing. For example chat commands can be created for admins by checking who sent the message and doing an action based on that.

playerId is who sent the message

message is a string of what they typed.

all is a boolean if the message is to all.

'''IMPORTANT: ''' If any value is returned with this function then any other callback that uses it will be ignored. If no choice is to be made, then do NOT return any value.

|rtnType= nothing

|rtnExample= Value 1: string
Filtered message
"" An empty string. If empty the message will not be sent.

|reqType1= number

|reqName1= playerId

|reqType2= string

|reqName2= message

|reqType3= boolean

|reqName3= all

|reqType4=

|reqName4=

|reqType5=

|optType1=

|optName1=

|optType2=

|related=
List of Callbacks: {{listOfDCSHooks}}

|examples= Replaces any occurrence of the word "hockey" with "Go Avs Go" in a chat message. Additionally if someone tries to say "Detroit Red Wings" then the message will be suppressed.

function myCall.onPlayerTrySendChat(id, msg, all)
if string.gsub(msg, "hockey") then
return "Go Avs Go"
elseif string.find("Detroit Red Wings") then
return ""
end
end
|notes=
}}
[[Category:DCS Hooks|onPlayerTrySendChat]]

DCS hook onPlayerTrySendChat - Revision history

Grimes: Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTrySendChat |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player attempts to..."