Starter Rust AI for Screeps: World, the JavaScript-based MMO game.
This uses the screeps-game-api bindings from the rustyscreeps organization.
While it's possible to compile using wasm-pack directly using the Node.js target,
some modifications are needed to load the output within the Screep environment, so it's
recommended to use cargo-screeps for building and deploying your code.
The documentation is currently a bit sparse. API docs which list functions one can use are located at https://docs.rs/screeps-game-api/.
Almost all crates on https://crates.io/ are usable (only things which interact with OS apis are broken).
Quickstart:
# Install CLI dependency:
cargo install cargo-screeps
# Clone the starter
git clone https://github.com/rustyscreeps/screeps-starter-rust.git
cd screeps-starter-rust
# note: if you customize the name of the crate, you'll need to update the MODULE_NAME
# variable in the javascript/main.js file with the updated name
# Copy the example config, and set up at least one deployment mode.
# Configure credentials if you'd like to upload directly, or a directory to copy to
# if you'd prefer to use the game client to deploy:
cp example-screeps.toml screeps.toml
nano screeps.toml
# Compile plus deploy to the configured 'upload' mode; any section name you
# set up in your screeps.toml for different environments and servers can be used
cargo screeps deploy -m upload