BZFlagWiki - User contributions [en]

Google Summer of Code

2007-07-12T16:20:46Z

Daxxar: Changed the DEVINFO link around, points to SVN now

BZFlag is participating in the 2007 [http://code.google.com/soc/ Google Summer of Code]. Under this program, Google allocates and funds students to write code for BZFlag during the northern hemisphere summer timeframe on specific projects. Those projects are proposed by students and sometimes following the suggested "proposal areas" section shown below or are ideas entirely of the student's own design. Student proposals are reviewed and evaluated by participating mentors. Google allocates a certain number of slots out of a total of 800 amongst approximately 135 participating mentoring organizations which then determines how many students may be approved by a given group such as BZFlag.

Adhering to specified [[Google Summer of Code Acceptance|development requirements]], selected students then work on their projects through the summer. If the student successfully completes what they proposed, they are ultimately paid $4500 for their work. In all, the program is a decent deal for the students, great publicity and marketing for Google, and a great opportunity for BZFlag development initiatives.

= Preparing an Application =

There was no specific format to applications, but they were told that they should be detailed in their approach and background information about themselves. They were supposed to state specifically what they intend to deliver and any implementation details they felt relevant such as what language they intend to use. C/C++ proposals were preferred though others were considered. Students that just submitted the summaries contained below did not do very well. If you talked with us on IRC about your SoC proposal, you were supposed to include your IRC nickname somewhere in your proposal.

Early proposal submission were encouraged as it gave us more time to review your proposal in detail, comment on them, and potentially ask for additional input. Submitting closer to the deadline wasn't a negative consideration as all submissions were be predominantly judged on their merit, but submitting and discussing early was an advantage for submissions that were similar to other submissions.

Students were asked to propose what they actually want to work on, how they intend to work on it, what they intend to DO, what they know about that task, some details about themselves, etc. Their ability to perform the task is outright presumed, so they are supposed to propose a task that they are comfortable and knowledgeable with performing.

= Program Evaluation =

We received a total of 45 proposals for the 2007 program that were then reviewed, evaluated, and critiqued. Of those applications, only '''four''' could be selected to work on BZFlag. There were about 20 really good proposals overall, making the selection process very competitive and difficult. ''This cannot be stressed enough..'' It was really hard to narrow down the submissions but in the end we did have only so many slots to work with and the line eventually had to be drawn. Every application was read multiple times and reviewed in detail. We thank '''everyone''' that submitted a proposal and hope to still see some of you become involved in our software development.

In the end, submissions were selected according to the overall long-term impact that accepting the proposal could make for the game, perception of the submitter's abilities to complete the task within the program timeframe, general consensus on the technical approach being proposed, and overall interest in having such modifications made to BZFlag. Particular notice was made of students that were responsive to questions and readily interactive in the IRC channel. Communication is a good thing.

While there's never any guarantee that work on any code will be integrated, this is very much the desire and '''intention''' of our participation in the Summer of Code. Students are expected to interact on the [http://my.bzflag.org/irc/ #bzflag IRC channel] on the Freenode network, abide by the [http://bzflag.svn.sourceforge.net/viewvc/*checkout*/bzflag/trunk/bzflag/DEVINFO DEVINFO] rules, agree to the [[Google Summer of Code Acceptance|development requirements]], and focus on providing a clean maintainable implementation.

The projects that were accepted are as follows:

== Graphical BZFlag Map Editor ==
=== Jude Nelson (jude-) ===

BZFlag does not yet have a sufficient graphical world map editor. That is to say that while there have been many over the years, they all fall into obsolescence or are less than ideal due to other constraints upon their use). While some existing editors come very close, it is usually the case that they do not fully support advanced map features, require the users to have a programmer's understanding of the file format, are not well documented, are very platform-specific, or are outright obsolete. This is problematic to the BZFlag community in that it hinders less technically-inclined users from developing worlds. To support this need, the proposed work aims to implement such an editor that should allow users to quickly create worlds in a visual manner, provide a GUI to easily manipulate all features of BZW, provide intuitive and interactive visualizations of all map data, and allow for easy extendibility to ensure future BZW compatibility. Additionally, to encompass a larger user base, it will be developed using cross-platform toolkits, allowing it to be easily ported between operating systems and ideally support the same target operating systems as BZFlag itself.

== Random Procedural World Generator ==
=== Kornel Kisielewicz (Epyon) ===

Although BZFlag implements a poor man's random map generator as default, most players prefer to play on user made maps. The reason is simple -- the primitive scattering algorithm implemented in BZF's random map generation is, well, simple and limited. Creating a nice looking and fun-to-play map by hand, however, is a non-trivial task too. In order to really enjoy playing BZFlag, you need to search for good levels in the community, and even those can get boring after a while because you learn their layout or their popularity diminishes. Moreover, players who know the map well have an unfair advantage when playing against people who see the map for the first time. Moreover still, if you want to set up your own server, the task of creating your own map by hand can be rather complicated and involved.

== Community Messaging System ==
=== Chris Wible (L4m3r) ===

BZFlag has efficient in-game chat among players on a server. However, it's currently difficult to reach a player from outside the game, or to communicate without actually joining a server. By implementing a more sophisticated community messaging system, players will be able to contact one another across servers and outside of gameplay, all from within the game client. This will allow players to get together in a common place to schedule matches as well as provide a general ''global chat'' mechanism for the game.

== Programmable Computer Player Client ==
=== Jørgen Pedersen Tjernø (daxxar) ===

BZFlag has a hard-coded computer player that players can join with or enable in the game client, but the behavior and capabilities of that bot player are rather limited, unchanging, and easily predicted. This efforts creates an interface for making better BZFlag computer players by building upon the existing '''exceptional''' efforts of the [http://bzrc.cs.byu.edu/ BZRC] project (developed and contributed by Andrew McNabb and others at BYU). This effort aims to provide a fully programmable/scriptable standard interface for controlling a tank through a framework that can be readily distributed and shared. This interface supports basic artificial intelligence (AI) research and AI education as well.

= Proposal Ideas =

While there are lots of [[Ideas]] floating around of varying utility to the game, the ideas listed below were the specific areas that we were predominantly interested in seeing worked on as part of the GSoC. Please note that students were also welcome to apply with their own original ideas. They should have run those ideas by one of the developers beforehand, as there are some ideas which will not be accepted regardless of the quality of the application and applicant, due to desire to preserve the scope and focus of the project.

Ideas marked with an "*" indicate entries where we received at least two or more submissions for that idea.

== Dead Reckoning and other Networking Enhancements ==
The basic idea is to improve BZFlag's networking by performing dead reckoning on the server along with context-sensitive packet delivery culling. Much work has gone into the game towards moving more and more of the game state to the server, but there is additional migration and protocol changes required. Similarly, network utilization can be optimized by not relaying certain packets (like miniscule position updates to distant players) based on the current game state. Some useful background reading for this task include "[http://www.research.ibm.com/netgames2005/papers/aggarwal.pdf Fairness in Dead-Reckoning based Distributed Multi-Player Games (pdf)]" and "[http://www.sigcomm.org/sigcomm2004/workshop_papers/net610-aggarwal.pdf Accuracy in Dead-Reckoning Based Distributed Multi-Player Games (pdf)]".

== Graphics Engine Integration * ==
One of the long-standing desires for BZFlag is to improve the graphics capabilities in the game by integrating with an existing rendering engine. This task would be to integrate BZFlag with a graphics engine like [http://ogre3d.org/ OGRE], [http://www.crystalspace3d.org/ Crystal Space], [http://www.openscenegraph.com/ OpenSceneGraph], or [http://irrlicht.sourceforge.net/ Irrlicht].

== Headless Artificial Intelligence Agent * ==
This task involves creating a clean stand-alone version of the game client that is headless (i.e. requires no GUI to run), programmable, and scriptable. Ideally, a programming interface that is compatible with an existing framework such as the [http://robocode.sourceforge.net/ Robocode] [http://www-128.ibm.com/developerworks/java/library/j-robocode/ API] should be made available for controlling AI tank players so that collaboration with other AI efforts can be leveraged. A scripting interface (perhaps using [http://www.swig.org/ SWIG]) should be provided on top of that API to allow dynamic control of the AI agents from a scripting language like Python, Ruby, Lua, Tcl, or Perl.

== Global authentication daemon ==
The goal of this project would be to provide global account management system daemon that the client and servers would communicate with for account, group membership, and profile information. This effort preferably be written in C++, would need to talk to an LDAP server for persistent storage on the backend, and allow chaining across multiple daemons for data replication and failover service. The daemon would need to provide a well structured simple communications API that the game client and game servers can securely talk to.

== Enhanced server listing ==
The game client includes a simplistic listing of publicly available servers. This task would involve significantly enhancing the listing section in BZFlag to allow for various sortings (e.g. ping time, country, name, etc), favorites, recently used, specific additional information on specific servers, and all existing information. The task would involve coming up with a user-friendly design that it fully keyboard-accessible. It could leverage external gui toolkits, use BZFlag's existing gui library, and/or extend the existing capabilities. The focus would be on creating an intuitive and informative listing enhancement within the constraints of the gaming interface.

== World file layout and editing application * ==
This task should produce an application for the creation/modification/arrangement of [[BZW]] map files and objects in a visual manner. The application should be designed in a cross platform compatible manner (ether some existing cross platform framework, or a built in platform system). The application should be able to manage all the existing structures in a [[BZW]] world file. Ideally, the application should also be able to import 3d meshes from other design applications. It would not be required to be able to dynamically edit meshes in the application.

== Two-player tanks * ==
Make modifications to the game such that it is optionally possible (e.g. via a server configuration) to allow multiplayer tanks where one player can only drive and the other can control the turret. The implementation would have to be some simple/intuitive interface to join and depart tanks as well as implemented in a fashion that preserves the "spirit" of BZFlag's operational simplicity.

== Enhanced cross-platform multiple display support ==
Add the ability to effectively manage multiple display environments from within the game allowing for the detection, alignment/orientation specification, and resolution parameters for each display via menu options as well as proper full-screen and/or windowed support. An additional feature could involve allowing the user to dedicate a display to the various primary gui elements (the 3D environment, the radar, and the chat console). BZFlag's current context management is mostly handled by SDL or other platform-specific modules, so this could be taken into consideration. There's also the possibility of our move to an integrated graphics engine would similarly impact how multidisplay contexts are created and managed.

== In-game profile management ==
BZFlag allows players to specify a callsign and team in addition to other player characteristics and preferences. This enhancement would focus on allowing the user to specify and manage multiple profiles from within the game. Profiles could be linked together and should be presented in an intuitive manner (proposal should highlight how you'd go about achieving that). The profiles would need to associate with global account information as well.

== Integrated BZFS web interface ==
The BZFlag game server, BZFS, could benefit from having a browser-accessible http/https interface for viewing server statistics, setting various parameters, and otherwise controlling the server daemon while it is running. Similar to how your network router has a web interface for changing configuration parameters, this idea is simply to create this interface in a maintainable and portable manner. Please go into detail on how exactly you'd go about doing this.

== Network Testing and Simulation Environment ==
This task should provide a controlled testing environment for simulating network behavioral characteristics, including the ability to change virtual network parameters to induce different network conditions of lag and packet loss. This environment should provide a viewer capability to observe interactions of BZFlag clients being tested from the perspective of the player, the server, and third-party observers. This simulation framework should work with the client and server directly so that testing of actual changes may be performed in a stand-alone environment.

== Cross server communications system * ==
This task would be the design and implementation of a server spanning chat system. It would allow players from one server to send chat messages to players on other servers. It should also be able to be used to allow players to know where there friends or "buddies" are playing if they are online. The system should tie into the central user name registration system. Added benefits would be the use of existing protocols or applications, such as Jabber or IRC, if they can be integrated cleanly. Support for using off-line apps for chat and friends list access as well as server management would be a plus.

== <INSERT YOUR IDEA HERE> ==
BZFlag is always open to new development ideas and is under constant improvement. If you are familiar with BZFlag's current capabilities and would like to propose some new enhancement, we'd be happy to hear about. Please discuss any new ideas with the existing core developers (on our IRC channel), if only to make sure the ideas are in-line with the spirit and constraints of the game.

= Promotion Flyers =

[[Image:BZGSoC2007 small.gif]]

Feel free to use the below flyer to help spread the word about our involvement with the Google Summer of Code. We'd love to hear about where all our flyer has been posted at through our [http://my.bzflag.org/irc/ IRC channel]. Flyers have been translated to other languages that we have mentors for, though please submit your application in English. While many developers can converse (fluently) in other languages, we do ask that developer discussions be held in English where possible.

* English ([http://my.bzflag.org/gsoc/BZGSoC2007.pdf PDF]) ([http://my.bzflag.org/gsoc/BZGSoC2007.png PNG])
* Deutsch | German ([http://my.bzflag.org/gsoc/BZGSoC2007_de.pdf PDF]) ([http://my.bzflag.org/gsoc/BZGSoC2007_de.png PNG])
* Español | Spanish ([http://my.bzflag.org/gsoc/BZGSoC2007_es.pdf PDF]) ([http://my.bzflag.org/gsoc/BZGSoC2007_es.png PNG])


= Mentors and Credits =

Thanks to the following BZFlag developers for their participation as mentors:

* Julio Jiménez Borreguero (aka jujibo aka Manu)
* Sean Morrison (aka learner aka brlcad)
** interested in AI and authentication list server services
* Jeffrey Myers (aka JeffM2501)
** interested in game editor
* Daniel Remenak (aka DTRemenak aka Erroneous)
* Mark Thomas (aka menotume)
* David Trowbridge (aka purple_cow)
* Alfredo Tupone (aka c3po)
** interested in Crystal Space integration
* David Wollner
* Andrew McNabb
* Tim Riker
* Donna Crawford

Additionally, special thanks to others in #bzflag that have provided support and feedback including:

* a_meteorite and DTRemenak
** for proofreading and copy editing the GSoC submission
* JeffM2501 and DTRemenak
** for proof editing the promotional flyer
* Saturos
** for translating the promotional flyer to German
* quantumdot and Manu
** for translating the promotional flyer to Spanish
* others...

Thanks for your interest and we look forward to seeing students apply!

[[Category: Development]]

BZRobots/Protocol

2007-07-10T15:19:09Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldSize
|Gives a 'BattleFieldSize'-reply with the size of the map in "units". (the map is size x size, and coordinates run from -size/2 to size/2)
|No
!style="background-color: #55ff55"|Yes
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining
|Gives a 'DistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat
|Gives a 'GunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading
|Gives a 'Heading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeight
|Gives a 'Height'-reply with height of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetLength
|Gives a 'Length'-reply with height of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration
|Gives a 'TickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining
|Gives a 'TickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining
|Gives a 'TurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth
|Gives a 'Width'-reply with width of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetX
|Gives a 'X'-reply with x-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetY
|Gives a 'Y'-reply with y-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetZ
|Gives a 'Z'-reply with z-coordinate of the tank. 0 is ground level.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|IdentifyFrontend <version>
|Greets the backend. (specifying protocol-version <version>, under development: 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|SetStop <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|SetSpeed <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-07-09T15:48:48Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldSize
|Gives a 'BattleFieldSize'-reply with the size of the map in "units". (the map is size x size, and coordinates run from -size/2 to size/2)
|No
!style="background-color: #55ff55"|Yes
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining
|Gives a 'DistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat
|Gives a 'GunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading
|Gives a 'Heading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeight
|Gives a 'Height'-reply with height of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetLength
|Gives a 'Length'-reply with height of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration
|Gives a 'TickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining
|Gives a 'TickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining
|Gives a 'TurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth
|Gives a 'Width'-reply with width of the tank.
|No
!style="background-color: #55ff55"|Yes
|-
|GetX
|Gives a 'X'-reply with x-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetY
|Gives a 'Y'-reply with y-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetZ
|Gives a 'Z'-reply with z-coordinate of the tank. 0 is ground level.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|IdentifyFrontend <version>
|Greets the backend. (specifying protocol-version <version>, under development: 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-07-09T15:25:19Z

Daxxar: Added GetZ

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldSize
|Gives a 'BattleFieldSize'-reply with the size of the map in "units". (the map is size x size, and coordinates run from -size/2 to size/2)
|No
!style="background-color: #55ff55"|Yes
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining
|Gives a 'DistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat
|Gives a 'GunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading
|Gives a 'Heading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetHeight
|Gives a 'Height'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration
|Gives a 'TickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining
|Gives a 'TickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining
|Gives a 'TurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth
|Gives a 'Width'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetX
|Gives a 'X'-reply with x-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetY
|Gives a 'Y'-reply with y-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetZ
|Gives a 'Z'-reply with z-coordinate of the tank. 0 is ground level.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|IdentifyFrontend <version>
|Greets the backend. (specifying protocol-version <version>, under development: 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/API BZRobots vs Robocode

2007-07-09T15:23:12Z

Daxxar: New page: =Overview= This page is to describe the changes that have been made to the RoboCode-compliant part of the API to accomodate how BZFlag worsk. = API Changes = == Behaviour changes == * '''...

=Overview=
This page is to describe the changes that have been made to the RoboCode-compliant part of the API to accomodate how BZFlag worsk.

= API Changes =
== Behaviour changes ==
* '''execute()''' - No longer "blocks" until the action is completed - it returns immediately unless you're currently completing an action. This also goes for other functions, see their relevant protocol messages in [[BZRobots/Protocol]] ("Steady-state required?"). This is because BZFlag is realtime (and RoboCode isn't).

