descriptionThe JAnky Redcode Simulator
last changeThu, 9 Mar 2023 14:04:19 +0000 (15:04 +0100)
readme
JaRS: Janky Redcode Simulator
=============================

A hobby implementation of the Memory Array Redcode Simulator (MARS)
and associated tools for the programming game, Core War. The original
concept for this game was developed by A. K. Dewdney (see
http://corewar.co.uk/dewdney for copies of the 1984 Scientific
American columns where the idea was first presented).

At this pont, JaRS contains utilities for:
- Running redcode programs (warriors) specified in the "load file"
  format of the 1994 draft of the core war standard,
- Visualizing the progress of battles graphically using Tk, and
- Maintaining King of the Hill style tournaments in the spirit of
  http://www.koth.org.

JaRS is still under development, and many aspects have not been fully
tested.  Use at your own risk!

Further Details
---------------

JaRS follows version 3.3 of the Proposed 1994 Core War Standard.
(A copy is here: gopher://thelambdalab.xyz/0/docs/icws94.txt.)

Currently the parser only handles the redcode programs expressed in
the simple "load file" format described by the standard.  All possible
core war programs can be expressed in this format, but it lacks some
niceties such as labeled addresses.  That is, it accepts the redcode
equivalent of machine code but lacks an assembler.

Furthermore the simulator itself lacks support for p-space, a private
memory area reserved for each program in some later revisions of the
standard.

License
-------

JaRS is free software, and is distributed under the terms of version 3
of the GNU General Public License.  A copy of this license can be found in
the file named COPYING.
shortlog
2023-03-09 plugdAdded parse error on empty program. master
2021-08-19 plugdAdded debugger.
2021-08-19 plugdDefault to no visualization.
2021-07-29 plugdFinal queue count now adjustable.
2020-05-13 plugdNow have warrior info files in hill dir.
2020-05-11 plugdEasier debugging of MARS.
2020-05-11 plugdFixed typo in SPL action.
2020-05-11 plugdUpdated makefile.
2020-05-11 plugdTiny changes, made note of bug in SPL.
2020-05-11 plugdUpdated gitignore.
2020-05-11 plugdFixed first par of readme.
2020-05-11 plugdKOTH almost functional.
2020-05-08 plugdAdded static compilation sequence to makefile.
2020-05-08 plugdFixed gopher link in readme.
2020-05-08 plugdUpdated readme.
2020-05-08 plugdAdded readme and license.
...
heads
13 months ago master