Runway

Runway is an asset manager for Roblox projects.

It maps paths in your project to asset strings and supports fast local development or uploads using Open Cloud.

Runway borrows from Tarmac but doesn't aim to do resource compilation (spritesheet packing, alpha bleeding, DPI scaling, etc). Runway's input/output system should ideally be modular enough to build other tools on top of it.

Installation

With Aftman (recommended)

Install Aftman, then add an entry to the [tools] section of aftman.toml: toml runway = "hazelmeow/runway@0.1.0"

From releases

tba

From source

Clone the repository and run: bash cargo install --path .

Usage

Configuration

Runway is configured with a runway.toml file at the root of your project. Paths within runway.toml should be relative to the project root.

Config files require a name and can have any number of targets, inputs, and codegen outputs. The minimum (useful) config is a name and one of each: ```toml name = "my-project"

[[target]] type = "local"

[[input]] glob = "assets/*/.png"

[[codegen]] format = "lua" path = "src/assets.lua" `` With this config, we can runrunway sync --target localto make our images accessible from Studio using the asset strings listed inassets.lua`.

Input globs use .gitignore's syntax. You can add another glob by adding another [[input]] section.

To upload assets to Roblox using the Open Cloud API, use the roblox target type. Syncing to Roblox requires --api-key and either --user-id or --group-id. We can also give each target a key which is used by the --target argument and keys the upload state. toml [[target]] key = "production" type = "roblox"

Runway can output asset paths as json, lua, or ts files. You can specify multiple outputs by adding more [[codegen]] sections. There are some additional options available per output: ```toml [[codegen]] format = "ts" path = "src/assets.ts"

flatten = false # Defaults to false, makes the output map flat instead of nesting by path stripprefix = "assets" # Defaults to none, removes leading path from output map stripextension = true # Defaults to true, removes extension from output map ```

State

Syncing will generate runway-state.toml and runway-state.local.toml files containing the uploaded asset IDs and hashes of their contents for detecting changes.

The local state file should not be checked in to version control. The Roblox state file is useful for skipping uploading assets to Roblox that haven't changed.

Global options

• -h, --help, -V, --version
  • Does that you think
• -v, --verbose,
  • Logs more details. Use twice for even more verbosity
• -q, --quiet
  • Logs less output
• -t, --target <key>
  • Target's key or type if key is unspecified
• -c, --config [path]
  • Path to file or directory containing config
  • Defaults to current directory

Syncing to Roblox

These options can also be read from the listed environment variables.

• -a, --api-key <key>, RUNWAY_API_KEY=
  • Open Cloud API key
• -u, --user-id <id>, RUNWAY_USER_ID=
  • User ID to upload as
• -g, --group-id <id>, RUNWAY_GROUP_ID=
  • Group ID to upload as

runway sync

Finds files matched by configured inputs and syncs changed assets to the specified target, then generates configured outputs.

Examples: runway sync --target local runway sync --target roblox --api-key <key> --user-id <id>

Additional options: * -f, --force * Skips checking if files are changed and syncs everything

runway watch

Watches a project for new/changed inputs and runs the sync process automatically.

Supported asset types

All image and audio types should work but haven't been closely checked yet. Models aren't tested yet.

See the Open Cloud assets docs for more details.

| Extension | Local | Roblox | | ------------------- |:-----:|:------:| | .png | Yes | Yes | | .jpg
.jpeg | ? | ? | | .bmp | ? | ? | | .tga | ? | ? | | .mp3 | Yes | ? | | .ogg | Yes | ? | | .fbx | ? | ? |

License

Runway is available under the MIT license. See LICENSE.txt.