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

bz eGetPlayerSpawnPosEvent

From BZFlagWiki
Jump to: navigation, search
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_eGetPlayerSpawnPosEvent is an API event that is called each time the server needs a new spawn position.

Data[edit]

bz_eGetPlayerSpawnPosEvent returns the bz_GetPlayerSpawnPosEventData_V1 data class.

name type value description
eventType bz_eEventType bz_eGetPlayerSpawnPosEventData
playerID int ID of the player that is requesting the spawn position.
team bz_eTeamType The team the player is currently in.
handled bool The current state representing if other plug-ins have modified the spawn position. Plug-ins that modify the spawn position should set this value to true to inform other plug-ins that have not processed yet.
pos float[3] Position where the player will be spawned. This value is initialized to the server computed spawn position using the current spawn rules.
rot float The rotational direction that the player will be spawned at. This value is initialized to the server computed spawn rotation using the current spawn rules.
eventTime double The server time at which the event occurred (in seconds).

Uses[edit]

This is a modification event, plug-ins may change the pos and rot fields to effect changes in the spawn position that is used for the player.