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

bz eGetPlayerSpawnPosEvent

From BZFlagWiki
Revision as of 17:59, 28 November 2007 by JeffM2501 (Talk | contribs)

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

The bz_eGetPlayerSpawnPosEvent is an API event that is called each time the server needs a new spawn postion.

Data

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.
time double The local server time of the event.

Uses

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.