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

Editing Functions (API)

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Archived wiki

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
{{DoDoc|
+
{{DoDoc|Fill in articles for all API Functions}}
Fill in articles for all API Functions<br>
+
Finish updating to 2.3.x<br>
+
Verify future API functions.
+
}}
+
  
{{BZFS_API_Doc|keeptitle=1}}
+
{{BZFS_API_Doc}}
  
  
Line 16: Line 12:
  
 
=== Event Registration ===
 
=== Event Registration ===
2.0.x
+
  BZF_API bool [[bz_registerEvent]] ( [[Events(API)|bz_eEventType]] eventType, [[Events(API)|bz_EventHandler]]* eventHandler );
  BZF_API bool [[bz_registerEvent]] ( [[Event(API)|bz_eEventType]] eventType, [[Event(API)|bz_EventHandler]]* eventHandler );
+
  BZF_API bool [[bz_removeEvent]] ( [[Events(API)|bz_eEventType]] eventType, [[Events(API)|bz_EventHandler]]* eventHandler );
  BZF_API bool [[bz_removeEvent]] ( [[Event(API)|bz_eEventType]] eventType, [[Event(API)|bz_EventHandler]]* eventHandler );
+
2.3+
+
BZF_API bool [[Register]] ( [[Event(API)|bz_eEventType]] eventType );
+
virtual void Cleanup() {Flush();}
+
  
 
=== Non-Player Connections ===
 
=== Non-Player Connections ===
2.3+
 
 
  BZF_API bool [[bz_registerNonPlayerConnectionHandler]] ( int connectionID, [[bz_NonPlayerConnectionHandler]]* handler );
 
  BZF_API bool [[bz_registerNonPlayerConnectionHandler]] ( int connectionID, [[bz_NonPlayerConnectionHandler]]* handler );
 
  BZF_API bool [[bz_removeNonPlayerConnectionHandler]] ( int connectionID, [[bz_NonPlayerConnectionHandler]]* handler );
 
  BZF_API bool [[bz_removeNonPlayerConnectionHandler]] ( int connectionID, [[bz_NonPlayerConnectionHandler]]* handler );
Line 35: Line 26:
 
=== Player Information ===
 
=== Player Information ===
 
==== Player Information ====
 
==== Player Information ====
2.3+
 
 
  BZF_API bool [[bz_hasPerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_hasPerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_getAdmin]] ( int playerID );
 
  BZF_API bool [[bz_getAdmin]] ( int playerID );
Line 41: Line 31:
 
  BZF_API const char* [[bz_getPlayerCallsign]] ( int playerID );
 
  BZF_API const char* [[bz_getPlayerCallsign]] ( int playerID );
 
  BZF_API const char* [[bz_getPlayerIPAddress]] ( int playerID );
 
  BZF_API const char* [[bz_getPlayerIPAddress]] ( int playerID );
BZF_API const char* [[bz_getPlayerFlag]] ( int playerID );
 
?
 
 
  BZF_API const char* [[bz_getPlayerReferrer]] ( int playerID );
 
  BZF_API const char* [[bz_getPlayerReferrer]] ( int playerID );
 
  BZF_API const char* [[bz_getPlayerCustomData]] (int playerID, const char* key );
 
  BZF_API const char* [[bz_getPlayerCustomData]] (int playerID, const char* key );
 +
BZF_API const char* [[bz_getPlayerFlag]] ( int playerID );
 +
BZF_API const char* [[bz_getPlayerCallsign]] ( int playerID );
  
 
==== Player State Information ====
 
==== Player State Information ====
2.3+
 
BZF_API bool [[bz_isPlayerPaused]] ( int playerID );
 
BZF_API bool [[bz_isPlayerSpawnable]] ( int playerID );
 
BZF_API bool [[bz_getPlayerCurrentState]] ( int playerID, bz_PlayerUpdateState &state );
 
BZF_API bool [[bz_getPlayerSpawnAtBase]] ( int playerId );
 
BZF_API bool [[bz_setPlayerSpawnable]] ( int playerID, bool spawn );
 
BZF_API void [[bz_setPlayerSpawnAtBase]] ( int playerId, bool base );
 
?
 
 
  BZF_API bool [[bz_getPlayerPosition]] ( int playerID, float pos[3], bool extrapolate );
 
  BZF_API bool [[bz_getPlayerPosition]] ( int playerID, float pos[3], bool extrapolate );
 
  BZF_API bool [[bz_getPlayerRotation]] ( int playerID, float *rot, bool extrapolate );
 
  BZF_API bool [[bz_getPlayerRotation]] ( int playerID, float *rot, bool extrapolate );
