This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "Bz eGetPlayerMotto"

From BZFlagWiki
Jump to: navigation, search
m (Data: Forgot a break in the table row.)
m (v1 and v2 info)
 
(One intermediate revision by the same user not shown)
Line 6: Line 6:
  
 
==Data==
 
==Data==
'''bz_eGetPlayerMotto''' returns the '''bz_GetPlayerMottoData_V1''' data class.
+
'''bz_eGetPlayerMotto''' returns the '''bz_GetPlayerMottoData_V1''' or '''bz_GetPlayerMottoData_V2''' data class.
  
 
   {| border="1" cellpadding="20" cellspacing="0"
 
   {| border="1" cellpadding="20" cellspacing="0"
Line 20: Line 20:
 
   |bz_ApiString
 
   |bz_ApiString
 
   |The motto of the joining player.
 
   |The motto of the joining player.
 +
  |-
 +
  |record
 +
  |[[bz_BasePlayerRecord]]
 +
  |The player record for the player using the motto (requires bz_GetPlayerMottoData_V2).
 
   |-
 
   |-
 
   |eventTime
 
   |eventTime

Latest revision as of 22:00, 28 February 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_eGetPlayerMotto is an API event that is called when the player joins. It gives us the motto of the player.

Data[edit]

bz_eGetPlayerMotto returns the bz_GetPlayerMottoData_V1 or bz_GetPlayerMottoData_V2 data class.

name type value description
eventType bz_eEventType bz_eGetPlayerMotto
motto bz_ApiString The motto of the joining player.
record bz_BasePlayerRecord The player record for the player using the motto (requires bz_GetPlayerMottoData_V2).
eventTime double The server time the event occurred (in seconds.)

Uses[edit]

This event is called before the ePlayerJoinEvent. So what you can do is store the motto in a string, and later check it when you get the other player data. As of 2.4.0, this is the only method of getting the motto.