About Corewar

Corewar is a game where two or more players write competing assembly programs in a custom assembly language called Redcode, aiming to control a shared virtual memory space.

The game concept originated in 1984 and was first introduced in this article. Since then, a few implementations have emerged, but most have grown outdated or lack the features needed for a modern experience, especially for easily playing against friends or competing online.

This project aims to revitalize Corewar, bringing it to a whole new audience of tech enthusiasts. Happy hacking!

Start playing

The current production deployment can be found here.

We deploy every active branch to https://$BRANCHNAME.corewar.shonk.software/ aswell.

Local setup

To run the project locally, you can use our prebuilt container image.

docker run -p 8080:80 ghcr.io/corewar-teamprojekt/corewar:latest

podman run -p 8080:80 ghcr.io/corewar-teamprojekt/corewar:latest

Technologies

This app uses a react frontend with shadcn as its core component library. On the serverside, we run a ktor backend.

For more details regarding our architecture, check out this drawio file.

Contributing / Local setup

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

License

The Corewar project is open-sourced software licensed under the Apache License.

Corewar

Install / Use

README