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

From BZFlagWiki
Jump to navigation Jump to search
Allejo (talk | contribs)
m also added eventTime here
 
(3 intermediate revisions by 2 users not shown)
Line 19: Line 19:
   |playerID     
   |playerID     
   |int
   |int
   |The player that dropped the flag
   |The player that dropped the flag (this value may be set to -1 if the player ID is unknown).
   |-
   |-
   |flagID       
   |flagID       
   |int
   |int
   |The flag ID that was dropped
   |The flag ID that was dropped
  |-
  |flagType     
  |[[bz_ApiString]]
  |The flag abbreviation of the flag that was grabbed
   |-
   |-
   |pos
   |pos
   |float[3]
   |float[3]
   |The position at which the flag was dropped
   |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==
==History==

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.


Overview

The bz_eFlagDroppedEvent is an API event that is called each time a flag is dropped by a player.

Data

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

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.