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 sendTextMessage: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
Tulcod (talk | contribs)
No edit summary
No edit summary
Line 1: Line 1:
{{BZFS_API_Doc}}
{{BZFS_API_Doc}}
{{BZFS_API_Funcs}}
{{BZFS_API_Funcs}}
==Prototype==
==Prototype==
BZF_API bool bz_sendTextMessage (int from, int to, const char* message);
BZF_API bool bz_sendTextMessage (int from, int to, const char* message);
BZF_API bool bz_sendTextMessage (int from, bz_eTeamType to, const char* message);
BZF_API bool bz_sendTextMessage (int from, [[bz_eTeamType]] to, const char* message);


==Parameters==
==Parameters==
* int from: From which player do we need to pretend this message is coming from?
* int from: The player ID that the message will appear to be from. This must be a valid player ID, or BZ_SERVER if the message is to be a system message.
* int to: To which player or team are we sending this message?
* int to: The target player ID to send the message to. This must be a valid player ID or BZ_ALLUSERS if the message is to be broadcast to all connected users.
* const char* message: The message to be sent
* [[bz_eTeamType]] to: The target team to send the message to. This must be a valid team enumeration from [[bz_eTeamType]].
* const char* message: The text of the message to be sent.


==Description==
==Description==
This API function will cause the server to send a message to a player or team
This API function will cause the server to send a text message to a single player, all players, or team. The text message can be made to appear from any user or the server itself.
 
==Usage==
If you want to send a message, use this function. This can be used for private messages based on previous input.
 
==Notes==
Want to send a message coming from the server, and not pretend to be someone else? Use BZ_SERVER for the from argument.

Revision as of 21:51, 27 November 2007

BZFS API Documentation This page contains part of the BZFS API documentation for use by Plug-ins on the BZFS server.
BZFS API Function. This page documents a BZFS_API Function, that is provided by the BZFS game server for plug-ins to call.



Prototype

BZF_API bool bz_sendTextMessage (int from, int to, const char* message); BZF_API bool bz_sendTextMessage (int from, bz_eTeamType to, const char* message);

Parameters

  • int from: The player ID that the message will appear to be from. This must be a valid player ID, or BZ_SERVER if the message is to be a system message.
  • int to: The target player ID to send the message to. This must be a valid player ID or BZ_ALLUSERS if the message is to be broadcast to all connected users.
  • bz_eTeamType to: The target team to send the message to. This must be a valid team enumeration from bz_eTeamType.
  • const char* message: The text of the message to be sent.

Description

This API function will cause the server to send a text message to a single player, all players, or team. The text message can be made to appear from any user or the server itself.