7.0.0 Alpha 4

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":

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.

6.1.0

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:

From Crates.io

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

cargo install rojo

7.0.0 Alpha 3

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":

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)

7.0.0 Alpha 2

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":

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.

7.0.0 Alpha 1

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.

6.0.2

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:

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.

6.0.1

This is a minor release to account for an API change on Roblox's side. Only rojo upload is affected.

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.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 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.0

• Fixed rojo upload requests being rejected by Roblox

6.0.0

Happy 2021! This is the first stable release for Rojo 6. As Rojo has been used in production by top games for some time, I felt it was time to change Rojo's version number from pre-1.0 to post-1.0.

If you're upgrading from the Rojo 6.0 release candidates, there are a couple new bugfixes since rc4. The full set of changes since rc4 is available in CHANGELOG.md, here.

If you're upgrading from Rojo 0.5.x, everything should be smooth sailing. There are a couple intentional compatibility breakages in this release that should only be hit rarely, so we'll be releasing a migration guide soon.

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.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

Major Changes Since 0.5.x

For a full changelog, check out the release notes in CHANGELOG.md. Relevant entries are all 0.6.0 alpha releases, as well as all 6.0.0 release candidates.

More information will be posted about these features will be posted in the coming days.

Project File Composition

Project files can now compose together the contents of other project files.

Support for Refs

Ref properties like Model.PrimaryPart and ObjectValue.Value will now build and live sync correctly. This required a little bit of extra legwork that's finally here!

Brand new Studio Plugin UI

Rojo 6 includes a brand new UI by @Reselim that supports dark mode in Studio. Check it out!

Sync Improvements

• Rojo now detects changes to project files, which are now reflected immediately when live syncing
• Class names are now optional for service definitions in project files
• .json files now turn into ModuleScript instances, making it easy to import data as plain old Lua tables
• Added the globIgnorePaths option for project files, enabling projects to exclude files from Rojo, like TestEZ tests.

CLI Improvements

• Added the rojo plugin install/uninstall command, which will automatically install the Rojo Roblox Studio plugin for you
• Added a brand new rojo init command, which creates much better default projects
• Added the rojo doc command, which opens Rojo's documentation in your browser
• rojo upload now automatically discovers your Roblox auth cookie from Roblox Studio
• rojo upload now automatically uploads a place or model correctly, removing the --kind parameter
• Added the --watch/-w flag to rojo build
• Added a --verbose flag, which can be specified multiple times

6.0.0 Release Candidate 4

This is the fourth release candidate for Rojo 6.

This release contains a brand new UI overhaul, brought to you by @Reselim!

Trying the Release Candidate

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

• Run rojo plugin install from the Rojo 6 CLI
• Download the attached Rojo.rbxm and install it manually
• Install from the Roblox plugin page

There are now a few ways to download the Rojo CLI.

With Foreman

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

rojo = { source = "rojo-rbx/rojo", version = "6.0.0-rc.4" }

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 --version 6.0.0-rc.4

All Changes Since 6.0.0-rc.3

• Added brand new Rojo UI (#367)
• Added projectName to /api/rojo output.

6.0.0 Release Candidate 3

This is the second release candidate for Rojo 6! This is entirely an emergency patch release to fix regressions introduced by 6.0.0rc-2.

For a full changelog, check out the 6.0.0-rc.2 Release.

Changes since 6.0.0-rc.2

• Fixed the Rojo plugin attempted to write the non-scriptable properties Instance.SourceAssetId and HttpServer.HttpEnabled.
• Fixed the Rojo plugin's handling of null referents.