This wiki is archived and useful information is being migrated to the main bzflag.org website
bz eRawChatMessageEvent
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_eRawChatMessageEvent is an API event that is called for each chat message the server receives. It is called before any filtering is done.
Data
bz_eRawChatMessageEvent returns the bz_ChatEventData_V1 data class, this class is shared with the bz_eFilteredChatMessageEvent 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 modification event. The text of the message can be changed and will be used to send the actual message to all other users. This event is the primary hook for plug-ins that wish to implement custom chat filters.