Apple-2-SW
/
robotwar
mirror of https://github.com/richardharrington/robotwar.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README.md

This commit is contained in:
Richard Harrington 2014-01-10 23:26:08 -05:00
parent 489f087480
commit fe9294bff1
1 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@ -3,13 +3,24 @@ RobotWar
A reverse-engineered version (in Clojure) of Silas Warner's 1981 Apple II game, RobotWar.
In RobotWar, players write programs in a Forth-like language created specifically for the game, which is compiled down to a virtual machine code and then used as an AI for a (virtual) robot in battles against other players' robots. It's currently a work in progress. I'll have installation instructions up soon, but in the meantime, if you'd like to create and email me some robot source code to test with, check out the following links to get started:
In RobotWar, players write programs in a Forth-like language created specifically for the game, which is compiled down to a virtual machine code and then used as an AI for a (virtual) robot in battles against other players' robots.
Here are some resources that describe the game pretty well:
* [The original manual](http://corewar.co.uk/robotwar/robotwar.txt)
* [A blog post](http://www.filfre.net/2012/01/robot-war/) explaining the game in some detail
* Last but not least, an excellent [web-based JavaScript version](http://robotwarjs.net) that just came out.
You can easily use that last link to write and test robots. Both me and the guy who created that site are hewing pretty closely to the specs of the original game, so any robot code you create in his will almost certainly run in mine.
### To see it in action:
Install [leiningen](http://leiningen.org), then:
git clone git@github.com:richardharrington/robotwar.git
cd robotwar
lein ring server
Then type in the names of the robots displayed in the browser (up to 5), and watch them move around the arena.
My implementation of it is currently a work in progress. As you will note, the robots aren't actually damaging each other yet, but it has sound effects (the blaster effect from Star Wars), which as we know is 90% of the battle.
### Architecture