The International is my bot for Screeps, thematically based after communist aesthetics. Owned rooms are called communes, offensive and defensive forces are called the Red Army, economic workers are known as the Proletariat, and the Revolutionaries establish new communes and rebuild destroyed ones.
This bot can provide experienced and new players a reference for when they get stuck, need inspiration, or want to laugh at some terrible code. Comments are used commonly, and code is structured so it can be easily understood, replicated, and expanded upon. Please follow similar guidelines if you make a pull request ๐.
Feel welcome to fork it and otherwise use it, however do not be overly aggressive on the Screeps world, especially to newer players. The bot is intended to be automated, but can perform manual actions via the console. It has an information panel showing progress, events, economy, military, and more.
If you have specific questions or want to discuss the bot, please join our discord server.
Please read the about section before installing and using this bot.
First you'll want to download or fork the repository.
Ensure you have downloaded Node
Make sure your node version is below 17.0.0
You can check your node version with:
node -v
If your node version is too recent, you can change it with NVM:
Linux/MacOS nvm
Windows nvm-windows
After making sure you have correct node version go to the project folder (not src), you'll want to install the devDependencies like so:
npm i
And that's it. Join our discord server if you need help.
Before you use this bot, please consider two things. First, if you're a new player and especially one that wants to learn programming, JS, or TS, then this is not the place to start. I strongly encourage you to start your own bot and achieve a decent economy before using or contributing to this bot.
Secondly, DO NOT USE THIS BOT TO BULLY. Do not attack noobs, taking their remotes or claimed rooms. This is a fun game where people often program their own bots from scratch, so it is entirely fun-ruining and incredibly rude to pick on those who aren't using an open source bot like this one. If you find yourself against another open source bot, or a bot that can put up a fair fight against you, then best of luck. Please feel welcome to share experiences or ask questions in the discord server.
To begin, you need to decide what branch to use. Main is generally old but stable, while Development is less stable but more up to date. If you want to find bugs or test new features, Development is for you.
Using rollup we will translate the code into a single js file, which will be used in environments set in the screeps.json file. This reduces cpu usage, and compiles the code so it can be run by Screeps while we develop using folders and typescript.
First, rename example.screeps.json to screeps.json and fill in the required information for each environment you want to run the bot in.
To then run the bot, use the command npm run push-mmo
replacing mmo with the environment you want to compile to. This wiil initially compile to the environment, as well as automatically compiling and pushing to the environment on code changes.
For more information, please go to the wiki
Soon to be added again when PandaMaster fixes the new ScreepsPlus replacement site!
To run the bot on an performance checking server, run npm run server
and check out localhost:21025
(server) and localhost:3000
(grafana) in your browser. Alternatives with in-depth instructions can be found at Using a Private Server
For the performance server users its always RoomName as email and password is password
.
If you'd like to use rollup to compile to a private server, you'll need to download and configure screepsmod-auth to push your code.
I'd also suggest using this less-laggy tool steamless-client to watch your private server run from the comfort of your browser.
We're a huge fan of teamwork, and many useful features of this bot have been added by contributors.
If you want to join us in development for this bot, please join our discord server and share what you're working on, or hoping to add. We're happy to review issues, merge pull requests, and add collaborators!
Please use the development branch for pull requests, commits, etc.
An extra special thanks to Panda Master, Allorrian, Plaid Rabbit, Aerics, and DefaultO for their essential contribution to this project.
If you'd like to support the project, Carson Burke (AKA MarvinTMB) is happy to accept single time or monthly donations through the following links.