Registry / devops / rollup-plugin-screeps-ss3

rollup-plugin-screeps-ss3

library1.1.2jsnpmunverified

A Rollup plugin for uploading code to Screeps game servers. Version 1.1.2 supports the unified `.screeps.yaml` credentials file (SS3 standard) as well as legacy JSON config. It automatically applies source maps in Screeps-friendly format and can derive the target branch from the current git branch. Unlike other Screeps plugins, it integrates with the Screepers unified credential standard and offers environment variable overrides for server and branch.

devops

npm install rollup-plugin-screeps-ss3

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-SCRE

rollup-plugin-screeps-ss3

devopsjavascriptv1.1.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

screeps

✓ import screeps from 'rollup-plugin-screeps-ss3'

✗ import { screeps } from 'rollup-plugin-screeps-ss3'

Package uses default export

screeps

✓ const screeps = require('rollup-plugin-screeps-ss3').default;

✗ const screeps = require('rollup-plugin-screeps-ss3');

In CommonJS, default export is under .default

ScreepsOptions

✓ import type { ScreepsOptions } from 'rollup-plugin-screeps-ss3';

✗ import { ScreepsOptions } from 'rollup-plugin-screeps-ss3';

Type-only import to avoid runtime inclusion

Example rollup.config.js using the plugin with environment variable overrides for server and branch and source maps enabled.

// rollup.config.js import screeps from 'rollup-plugin-screeps-ss3'; export default { input: 'src/main.js', output: { file: 'dist/main.js', format: 'cjs', }, sourcemap: true, plugins: [ screeps({ server: process.env.SCREEPS_SERVER ?? 'main', branch: process.env.SCREEPS_BRANCH ?? 'auto', }) ] };

Debug

Known issues

gotchaSource maps only work if output format is 'cjs' or 'es' with inline source maps

fix

Set output.format to 'cjs' or 'es' and enable sourcemap: true

affects: >=1.0.0

deprecatedLegacy JSON config file is deprecated in favor of .screeps.yaml

fix

Migrate your config to .screeps.yaml following the SS3 unified credentials standard

affects: >=1.1.0

breakingThe package no longer exports a named function, only default export

fix

Use import screeps from ... instead of import { screeps } from ...

affects: >=1.0.0

gotchaIf branch is set to 'auto' and not in a git repository, the plugin will throw

fix

Ensure you are in a git repository when using branch: 'auto', or set an explicit branch name

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'rollup-plugin-screeps-ss3'

Package not installed or not in devDependencies

fix

npm install --save-dev rollup-plugin-screeps-ss3

TypeError: screeps is not a function

Using incorrect import pattern: named import instead of default import

fix

import screeps from 'rollup-plugin-screeps-ss3'

Error: Config file not found: .screeps.yaml

Missing or misnamed credentials file in project root

fix

Create a .screeps.yaml file following the SS3 standard, or pass explicit config object

TypeError: Cannot read property 'default' of undefined

Using CommonJS require without accessing .default

fix

const screeps = require('rollup-plugin-screeps-ss3').default;

Upgrade

Version history

1.1.2latest on npm

Audit

Dependencies

rollupoptionalPeer dependency required as a plugin

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/ShuP1/rollup-plugin-screeps-ss3 ↗

packagehttps://www.npmjs.com/package/rollup-plugin-screeps-ss3 ↗