@olistic/warriorjsPublic

JavaScript and TypeScript battle game for the CLI

WarriorJS is a programming game where you write JavaScript or TypeScript to control a warrior through puzzle towers. The code you write decides how the warrior moves, fights, rescues captives, and survives each floor. The project ships a CLI, a website, shared game libraries, and tower content.

9,538 stars•499 forks•TypeScript•Updated 5mo ago

Who it's for

People who want to practice coding by solving game levels in the terminal or browser.

What it delivers

You can learn and practice JavaScript or TypeScript by writing code that directly controls game behavior.

What it does

CLI gameplay

Start the game with `warriorjs` and play through guided tower levels from the terminal.

Browser play

Play the game from the website at warriorjs.com without using the CLI.

Tower-based puzzles

Solve levels built around enemies, captives, stairs, and floor-by-floor objectives.

Player API docs

The docs explain the gameplay, towers, and the API you use to write your warrior logic.

Tower authoring

Contributors can build new towers that other players can install and play.

How to get it

1Install the CLI
```
npm install --global @warriorjs/cli
```
2Launch the game
```
warriorjs
```

README

Learn JavaScript and TypeScript by writing code that fights

In WarriorJS, you write JavaScript or TypeScript to guide a warrior through towers full of enemies. Each floor is a puzzle: battle sludge, dodge archers, rescue captives, and reach the stairs alive. The code you write is the strategy — there's no clicking, no dragging, just logic and sharp thinking.

Whether you're writing your first if statement or refactoring for a perfect score, every floor will test you.

Quick Start

Install Node.js 22 or later.
Install the CLI:

npm install --global @warriorjs/cli

Launch the game:

warriorjs

The game walks you through creating a warrior and choosing a tower. Open the generated README.md for your first level's instructions, write your solution in Player.js, then run warriorjs again to see how your warrior fares.

You can also play from your browser at warriorjs.com.