Weepy Roblox Explorer

Companion VSCode extension for browsing roblox-project-sync data generated by Weppy Roblox MCP.

Features

• Service/instance tree rendered from explorer/{Service}/_tree.json
• Click-to-open backing files (.server.luau, .client.luau, .module.luau, .value.json, .props.json)
• Custom Roblox class icons (dark/light)
• Multi-place tree root (Place -> Service -> Instance)
• Optional MCP polling for place sync state and direction
• Sync status badges from .sync-index.json (modified, studio, conflict)
• Auto-refresh with 500ms debounce when sync files change
• Instance search across all services with QuickPick
• Optional hide of sync artifacts via robloxExplorer.hidePropsFiles
• Configurable MCP local HTTP base URL with 3002 -> 3003 fallback when unset
• Explorer title bar settings button that opens VSCode Settings filtered to robloxExplorer

Telemetry

Anonymous analytics are buffered locally and forwarded only through the local MCP bridge when it is available. They do not include file paths, instance paths, place IDs, or script contents.

Requirements

• VSCode ^1.85.0
• Weppy Roblox MCP installed with Sync initialized so roblox-project-sync/place_*/.sync-meta.json exists

Installation

Install Weepy Roblox Explorer from the VS Code Marketplace.

This extension is not a standalone Roblox integration. It reads sync files generated by Weppy Roblox MCP, and live sync state or direction indicators become available when the local MCP server is reachable. Install Weppy Roblox MCP first: https://github.com/hope1026/weppy-roblox-mcp

Extension Settings

• robloxExplorer.syncRoot: Optional absolute path to roblox-project-sync
• robloxExplorer.mcpBaseUrl: Optional MCP local HTTP base URL. If empty, Explorer tries http://127.0.0.1:3002 and then http://127.0.0.1:3003
• robloxExplorer.hidePropsFiles: Hide sync artifact files in default explorer
• robloxExplorer.autoRefresh: Auto-refresh tree on sync file changes
• robloxExplorer.showSyncStatus: Show sync status decorations

Commands

• Weepy Roblox Explorer: Refresh
• Weepy Roblox Explorer: Open Settings
• Weepy Roblox Explorer: Search Instances
• Weepy Roblox Explorer: Open Backing File
• Weepy Roblox Explorer: Copy Instance Path
• Weepy Roblox Explorer: Reveal in Explorer

Development

cd roblox-explorer
npm install
npm run smoke:real-data
npm run typecheck
npm test
npm run build

Launch with the repository root .vscode/launch.json config for the explorer extension.

Publish

VSCE_PAT=xxxx ./deploy/scripts/publish-roblox-explorer.sh

Detailed guide: DEPLOYMENT.md