This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "Bz eGetPlayerMotto"
From BZFlagWiki
(Created Documentation for this API Event. (sigonasr2)) |
m (v1 and v2 info) |
||
(4 intermediate revisions by 3 users 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 | ||
+ | |double | ||
+ | |The server time the event occurred (in seconds.) | ||
|} | |} | ||
==Uses== | ==Uses== | ||
− | This event is called | + | 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. |
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.