Line 60: Line 42:
 
  BZF_API bool [[bz_getPlayerAngVel]] ( int playerID, float *angvel );
 
  BZF_API bool [[bz_getPlayerAngVel]] ( int playerID, float *angvel );
 
  BZF_API bool [[bz_getPlayerPhysicsDriver]] ( int playerID, int* phydrv );
 
  BZF_API bool [[bz_getPlayerPhysicsDriver]] ( int playerID, int* phydrv );
 +
BZF_API bool [[bz_isPlayerPaused]] ( int playerID );
 +
BZF_API bool [[bz_canPlayerSpawn]]( int playerID );
  
 
==== Player Lists and Records ====
 
==== Player Lists and Records ====
2.3+
 
 
  BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByIndex]] ( int index );
 
  BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByIndex]] ( int index );
  BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerBySlotOrCallsign]] ( const char* name );
+
  BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByCallsign]] ( const char* name );
 +
BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByBZID]] ( int BZID );
 
  BZF_API bool [[bz_updatePlayerData]] ( [[bz_BasePlayerRecord]] *playerRecord );
 
  BZF_API bool [[bz_updatePlayerData]] ( [[bz_BasePlayerRecord]] *playerRecord );
 
  BZF_API bool [[bz_freePlayerRecord]] ( [[bz_BasePlayerRecord]] *playerRecord );
 
  BZF_API bool [[bz_freePlayerRecord]] ( [[bz_BasePlayerRecord]] *playerRecord );
Line 72: Line 56:
 
  BZF_API bool [[bz_getPlayerIndexList]] ( [[bz_APIIntList]] *playerList );
 
  BZF_API bool [[bz_getPlayerIndexList]] ( [[bz_APIIntList]] *playerList );
 
  BZF_API void [[bz_deleteIntList]] ( [[bz_APIIntList]] *l);
 
  BZF_API void [[bz_deleteIntList]] ( [[bz_APIIntList]] *l);
 
Unknown
 
BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByBZID]] ( int BZID );
 
BZF_API [[bz_BasePlayerRecord]] *[[bz_getPlayerByCallsign]] ( const char* name );
 
  
 
==== Player Management ====
 
==== Player Management ====
2.3+
 
 
  BZF_API bool [[bz_grantPerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_grantPerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_revokePerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_revokePerm]] ( int playerID, const char* perm );
 
  BZF_API bool [[bz_validAdminPassword]] ( const char* passwd );
 
  BZF_API bool [[bz_validAdminPassword]] ( const char* passwd );
 
  BZF_API bool [[bz_setPlayerOperator]] ( int playerId );
 
  BZF_API bool [[bz_setPlayerOperator]] ( int playerId );
?
+
BZF_API bool [[bz_setPlayerSpawnable]]( int playerID, bool spawn );
 
  BZF_API bool [[bz_setPlayerLimboMessage]]( int playerID, const char* text );
 
  BZF_API bool [[bz_setPlayerLimboMessage]]( int playerID, const char* text );
 
  BZF_API bool [[bz_setPlayerCustomData]] (int playerID, const char* key, const char* data );
 
  BZF_API bool [[bz_setPlayerCustomData]] (int playerID, const char* key, const char* data );
  
 
=== Team Management ===
 
=== Team Management ===
2.3+
+
  BZF_API unsigned int [[bz_getTeamPlayerLimit]] ( bz_eTeamType team )
  BZF_API unsigned int [[bz_getTeamPlayerLimit]] ( bz_eTeamType team );
+
 
  BZF_API int [[bz_getTeamCount]] ([[bz_eTeamType]] team );
 
  BZF_API int [[bz_getTeamCount]] ([[bz_eTeamType]] team );
 
  BZF_API int [[bz_getTeamScore]] ([[bz_eTeamType]] team );
 
  BZF_API int [[bz_getTeamScore]] ([[bz_eTeamType]] team );
Line 96: Line 74:
 
  BZF_API void [[bz_setTeamWins]] ([[bz_eTeamType]] team, int wins );
 
  BZF_API void [[bz_setTeamWins]] ([[bz_eTeamType]] team, int wins );
 
  BZF_API void [[bz_setTeamLosses]] ([[bz_eTeamType]] team, int losses );
 
  BZF_API void [[bz_setTeamLosses]] ([[bz_eTeamType]] team, int losses );
BZF_API void [[bz_incrementTeamWins]] (bz_eTeamType team, int increment);
 
