@weppy/roblox-mcp 2.0.5 → 2.0.7

package/docs/pt-br/installation/roblox-explorer.md

@@ -0,0 +1,58 @@
+# Weppy Roblox Explorer (Extensão VSCode)
+
+Visualização em árvore de instâncias similar ao Explorer do Roblox Studio, dentro do VSCode. Navegue por instâncias sincronizadas, abra scripts diretamente e acompanhe o status de sincronização sem sair do editor.
+Esta é uma extensao complementar do Weppy Roblox MCP, e não uma integração Roblox independente.
+
+![Weppy Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Requisitos
+
+- VSCode 1.85+
+- [Roblox MCP](../../../README.md) instalado com Sync habilitado (Basic ou Pro)
+- `roblox-project-sync/place_*/.sync-meta.json` já gerado pelo Sync
+
+## Instalação
+
+Pesquise **Weppy Roblox Explorer** na barra lateral de Extensões do VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) e clique em **Install**.
+
+Ou instale diretamente por um destes marketplaces:
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
+- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
+
+A navegação basica da arvore funciona a partir dos arquivos sincronizados em disco. Status sync ao vivo, indicadores de direction e envio de telemetria do Explorer ficam disponiveis quando o servidor MCP local está acessivel.
+
+## Funcionalidades
+
+- **Árvore de instâncias**: Hierarquia de serviços/instâncias idêntica ao Roblox Studio
+- **Ícones de classes Roblox**: Mais de 200 ícones com suporte a temas escuro/claro
+- **Multi-Place**: Raízes de árvore separadas por Place sincronizado
+- **Abrir ao clicar**: Abre arquivos de suporte (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
+- **Pesquisa de instâncias**: Pesquisa QuickPick em todos os serviços
+- **Badges de status Sync**: Visualize os estados `modified`, `studio`, `conflict` de relance
+- **Atualização automática**: A árvore é atualizada automaticamente quando os arquivos Sync mudam (debounce 500ms)
+- **Copiar caminho de instância**: Clique com o botão direito para copiar caminhos no formato `game.Workspace.Part`
+
+## Configurações
+
+| Configuração | Padrão | Descrição |
+|--------------|--------|-----------|
+| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `roblox-project-sync`. Detectado automaticamente se vazio. |
+| `robloxExplorer.hidePropsFiles` | `false` | Oculta arquivos de Sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrão do VSCode. |
+| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a árvore quando os arquivos Sync mudam. |
+| `robloxExplorer.showSyncStatus` | `true` | Exibe decorações de status Sync nos itens da árvore. |
+
+## Comandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `Weppy Roblox Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
+| `Weppy Roblox Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
+| `Weppy Roblox Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
+| `Weppy Roblox Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
+| `Weppy Roblox Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
+
+## Relacionado
+
+- [Guia detalhado de Sync](../sync/overview.md)
+- [Guia de instalação](README.md)

package/docs/pt-br/sync/overview.md

@@ -22,9 +22,10 @@ O caminho local padrao e `roblox-project-sync/place_{placeId}/explorer`.
 
 ### Explorar dados sincronizados no VSCode
 
-Instale a extensao [Weepy Roblox Explorer](../installation/roblox-explorer.md) para explorar a arvore de instancias sincronizada no VSCode, assim como no Roblox Studio.
+Instale a extensao [Weppy Roblox Explorer](../installation/roblox-explorer.md) para explorar a arvore de instancias sincronizada no VSCode, assim como no Roblox Studio.
+O Explorer le os arquivos de sync gerados aqui e tambem pode mostrar status sync ao vivo e informacoes de direction quando o servidor MCP local estiver em execucao.
 
-![Weepy Roblox Explorer — explorar a arvore de instancias sincronizada no VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![Weppy Roblox Explorer — explorar a arvore de instancias sincronizada no VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 - Arvore de servicos/instancias com icones de classes Roblox
 - Clique em um script para abri-lo e editar

package/llms-full.txt

@@ -201,10 +201,7 @@ In the agent pane, click ⋯ → MCP Servers → Manage MCP Servers → View raw
 
 Browse synced instance trees inside VSCode with Roblox class icons.
 
-1. Download the latest `weppy-roblox-explorer-v*.zip` from [Releases](https://github.com/hope1026/weppy-roblox-mcp/releases)
-2. Extract the ZIP package to get `weppy-roblox-explorer-*.vsix`
-3. Open VSCode → Extensions sidebar → ⋯ → Install from VSIX...
-4. Select the extracted `.vsix` file
+Search for **Weppy Roblox Explorer** in the VSCode Extensions sidebar and click Install, or install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer) or [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer).
 
 Features:
 - Instance tree with Roblox class icons (dark/light theme)

package/llms.txt

@@ -66,5 +66,7 @@ Or manually:
 
 - GitHub: https://github.com/hope1026/weppy-roblox-mcp
 - npm: https://www.npmjs.com/package/@weppy/roblox-mcp
+- Roblox Explorer (VS Code Marketplace): https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer
+- Roblox Explorer (Open VSX): https://open-vsx.org/extension/weppy/weppy-roblox-explorer
 - Issues: https://github.com/hope1026/weppy-roblox-mcp/issues
 - Discussions: https://github.com/hope1026/weppy-roblox-mcp/discussions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "author": {
     "name": "hope1026"
   },