mirror of https://github.com/dirtbags/tanks.git
a3cb9f8fe1
|
||
|---|---|---|
| contrib | ||
| docs | ||
| examples | ||
| www | ||
| .gitignore | ||
| LICENSE.md | ||
| Makefile | ||
| README.md | ||
| ctanks.c | ||
| ctanks.h | ||
| dump.h | ||
| forf.c | ||
| forf.h | ||
| forftanks.c | ||
| run-tanks | ||
| upload.cgi.c | ||
README.md
Tanks
Dirtbags Tanks is a game in which you pit your coding abilities against other hackers. You write a program for your tank, set it out on the battlefield, and watch how your program fares against tanks written by other players. Dirtbags Tanks is frequently a component of Dirtbags Capture The Flag.
Running it
forftanks TANKDIR [TANKDIR...]
forftanks will run a round with every tank provided as an argument.
It outputs a JSON object describing the round.
Output fields
seed- Seed used by the random number generator. You can specify your own seed with the environment variable `SEED. If the same seed is used with the same tanks, you will get the same output.
field- Dimensions of the play field.
tanks- Description of each tank.
rounds- List of frames for each round. Each frame is a list of tank state for each tank. Tank state is described below.
Tank state
Tank state is packed more tightly than most modern JSON APIs. Tank state is a tuple of (x position, y position, orientation angle, turret angle, flags, sensor bits).
- x position, y position
- Tank's position on the play field.
- orientation angle
- Tank's orientation on the play field, in radians.
- turret angle
- Turret angle, relative to the tank, in radians.
- flags
- Logical or of 1 (firing), 2 (LED on), and 4 (dead)
- sensor bits
- Bit field of sensor state (1 = triggered)
Documentation
Current Maintainer
Neale Pickett neale@woozle.org