BZF_API void [[bz_incrementTeamLosses]] (bz_eTeamType team, int increment);
 
 
  BZF_API void [[bz_resetTeamScore]] ([[bz_eTeamType]] team );
 
  BZF_API void [[bz_resetTeamScore]] ([[bz_eTeamType]] team );
 
  BZF_API void [[bz_resetTeamScores]] ( void );
 
  BZF_API void [[bz_resetTeamScores]] ( void );
?
 
 
  BZF_API void [[bz_changeTeam]]( int player, [[bz_eTeamType]] team );
 
  BZF_API void [[bz_changeTeam]]( int player, [[bz_eTeamType]] team );
  
 
=== Score Management ===
 
=== Score Management ===
2.3+
 
 
  BZF_API bool [[bz_setPlayerWins]] ( int playerId, int wins );
 
  BZF_API bool [[bz_setPlayerWins]] ( int playerId, int wins );
 
  BZF_API bool [[bz_setPlayerLosses]] ( int playerId, int losses );
 
  BZF_API bool [[bz_setPlayerLosses]] ( int playerId, int losses );
 
  BZF_API bool [[bz_setPlayerTKs]] ( int playerId, int tks );
 
  BZF_API bool [[bz_setPlayerTKs]] ( int playerId, int tks );
 
  BZF_API bool [[bz_resetPlayerScore]] ( int playerId );
 
  BZF_API bool [[bz_resetPlayerScore]] ( int playerId );
BZF_API bool [[bz_incrementPlayerWins]] (int playerId, int increment)
 
BZF_API bool [[bz_incrementPlayerLosses]] (int playerId, int increment);
 
BZF_API bool [[bz_incrementPlayerTKs]] (int playerId, int increment);
 
 
  BZF_API int [[bz_getPlayerWins]] ( int playerId );
 
  BZF_API int [[bz_getPlayerWins]] ( int playerId );
 
  BZF_API int [[bz_getPlayerLosses]] ( int playerId );
 
  BZF_API int [[bz_getPlayerLosses]] ( int playerId );
Line 118: Line 89:
  
 
=== Latency Information ===
 
=== Latency Information ===
2.3+
 
 
  BZF_API int [[bz_getPlayerLag]] ( int playerId );
 
  BZF_API int [[bz_getPlayerLag]] ( int playerId );
 
  BZF_API int [[bz_getPlayerJitter]] ( int playerId );
 
  BZF_API int [[bz_getPlayerJitter]] ( int playerId );
 
  BZF_API float [[bz_getPlayerPacketloss]] ( int playerId );
 
  BZF_API float [[bz_getPlayerPacketloss]] ( int playerId );
BZF_API int [[bz_getIdleTime]] ( int playerId );
 
BZF_API int [[bz_getPausedTime]] ( int playerId );
 
  
 
=== Permission Group Management ===
 
=== Permission Group Management ===
2.3+
 
 
  BZF_API [[bz_APIStringList]]* [[bz_getGroupList]] ( void );
 
  BZF_API [[bz_APIStringList]]* [[bz_getGroupList]] ( void );
 
  BZF_API [[bz_APIStringList]]* [[bz_getGroupPerms]] ( const char* group );
 
  BZF_API [[bz_APIStringList]]* [[bz_getGroupPerms]] ( const char* group );
Line 132: Line 99:
  
 
=== Chat Messages ===
 
=== Chat Messages ===
2.3+
 
 
  BZF_API bool [[bz_sendTextMessage]] (int from, int to, const char* message);
 
  BZF_API bool [[bz_sendTextMessage]] (int from, int to, const char* message);
 
  BZF_API bool [[bz_sendTextMessage]] (int from, [[bz_eTeamType]] to, const char* message);
 
  BZF_API bool [[bz_sendTextMessage]] (int from, [[bz_eTeamType]] to, const char* message);
 
  BZF_API bool [[bz_sendTextMessagef]] (int from, int to, const char* fmt, ...);
 
  BZF_API bool [[bz_sendTextMessagef]] (int from, int to, const char* fmt, ...);
 
  BZF_API bool [[bz_sendTextMessagef]] (int from, [[bz_eTeamType]] to, const char* fmt, ...);
 
  BZF_API bool [[bz_sendTextMessagef]] (int from, [[bz_eTeamType]] to, const char* fmt, ...);
?
 
 
  BZF_API bool [[bz_sendFetchResMessage]] ( int playerID,  const char* URL );
 
  BZF_API bool [[bz_sendFetchResMessage]] ( int playerID,  const char* URL );
 
  BZF_API bool [[bz_sendJoinServer]] ( int playerID, const char* address, int port, int team, const char* referrer, const char* message );
 
  BZF_API bool [[bz_sendJoinServer]] ( int playerID, const char* address, int port, int team, const char* referrer, const char* message );
