mirror of
https://github.com/Stefanuk12/Verde.git
synced 2026-08-14 21:04:56 +00:00
A Roblox Studio Explorer + Properties Emulator in VS Code
- JavaScript 32.2%
- TypeScript 24.7%
- Luau 22%
- HTML 18%
- CSS 2.9%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .github/workflows | ||
| extension | ||
| plugin | ||
| .envrc | ||
| .gitignore | ||
| flake.lock | ||
| flake.nix | ||
| README.md | ||
Verde
A Roblox Studio + Properties Emulator VS Code extension.
Verde allows to view your entire datamodel from within VS Code, with operations like copy, paste, duplicate, rename, and delete for any instance.
Verde also comes with a properties window, allowing you to read and modify any properties of any instance without having to leave your editor.
Verde can be used either with a dedicated sync tool (Like Rojo/Argon/Azul) or with the newly released Script Sync + Luau-LSP (for sourcemap generation)
Features
- Live Instance Tree: View your Roblox game's instance hierarchy in VS Code.
- Script Opening: Double-click scripts from the explorer to open them right in VS Code (works with Rojo/Argon/Azul/Luau-LSP sourcemaps).
- Instance Operations: Rename, duplicate, delete, copy, and paste instances.
- Ctrl+P Quick-Pick Menu: Quickly see most recently interacted instances, or search for a specific instance to quickly navigate to it.
- Properties Panel: View and edit instance properties right from VS Code.
- Play Sounds right from VS Code: Opening the Properties panel of a Sound instance, there will be a green Play button, just like in studio.
- If not playing, make sure the
Only Play Audio When Window In FocusStudio setting is disabled.
- If not playing, make sure the
Requirements
- Roblox Studio with the Verde plugin installed
- A Rojo/Argon/Azul setup with sourcemap generation (for script opening functionality)
Extension Installation
Manually
- Run
npm run packagein the extension directory to create a.vsixfile - In VS Code, press Ctrl + Shift + P to open the command palette
- Select "Install from VSIX..." and choose the generated
.vsixfile
Online
Setup
- Install the Verde plugin in Roblox Studio
- Open your VS Code workspace
- The extension will automatically start a WebSocket server
- Open Roblox Studio and run your game with the plugin
- The Roblox Explorer view should appear in VS Code
Extension Settings
verde.sourcemapPath: Path to sourcemap file (relative to workspace root) - defaults to "sourcemap.json"verde.port: Port for the WebSocket server - defaults to 9000verde.host: Host IP address for the WebSocket server - defaults to "localhost"verde.autoStart: Automatically start the server when the extension activates - defaults to trueverde.iconDirectory: Optional absolute or workspace-relative directory containingClassName.pngoverrides. You can point either to the icon folder itself or to a parent pack root that containsRobloxCustom/instance/16x/200. Missing icons still use Verde's bundled assets.
Usage
Opening Scripts
- Click on any Script, LocalScript, or ModuleScript in the Verde explorer
- The extension will look up the file path in your sourcemap
- The corresponding file will open in VS Code
Instance Operations
- Right-click instances for context menu options
- Use keyboard shortcuts for quick operations:
Enter: RenameDelete: DeleteCtrl+C: CopyCtrl+V: PasteCtrl+D: DuplicateCtrl+Shift+A: Open new instance panel

