{"id":24703293,"url":"https://github.com/rojo-rbx/vscode-rojo","last_synced_at":"2025-07-08T01:34:43.534Z","repository":{"id":35010732,"uuid":"130013573","full_name":"rojo-rbx/vscode-rojo","owner":"rojo-rbx","description":"Visual Studio Code plugin for Rojo","archived":false,"fork":false,"pushed_at":"2024-02-22T20:44:58.000Z","size":972,"stargazers_count":34,"open_issues_count":8,"forks_count":23,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-14T06:18:31.318Z","etag":null,"topics":["roblox","rojo","vscode"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=evaera.vscode-rojo","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rojo-rbx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-18T06:20:46.000Z","updated_at":"2024-01-23T05:24:56.000Z","dependencies_parsed_at":"2023-01-15T11:57:12.482Z","dependency_job_id":null,"html_url":"https://github.com/rojo-rbx/vscode-rojo","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rojo-rbx%2Fvscode-rojo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rojo-rbx%2Fvscode-rojo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rojo-rbx%2Fvscode-rojo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rojo-rbx%2Fvscode-rojo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rojo-rbx","download_url":"https://codeload.github.com/rojo-rbx/vscode-rojo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235807602,"owners_count":19047988,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["roblox","rojo","vscode"],"created_at":"2025-01-27T05:54:49.527Z","updated_at":"2025-01-27T05:54:50.287Z","avatar_url":"https://github.com/rojo-rbx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rojo for VS Code\n\nIntegrates [Rojo](https://github.com/rojo-rbx/rojo) natively with VS Code.\n\n![Rojo menu](https://i.eryn.io/2222/chrome-DdVyGHdh.png)\n\nAll actions are performed via the Rojo menu, as seen above. To open the Rojo menu, either:\n\n- Open the Command Pallette (`Ctrl` + `Shift` + `P`) and type \"Rojo: Open menu\"\n- Use the Rojo button in the bottom right corner:\n\n![Rojo button](https://i.eryn.io/2222/dHvsUY6w.png)\n\n\u003e Note: The Rojo button only appears if a folder in your workspace contains a `*.project.json` file.\n\n## Automatic installation\n\nIf you do not have Rojo installed, the extension will ask you if you want it to be automatically installed for you. If you do, it will be installed via [Aftman](https://github.com/LPGhatguy/aftman), a toolchain manager. This will create an `aftman.toml` file in your project directory, which will pin the current version of Rojo in your project.\n\nYou must click \"Install Roblox Studio plugin\" at least once if you want to live-sync from Studio!\n\n## System rojo\n\nThis extension uses the `rojo.exe` from your system path. If you already installed Rojo manually to use it from the command line, or with another toolchain manager, this extension will use that version of Rojo automatically. However, we recommend upgrading to Aftman-managed Rojo for the best experience.\n\n### Foreman\n\nIf you are already using Foreman to manage your system Rojo, we recommend switching to Aftman. Aftman is a more robust, spiritual successor to Foreman, created by the same original author. (Who is also the creator of Rojo! 🙂)\n\nIf you want to learn more, see the [Differences from Foreman](https://github.com/LPGhatguy/aftman#differences-from-foreman) section of the Aftman README.\n\n\u003e **_Warning_: Stopping Rojo does not work with Foreman**\n\u003e\n\u003e All currently-released versions of Foreman (as of v1.0.4) have a bug that makes killing the launched Rojo process leave a Rojo process running forever. There is [an open issue on the Foreman repo](https://github.com/Roblox/foreman/issues/45) for this problem, but for now you must either not use Rojo managed with Foreman, or kill the process yourself. Aftman does not have this problem.\n\n### Migrating from a globally-installed or Foreman-managed Rojo\n\nWhen you open the extension for the first time, if you are not using Aftman, a message will appear in the bottom-right. If you click \"Switch to Aftman\" on that message, your old `rojo.exe` will automatically be removed from your system PATH, and you will see another prompt that will install Aftman and Rojo for you.\n\n## Coming from V1 of this extension\n\nThe release of V2 of this extension has changed how it works drastically, both internally and how you interact with it. However, we hope that these changes do not negatively affect your workflow.\n\n- All sub-commands have been removed in favor of a single menu.\n- The extension no longer uses its own bespoke installation of Rojo. It shares whatever version of Rojo you have installed on your system.\n- When the extension installs Rojo for you, it is installed in a way so that you can use it from the command line.\n- Versions of Rojo before Rojo 6 are no longer supported.\n- The extension will not automatically update Rojo for you. When Rojo is installed via Aftman, you can change your installed Rojo version by editing the `aftman.toml` file in your project.\n\nIf something about this new extension breaks your workflow, please tell us about it!\n\n- Join the [Roblox Open Source Discord Server](https://discord.gg/wH5ncNS)\n- [Open an issue](https://github.com/rojo-rbx/vscode-rojo/issues) on the project repo\n\nYou can always temporarily revert to V1 by [clicking the cog on the extension page and choosing \"Install another version\"](https://i.eryn.io/2222/2q0w1H3I.png).\n\n## Help me!\n\n- Read the [Rojo docs](https://rojo.space/docs/v7/)\n- Join the [Roblox Open Source Discord Server](https://discord.gg/wH5ncNS)\n\n## Supported platforms\n\n- Windows\n- macOS\n- Linux\n\n## License\n\nRojo for VS Code is available under the terms of The Mozilla Public License Version 2. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frojo-rbx%2Fvscode-rojo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frojo-rbx%2Fvscode-rojo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frojo-rbx%2Fvscode-rojo/lists"}