Line 144: Line 109:
  
 
=== Server Management ===
 
=== Server Management ===
2.3+
 
 
  BZF_API bool [[bz_restart]] ( void );
 
  BZF_API bool [[bz_restart]] ( void );
 
  BZF_API void [[bz_shutdown]] ();
 
  BZF_API void [[bz_shutdown]] ();
Line 154: Line 118:
 
  BZF_API void [[bz_reloadUsers]] ();
 
  BZF_API void [[bz_reloadUsers]] ();
 
  BZF_API void [[bz_reloadHelp]] ();
 
  BZF_API void [[bz_reloadHelp]] ();
BZF_API void [[bz_reloadBadwords]] ();
 
 
  BZF_API int [[bz_getPlayerCount]] ( void );
 
  BZF_API int [[bz_getPlayerCount]] ( void );
BZF_API bool [[bz_getShotMismatch]] ( void );
 
BZF_API void [[bz_setShotMismatch]] ( bool value );
 
BZF_API bool [[bz_isAutoTeamEnabled]] ( void );
 
?
 
 
  BZF_API bool [[bz_anyPlayers]] ( void );
 
  BZF_API bool [[bz_anyPlayers]] ( void );
  
 
=== Rabbit Hunt ===
 
=== Rabbit Hunt ===
?
 
 
  BZF_API void [[bz_newRabbit]] ( int player, bool swap );
 
  BZF_API void [[bz_newRabbit]] ( int player, bool swap );
 
  BZF_API void [[bz_removeRabbit]] ( int player );
 
  BZF_API void [[bz_removeRabbit]] ( int player );
  
 
=== Map Management ===
 
=== Map Management ===
2.3+
 
 
  BZF_API void [[bz_setClientWorldDownloadURL]] ( const char* URL );
 
  BZF_API void [[bz_setClientWorldDownloadURL]] ( const char* URL );
  BZF_API const [[bz_ApiString]] [[bz_getClientWorldDownloadURL]] ( void );
+
  BZF_API const [[bzApiString]] [[bz_getClientWorldDownloadURL]] ( void );
 
  BZF_API bool [[bz_saveWorldCacheFile]] ( const char* file );
 
  BZF_API bool [[bz_saveWorldCacheFile]] ( const char* file );
  
 
=== Flag Management ===
 
=== Flag Management ===
2.3+
+
 
 
  BZF_API bool [[bz_givePlayerFlag]] ( int playerID, const char* flagType, bool force );
 
  BZF_API bool [[bz_givePlayerFlag]] ( int playerID, const char* flagType, bool force );
 
  BZF_API bool [[bz_removePlayerFlag]] ( int playerID );
 
  BZF_API bool [[bz_removePlayerFlag]] ( int playerID );
  BZF_API void [[bz_resetFlags]] ( bool onlyUnused, bool keepTeamFlags = false );
+
  BZF_API void [[bz_resetFlags]] ( bool onlyUnused );
 
  BZF_API unsigned int [[bz_getNumFlags]] ( void );
 
  BZF_API unsigned int [[bz_getNumFlags]] ( void );
  BZF_API const [[bz_ApiString]] [[bz_getFlagName|bz_getName]] ( int flag );
+
  BZF_API const [[bz_ApiString]] [[bz_getFlagName]] ( int flag );
 
  BZF_API bool [[bz_resetFlag]] ( int flag );
 
  BZF_API bool [[bz_resetFlag]] ( int flag );
 
  BZF_API int [[bz_flagPlayer]] ( int flag );
 
  BZF_API int [[bz_flagPlayer]] ( int flag );
BZF_API const char* [[bz_getPlayerFlag]] ( int playerID );
 
BZF_API int [[bz_getPlayerFlagID]] ( int playerID );
 
 
  BZF_API bool [[bz_getFlagPosition]] ( int flag, float* pos );
 
  BZF_API bool [[bz_getFlagPosition]] ( int flag, float* pos );
  BZF_API bool [[bz_moveFlag]] ( int flag, float pos[3] );
+
  BZF_API bool [[bz_moveFlag]] ( int flag, float pos[3], bool reset = true );
 
  BZF_API bool [[bz_RegisterCustomFlag]] ( const char* abbr, const char* name, const char* helpString, bz_eShotType shotType, bz_eFlagQuality quality );
 
  BZF_API bool [[bz_RegisterCustomFlag]] ( const char* abbr, const char* name, const char* helpString, bz_eShotType shotType, bz_eFlagQuality quality );
  
 
=== Shot Type Control ===
 
