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

From BZFlagWiki
Jump to navigation Jump to search
Tulcod (talk | contribs)
New page: {{BZFS_API_Doc}} {{BZFS_API_Events}} ==Overview== The '''bz_eGetAutoTeamEvent''' is an API event that is called when the server needs to know which team to add a new player to. ==Data== ...
 
No edit summary
Line 3: Line 3:


==Overview==
==Overview==
The '''bz_eGetAutoTeamEvent''' is an API event that is called when the server needs to know which team to add a new player to.
The '''bz_eGetAutoTeamEvent''' is an API event that is called for each new player is added to a team.


==Data==
==Data==
Line 19: Line 19:
   |playerID
   |playerID
   |int
   |int
   |ID of the new player
   |ID of the player that is being added to the game.
   |-
   |-
   |callsign
   |callsign
   |bzApiString
   |[[bz_ApiString]]
   |Callsign of the new player
   |Callsign of the player that is being added to the game.
   |-
   |-
   |team
   |team
   |bz_eTeamType
   |[[bz_eTeamType]]
   |The team bzfs chose the player to belong to, you CAN change this
   |The team that the player will be added to. Initalised to the team chosen by the current server team rules, or the effects of a plug-in that has previously processed the event. Plug-ins wishing to override the team should set this value.
   |-
   |-
   |handled
   |handled
   |bool
   |bool
   |Set this value to true once you've modified the team, so that other plugins will know they shouldn't modify it again
   |The current state representing if other plug-ins have modified the default team. Plug-ins that modify the team should set this value to true to inform other plug-ins that have not processed yet.
   |}
   |}


==Uses==
==Uses==
You can use this event to let team choosing be done by a plugin.
This is a modification event, the final results of the team member will be used and sent to the requesting player. Please note that this event can override the users team choice.
 
[[Category:BZFS_API_Docs]]
[[Category:BZFS_API_Events]]

Revision as of 18:07, 28 November 2007

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_eGetAutoTeamEvent is an API event that is called for each new player is added to a team.

Data

bz_eGetAutoTeamEvent returns the bz_GetAutoTeamEventData_V1 data class.

name type value description
eventType bz_eEventType bz_eGetAutoTeamEvent
playerID int ID of the player that is being added to the game.
callsign bz_ApiString Callsign of the player that is being added to the game.
team bz_eTeamType The team that the player will be added to. Initalised to the team chosen by the current server team rules, or the effects of a plug-in that has previously processed the event. Plug-ins wishing to override the team should set this value.
handled bool The current state representing if other plug-ins have modified the default team. Plug-ins that modify the team should set this value to true to inform other plug-ins that have not processed yet.

Uses

This is a modification event, the final results of the team member will be used and sent to the requesting player. Please note that this event can override the users team choice.