This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "Bz eFilteredChatMessageEvent"
(New page: {{BZFS_API_Doc}} {{BZFS_API_Events}} {{Stub}} ==Overview== The '''bz_eFilteredChatMessageEvent''' is an API event that is called each time a filtered chat message is received. ==Data== '...) |
(→Uses: hyphenated compound adjective) |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{BZFS_API_Doc}} | {{BZFS_API_Doc}} | ||
{{BZFS_API_Events}} | {{BZFS_API_Events}} | ||
− | + | ||
==Overview== | ==Overview== | ||
− | The '''bz_eFilteredChatMessageEvent''' is an API event that is called each | + | The '''bz_eFilteredChatMessageEvent''' is an API event that is called for each chat message the server receives. It is called after the server or any plug-ins have done chat filtering. |
==Data== | ==Data== | ||
− | '''bz_eFilteredChatMessageEvent''' returns the ''' | + | '''bz_eFilteredChatMessageEvent''' returns the '''bz_ChatEventData_V1''' data class, this class is shared with the [[bz_eRawChatMessageEvent]] event. |
− | + | {| border="1" cellpadding="20" cellspacing="0" | |
!name | !name | ||
!type | !type | ||
Line 16: | Line 16: | ||
|eventType | |eventType | ||
|[[Event(API)|bz_eEventType]] | |[[Event(API)|bz_eEventType]] | ||
− | |bz_eFilteredChatMessageEvent | + | |bz_eFilteredChatMessageEvent. |
|- | |- | ||
− | | | + | |from |
− | | | + | |int |
− | | | + | |The player ID sending the message. |
+ | |- | ||
+ | |to | ||
+ | |int | ||
+ | |The player ID that the message is to if the message is to an individual, or a broadcast. If the message is a broadcast the id will be BZ_ALLUSERS. | ||
+ | |- | ||
+ | |team | ||
+ | |[[bz_eTeamType]] | ||
+ | |The team the message is for if it not for an individual or a broadcast. If it is not a team message the team will be eNoTeam. | ||
+ | |- | ||
+ | |message | ||
+ | |[[bz_ApiString]] | ||
+ | |The filtered final text of the message. | ||
+ | |- | ||
+ | |eventTime | ||
+ | |double | ||
+ | |The time of the event. | ||
|} | |} | ||
==Uses== | ==Uses== | ||
− | + | This is a notification-only event. The text of the chat message can not be changed, and has been pre-filtered. This event is the primary hook for plug-ins that wish to implement chat logging or chat relay. Plug-ins that wish to do chat filtering should use the [[bz_eRawChatMessageEvent]] event. | |
− | + | ||
− | [[ | + | |
− | + |
Latest revision as of 23:30, 27 January 2013
BZFS API Documentation This page contains part of the BZFS API documentation for use by Plug-ins on the BZFS server. |
BZFS Event. This page documents a BZFS event that is called by the game server to notify plug-ins of various actions and state changes in the game world.
Overview[edit]
The bz_eFilteredChatMessageEvent is an API event that is called for each chat message the server receives. It is called after the server or any plug-ins have done chat filtering.
Data[edit]
bz_eFilteredChatMessageEvent returns the bz_ChatEventData_V1 data class, this class is shared with the bz_eRawChatMessageEvent event.
name | type | value description |
---|---|---|
eventType | bz_eEventType | bz_eFilteredChatMessageEvent. |
from | int | The player ID sending the message. |
to | int | The player ID that the message is to if the message is to an individual, or a broadcast. If the message is a broadcast the id will be BZ_ALLUSERS. |
team | bz_eTeamType | The team the message is for if it not for an individual or a broadcast. If it is not a team message the team will be eNoTeam. |
message | bz_ApiString | The filtered final text of the message. |
eventTime | double | The time of the event. |
Uses[edit]
This is a notification-only event. The text of the chat message can not be changed, and has been pre-filtered. This event is the primary hook for plug-ins that wish to implement chat logging or chat relay. Plug-ins that wish to do chat filtering should use the bz_eRawChatMessageEvent event.