=== Shot Type Control ===
?
 
 
  BZF_API bool [[bz_setPlayerShotType]] ( int playerId, [[bz_eShotType]] shotType );
 
  BZF_API bool [[bz_setPlayerShotType]] ( int playerId, [[bz_eShotType]] shotType );
 
=== Shot Management ===
 
2.4.5+
 
BZF_API uint32_t [[bz_getShotMetaData]] (int fromPlayer, int shotID, const char* name);
 
BZF_API void [[bz_setShotMetaData]] (int fromPlayer, int shotID , const char* name, uint32_t value);
 
BZF_API bool [[bz_shotHasMetaData]] (int fromPlayer, int shotID , const char* name);
 
BZF_API uint32_t [[bz_getShotGUID]] (int fromPlayer, int shotID);
 
  
 
=== World Weapon Management ===
 
=== World Weapon Management ===
2.3+
+
  BZF_API bool [[bz_fireWorldWep]] ( const char* flagType, float lifetime, float *pos, float tilt, float direction, int shotID , float dt );
  BZF_API bool [[bz_fireWorldWep]] ( const char* flagType, float lifetime, int fromPlayer, float *pos, float tilt, float direction, int shotID , float dt, bz_eTeamType shotTeam = eRogueTeam );
+
  BZF_API int [[bz_fireWorldGM]] ( int targetPlayerID, float lifetime, float *pos, float tilt, float direction, float dt );
BZF_API bool [[bz_fireWorldWep]] ( const char* flagType, float lifetime, int fromPlayer, float *pos, float tilt, float direction, int *shotID , float dt, bz_eTeamType shotTeam = eRogueTeam );
+
  BZF_API int [[bz_fireWorldGM]] ( int targetPlayerID, float lifetime, float *pos, float tilt, float direction, float dt, bz_eTeamType shotTeam = eRogueTeam );
+
  
 
=== Server Time ===
 
=== Server Time ===
2.3+
 
 
  BZF_API double [[bz_getCurrentTime]] ( void );
 
  BZF_API double [[bz_getCurrentTime]] ( void );
 +
BZF_API float [[bz_getMaxWaitTime]] ( void );
 +
BZF_API void [[bz_setMaxWaitTime]] ( float maxTime );
 
  BZF_API void [[bz_getLocaltime]] ( [[bz_Time]] *ts );
 
  BZF_API void [[bz_getLocaltime]] ( [[bz_Time]] *ts );
 
  BZF_API void [[bz_getUTCtime]] ( [[bz_Time]] *ts );
 
  BZF_API void [[bz_getUTCtime]] ( [[bz_Time]] *ts );
 
?
 
BZF_API float [[bz_getMaxWaitTime]] ( void );
 
BZF_API void [[bz_setMaxWaitTime]] ( float maxTime );
 
  
 
=== Global Database Management (BZDB) ===
 
=== Global Database Management (BZDB) ===
2.3+
 
 
  BZF_API double [[bz_getBZDBDouble]] ( const char* variable );
 
  BZF_API double [[bz_getBZDBDouble]] ( const char* variable );
 
  BZF_API [[bz_ApiString]] [[bz_getBZDBString]] ( const char* variable );
 
  BZF_API [[bz_ApiString]] [[bz_getBZDBString]] ( const char* variable );
Line 222: Line 163:
 
  BZF_API int [[bz_getBZDBInt]] ( const char* variable );
 
  BZF_API int [[bz_getBZDBInt]] ( const char* variable );
 
  BZF_API int [[bz_getBZDBItemPerms]] ( const char* variable );
 
  BZF_API int [[bz_getBZDBItemPerms]] ( const char* variable );
  BZF_API bool [[bz_getBZDBItemPesistent]] ( const char* variable );
+
  BZF_API bool [[bz_getBZDBItemPersistent]] ( const char* variable );
 
  BZF_API bool [[bz_BZDBItemExists]] ( const char* variable );
 
  BZF_API bool [[bz_BZDBItemExists]] ( const char* variable );
 
  BZF_API bool [[bz_setBZDBDouble]] ( const char* variable, double val, int perms = 0, bool persistent = false );
 
  BZF_API bool [[bz_setBZDBDouble]] ( const char* variable, double val, int perms = 0, bool persistent = false );
Line 233: Line 174:
  
 
=== Logging ===
 
=== Logging ===
2.3+
 
 
  BZF_API void [[bz_debugMessage]] ( int level, const char* message );
 
  BZF_API void [[bz_debugMessage]] ( int level, const char* message );
 
  BZF_API void [[bz_debugMessagef]] ( int level, const char* fmt, ... )
 
  BZF_API void [[bz_debugMessagef]] ( int level, const char* fmt, ... )