== Name changes ==
* '''getHeight()''' - Renamed to '''getLength()'''. This is because "height" in three dimensions refers to an different axis than what getHeight in two dimensions (and RoboCode) refers to.

=See Also=
* [[BZRobots/About]]
* [[BZRobots/Protocol]]

BZRobots/History

2007-07-09T15:17:56Z

Daxxar: /* See Also */

=Overview=
This page describes the Programmable Computer Player Client project for the [[Google Summer Of Code]].
The project is being developed by Jørgen Pedersen Tjernø (AKA daxxar) as described on the [[Google_Summer_of_Code#Programmable_Computer_Player_Client|GSoC Wiki Page]]. Development updates are posted to the dev blog at http://gsoc.daxxar.com. The code will be kept in the [[BZFlag_SVN| BZFlag subversion system]] at http://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/bzflag/src/bzrobots.

=Architecture=
The architecture will be designed in such a way that a client component (similar to the current bzrobots) takes commands via a defined protocol from an AI component. The client component will be called the 'backend'. The 'frontend' will be what executes the AI logic, and takes care of communication with the 'backend'.

=See Also=
[[BZRobots/Protocol]] - Description of the new protocol

[[BZRobots/Ideas]] - Feature suggestions / thoughts

[[BZRobots/RoboCode_Changes]] - List of relevant changes from the RoboCode API (due to various parts of bzflags)

BZRobots/Protocol

2007-07-09T14:32:22Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldSize
|Gives a 'BattleFieldSize'-reply with the size of the map in "units". (the map is size x size, and coordinates run from -size/2 to size/2)
|No
!style="background-color: #55ff55"|Yes
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining
|Gives a 'DistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat
|Gives a 'GunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading
|Gives a 'Heading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetHeight
|Gives a 'Height'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration
|Gives a 'TickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining
|Gives a 'TickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining
|Gives a 'TurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth
|Gives a 'Width'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetX
|Gives a 'X'-reply with x-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetY
|Gives a 'Y'-reply with y-coordinate of the tank. (0, 0) is "lower left" corner.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|IdentifyFrontend <version>
|Greets the backend. (specifying protocol-version <version>, under development: 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-07-09T13:59:47Z

Daxxar: Fixed some reply names, removed <bot>-references, GetBattleFieldWidth/Height -> GetBattleFieldSize

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldSize
|Gives a 'BattleFieldSize'-reply with the size of the map in "units". (the map is size x size, and coordinates run from -size/2 to size/2)
|No
!style="background-color: #ff3333"|No
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining
|Gives a 'DistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat
|Gives a 'GunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading
|Gives a 'Heading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetHeight
|Gives a 'Height'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration
|Gives a 'TickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining
|Gives a 'TickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining
|Gives a 'TurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth
|Gives a 'Width'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetX
|Gives a 'X'-reply with x-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetY
|Gives a 'Y'-reply with y-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|IdentifyFrontend <version>
|Greets the backend. (specifying protocol-version <version>, under development: 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-07-06T08:34:30Z

Daxxar: /* Overview */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google_Summer_of_Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldHeight <bot>
|Gives a 'GetBattleFieldHeight'-reply with the height of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldWidth <bot>
|Gives a '|GetBattleFieldWidth'-reply with the width of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining <bot>
|Gives a 'GetDistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat <bot>
|Gives a 'GetGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading <bot>
|Gives a 'GetHeading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetHeight <bot>
|Gives a 'GetHeight'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds <bot>
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum <bot>
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed <bot>
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration <bot>
|Gives a 'GetTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining <bot>
|Gives a 'GetTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime <bot>
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining <bot>
|Gives a 'GetTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth <bot>
|Gives a 'GetWidth'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetX <bot>
|Gives a 'GetX'-reply with x-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetY <bot>
|Gives a 'GetY'-reply with y-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|IdentifyFrontend 0001
|Greets the backend. (specifying protocol-version 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-07-06T08:26:02Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google Summer Of Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|Execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see SetFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetBases
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldHeight <bot>
|Gives a 'GetBattleFieldHeight'-reply with the height of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|GetBattleFieldWidth <bot>
|Gives a '|GetBattleFieldWidth'-reply with the width of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|GetConstants
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetFlags
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetDistanceRemaining <bot>
|Gives a 'GetDistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetGunHeat <bot>
|Gives a 'GetGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetHeading <bot>
|Gives a 'GetHeading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetHeight <bot>
|Gives a 'GetHeight'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetMyTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetNumRounds <bot>
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|GetObstacles
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetOtherTanks
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetRoundNum <bot>
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|GetShots
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetSpeed <bot>
|Returns the current velocity, as per default - or as per last SetSpeed.
|No
!style="background-color: #ff3333"|No
|-
|GetTeams
|<explain>
|No
!style="background-color: #ff3333"|No
|-
|GetTickDuration <bot>
|Gives a 'GetTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTickRemaining <bot>
|Gives a 'GetTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|GetTime <bot>
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetTurnRemaining <bot>
|Gives a 'GetTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|GetWidth <bot>
|Gives a 'GetWidth'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|GetX <bot>
|Gives a 'GetX'-reply with x-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|GetY <bot>
|Gives a 'GetY'-reply with y-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|IdentifyFrontend 0001
|Greets the backend. (specifying protocol-version 0001)
|No
!style="background-color: #55ff55"|Yes
|-
|SetAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|SetFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|SetResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to SetStop. This will fail if there are no previous SetStop-calls. Will not restore until you 'execute'. (If you call SetAhead, SetTurn etc before this, they will be overwritten unless SetResume fails)
|No
!style="background-color: #ff3333"|No
|-
|SetStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called SetStop and not SetResume, this will fail unless you've Set overwrite to true. Does not store & clear until you call 'execute'. (You can call SetAhead, SetTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|SetSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|SetTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|SetTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-06-28T17:13:43Z

Daxxar:

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google Summer Of Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|agent 1
|Greets the backend.
|No
!style="background-color: #55ff55"|Yes
|-
|bases
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|constants
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see setFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|flags
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|getBattleFieldHeight <bot>
|Gives a 'getBattleFieldHeight'-reply with the height of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|getBattleFieldWidth <bot>
|Gives a '|getBattleFieldWidth'-reply with the width of the map in "units".
|No
!style="background-color: #ff3333"|No
|-
|getDistanceRemaining <bot>
|Gives a 'getDistanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getGunHeat <bot>
|Gives a 'getGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getHeading <bot>
|Gives a 'getHeading'-reply with heading of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|getHeight <bot>
|Gives a 'getHeight'-reply with height of the tank.
|No
!style="background-color: #ff3333"|No
|-
|getNumRounds <bot>
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|getRoundNum <bot>
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|getSpeed <bot>
|Returns the current velocity, as per default - or as per last setSpeed.
|No
!style="background-color: #ff3333"|No
|-
|getTickDuration <bot>
|Gives a 'getTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTickRemaining <bot>
|Gives a 'getTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTime <bot>
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|getTurnRemaining <bot>
|Gives a 'getTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getWidth <bot>
|Gives a 'getWidth'-reply with width of the tank.
|No
!style="background-color: #ff3333"|No
|-
|getX <bot>
|Gives a 'getX'-reply with x-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|getY <bot>
|Gives a 'getY'-reply with y-coordinate of the tank.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|mytanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|obstacles
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|othertanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|setAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|setFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|setResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to setStop. This will fail if there are no previous setStop-calls. Will not restore until you 'execute'. (If you call setAhead, setTurn etc before this, they will be overwritten unless setResume fails)
|No
!style="background-color: #ff3333"|No
|-
|setStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called setStop and not setResume, this will fail unless you've set overwrite to true. Does not store & clear until you call 'execute'. (You can call setAhead, setTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|setSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|setTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|shots
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|teams
|<explain>
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-06-28T11:23:08Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google Summer Of Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|agent 1
|Greets the backend.
|No
!style="background-color: #55ff55"|Yes
|-
|bases
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|constants
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see setFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|flags
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|getDistanceRemaining <bot>
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getGunHeat <bot>
|Gives a 'getGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getNumRounds <bot>
|To be defined (or removed?)
|No
!style="background-color: #ff3333"|No
|-
|getRoundNum <bot>
|Returns the number of times the bot has died (or?).
|No
!style="background-color: #ff3333"|No
|-
|getSpeed <bot>
|Returns the current velocity, as per default - or as per last setSpeed.
|No
!style="background-color: #ff3333"|No
|-
|getTickDuration <bot>
|Gives a 'getTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTickRemaining <bot>
|Gives a 'getTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTime <bot>
|RoboCode: "Returns the game time of the current round, where the time is equal to the current turn in the round." - Will most likely return number of times you've 'execute'-d. Alternatively; return elapsed seconds / tickDuration (but tickDuration can change), or elapsed seconds.
|'''Yes'''
!style="background-color: #ff3333"|No
|-
|getTurnRemaining <bot>
|Gives a 'getTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|mytanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|obstacles
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|othertanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|setAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|setFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|setResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to setStop. This will fail if there are no previous setStop-calls. Will not restore until you 'execute'. (If you call setAhead, setTurn etc before this, they will be overwritten unless setResume fails)
|No
!style="background-color: #ff3333"|No
|-
|setStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called setStop and not setResume, this will fail unless you've set overwrite to true. Does not store & clear until you call 'execute'. (You can call setAhead, setTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|setSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|setTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|shots
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|teams
|<explain>
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-06-27T17:35:06Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google Summer Of Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|agent 1
|Greets the backend.
|No
!style="background-color: #55ff55"|Yes
|-
|bases
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|constants
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see setFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|flags
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|getDistanceRemaining <bot>
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getGunHeat <bot>
|Gives a 'getGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getTickDuration <bot>
|Gives a 'getTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTickRemaining <bot>
|Gives a 'getTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTurnRemaining <bot>
|Gives a 'getTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|mytanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|obstacles
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|othertanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|setAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|setFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|setResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to setStop. This will fail if there are no previous setStop-calls. Will not restore until you 'execute'. (If you call setAhead, setTurn etc before this, they will be overwritten unless setResume fails)
|No
!style="background-color: #ff3333"|No
|-
|setStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called setStop and not setResume, this will fail unless you've set overwrite to true. Does not store & clear until you call 'execute'. (You can call setAhead, setTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|setSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|setTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|shots
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|teams
|<explain>
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-06-27T17:34:05Z

Daxxar: /* Protocol Description */

=Overview=
This page describes the BZRobots Enhanced Protocol that is part of the Programmable Computer Player Client project for the [[Google Summer Of Code]].

=Protocol Description=
The protocol is linebased, and works on a request-reply basis. Below is a table of all available requests.
The backend has something called a ''steady-state'' - this is basically when the backend is idle, and the tank likewise. Some commands will only work in this steady-state (because they will only make sense when the bot is not doing anything), and if one of these commands are sent when the bot is in ''active-state'' the backend will '''not reply''' until the backend has entered ''steady-state'' (and any commands sent after the first command are queued for handling until the ''blocking'' command has been handled). These commands are marked with "'''Yes'''" in the "Steady-state required?"-column.

'''Frontend To Backend Messages'''
{| cellspacing="0" border="1"
!Message syntax
!Description
!Steady-state required?
!Implemented?
|-
|agent 1
|Greets the backend.
|No
!style="background-color: #55ff55"|Yes
|-
|bases
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|constants
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|execute <bot>
|Runs a tick of the 'planned actions', and perhaps fires a shot (see setFire).
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|flags
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|getDistanceRemaining <bot>
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getGunHeat <bot>
|Gives a 'getGunHeat'-reply with how many seconds are left of the gun cooldown.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|getTickDuration <bot>
|Gives a 'getTickDuration'-reply with how many seconds makes up one tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTickRemaining <bot>
|Gives a 'getTickRemaining'-reply with how many seconds are left of this tick.
|No
!style="background-color: #55ff55"|Yes
|-
|getTurnRemaining <bot>
|Gives a 'getTurnRemaining'-reply with how much is left of the currently planned turn.
|'''Yes'''
!style="background-color: #55ff55"|Yes
|-
|mytanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|obstacles
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|othertanks
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|setAhead <bot> <distance>
|Sets planned movement (for next 'execute'-s) that moves 'distance' units.
|No
!style="background-color: #55ff55"|Yes
|-
|setFire <bot>
|Sets a planned shot (for next 'execute')
|No
!style="background-color: #55ff55"|Yes
|-
|setResume <bot>
|Overwrites and restores the bots current actions (distance and turn) from a previous call to setStop. This will fail if there are no previous setStop-calls. (If you call setAhead, setTurn etc before this, they will be overwritten unless setResume fails)
|No
!style="background-color: #ff3333"|No
|-
|setStop <bot> <overwrite>
|Stores and clears the bots current actions (distance and turn). If you've previously called setStop and not setResume, this will fail unless you've set overwrite to true. Does not store & clear until you call 'execute'. (You can call setAhead, setTurn etc after this, and they will become the 'new' values, instead of 0.)
|No
!style="background-color: #ff3333"|No
|-
|setSpeed <bot> <factor>
|Sets next actions speed, value between 0 and 1.0. (for future 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|setTickDuration <bot> <seconds>
|Sets the duration of a tick, in seconds.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnLeft <bot> <degrees>
|Sets planned turn (for next 'execute'-s) that turns 'degrees' degrees to the left.
|No
!style="background-color: #55ff55"|Yes
|-
|setTurnRate <bot> <factor>
|Sets next actions turnrate, value between 0 and 1.0. (for next 'execute'-s)
|No
!style="background-color: #55ff55"|Yes
|-
|shots
|<explain>
|No
!style="background-color: #55ff55"|Yes
|-
|teams
|<explain>
|No
!style="background-color: #55ff55"|Yes
|}

=See Also=
[[BZRobots/About]] - Project Overview

[[BZRobots/Ideas]] - Feature suggestions / thoughts

BZRobots/Protocol

2007-06-27T16:14:37Z

Daxxar: /* Protocol Description */

BZRobots/Ideas

2007-06-27T15:58:38Z

Daxxar: /* See Also */

=Overview=
This page is to describe the community ideas for the BZRobots API that is to be provided as part of the Programmable Computer Player Client project for the Google Summer Of Code

= Feature ideas =
==Scripting==
* Integrate python as a scripting language on top of C++
* Be able to load C++ or python modules transparently.

==API functions==
* Provide global, team, admin, and report chat APIs so bots can communicate just like players, perhaps with some parsing helper functions.
* Provide an API for visual targets based on the same rules a player would see.
* Have methods to compute travel paths to desired locations, with updates for moving targets.

=See Also=
* [[Google_Summer_of_Code|Google Summer of Code]]
* [[BZRobots/About]]

BZRobots/History

2007-06-26T16:46:36Z

Daxxar:

This is a page about the 'new' BZRobots as a part of [http://code.google.com/soc GSoC].

I'm daxxar, and you can read about the project at [[Google_Summer_of_Code#Programmable_Computer_Player_Client|GSoC Wiki Page]]. Development updates are posted to my blog [http://gsoc.daxxar.com]. My code will be on the SVN [http://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/bzflag/src/bzrobots here]. :-)

Interesting pages on this wiki on my project are currently:
* [[BZRobots/Protocol]] - Description of the new protocol
* [[BZRobots/Ideas]] - Feature suggestions / thoughts

The architecture will be that one component (similar to the current bzrobots) takes commands via a defined protocol (see the protocol page). This is called the 'backend'. The 'frontend' is what executes the script or loads the module or whatever, and which takes care of communication with the 'backend'.

BZRobots/Ideas

2007-06-26T16:45:33Z

Daxxar: New page: = Feature ideas = Here '''everyone''' can post their feature suggestions for the new BZRobots :-) * Python support (Thanks JeffM & DTRemenak) * Communication via chat (team chat), e.g. t...

= Feature ideas =

Here '''everyone''' can post their feature suggestions for the new BZRobots :-)

* Python support (Thanks JeffM & DTRemenak)
* Communication via chat (team chat), e.g. to "give orders" (Thanks Macrosoft)

BZRobots/Protocol

2007-06-23T16:11:19Z

Daxxar: /* BZRobots Enhanced Protocol */

== BZRobots Enhanced Protocol ==

This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC. The protocol is inspired by the API it will convey the messages of, which in turn is inspired by [http://robocode.sourceforge.net RoboCode]. ;-)

{| cellspacing="0" border="1"
|+ Backend -> frontend messages
!Message syntax
!Description
|-
|SOME_COMMAND_HERE <float>
|THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT
|}

{| cellspacing="0" border="1"
|+ Frontend -> backend messages
!Message syntax
!Description
|-
|setAhead <distance>
|Sets planned movement (for next 'execute') that moves 'distance' units.
|-
|setBack <distance>
|Sets planned movement backwards, same as setAhead -distance
|-
|setTurnLeft <degrees>
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the left.
|-
|setTurnRight <degrees>
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the right, same as setTurnLeft -degrees.
|-
|setFire
|Sets a planned shot (for next 'execute')
|-
|setTurnRate
|Sets next actions turnrate. (for next 'execute')
|-
|setSpeed
|Sets next actions speed. (for next 'execute')
|-
|getDistanceRemaining
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.
|-
|getTurnRemaining
|Gives a 'turnRemaining'-reply with how much is left of the currently planned turn.
|-
|execute
|Runs a tick of the 'planned actions', and replies with a 'tick over' when the tick has passed.
|}

BZRobots/Protocol

2007-06-18T19:38:09Z

Daxxar: /* BZRobots Enhanced Protocol */

== BZRobots Enhanced Protocol ==

This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC. The protocol is inspired by the API it will convey the messages of, which in turn is inspired by [http://robocode.sourceforge.net RoboCode]. ;-)

{| cellspacing="0" border="1"
|+ Backend -> frontend messages
!Message syntax
!Description
|-
|SOME_COMMAND_HERE <float>
|THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT
|}

{| cellspacing="0" border="1"
|+ Frontend -> backend messages
!Message syntax
!Description
|-
|setAhead <distance>
|Sets planned movement (for next 'execute') that moves 'distance' units.
|-
|setBack <distance>
|Sets planned movement backwards, same as setAhead -distance
|-
|setTurnLeft <degrees>
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the left.
|-
|setTurnRight <degrees>
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the right, same as setTurnLeft -degrees.
|-
|setFire
|Sets a planned shot (for next 'execute')
|-
|getDistanceRemaining
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.
|-
|getTurnRemaining
|Gives a 'turnRemaining'-reply with how much is left of the currently planned turn.
|-
|execute
|Runs a tick of the 'planned actions', and replies with a 'tick over' when the tick has passed.
|}

BZRobots/Protocol

2007-06-18T19:23:04Z

Daxxar:

== BZRobots Enhanced Protocol ==

This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC.

{| cellspacing="0" border="1"
|+ Backend messages
!Message syntax
!Description
!Example
|-
|SOME_COMMAND_HERE <float>
|THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT
|SOME_COMMAND_HERE 15
|}

{| cellspacing="0" border="1"
|+ Frontend messages
!Message syntax
!Description
!Example
|-
|SOME_COMMAND_HERE <float>
|THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT
|SOME_COMMAND_HERE 15
|}

BZRobots/History

2007-06-18T19:16:19Z

Daxxar: Quick architecture info

This is a page about the 'new' BZRobots as a part of [http://code.google.com/soc GSoC].

I'm daxxar, and you can read about the project at [[Google_Summer_of_Code#Programmable_Computer_Player_Client|GSoC Wiki Page]]. Development updates are posted to my blog [http://gsoc.daxxar.com]. My code will be on the SVN [http://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/bzflag/src/bzrobots here]. :-)

Interesting pages on this wiki on my project are currently:
* [[BZRobots/Protocol]] - Description of the new protocol

The architecture will be that one component (similar to the current bzrobots) takes commands via a defined protocol (see the protocol page). This is called the 'backend'. The 'frontend' is what executes the script or loads the module or whatever, and which takes care of communication with the 'backend'.

BZRobots

2007-06-18T19:07:20Z

Daxxar: Redirecting to BZRobots/About

#REDIRECT [[BZRobots/About]]

BZRobots/History

2007-06-18T19:03:33Z

Daxxar: New page: This is a page about the 'new' BZRobots as a part of [http://code.google.com/soc GSoC]. I'm daxxar, and you can read about the project at [[Google_Summer_of_Code#Programmable_Computer_Pla...

BZRobots/Protocol

2007-06-18T18:50:15Z

Daxxar: New page: == BZRobots Enhanced Protocol == This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC.

== BZRobots Enhanced Protocol ==

This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC.