Fixed gopher link in readme.
[jars.git] / README
1 JaRS: Janky Redcode Simulator
2 =============================
3
4 A hobby implementation of the Memory Array Redcode Simulator (MARS) and
5 associated tools for the programming game Corewar designed by A. K. Dewdney
6 (see http://corewar.co.uk/dewdney for copies of the 1984 Scientific American
7 columns where the idea was first presented).
8
9 At this pont, the JaRS contains a collection of utilities for:
10 - Running redcode programs (warriors) specified in the "load file"
11   format of the 1994 draft of the core war standard,
12 - Visualizing the progress of battles graphically using Tk,
13 - Maintaining King of the Hill style tournaments in the spirit of
14   http://www.koth.org.
15
16 Further Details
17 ---------------
18
19 JaRS follows version 3.3 of the Proposed 1994 Core War Standard.
20 (A copy is here: gopher://thelambdalab.xyz/0/docs/icws94.txt.)
21
22 Currently the parser only handles the redcode programs expressed in
23 the simple "load file" format described by the standard.  All possible
24 core war programs can be expressed in this format, but it lacks some
25 niceties such as labeled addresses.  That is, it accepts the redcode
26 equivalent of machine code but lacks an assembler.
27
28 Furthermore the simulator itself lacks support for p-space, a private
29 memory area reserved for each program in some later revisions of the
30 standard.
31
32 License
33 -------
34
35 JaRS is free software, and is distributed under the terms of version 3
36 of the GNU General Public License.  A copy of this license can be found in
37 the file named COPYING.