Line 239: Line 179:
  
 
=== Server Administration ===
 
=== Server Administration ===
2.3+
 
 
  BZF_API bool [[bz_kickUser]] ( int playerIndex, const char* reason, bool notify );
 
  BZF_API bool [[bz_kickUser]] ( int playerIndex, const char* reason, bool notify );
  BZF_API bool [[bz_IPBanUser]] ( int bannedByIndex, const char* ip, int duration, const char* reason );
+
  BZF_API bool [[bz_IPBanUser]] ( const char* ipAddress, const char* ip, int durration, const char* reason );
  BZF_API bool [[bz_HostBanUser]] ( int bannedByIndex, const char* hostmask, int duration, const char* reason );
+
  BZF_API bool [[bz_IDBanUser]] ( const char* bzid, const char* bzID , int duration, const char *reason );
 +
BZF_API bool [[bz_HostBanUser]] ( const char* hostmask, const char* source, int duration, const char* reason );
 
  BZF_API bool [[bz_IPUnbanUser]] ( const char* ip );
 
  BZF_API bool [[bz_IPUnbanUser]] ( const char* ip );
 
  BZF_API bool [[bz_IDUnbanUser]] ( const char* bzID );
 
  BZF_API bool [[bz_IDUnbanUser]] ( const char* bzID );
Line 251: Line 191:
 
  BZF_API bool [[bz_pollActive]] ( void );
 
  BZF_API bool [[bz_pollActive]] ( void );
 
  BZF_API bool [[bz_pollVeto]] ( void );
 
  BZF_API bool [[bz_pollVeto]] ( void );
 
?
 
BZF_API bool [[bz_IDBanUser]] ( int bannedByIndex, const char* bzID , int duration, const char *reason );
 
  
 
=== Reporting ===
 
=== Reporting ===
2.3+
 
 
  BZF_API [[bz_APIStringList]]* [[bz_getReports]] ( void );
 
  BZF_API [[bz_APIStringList]]* [[bz_getReports]] ( void );
?
 
 
  BZF_API unsigned int [[bz_getReportCount]] ( void );
 
  BZF_API unsigned int [[bz_getReportCount]] ( void );
 
  BZF_API const char* [[bz_getReportSource]] ( unsigned int id );
 
  BZF_API const char* [[bz_getReportSource]] ( unsigned int id );
Line 268: Line 203:
  
 
=== Timed Game Management ===
 
=== Timed Game Management ===
2.3+
 
 
  BZF_API bool [[bz_setTimeLimit]] ( float timeLimit );
 
  BZF_API bool [[bz_setTimeLimit]] ( float timeLimit );
 
  BZF_API float [[bz_getTimeLimit]] ( void );
 
  BZF_API float [[bz_getTimeLimit]] ( void );
BZF_API float [[bz_getCountdownRemaining]] ( void );
 
 
  BZF_API bool [[bz_isTimeManualStart]] ( void );
 
  BZF_API bool [[bz_isTimeManualStart]] ( void );
 
  BZF_API bool [[bz_isCountDownActive]] ( void );
 
  BZF_API bool [[bz_isCountDownActive]] ( void );
 
  BZF_API bool [[bz_isCountDownInProgress]] ( void );
 
  BZF_API bool [[bz_isCountDownInProgress]] ( void );
BZF_API bool [[bz_isCountDownPaused]] ( void );
 
BZF_API void [[bz_pauseCountdown]] ( int playerID );
 
 
  BZF_API void [[bz_pauseCountdown]] ( const char *pausedBy );
 
  BZF_API void [[bz_pauseCountdown]] ( const char *pausedBy );
BZF_API void [[bz_resumeCountdown]] ( int playerID );
 
 
  BZF_API void [[bz_resumeCountdown]] ( const char *resumedBy );
 
  BZF_API void [[bz_resumeCountdown]] ( const char *resumedBy );
BZF_API void [[bz_startCountdown]] ( int delay, float limit, int playerID );
 
 
  BZF_API void [[bz_startCountdown]] ( int delay, float limit, const char *byWho );
 
  BZF_API void [[bz_startCountdown]] ( int delay, float limit, const char *byWho );
BZF_API void [[bz_cancelCountdown]] ( int playerID );
 
BZF_API void [[bz_cancelCountdown]] ( const char *canceledBy );
 
  
 
=== Custom Text Commands ===
 
