This wiki is archived and useful information is being migrated to the main bzflag.org website
(Note that the following information applies to the BZRobots in the upcoming BZFlag 3.0 release)
BZRobots is a programmable computer player client that is compatible with the BZFS server. It is designed to be an artificial intelligence training and development tool that operates under the BZFlag platform.
BZRobots requires that you have already configured and are running an instance of BZFS, that allows one or more bots (using the -botsPerIP setting). Also, BZRobots is a "headless" client (i.e. there are no graphics, it is only text-based), so if you want to watch your bots in action, you will also need to join as an observer or player using the BZFlag client.
The BZRobots Programmable Computer Player Client was originally developed by Brigham Young University as a project called BZRC
This work was continued in 2009 by Mathew Eis (AKA Bulldozer and KingRobot), again as part of Google Summer of Code.
The current BZRobots code can be found in the BZFlag subversion system at http://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/bzflag/src/bzrobots
Quick Start: Building
The BZRobots client (and support for C++ bots) will by default as a standard part of the bzflag trunk build. However, if you want to build Python bots, you will need to run ./configure with the option --enable-bzrobots-python (and of course have the necessary dependencies)
Open the bzrobots solution, then build the bzrobots and testbot projects.
Quick Start: Running
(Note: This quick start assumes that you will be testing bzrobots from within the build directory, have already run 'autogen.sh', 'configure', and 'make' and have not run 'make install')
(Due to the use of libtool, the binary TestRobot.so is in the .libs directory)
# cd bzflag/src/bzrobots # ./bzrobots -team red sobot@localhost .libs/TestRobot.so
Linux/OS X: Python [.py]
# cd bzflag/src/bzrobots # ln -s .libs/bzrobot_pyext.so ./bzrobot_pyext.so # ./bzrobots -team red pybot@localhost ../../bots/python/TestRobot.py
Linux/OS X: LUA [.lua]
# cd bzflag/src/bzrobots # ./bzrobots -team red luabot@localhost ../../bots/lua/bzbot.lua
# cd bzflag # bzrobots.exe -team red dllbot@localhost TestRobot.dll
Windows: LUA [.lua]
# cd bzflag # bzrobots.exe -team red luabot@localhost bots\lua\bzbot.lua
- BZRobots/API - A description the BZRobots API
- BZRobots/API_BZRobots_vs_Robocode - For those coming from RoboCode, a list of differences between the RoboCode and BZRobots
- BZRobots/Ideas - Community suggestions for and enhancements changes for BZRobots