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

Difference between revisions of "Recordmatch"

From BZFlagWiki
Jump to: navigation, search
(Cleaning up this mess... let's use correct information and formatting, shall we?)
Line 1: Line 1:
If you run a match server or a server with countdown you have to use all the time '''/record'''... It you load the plugin, you dont need that. The plugin is recording automatically the match.
+
Recordmatch is a standard [[Plug-ins|plug-in]] that is shipped with the [[BZFlag Source|source code]].  It allows for match games, such as league matches, to be recorded onto the server to be replayed later.  It will automatically record when a game (match) is started, and it will record with a filename given by the current date and time. Recordmatch is included in [[BZFlag 2.0.6|v2.0.6]] and later releases.
  
# Add in your config option -loadplugin patch/to/recordmatch.dll or use /loadplugin patch/to/recordmatch.dll from in game.
+
==Usage==
# Start the match (Use /countdown)
+
When the airspawn is loaded it can take an [[Plug-ins#Parameters|optional parameter]] that represents the maximum height variance that will be applied to a spawn position. The default value is 10 [[world units]]. With the plugin loaded, the height above ground of tank spawns will be a random value between 0 and the maximum value. The usage is (for Windows and *Nix, respectively):
# Just play the match. The plugin is recording the match.
+
  
In your config you must also put the following two commands:
+
-loadplugin "X:\path\to\the\plugin\recordmatch.dll"
 +
-loadplugin "/path/to/the/plugin/recordmatch.so"
  
#-timemanual
+
or in an already running game (for Windows and *Nix, respectively):
#-time <Number of seconds>
+
  
The records are saved under e.g.: match-20080824-211216<br>
+
/loadplugin "X:\path\to\the\plugin\record.dll"
The Match was saved at 24.08.2008 at 21:12:16
+
/loadplugin "/path/to/the/plugin/recordmatch.so"
  
If you want to see the match use at your replay server the command /replay
+
Examples:
 +
 
 +
-loadplugin "C:\Program Files\BZFlag2.0.8\recordmatch.dll"
 +
-loadplugin "/usr/local/bzflag2.0.8/plugins/recordmatch.so"
 +
 
 +
The "-loadplugin" syntax is used in the [[sample conf|server configuration]] file or at the command line when invoking a game [[BZFS|server]].
 +
 
 +
==History==
 +
The BZFS API was changed in the development of 2.0.6 to allow for recordings to be started. Recordmatch is the first plugin to use the newly-added capability.
 +
 
 +
[[Category:Development]]
 +
[[Category:Plug-Ins]]

Revision as of 03:56, 25 May 2009

Recordmatch is a standard plug-in that is shipped with the source code. It allows for match games, such as league matches, to be recorded onto the server to be replayed later. It will automatically record when a game (match) is started, and it will record with a filename given by the current date and time. Recordmatch is included in v2.0.6 and later releases.

Usage

When the airspawn is loaded it can take an optional parameter that represents the maximum height variance that will be applied to a spawn position. The default value is 10 world units. With the plugin loaded, the height above ground of tank spawns will be a random value between 0 and the maximum value. The usage is (for Windows and *Nix, respectively):

-loadplugin "X:\path\to\the\plugin\recordmatch.dll"
-loadplugin "/path/to/the/plugin/recordmatch.so"

or in an already running game (for Windows and *Nix, respectively):

/loadplugin "X:\path\to\the\plugin\record.dll"
/loadplugin "/path/to/the/plugin/recordmatch.so"

Examples:

-loadplugin "C:\Program Files\BZFlag2.0.8\recordmatch.dll"
-loadplugin "/usr/local/bzflag2.0.8/plugins/recordmatch.so"

The "-loadplugin" syntax is used in the server configuration file or at the command line when invoking a game server.

History

The BZFS API was changed in the development of 2.0.6 to allow for recordings to be started. Recordmatch is the first plugin to use the newly-added capability.