=== Custom Text Commands ===
2.3+
 
 
  BZF_API bool [[bz_registerCustomSlashCommand]] ( const char* command, [[bz_CustomSlashCommandHandler]] *handler );
 
  BZF_API bool [[bz_registerCustomSlashCommand]] ( const char* command, [[bz_CustomSlashCommandHandler]] *handler );
 
  BZF_API bool [[bz_removeCustomSlashCommand]] ( const char* command );
 
  BZF_API bool [[bz_removeCustomSlashCommand]] ( const char* command );
  
 
=== Plug-in Management ===
 
=== Plug-in Management ===
2.3+
+
  BZF_API int [[bz_getLoadedPlugins]] ( bz_APIStringList * list );
  BZF_API int [[bz_getLoadedPlugins]] ( [[bz_APIStringList]] * list );
+
 
  BZF_API bool [[bz_loadPlugin]] ( const char* path, const char* params );
 
  BZF_API bool [[bz_loadPlugin]] ( const char* path, const char* params );
 
  BZF_API bool [[bz_unloadPlugin]] ( const char* path );
 
  BZF_API bool [[bz_unloadPlugin]] ( const char* path );
Line 300: Line 225:
  
 
=== Public Server Information ===
 
=== Public Server Information ===
2.3+
 
 
  BZF_API bool [[bz_getPublic]] ( void );
 
  BZF_API bool [[bz_getPublic]] ( void );
 
  BZF_API [[bz_ApiString]] [[bz_getPublicAddr]] ( void );
 
  BZF_API [[bz_ApiString]] [[bz_getPublicAddr]] ( void );
 
  BZF_API [[bz_ApiString]] [[bz_getPublicDescription]] ( void );
 
  BZF_API [[bz_ApiString]] [[bz_getPublicDescription]] ( void );
BZF_API int [[bz_getPublicPort]] ( void );
 
 
  BZF_API void [[bz_updateListServer]] ( void );
 
  BZF_API void [[bz_updateListServer]] ( void );
  
 
=== HTTP Transfer ===
 
=== HTTP Transfer ===
2.3+
 
 
  BZF_API bool [[bz_addURLJob]] ( const char* URL, [[bz_BaseURLHandler]]* handler = NULL, const char* postData = NULL );
 
  BZF_API bool [[bz_addURLJob]] ( const char* URL, [[bz_BaseURLHandler]]* handler = NULL, const char* postData = NULL );
 
  BZF_API bool [[bz_removeURLJob]] ( const char* URL );
 
  BZF_API bool [[bz_removeURLJob]] ( const char* URL );
?
 
 
  BZF_API bool [[bz_stopAllURLJobs]] ( void );
 
  BZF_API bool [[bz_stopAllURLJobs]] ( void );
  
 
=== Callback Functions ===
 
=== Callback Functions ===
?
 
 
  BZF_API bool [[bz_registerCallBack]] ( const char* name, [[bz_GenericCallback]] *callback );
 
  BZF_API bool [[bz_registerCallBack]] ( const char* name, [[bz_GenericCallback]] *callback );
 
  BZF_API bool [[bz_registerCallBack]] ( const char* name, [[bz_GenericCallbackFunc]] callback );
 
  BZF_API bool [[bz_registerCallBack]] ( const char* name, [[bz_GenericCallbackFunc]] callback );
Line 324: Line 244:
  
 
=== Inter-Plug-in Communications ===
 
=== Inter-Plug-in Communications ===
2.3+
 
 
  BZF_API bool [[bz_clipFieldExists]] ( const char *name );
 
  BZF_API bool [[bz_clipFieldExists]] ( const char *name );
 
  BZF_API const char* [[bz_getclipFieldString]] ( const char *name );
 
  BZF_API const char* [[bz_getclipFieldString]] ( const char *name );
Line 336: Line 255:
  
 
=== Game Recording ===
 
=== Game Recording ===
2.3+
 
 
  BZF_API bool [[bz_saveRecBuf]] ( const char * _filename, int seconds);
 
  BZF_API bool [[bz_saveRecBuf]] ( const char * _filename, int seconds);
 
  BZF_API bool [[bz_startRecBuf]] ( void );
 
  BZF_API bool [[bz_startRecBuf]] ( void );
Line 343: Line 261:
 
=== Map Management ===
 
=== Map Management ===
 
==== Map Information ====
 
==== Map Information ====
?
 
 
  BZF_API void [[bz_getWorldSize]] ( float *size, float *wallHeight );
 
  BZF_API void [[bz_getWorldSize]] ( float *size, float *wallHeight );
 
  BZF_API unsigned int [[bz_getWorldObjectCount]] ( void );
 
  BZF_API unsigned int [[bz_getWorldObjectCount]] ( void );
