icon-snap-upload
v1.1.0
Published
Upload icons from the Icon Snap Roblox Studio plugin straight to Roblox as Decals via Open Cloud
Maintainers
Readme
icon-snap-upload
Upload icons from the Icon Snap Roblox Studio plugin straight to Roblox as Decals via Open Cloud. No install, no dependencies — just Node 18+.
npx icon-snap-uploadRun it from anywhere — nothing is written to your current folder. The first run asks for:
- An Open Cloud API key with the Assets read + write scopes (create one at https://create.roblox.com/dashboard/credentials), and
- whether uploads go to your user account or a group, plus that id.
Answers are remembered in ~/.icon-snap-upload/config.json, so later runs are just
npx icon-snap-upload again. The key stays on your computer — the plugin only ever talks
to localhost, and the key is only sent to Roblox.
Then in the plugin: open Save, pick the Roblox tab, and press Check connection.
Every snap is uploaded as a Decal (or turn off Auto-upload new snaps and use the Upload
buttons in Snapped icons); each icon's asset id shows up on its row, ready to copy.
Asset ids (and PNG copies, as a backup) also land in
~/.icon-snap-upload/icons/upload-manifest.json.
Options:
--reconfigure— ask for the key/id again and overwrite the remembered answers--port <n>(default 8792 — one aboveicon-snap's 8791, so both companions can run side by side),--out <dir>(override the PNG/manifest folder)ROBLOX_API_KEY=<key> npx icon-snap-upload --user-id <id>(or--group-id <id>) — non-interactive, ignores and never touches the stored config (for CI or one-offs)
Just want PNGs saved into your project folder (for example to sync them with a tool like
asphalt)? That's the separate icon-snap package.
