README.md

corewars-compiler

By fabaindaiz

This software aims to be an easier way to write and optimize code for corewars. corewars-compiler uses its own mini functional language called RED which can then be compiled into optimized redcode.

work in progress.

Instructions of use

• See REFERENCE.md for develop and run.
• See docs/manual/ for the user manual: getting started, a tutorial, a cookbook of classic warriors and the tools.
• See LANGUAGE.md for RED language reference.
• See docs/semantics.md for what each construct means and what the compiler preserves.
• See docs/roadmap.md for known defects and planned work, and docs/references.md for the research behind them.
• Working with an AI assistant: AGENTS.md is its entry point (CLAUDE.md imports it).

Intepreters

To execute the resulting redcode you can use one of these redcode interpreters.

• pMARS
• other MARS implementations
• python MARS

TODO

• Create a RED language tutorial
• Improve control flow instructions and conditions
• Reduce duplicate code and improve compiled redcode

Acknowledgements

• Pleiad for BBCTester, through its fork BBCStepTester, which the tests use

References

Getting started

• the beginners' guide
• my first corewars book

Redcode learning

• corewars tips & tricks

Redcode wariors

• redcode warriors
• warriors sorted by type
• warriors sorted by name

Redcode reference

• 1994 Core War Standard
• REDCODE REFERENCE
• ICWS94 validate

Corewars koth

• KotH
• SAL hills
• hills