Line 359: Line 276:
  
 
==== Map Collisions ====
 
==== Map Collisions ====
?
 
 
  [[bz_eAPIColType]] [[bz_cylinderInMapObject]] ( float pos[3], float height, float radius, [[bz_APIBaseWorldObject]] **object );
 
  [[bz_eAPIColType]] [[bz_cylinderInMapObject]] ( float pos[3], float height, float radius, [[bz_APIBaseWorldObject]] **object );
 
  [[bz_eAPIColType]] [[bz_boxInMapObject]] ( float pos[3], float size[3], float angle, [[bz_APIBaseWorldObject]] **object );
 
  [[bz_eAPIColType]] [[bz_boxInMapObject]] ( float pos[3], float size[3], float angle, [[bz_APIBaseWorldObject]] **object );
  
 
==== Custom Map Objects ====
 
==== Custom Map Objects ====
2.3+
 
 
  BZF_API bool [[bz_registerCustomMapObject]] ( const char* object, [[bz_CustomMapObjectHandler]] *handler );
 
  BZF_API bool [[bz_registerCustomMapObject]] ( const char* object, [[bz_CustomMapObjectHandler]] *handler );
 
  BZF_API bool [[bz_removeCustomMapObject]] ( const char* object );
 
  BZF_API bool [[bz_removeCustomMapObject]] ( const char* object );
  
 
=== Utility ===
 
=== Utility ===
2.3+
 
 
  BZF_API const char *[[bz_MD5]] ( const char* str );
 
  BZF_API const char *[[bz_MD5]] ( const char* str );
 
  BZF_API const char *[[bz_MD5]] ( const void* data, size_t size );
 
  BZF_API const char *[[bz_MD5]] ( const void* data, size_t size );
Line 376: Line 290:
  
 
=== Misc ===
 
=== Misc ===
2.3+
 
 
  BZF_API bool [[bz_getStandardSpawn]] ( int playerID, float pos[3], float *rot );
 
  BZF_API bool [[bz_getStandardSpawn]] ( int playerID, float pos[3], float *rot );
BZF_API bool [[bz_killPlayer]] ( int playerID, bool spawnOnBase);
 
 
  BZF_API bool [[bz_killPlayer]] ( int playerID, bool spawnOnBase, int killerID = -1, const char* flagID = NULL );
 
  BZF_API bool [[bz_killPlayer]] ( int playerID, bool spawnOnBase, int killerID = -1, const char* flagID = NULL );
 
  BZF_API bool [[bz_sendPlayCustomLocalSound]] ( int playerID, const char* soundName );
 
  BZF_API bool [[bz_sendPlayCustomLocalSound]] ( int playerID, const char* soundName );
Line 387: Line 299:
 
  BZF_API const char *[[bz_urlEncode]](const char* val );
 
  BZF_API const char *[[bz_urlEncode]](const char* val );
 
  BZF_API [[bz_eGameType]] [[bz_getGameType]]( void );
 
  BZF_API [[bz_eGameType]] [[bz_getGameType]]( void );
 +
BZF_API bool [[bz_allowJumping]] ( void );
 
  BZF_API [[bz_eTeamType]] [[bz_checkBaseAtPoint]] ( float pos[3] );
 
  BZF_API [[bz_eTeamType]] [[bz_checkBaseAtPoint]] ( float pos[3] );
 
  BZF_API int [[bz_APIVersion]] ( void );
 
  BZF_API int [[bz_APIVersion]] ( void );
?
 
BZF_API bool [[bz_allowJumping]] ( void );
 
  
 
=== Server Side Players (Development) ===
 
=== Server Side Players (Development) ===
? (In API for 2.3+, but will crash a server)
 
 
  BZF_API int [[bz_addServerSidePlayer]] ( [[bz_ServerSidePlayerHandler]] *handler );
 
  BZF_API int [[bz_addServerSidePlayer]] ( [[bz_ServerSidePlayerHandler]] *handler );
 
  BZF_API bool [[bz_removeServerSidePlayer]] ( int playerID, [[bz_ServerSidePlayerHandler]] *handler );
 
  BZF_API bool [[bz_removeServerSidePlayer]] ( int playerID, [[bz_ServerSidePlayerHandler]] *handler );
  
 
== See also ==
 
== See also ==
* [[BZFS API]]
+
[[BZFS API]]
* [[Events (API)|BZFS API Events]]
+
 
* [[Plug-ins]]
+
[[plug-ins]]
  
 
[[Category:BZFS_API_Functions]]
 
[[Category:BZFS_API_Functions]]

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)

Templates used on this page: