# Weepy Roblox Explorer (VSCode Extension)

Roblox Studio Explorer-like tree view for VSCode. Browse synced instance trees, open scripts directly, and track sync status — all inside your editor.
This is a companion extension for Weppy Roblox MCP, not a standalone Roblox integration.

![Weepy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)

## Requirements

- VSCode 1.85+
- [Roblox MCP](../../../README.md) installed with Sync enabled (Basic or Pro)
- `roblox-project-sync/place_*/.sync-meta.json` already generated by Sync

## Installation

Search for **Weepy Roblox Explorer** in the VSCode Extensions sidebar (`Ctrl+Shift+X` / `Cmd+Shift+X`) and click **Install**.

Or install directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer).

Core tree browsing works from synced files on disk. Live sync state, direction indicators, and Explorer telemetry forwarding are available when the local MCP server is reachable.

## Features

- **Instance tree**: Service/instance hierarchy matching Roblox Studio
- **Roblox class icons**: Dark/light theme support with 200+ class icons
- **Multi-place**: Separate tree roots per synced place
- **Click-to-open**: Open backing files (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
- **Instance search**: QuickPick search across all services
- **Sync status badges**: See `modified`, `studio`, `conflict` states at a glance
- **Auto-refresh**: Tree updates automatically when sync files change (500ms debounce)
- **Copy instance path**: Right-click to copy `game.Workspace.Part` style paths

## Settings

| Setting | Default | Description |
|---------|---------|-------------|
| `robloxExplorer.syncRoot` | `""` | Absolute path to `roblox-project-sync` root. Auto-discovered if empty. |
| `robloxExplorer.hidePropsFiles` | `false` | Hide sync artifact files (`.props.json`, `_tree.json`, `.value.json`) in the default VSCode explorer. |
| `robloxExplorer.autoRefresh` | `true` | Auto-refresh tree when sync files change. |
| `robloxExplorer.showSyncStatus` | `true` | Show sync status decorations on tree items. |

## Commands

| Command | Description |
|---------|-------------|
| `Weepy Roblox Explorer: Refresh` | Manually refresh the instance tree |
| `Weepy Roblox Explorer: Search Instances` | Search instances across all services |
| `Weepy Roblox Explorer: Open Backing File` | Open the file backing a selected instance |
| `Weepy Roblox Explorer: Copy Instance Path` | Copy the full instance path (e.g. `game.Workspace.Part`) |
| `Weepy Roblox Explorer: Reveal in Explorer` | Show the backing file in the default VSCode explorer |

## Related

- [Sync Deep Dive](../sync/overview.md)
- [Installation Guide](README.md)
