Setup
Last updated
Was this helpful?
Last updated
Was this helpful?
This repository is intended as a base to be used for building more complex AIs, and has all the tooling needed to transpile Python into JavaScript set up.
The ./build.py script does the majority of the work. It sets up the python environment, and installs all dependencies. However, you will still need some base software installed:
version 3.7 or above
npm
Your Linux distribution should have python installed. Use your package manager (apt, dnf, etc.) to install git, node and npm.
Using , install git, python and node (npm comes with node):
Install git from . Default options are fine.
Start "git bash" to start a terminal for the next step.
Next, if you haven't already cloned this repository, you'll want to. Use a git gui if you have one, or:
The last step to setting up screeps-game-api is to create and configure the build. This will allow build.py to upload files directly to the screeps server after building.
Alternatively, you can use your username and password for authentication. To do this, remove the token line, and add username and password fields to config.json. Be careful about commas - all lines except the last should have trailing commas.
Following that, you're all set up! build.py will automatically download and install the rest of the dependencies into a local environment when it is first run.
To run build.py on a Unix system (Linux, MacOS), use:
To run build.py on Windows with raw Python installed from python.org:
On first run, this will install remaining dependencies, then compile, build, and deploy your code to Screeps! On subsequent runs, it will simply call installed tools and deploy code from there.
If you're having trouble running build.py in Windows, it might be worth trying out an alternative installation method.
For Windows users, running build.py may fail if virtualenv cannot be detected in your PATH. The setup procedure here should only be used if the primary installation method at this top of this README does not work.
While Miniconda will install its own version of Python to your system, you do not need to modify or uninstall any version already in place. The installer will ask if you want Miniconda to be used as your default version of Python; if you plan to use conda only for screeps, you can decline.
Once the installation is complete, look for a program icon labeled Anaconda Prompt and run it. All commands listed for the rest of the guide must be entered in the terminal created by Anaconda Prompt.
Enter the following commands in the order listed:
conda create -n screeps python=3.8
activate screeps
conda install git
Once finished, you can now try python build.py again.
To transpile your Python code to JavaScript, build.py must be called from an Anaconda Prompt using the screeps environment; this can be achieved through the following steps:
Open an Anaconda Prompt
enter the command: activate screeps
The above steps only need to be performed when opening a new Anaconda Prompt, you can keep it running in the background while you make changes to your code and switch to it only when you need to run build.py. To deactivate the screeps environment, you can either enter the command deactivate screeps, or you can close the prompt itself.
Install the latest version of Python from . Again, default options should be fine.
Install node.js LTS Windows Installer from . Default options should again be fine.
Next, you'll want to open this repository in your file manager, copy config.default.json to config.json and proceed to
Copy the contents of config.default.json into config.json. with full access rights through your screep's account management page, then copy the token and paste it to the token key in config.json.
This setup procedure uses conda, which is provided through the If you already have something like on your system, you can skip this step. If you are new to conda, the does a great job of covering the basics.