mirror of https://github.com/dirtbags/tanks.git
4fd9aa541b | ||
---|---|---|
contrib | ||
docs | ||
examples | ||
www | ||
.gitignore | ||
LICENSE.md | ||
Makefile | ||
README.md | ||
ctanks.c | ||
ctanks.h | ||
dump.h | ||
forf.c | ||
forf.h | ||
forftanks.c | ||
tanksd.go |
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