v7.2.1 Release Test

This is a test release to ensure that our changes to the Rojo release workflow still work.

v7.2.1

This fix addresses a couple issues introduced with the new notifications feature in Rojo 7.2.0.

Changes Since Rojo 7.2.0

• Fixed notification sound by changing it to a generic sound. (#566)
• Added setting to turn off sound effects. (#568)

Upgrading

To install the Roblox Studio plugin, there are a few options:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.2.1" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.57.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.2.1

v7.2.0

This release includes a bunch of long-awaited improvements and several smaller fixes as well.

Changes Since Rojo 7.1.1

• Added support for .luau files. (#552)
• Added support for live syncing Attributes and Tags. (#553)
• Added notification popups in the Roblox Studio plugin. (#540)
• Fixed init.meta.json when used with init.lua and related files. (#549)
• Fixed incorrect output when serving from a non-default address or port (#556)
• Fixed Linux binaries not running on systems with older glibc. (#561)
• Added camelCase casing for JSON models, deprecating PascalCase names. (#563)
• Switched from structopt to clap for command line argument parsing.
• Significantly improved performance of building and serving. (#548)
• Increased minimum supported Rust version to 1.57.0. (#564)

Upgrading

To install the Roblox Studio plugin, there are a few options:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.2.0" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.57.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.2.0

v7.1.1-perf-work

This is an experimental branch of Rojo v7 with a number of performance fixes applied.

See #548 for the tracking pull request.

v7.1.1

This is the first release of Rojo to support Apple Silicon! Release artifacts ending in -macos-aarch64 should run natively. Please report any problems by filing an issue on GitHub.

Changes Since Rojo 7.1.0

• Fixed sourcemap command not stripping paths correctly (#544)
• Fixed Studio plugin settings not saving correctly.

Upgrading

To install the Roblox Studio plugin, there are a few options:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.1.1" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.55.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.1.1

7.1.0

Major Changes

Open Cloud Upload Support

rojo upload now supports the --api_key and --universe_id parameters, which enable using the new Open Cloud API for uploading places. Users who don't provide these parameters will continue using the current cookie-based API.

Thanks to @VernandoGames for implementing this feature!

Luau LSP Support

This release brings a new subcommand, sourcemap, for integration with Luau Language Server.

Thanks to @filiptibell and @JohnnyMorganz for building and collaborating on this feature!

Optional Paths

A long requested feature from roblox-ts users, Rojo projects can now define optional paths:

{
	"name": "hello optional paths",
	"tree": {
		"$className": "Folder"
		"src": {
			"$path": "src"
		},
		"node_modules": {
			"$path": { "optional": "node_modules" }
		}
	}
}

These objects will not be included if the path they define isn't found on the filesystem.

Thanks to @Quenty for doing the initial implementation of this feature!

Plugin Icons and Shortcuts

The Rojo Studio plugin recently gained some new status icons to show you what's up with Rojo at a glance:

You can also now bind custom keybindings for connecting, disconnecting, or toggling your Rojo connection:

Thanks to @boatbomber for implementing these features and caring deeply about UX!

Changes Since Rojo 7.0.0

For a guide to upgrading from Rojo 6 to Rojo 7, see the official upgrade guide.

• Added support for specifying an address to be used by default in project files. (#507)
• Added support for optional paths in project files. (#472)
• Added support for the new Open Cloud API when uploading. (#504)
• Added sourcemap command for generating sourcemaps to feed into other tools. (#530)
• Added PluginActions for connecting/disconnecting a session (#537)
• Added changing toolbar icon to indicate state (#538)

Upgrading

To install the Roblox Studio plugin, there are a few options:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.1.0" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.55.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.1.0

7.0.0

Welcome to Rojo 7.0. After lots of iteration, testing, and feedback, we've finally arrived at a stable Rojo 7 release.

Changes Since Rojo 6

For a guide to upgrading from Rojo 6 to Rojo 7, see the official upgrade guide.

• Full support for binary models and places. Now you can use rbxm and rbxl files!
• Much better error messages for invalid project configurations.
• Added the fmt-project subcommand.
• Added the --address flag to rojo serve to support external connections.
• Added support for specifying CollectionService tags in project files — set the Tags property to an array of strings!
• Improved property syntax in project files, model files, and meta files. This was a breaking change. Check out the upgrade guide for details.

Changes Since 7.0.0-rc.3

• Fixed Rojo's interactions with properties enabled by FFlags that are not yet enabled. (#493)
• Improved output in Roblox Studio plugin when bad property data is encountered.
• Reintroduced support for CFrame shorthand syntax in Rojo project and .meta.json files, matching Rojo 6. (#430)
• Connection settings are now remembered when reconnecting in Roblox Studio. (#500)
• Updated reflection database to Roblox v503.

Upgrading

To install the Roblox Studio plugin, there are a few options:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.0.0" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.55.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.0.0

7.0.0 Release Candidate 3

This is the last release candidate for Rojo 7. In an effort to get Rojo 7 out the door, we'll be freezing features from here on out, something we should've done a couple months ago.

Expect to see Rojo 7 stable soon!

Changes Since 7.0.0-rc.1

• Added support for writing Tags in project files, model files, and meta files. (#484)
• Adjusted Studio plugin colors to match Roblox Studio palette. (#482)
• Improved experimental two-way sync feature by batching changes. (#478)

Upgrading

To install the Roblox Studio plugin, there are a few options now:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.0.0-rc.3" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.46.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.0.0-rc.3

7.0.0 Release Candidate 1

This is the first release candidate for Rojo 7. We expect this to be the final release before Rojo 7.0 stable.

Changes Since 7.0.0-alpha.4

In Rojo 6 and previous Rojo 7 alphas, an explicit Vector3 property would be written like this:

{
    "className": "Part",
    "properties": {
        "Position": {
            "Type": "Vector3",
            "Value": [1, 2, 3]
        }
    }
}

For Rojo 7, this will need to be changed to:

{
    "className": "Part",
    "properties": {
        "Position": {
            "Vector3": [1, 2, 3]
        }
    }
}

The shorthand property format that most users use is not impacted. For reference, it looks like this:

{
    "className": "Part",
    "properties": {
        "Position": [1, 2, 3]
    }
}

• Major breaking change: changed property syntax for project files; shorthand syntax is unchanged.
• Added the fmt-project subcommand for formatting Rojo project files.
• Improved error output for many subcommands.
• Updated to stable versions of rbx-dom libraries.
• Updated async infrastructure, which should fix a handful of bugs. (#459)
• Fixed syncing refs in the Roblox Studio plugin (#462, #466)
• Added support for long paths on Windows. (#464)

Upgrading

To install the Roblox Studio plugin, there are a few options now:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "=7.0.0-rc.1" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 7.x:

From Crates.io

You can use Cargo (1.46.0+) to build the release yourself from crates.io:

cargo install rojo --version 7.0.0-rc.1

6.2.0

This is a small bugfix release for the 6.0 release series. It will likely be the final release for Rojo 6, as Rojo 7 is nearing ready.

Changes Since 6.1.0

• Added "EXPERIMENTAL!" label to two-way sync toggle in Rojo's Roblox Studio plugin.
• Fixed "Open Scripts Externally" feature crashing Studio (#369)
• Updated dependencies, fixing HumanoidDescription ID issues.

Upgrading

To install the Roblox Studio plugin, there are a few options now:

• Run rojo plugin install from the Rojo CLI
• Download the attached Rojo.rbxm and place it into you Roblox Studio plugins folder
• Install from the Roblox plugin page

There are also multiple to install the Rojo CLI.

With Foreman

Add a line to the [tools] section in foreman.toml:

rojo = { source = "rojo-rbx/rojo", version = "6.2.0" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Change your release channel in the extension's setting page to 6.x:

From Crates.io

You can use Cargo (1.43.1+) to build the release yourself from crates.io:

cargo install rojo