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

Difference between revisions of "Bz restart"

From BZFlagWiki
Jump to: navigation, search
(Prototype)
(Description)
Line 10: Line 10:
 
This API function will cause the server to do a full restart.
 
This API function will cause the server to do a full restart.
 
This restart will perform the following actions.
 
This restart will perform the following actions.
* kick all players
+
* kick all players
* stop any countdowns
+
* stop any countdowns
* stop any recordings
+
* stop any recordings
* unload the world
+
* unload the world
* reload the world ( calling [[bz_eGetWorldEvent]] allowing for a map file override )
+
* reload the world ( calling [[bz_eGetWorldEvent]] allowing for a map file override )
* resets all flags.
+
* resets all flags.
* accept new connections.
+
* accept new connections.
  
 
==Usage===
 
==Usage===

Revision as of 02:00, 14 August 2007

BZFS API Documentation This page contains part of the BZFS API documentation for use by Plug-ins on the BZFS server.
BZFS API Function. This page documents a BZFS_API Function, that is provided by the BZFS game server for plug-ins to call.

Prototype

BZF_API bool bz_restart ( void );

Parameters

none.

Description

This API function will cause the server to do a full restart. This restart will perform the following actions.

  • kick all players
  • stop any countdowns
  • stop any recordings
  • unload the world
  • reload the world ( calling bz_eGetWorldEvent allowing for a map file override )
  • resets all flags.
  • accept new connections.

Usage=

This will basically do a server and map reload, with out a full shutdown of the server executable. None of the plug ins are unloaded and the server will not be delisted from the list server. This function is intended for plug-ins that wish to reload the server with a different map.

Notes

There may be some additional things that need to reset. They will need to be added as they are found ( like reload the command line options, or let the plug-in set them ).