Integrates Rojo natively with VS Code.
All actions are performed via the Rojo menu, as seen above. To open the Rojo menu, either:
Ctrl
+ Shift
+ P
) and type "Rojo: Open menu"Note: The Rojo button only appears if a folder in your workspace contains a
*.project.json
file.
If 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, 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.
You must click "Install Roblox Studio plugin" at least once if you want to live-sync from Studio!
This 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.
If 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! 🙂)
If you want to learn more, see the Differences from Foreman section of the Aftman README.
Warning: Stopping Rojo does not work with Foreman
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 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.
When 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.
The 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.
aftman.toml
file in your project.If something about this new extension breaks your workflow, please tell us about it!
You can always temporarily revert to V1 by clicking the cog on the extension page and choosing "Install another version".
Rojo for VS Code is available under the terms of The Mozilla Public License Version 2. See LICENSE for details.