Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rojo-rbx/rojo/llms.txt

Use this file to discover all available pages before exploring further.

This page summarizes the most significant changes in recent Rojo releases. Each entry links to the pull request where the change was introduced. For the complete history of all releases, see the CHANGELOG.md in the GitHub repository.

​
Unreleased

The following changes are merged but not yet part of a stable release.
  • inf and nan values in properties are now synced (#1176)
  • Fixed a bug caused by reference properties (such as ObjectValue.Value) pointing to an instance not included in syncback (#1179)
  • Fixed instance replacement fallback failing when too many instances needed to be replaced (#1192)
  • Added actors and bindable/remote event/function variants to be synced back as JSON files (#1199)
  • Fixed a bug where macOS paths weren’t being handled correctly (#1201)
  • Fixed a bug where the notification timeout thread would fail to cancel on unmount (#1211)
  • Added a “Forget” option to the sync reminder notification to avoid being reminded for that place in the future (#1215)
  • Improved relative path calculation for sourcemap generation to avoid issues with Windows UNC paths (#1217)

​
v7.7.0-rc.1 (November 27th, 2025)

This release candidate is a significant milestone for Rojo, introducing syncback, WebSocket-based communication, and JSONC support. Syncback A new rojo syncback command has been added. It takes a Roblox file and pulls instances out of it, placing them at the correct location in the provided project: 
rojo syncback <path/to/project> --input <path/to/file.rbxl>
Syncback behavior is controlled by a new syncbackRules field in the project file: 
{
    "syncbackRules": {
        "ignoreTrees": ["ServerStorage/ImportantSecrets"],
        "ignorePaths": ["src/ServerStorage/Secrets/*"],
        "ignoreProperties": {
            "BasePart": ["Color"]
        },
        "syncCurrentCamera": false,
        "syncUnscriptable": true
    }
}
FieldDescription
ignoreTreesPaths in the Roblox file to skip
ignorePathsPaths in the filesystem to skip
ignorePropertiesProperties that won’t be synced back, keyed by class name
syncCurrentCameraWhether to sync back Workspace.CurrentCamera. Defaults to false.
syncUnscriptableWhether to sync back properties that can’t be set by the Studio plugin. Defaults to true.
WebSocket communication (#1142) The internal communication between the Rojo server and Studio plugin has been rebuilt to use WebSockets instead of long polling. This improves reliability and reduces latency. JSONC support (#1159) All JSON-related files now support JSONC syntax (comments and trailing commas). This includes .project.jsonc, .meta.jsonc, and .model.jsonc. Other changes
  • Fixed a bug where passing --skip-git to rojo init would still create a file named gitignore.txt (#1172)
  • Fixed bugs and improved performance and UX for the script diff viewer (#994)
  • Added new syncbackRules support to the syncback command (#937)

​
v7.6.x

​
v7.6.1 (November 6th, 2025)

  • Fixed a bug where the last sync timestamp was not updating correctly in the plugin (#1132)
  • Improved the reliability of sync replacements by adding better error handling and recovery (#1135)
  • Small improvements to stability when syncing large projects (#1140)
  • Added support for JSON comments and trailing commas in project, meta, and model JSON files (#1144)
  • Added sourcemap.json to the default .gitignore files (#1145)

​
v7.6.0 (October 10th, 2025)

  • Added a flag to rojo init to skip initializing a git repository (#1122)
  • Added a fallback method for syncing instances that cannot be synced through normal means, enabling support for MeshParts and Unions (#1030)
  • Added auto-reconnect and improved UX for sync reminders (#1096)
  • Added support for syncing .yml and .yaml files, similar to JSON and TOML (#1093)
  • Added --absolute flag to the sourcemap subcommand for emitting absolute paths (#1092)
  • Added an update indicator to the version header when a newer plugin version is available (#1069)
  • Fixed Auto Connect Playtest Server no longer functioning due to a Roblox change (#1066)
  • Fixed sourcemap command outputting paths with OS-specific path separators (#1085)

​
v7.5.x

​
v7.5.1 (April 25th, 2025)

  • Fixed output spam related to Instance.Capabilities in the plugin

​
v7.5.0 (April 25th, 2025)

  • Added blockedPlaceIds project config field to block specific place IDs from live sync (#1021)
  • Added support for .plugin.lua(u) files, which apply the Plugin RunContext (#1008)
  • Added support for Roblox’s Content type; the old Content type is now ContentId
  • Added support for Enum attributes
  • Added support for a $schema field in .project.json, .model.json, and .meta.json files (#974)
  • Added the ability to manually link Ref properties using Attributes in project files (#843)
  • Added custom syncRules to the project format for treating files as different types (#813)
  • Added popout diff visualizer for table properties like Attributes and Tags (#834)
  • Added update notifications for newer compatible plugin versions (#832)
  • Significantly improved performance of .rbxm parsing
  • Fixed an edge case that caused model pivots to not be built correctly (#1027)
Earlier versions are documented in the CHANGELOG.md on GitHub, going back to v0.5.0.

Build docs developers (and LLMs) love

Get started for freeTalk to us