Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including screepsmod-auth with all npm packages installed. Try it out:

var screepsmodAuth = require("screepsmod-auth")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

screepsmod-auth v2.4.8


This adds user/pass auth to the screeps private server

NPM info

Circle CI


  1. npm install screepsmod-auth in your server folder.
  2. Thats it!


Web Form Method

  1. Open the steam client at least once (Required to create initial account)
  2. Goto http://yourServerHostOrIP:21025/authmod/password/
  3. Enter your desired password
  4. Click Signin with steam
  5. Your password should be set and you be able to login via API

Server CLI method

  1. Open the screeps server CLI (npx screeps cli or via Steam Server UI)
  2. Run setPassword('Username', 'YourDesiredPassword')
  3. Now you should be able to login via API



Returns a Promise, resovles to either the user object or false

Github Auth

To enable github auth, you need to add a github client id and client secret to your .screepsrc
(Or ENV vars GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET with other launchers)

Make sure to set the callback url to point to /api/auth/github/return on your server. ex:
Get the id and secret from youe Github settings:


clientId = <clientId>
clientSecret = <clientSecret>

Initial CPU and Spawn Blocking

You can set the initial CPU that gets placed on a user (Steam users always receive 100), and also control whether the new user can place spawns. This can be used in combination with a whitelist or manual approval to control spawning.

cpu = 100
preventSpawning = false


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free