Skip to content
Compare
Choose a tag to compare

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:

Switching version dropdown to select Rojo 7

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
Compare
Choose a tag to compare
Pre-release

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:

Switching version dropdown to select Rojo 7

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
Compare
Choose a tag to compare
Pre-release

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:

Switching version dropdown to select Rojo 7

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
Compare
Choose a tag to compare

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:

Rojo VS Code extension configured to install Rojo 6.x

From Crates.io

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

cargo install rojo
Compare
Choose a tag to compare

7.0.0 Alpha 4

Pre-release
Pre-release

This is a major polishing release, getting us closer to the release of Rojo 7.0 stable. Lots of edge cases that use to raise confusing errors or crashes now include much better information!

Upgrading

To install the Roblox Studio plugin, there are three 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-alpha.4" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Open your VS Code preferences and set the "Release Branch" option to "7.x":

Switching version dropdown to select Rojo 7

From Crates.io

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

cargo install rojo --version 7.0.0-alpha.4

Changes Since 7.0.0-alpha.3

  • Added the gameId and placeId optional properties to project files.
    • When connecting from the Rojo Roblox Studio plugin, Rojo will set the game and place ID of the current place to these values, if set.
    • This is equivalent to running game:SetUniverseId(...) and game:SetPlaceId(...) from the command bar in Studio.
  • Added "EXPERIMENTAL!" label to two-way sync toggle in Rojo's Roblox Studio plugin.
  • Fixed Name and Parent properties being allowed in Rojo projects. (#413)
  • Fixed "Open Scripts Externally" feature crashing Studio. (#369)
  • Empty .model.json files will no longer cause errors. (#420)
  • When specifying $path on a service, Rojo now keeps the correct class name. (#331)
  • Improved error messages for misconfigured projects.
Compare
Choose a tag to compare

This is a minor release that works around Roblox's new partially-released OptionalCoordinateFrame type. When reading files that contain this type, Rojo will currently output a warning. Previously, Rojo would encounter an error and give up.

Additionally, this release adds the new --address flag to the Rojo CLI. This is intended for users who want to run Roblox Studio and Rojo on different machines or with one of the programs in a virtual machine.

Changes Since 6.0.2

  • Updated dependencies, fixing OptionalCoordinateFrame-related issues.
  • Added --address flag to rojo serve to allow for external connections. (#403)

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.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 6.x:

Rojo VS Code extension configured to install Rojo 6.x

From Crates.io

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

cargo install rojo
Compare
Choose a tag to compare

7.0.0 Alpha 3

Pre-release
Pre-release

This release adds a new flag, --address, for accessing Rojo from other computers. It also includes fixes to help Rojo avoid throwing errors when encountering OptionalCoordinateFrame properties, newly added by Roblox.

Upgrading

To install the Roblox Studio plugin, there are three 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-alpha.3" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Open your VS Code preferences and set the "Release Branch" option to "7.x":

Switching version dropdown to select Rojo 7

From Crates.io

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

cargo install rojo --version 7.0.0-alpha.3

Changes Since 7.0.0-alpha.2

  • Updated dependencies, fixing OptionalCoordinateFrame-related issues.
  • Added --address flag to rojo serve to allow for external connections. (#403)
Compare
Choose a tag to compare

7.0.0 Alpha 2

Pre-release
Pre-release

This is a minor hotfix to address a release issue as part of 7.0.0 Alpha 1.

Upgrading

To install the Roblox Studio plugin, there are three 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-alpha.2" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Open your VS Code preferences and set the "Release Branch" option to "7.x":

Switching version dropdown to select Rojo 7

From Crates.io

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

cargo install rojo --version 7.0.0-alpha.2

Changes Since 7.0.0-alpha.1

  • Fixed incorrect protocol version between the client and server.
Compare
Choose a tag to compare

7.0.0 Alpha 1

Pre-release
Pre-release

This is the first prerelease that includes a massive body of work getting Rojo's DOM implementation upgraded. This means that we should now have 100% format coverage for both the XML and binary model formats.

Rojo 7.0.0 Alpha 1 includes some minor breaking changes to the way the Rojo project format represents certain kinds of values. It's going to change a bit more before Rojo 7 is stable — we're hoping to use this opportunity to normalize some of the case inconsistency introduced in Rojo 0.5.

Upgrading

To install the Roblox Studio plugin, there are three 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-alpha.1" }

From GitHub Release

Download one of the attached binaries on this release page!

From the VS Code Extension

Rojo 7 cannot be installed through the VS Code extension quite yet.

From Crates.io

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

cargo install rojo --version 7.0.0-alpha.1

Changes Since 6.0.2

  • Added support for all remaining property types.
  • Added support for the entire Roblox binary model format.
  • Changed rojo upload to upload binary places and models instead of XML.
    • This should make using rojo upload much more feasible for large places.
  • Breaking: Changed format of some types of values in project.json, model.json, and meta.json files.
    • This should impact few projects. See this file for new examples of each property type.
Compare
Choose a tag to compare

This is a minor release to work around Roblox's introduction of CSRF challenges on the upload endpoint Rojo uses.

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.0.2" }

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:

Rojo VS Code extension configured to install Rojo 6.x

From Crates.io

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

cargo install rojo

Changes Since 6.0.1

  • Fixed rojo upload to handle CSRF challenges.