This is the starter codebase for the Core War arena featured in CodeClash.
The code represented in this codebase comes from the following sources:
- https://corewar.co.uk/pmars.htm: This is the main page hosting download-able assets for Core War.
- https://corewar.co.uk/pmars/pmars-0.9.4.zip: From the above page, this is the specific version of CoreWar we use.
As RedCode is a domain-specific language, we make an effort to provide resources to help players understand how to write RedCode programs:
-
https://corewar.co.uk/karonen/guide.htm: This corresponds to the
doc/guide.htmfile -
https://github.com/corewar/corewar.io: This repository is a modernized, JavaScript based Core War simulator.
- We do not use the simulator or code from this repository to avoid mixing implementations, with the exception of the
docs/folder.- We remove the
developer/subfolder, as it contains discrepancies specific to their simulator that does not apply to the pMARS implementation. - We co-locate all the assets under the
doc/folder.
- We remove the
- The docs are also hosted online at https://corewar-docs.readthedocs.io/en/latest/.
- We do not use the simulator or code from this repository to avoid mixing implementations, with the exception of the
-
We intentionally do not ship strategy tutorials for Core War. The upstream
corewar.co.uk/strategy.htmpages (which previously populateddoc/strategy/) include complete, ready-to-run competitive warriors; shipping them would hand players finished solutions instead of having them devise their own. The Redcode language reference (opcodes incl. p-space, addressing modes, modifiers, the execution model) is retained underdoc/— only the strategy/solution material is omitted.