This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.
Bz eFilteredChatMessageEvent: Difference between revisions
 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== '...  | 
				mNo edit summary  | 
				||
| 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_eRawChatMessageEvent.  | ||
  |-  | |||
  |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 unfiltered 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 longing or chat relay. Plug-ins that wish to do chat filtering should use the [[bz_eRawChatMessageEvent]] event.  | |||
[[  | |||
Revision as of 17:43, 28 November 2007
| 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
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
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_eRawChatMessageEvent. | 
| 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 unfiltered text of the message. | 
| eventTime | double | The time of the event. | 
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 longing or chat relay. Plug-ins that wish to do chat filtering should use the bz_eRawChatMessageEvent event.