{"id":22213,"library":"rollup-plugin-screeps-ss3","title":"Rollup Plugin Screeps SS3","description":"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.","status":"active","version":"1.1.2","language":"javascript","source_language":"en","source_url":"https://github.com/ShuP1/rollup-plugin-screeps-ss3","tags":["javascript","rollup","screeps","typescript"],"install":[{"cmd":"npm install rollup-plugin-screeps-ss3","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-screeps-ss3","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-screeps-ss3","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required as a plugin","package":"rollup","optional":true}],"imports":[{"note":"Package uses default export","wrong":"import { screeps } from 'rollup-plugin-screeps-ss3'","symbol":"screeps","correct":"import screeps from 'rollup-plugin-screeps-ss3'"},{"note":"In CommonJS, default export is under .default","wrong":"const screeps = require('rollup-plugin-screeps-ss3');","symbol":"screeps","correct":"const screeps = require('rollup-plugin-screeps-ss3').default;"},{"note":"Type-only import to avoid runtime inclusion","wrong":"import { ScreepsOptions } from 'rollup-plugin-screeps-ss3';","symbol":"ScreepsOptions","correct":"import type { ScreepsOptions } from 'rollup-plugin-screeps-ss3';"}],"quickstart":{"code":"// rollup.config.js\nimport screeps from 'rollup-plugin-screeps-ss3';\n\nexport default {\n  input: 'src/main.js',\n  output: {\n    file: 'dist/main.js',\n    format: 'cjs',\n  },\n  sourcemap: true,\n  plugins: [\n    screeps({\n      server: process.env.SCREEPS_SERVER ?? 'main',\n      branch: process.env.SCREEPS_BRANCH ?? 'auto',\n    })\n  ]\n};","lang":"javascript","description":"Example rollup.config.js using the plugin with environment variable overrides for server and branch and source maps enabled."},"warnings":[{"fix":"Set output.format to 'cjs' or 'es' and enable sourcemap: true","message":"Source maps only work if output format is 'cjs' or 'es' with inline source maps","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Migrate your config to .screeps.yaml following the SS3 unified credentials standard","message":"Legacy JSON config file is deprecated in favor of .screeps.yaml","severity":"deprecated","affected_versions":">=1.1.0"},{"fix":"Use import screeps from ... instead of import { screeps } from ...","message":"The package no longer exports a named function, only default export","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Ensure you are in a git repository when using branch: 'auto', or set an explicit branch name","message":"If branch is set to 'auto' and not in a git repository, the plugin will throw","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"npm install --save-dev rollup-plugin-screeps-ss3","cause":"Package not installed or not in devDependencies","error":"Error: Cannot find module 'rollup-plugin-screeps-ss3'"},{"fix":"import screeps from 'rollup-plugin-screeps-ss3'","cause":"Using incorrect import pattern: named import instead of default import","error":"TypeError: screeps is not a function"},{"fix":"Create a .screeps.yaml file following the SS3 standard, or pass explicit config object","cause":"Missing or misnamed credentials file in project root","error":"Error: Config file not found: .screeps.yaml"},{"fix":"const screeps = require('rollup-plugin-screeps-ss3').default;","cause":"Using CommonJS require without accessing .default","error":"TypeError: Cannot read property 'default' of undefined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}