This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "Bz eFlagDroppedEvent"
From BZFlagWiki
m (also added eventTime here) |
|||
| (11 intermediate revisions by 6 users not shown) | |||
| Line 3: | Line 3: | ||
==Overview== | ==Overview== | ||
| − | The | + | The '''bz_eFlagDroppedEvent''' is an API event that is called each time a flag is dropped by a player. |
==Data== | ==Data== | ||
| − | + | '''bz_eFlagDroppedEvent''' returns the '''bz_FlagDroppedEventData_V1''' data class. | |
| − | + | ||
| − | + | {| border="1" cellpadding="20" cellspacing="0" | |
| − | + | !name | |
| − | + | !type | |
| − | + | !value desription | |
| + | |- | ||
| + | |eventType | ||
| + | |[[Event(API)|bz_eEventType]] | ||
| + | |bz_eFlagDroppedEvent | ||
| + | |- | ||
| + | |playerID | ||
| + | |int | ||
| + | |The player that dropped the flag (this value may be set to -1 if the player ID is unknown). | ||
| + | |- | ||
| + | |flagID | ||
| + | |int | ||
| + | |The flag ID that was dropped | ||
| + | |- | ||
| + | |flagType | ||
| + | |[[bz_ApiString]] | ||
| + | |The flag abbreviation of the flag that was grabbed | ||
| + | |- | ||
| + | |pos | ||
| + | |float[3] | ||
| + | |The position at which the flag was dropped | ||
| + | |- | ||
| + | |eventTime | ||
| + | |double | ||
| + | |The server time at which the event occurred (in seconds). | ||
| + | |} | ||
==Uses== | ==Uses== | ||
| − | This event is a notification only event, none of the data returned can be changed. If the plug-in wishes to change the spawning position of a flag it should use the [[bz_eFlagResetEvent]] | + | This event is a notification-only event, none of the data returned can be changed. If the plug-in wishes to change the spawning position of a flag it should use the [[bz_eFlagResetEvent]] |
| + | |||
| + | ==History== | ||
| + | In Version 2.0.x of BZFlag the data class for this event was named '''bz_FlagDroppedEventData''' and contains the same data. | ||
[[Category:BZFS_API_Docs]] | [[Category:BZFS_API_Docs]] | ||
[[Category:BZFS_API_Events]] | [[Category:BZFS_API_Events]] | ||
Latest revision as of 07:45, 1 May 2014
| 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.
Contents
Overview[edit]
The bz_eFlagDroppedEvent is an API event that is called each time a flag is dropped by a player.
Data[edit]
bz_eFlagDroppedEvent returns the bz_FlagDroppedEventData_V1 data class.
| name | type | value desription |
|---|---|---|
| eventType | bz_eEventType | bz_eFlagDroppedEvent |
| playerID | int | The player that dropped the flag (this value may be set to -1 if the player ID is unknown). |
| flagID | int | The flag ID that was dropped |
| flagType | bz_ApiString | The flag abbreviation of the flag that was grabbed |
| pos | float[3] | The position at which the flag was dropped |
| eventTime | double | The server time at which the event occurred (in seconds). |
Uses[edit]
This event is a notification-only event, none of the data returned can be changed. If the plug-in wishes to change the spawning position of a flag it should use the bz_eFlagResetEvent
History[edit]
In Version 2.0.x of BZFlag the data class for this event was named bz_FlagDroppedEventData and contains the same data.
