PlayCanvas Uploader 🚀

A lightweight Rollup plugin to automatically upload your bundles to PlayCanvas.

ℹ️ Looking for the Webpack version? webpack-playcanvas-uploader

Installation

npm install rollup-plugin-playcanvas-uploader --save-dev

Usage

Add the following to your rollup.config.mjs. Make sure to replace the placeholders with the correct values (see project details section below).

import uploader from "rollup-plugin-playcanvas-uploader";

export default {
    input: "src/index.js",
    output: {
        file: "dist/main.js"
    },
    plugins: [uploader({
        projectId: yourProjectId,
        branchId: yourBranchId,
        accessToken: yourAccessToken,
        files: [
            { path: "dist/main.js", assetId: yourScriptId }
        ]
    })]
};

Retrieving Project Details

Follow these steps to retrieve your PlayCanvas project details. Use these to overwrite the placeholders in your uploader options (outlined above):

1. Create an empty script in your PlayCanvas project (e.g. main.js) and click on it to open the inspector. Copy the ID of the file (a numeric value at the top) and paste it under the assetId of the first file in your uploader options. Whenever you make a bundle using Rollup, the contents of your bundle will be uploaded to this script file. Make sure the path of the file (e.g. dist/main.js) actually matches the output of your Rollup config.
2. Open your browser's console and enter config.project.id, config.self.branch.id and config.accessToken. Copy the values over to your uploader options as projectId, branchId and accessToken respectively. Make sure to read the security section below to help keep your access token secret.

You're all set! 🎉 PlayCanvas Uploader will now automatically upload your bundles.

Security

⚠️ Keep your access token secret!

Do not commit it to Git. You can instead store it in a Git-ignored JSON file and import it into your rollup.config.mjs. Alternatively, you can add your access token as an environment variable and use process.env to access it (e.g. process.env.PLAYCANVAS_ACCESS_TOKEN).

Bug Reports & Feature Requests

Bug reports and feature requests welcome — please open an issue on GitHub.

License

MIT © 2025 Steven Derks
Distributed under the MIT License. See the LICENSE file for details.