https://github.com/thieman/korhal

SC:BW Terran AI using JNIBWAPI and Clojure
https://github.com/thieman/korhal

Last synced: 7 days ago
JSON representation

SC:BW Terran AI using JNIBWAPI and Clojure

• Host: GitHub
• URL: https://github.com/thieman/korhal
• Owner: thieman
• License: epl-1.0
• Created: 2013-11-07T16:54:37.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-02-04T01:33:24.000Z (almost 11 years ago)
• Last Synced: 2024-04-14T19:16:42.499Z (7 months ago)
• Language: Scheme
• Size: 23.3 MB
• Stars: 109
• Watchers: 15
• Forks: 22
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Korhal

Korhal is a Brood War AI written in Clojure on top of a custom fork of JNIBWAPI that we use to extract even more information from the Brood War process. Korhal was started during my time at [Hacker School](https://www.hackerschool.com/).

## Getting Started

A virtual machine image is provided to get you up and running. [See the setup page in the wiki.](../../wiki/VM Setup)

[The wiki](../../wiki/Home) also has a decent amount of info about how Korhal works. Check it out before digging in.

## Current Status

Korhal is still in early development and is not combat ready. There's a whole lot of work to be done, so get in touch or file an issue if you'd like to contribute!

### Features

* nREPL server for interacting with a running game

* Brood War API designed for Clojure, ported from JNIBWAPI

* Fully asynchronous AI using Clojure's awesome ref types

* Contracts system keeps track of resources that have been committed to actions but not yet spent

* Can execute build orders given in similar format to how humans write them, e.g. 9 :supply-depot

* Very basic micro routines, e.g. marines attempt to kite zealots

### Example Videos

[Marines kiting zealots](http://www.youtube.com/watch?v=opuMbeqU0TI)

[Ghosts coordinating lockdowns](http://www.youtube.com/watch?v=dLX-cETVdyM)

[Skirmish against zealots and dragoons](http://www.youtube.com/watch?v=qYkhnUEt310)

[Basic build order execution](http://www.youtube.com/watch?v=LnIq5zx1jqw)