Clojure Warrior

Play Clojure Warrior (port of Ruby Warrior) with your own IDE and browser.

Run

After cloning this repo...

VS Code + Calva

• REPL ⚡
• Start your project with a REPL and connect
• Project type: shadow-cljs
• Builds to start: :app
• (wait)
• Build to connect to: :app
• Open http://localhost:8081
• Open src/warrior/bot.cljs, edit and save the file to run the bot.

Generic

npm install
npm start

Open http://localhost:8081

Open src/warrior/bot.cljs, edit and save the file to run the bot.

Other

For other editors, see shadow-cljs' documentation

How to Play

Your Bot

Edit play-turn in src/warrior/bot.cljs:

(defn play-turn [board]
  [])

play-turn receives the board and must return one action per turn:

[:action/walk :direction/forward]     ; move one space
[:action/attack :direction/forward]   ; attack the adjacent unit (backward attacks at half power)
[:action/rest]                        ; regain 10% of max health
[:action/rescue :direction/forward]   ; free an adjacent captive
[:action/pivot]                       ; turn around
[:action/shoot :direction/forward]    ; shoot the first unit within 2 spaces

Directions are :direction/forward or :direction/backward.

The first level only starts with :action/walk unlocked, and other actions are unlocked as you progress through the levels.

The Board

The board is a vector of rows, and each space in a row is a map:

[[{:unit/type :unit.type/wall}
  {:unit/type :unit.type/warrior
   :unit/health 20.0
   :unit/direction :direction/east
   :unit/melee? true
   :unit/ranged? true}
  {:unit/type :unit.type/floor
   :unit/empty? true}
  {:unit/type :unit.type/sludge
   :unit/health 12.0
   :unit/direction :direction/west
   :unit/enemy? true
   :unit/melee? true}
  {:unit/type :unit.type/stairs
   :unit/stairs? true
   :unit/empty? true}
  {:unit/type :unit.type/wall}]]

...but you will rarely need to work with this list directly. There are many helper functions (in clojure-warrior.api, required as w in bot.cljs)

(w/warrior board)
;; => {:unit/type :unit.type/warrior
;;     :unit/health 20.0
;;     :unit/direction :direction/east
;;     :unit/melee? true
;;     :unit/ranged? true
;;     :unit/position [1 0]}

(w/feel board :direction/forward)
;; the adjacent space in that direction
;; => {:unit/type :unit.type/floor
;;     :unit/empty? true
;;     :unit/position [2 0]}
;; => {:unit/type :unit.type/sludge
;;     :unit/health 12.0
;;     :unit/enemy? true
;;     ...}

(w/look board :direction/forward)
;; the first non-empty space in that direction
;; => {:unit/type :unit.type/archer
;;     :unit/health 7.0
;;     :unit/enemy? true
;;     ...}

(w/listen board)
;; all enemies and captives on the board
;; => ({:unit/type :unit.type/sludge
;;      :unit/enemy? true ...}
;;     {:unit/type :unit.type/captive
;;      :unit/captive? true ...})

(w/stairs board)
;; => {:unit/type :unit.type/stairs
;;     :unit/stairs? true
;;     :unit/empty? true
;;     :unit/position [4 0]}

(w/inspect board [4 0])
;; the space at a position
;; => {:unit/type :unit.type/stairs
;;     :unit/stairs? true
;;     :unit/empty? true
;;     :unit/position [4 0]}

(w/distance-to board [4 0])
;; steps from your warrior to a position
;; => 3

(w/say {:health 20.0})
;; adds {:health 20.0} to the message log
;; also sends its argument to tap>
;; (see them in shadow-cljs Inspect at http://localhost:9630/inspect)

Keeping State Between Turns

play-turn is a pure function of the board, so use an atom when you need to remember something from previous turns (for example, your health last turn):

(defonce previous-health (atom nil))

(defn play-turn [board]
  (let [health (:unit/health (w/warrior board))
        taking-damage? (and @previous-health
                            (< health @previous-health))]
    (reset! previous-health health)
    ...))

Editor (browser only)

The editor build adds a CodeMirror editor next to the game, so a bot can be written and run entirely in the browser (code is evaluated with SCI). Code is saved in localStorage; the Share button puts it in the URL.

npm run editor

Open http://localhost:8081

To build a static site into public/editor:

npm run release:editor
cp -RL public/editor <deploy-dir>   # -L copies the sprites symlink as files

Development

To run the app with bot in dev-src/warrior/bot.cljs instead of src/warrior/bot.cljs:

npm run dev   # shadow-cljs -A:dev watch app

Note, dev also expects clojure-warrior repo under checkouts/clojure-warrior.