Skip to content

rogerreeder/Overmind

 
 

Repository files navigation

Overmind Screeps AI

Current release: Overmind v0.2.x - "Logistics Logic"


What is Screeps?

Screeps is an MMO strategy game for programmers. The core objective is to expand your colony to gather more resources. The game runs 24/7, even when you aren't actively playing; to control your units, you program their behavior in JavaScript or any other transpiled language. This is the AI I have been developing for Screeps, themed loosely around the Zerg's swarm intelligence from Starcraft. Creeps belong to Colonies, which have several Hive Clusters. Creep actions for a given process are orchestrated by Overlords. The colony Overseer places Directives to adapt to stimuli.

We're on slack!

Found something you like, hate, or find confusing? Join the discussion on Slack in the #overmind channel!

Find me in game! (username: Muon)

I've recently respawned to shard2 in the EXS4X sector.

Using Overmind as your AI

If you're new to Screeps, I wouldn't recommend using Overmind as your AI: most of the fun of the game is programming your own AI and watching your little ant farm run! However, I've tried to make the codebase readable and well-documented, so feel free to fork the project or use it as inspiration when writing your AI.

If you do want to use Overmind as-is, the latest release should work right out of the box. However, if you find something broken, please submit an issue and I'll try to fix it.

Out of the box

If you just want to run Overmind without modification, you can copy the compiled main.js file attached to the latest release into your script.

Full installation

If you want to install the full codebase, download or clone the repository, then navigate to the Overmind root directory and run:

npm install

(This will take about a minute to execute.) To compile and deploy the codebase, create a screeps.json file from the example file, then nagivate to the Overmind root directory and do one of the following actions:

  • Compile and deploy to public server: npm run push-main
  • Compile and deploy to private server: npm run push-pserver
  • Compile without deploying: rollup -c

The deployment scripts are based on screeps-typescript-starter; for additional help, refer to their GitBook or submit an issue.

Design overview

Check out the Overmind wiki for in-depth explanations of parts of the design of the AI. (Click the image below to see a higher-resolution version.)

AI structural schematic

About

AI for Screeps, a programming strategy game

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.7%
  • JavaScript 0.3%