@weppy/roblox-mcp 2.4.1 → 2.5.1

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

@@ -0,0 +1,104 @@
+# Guia detalhado do WEPPY Roblox Explorer
+
+O **WEPPY Roblox Explorer** e uma extensao complementar para VSCode / Antigravity que replica a arvore do Explorer do Roblox Studio dentro do seu editor. Navegue por instancias sincronizadas, abra scripts e edite propriedades sem precisar alternar entre o Studio e o editor.
+
+> **Opcional** — o Explorer nao e obrigatorio. O servidor MCP e o plugin do Roblox Studio sao suficientes para usar todos os recursos principais. Instale o Explorer quando quiser navegar pela estrutura do projeto ou inspecionar e editar propriedades diretamente do editor.
+
+![WEPPY Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+
+## Por que usar o Explorer
+
+Agentes de IA ja conseguem entender o contexto completo do projeto a partir dos arquivos gerados pelo Sync, mas quando um humano navega pelo mirror os caminhos de arquivo sozinhos nem sempre deixam a hierarquia clara. O Explorer reutiliza os mesmos dados de sync e os apresenta com a **mesma arvore que voce ve no Roblox Studio**, o que facilita muito:
+
+- Ver de relance a qual servico / instancia um script pertence
+- Localizar rapidamente instancias entre servicos por nome ou caminho
+- Verificar o status de sync por arquivo (modified / studio / conflict)
+- Editar propriedades sem abrir o Studio
+
+## Requisitos
+
+- VSCode 1.85+ ou Antigravity
+- [Roblox MCP](../installation/README.md) instalado com Sync habilitado (Basic ou Pro)
+- Um arquivo `weppy-project-sync/place_*/.sync-meta.json` gerado pelo Sync na raiz do projeto
+
+O Explorer funciona apenas com os arquivos de sync em disco. Quando o servidor MCP local esta em execucao, o estado de sync ao vivo e as informacoes de direction tambem sao refletidos.
+
+## Instalacao
+
+Procure por **WEPPY Roblox Explorer** na barra lateral de Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`) do VSCode ou Antigravity e clique em **Install**.
+
+Links diretos dos 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)
+
+## Navegando pela arvore de instancias
+
+Apos a instalacao, uma visao **WEPPY Explorer** aparece na Activity Bar do VSCode e descobre automaticamente o diretorio de sync a partir da raiz do projeto.
+
+- **Raizes de servicos**: Servicos sincronizados como `Workspace`, `ReplicatedStorage` e `ServerScriptService` aparecem no nivel superior.
+- **Icones de classes Roblox**: Mais de 200 icones no estilo do Studio que alternam automaticamente entre tema escuro e claro.
+- **Multi Place**: Cada Place sincronizado e mostrado com sua propria raiz de arvore quando ha varios places.
+- **Atualizacao automatica**: A arvore e atualizada com um debounce de 500ms sempre que arquivos de sync mudam.
+- **Badges de status de sync**: Os estados `modified`, `studio` e `conflict` aparecem ao lado dos icones para voce notar mudancas e conflitos na hora.
+
+Clicar em um item da arvore abre o arquivo que respalda a instancia (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`, ...). O menu de contexto permite copiar o caminho da instancia no formato `game.Workspace.Part` ou revelar o arquivo no explorador padrao do VSCode.
+
+## Painel de propriedades
+
+Selecione uma instancia na arvore do Explorer e execute **Open Properties** para abrir um painel parecido com a janela Properties do Studio. Voce pode inspecionar e editar propriedades agrupadas sem mexer diretamente no arquivo `.props.json`.
+
+![Painel de propriedades — edite propriedades no estilo Studio dentro do VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
+
+- **Exibicao agrupada**: As propriedades sao organizadas nos mesmos grupos do Studio (Appearance, Behavior, Data, Part, Transform etc.).
+- **Editores por tipo**: Os widgets de entrada combinam com o tipo da propriedade — numeros, strings, booleanos, cores, Vector3, enums e muito mais.
+- **Edicao baseada em arquivo**: As mudancas sao escritas no arquivo `*.props.json` da instancia e retornam ao Studio pelo caminho reverso do Sync (Pro, quando bidirectional esta ativado).
+- **Editor personalizado**: Abrir um arquivo `.props.json` diretamente carrega o Painel de propriedades em vez do editor de texto padrao.
+
+Se voce quiser que o Painel de propriedades abra automaticamente enquanto navega pela arvore, defina `robloxExplorer.propertyPanel.autoOpen` como `true` nas configuracoes.
+
+## Busca de instancias
+
+Execute o comando `WEPPY Explorer: Search Instances` (pelo icone do titulo da visao ou pela Command Palette) para abrir um QuickPick que busca em todos os servicos sincronizados.
+
+- Correspondencia parcial sobre os nomes de instancia
+- Selecionar um resultado foca a arvore no item correspondente
+- Quando varios places estao sincronizados, os resultados sao delimitados por place
+
+## Configuracoes
+
+| Configuracao | Padrao | Descricao |
+|--------------|--------|-----------|
+| `robloxExplorer.mcpBaseUrl` | `""` | URL HTTP base do MCP local. Vazio faz o Explorer tentar `http://127.0.0.1:3002` e depois `http://127.0.0.1:3003`. |
+| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz `weppy-project-sync`. Descoberto automaticamente pelas pastas do workspace quando vazio. |
+| `robloxExplorer.hidePropsFiles` | `false` | Oculta os arquivos de sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrao do VSCode. |
+| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a arvore quando arquivos de sync mudam. |
+| `robloxExplorer.showSyncStatus` | `true` | Mostra decoracoes de status de sync nos itens da arvore. |
+| `robloxExplorer.followFocusCue` | `false` | Segue arquivos externos de focus cue para expandir a arvore e abrir arquivos relacionados. |
+| `robloxExplorer.propertyPanel.autoOpen` | `false` | Abre o Painel de propriedades automaticamente ao selecionar uma instancia na arvore. |
+
+## Comandos
+
+| Comando | Descricao |
+|---------|-----------|
+| `WEPPY Explorer: Refresh` | Atualiza manualmente a arvore de instancias |
+| `WEPPY Explorer: Search Instances` | Busca instancias em todos os servicos |
+| `WEPPY Explorer: Open Backing File` | Abre o arquivo da instancia selecionada |
+| `WEPPY Explorer: Open Properties` | Abre o Painel de propriedades da instancia selecionada |
+| `WEPPY Explorer: Copy Instance Path` | Copia o caminho completo da instancia (ex.: `game.Workspace.Part`) |
+| `WEPPY Explorer: Reveal in Explorer` | Mostra o arquivo no explorador padrao do VSCode |
+| `WEPPY Explorer: Collapse All` | Recolhe todos os nos da arvore |
+| `WEPPY Explorer: Open Settings` | Abre a pagina de configuracoes do Explorer |
+
+## Solucao de problemas
+
+- **Arvore vazia**: Verifique se o diretorio `weppy-project-sync/place_*` existe e se o Sync completou pelo menos um Full Sync. Defina `robloxExplorer.syncRoot` manualmente se necessario.
+- **Status de sync nao aparece**: Confirme que o servidor MCP local esta em execucao e tente definir `robloxExplorer.mcpBaseUrl` de forma explicita.
+- **Painel de propriedades nao abre**: Se um arquivo `.props.json` abrir no editor de texto padrao, clique com o direito sobre ele e escolha **Reopen Editor With... → WEPPY Property Panel**.
+- **Icones quebrados**: Selecione novamente o tema do VSCode ou reinicie a janela para atualizar o cache de icones.
+
+## Documentos relacionados
+
+- [Guia de instalacao do Roblox MCP](../installation/README.md)
+- [Guia de Sync](../sync/overview.md)
+- [Visao geral das ferramentas](../tools/overview.md)

package/docs/pt-br/installation/README.md

@@ -68,12 +68,12 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
 
 ---
 
-## Opcional: Instalar WROX Roblox Explorer (Extensão VSCode)
+## Opcional: Instalar WEPPY Roblox Explorer (Extensão VSCode)
 
 Navegue pelas árvores de instâncias sincronizadas dentro do VSCode com ícones de classes Roblox.
-Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `wrox-project-sync` dentro da raiz do projeto.
+Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `weppy-project-sync` dentro da raiz do projeto.
 
-👉 [Guia de instalação do WROX Roblox Explorer](https://weppyai.com/en/install#explorer)
+👉 [Guia de instalação do WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
 
 Instalação direta:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
@@ -83,7 +83,7 @@ Instalação direta:
 
 ## Depois da instalação
 
-1. Abra o **Roblox Studio** e na aba Plugins clique em **WROX** → **Connect**
+1. Abra o **Roblox Studio** e na aba Plugins clique em **WEPPY** → **Connect**
 2. No **app de IA** teste assim:
 
 ```

package/docs/pt-br/installation/ai-apps/antigravity.md

@@ -61,7 +61,7 @@ Recomendamos manter o padrão (HTTP `127.0.0.1:3002`). Se necessário, você pod
 
 ## Teste de conexão
 
-1. Abra o **Roblox Studio** → aba Plugins → **WROX** → **Connect**
+1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
 2. No **Antigravity**, digite:
    ```
    Diga-me o que está selecionado atualmente no Roblox Studio

package/docs/pt-br/installation/ai-apps/claude-app.md

@@ -46,7 +46,7 @@ Como usar o Roblox MCP no [Claude Desktop App](https://claude.ai/download).
 
 ## Teste de Conexao
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **WROX** → **Connect**
+1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
 2. Inicie uma nova conversa no **Claude Desktop** e teste:
    ```
    Crie uma parte azul no Roblox Studio

package/docs/pt-br/installation/ai-apps/claude-code.md

@@ -64,7 +64,7 @@ O Claude Code gerencia o servidor MCP automaticamente:
 
 ## Teste de Conexao
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **WROX** → **Connect**
+1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
 2. Teste no **Claude Code**:
    ```
    Crie uma parte azul no Roblox Studio

package/docs/pt-br/installation/ai-apps/codex-app.md

@@ -30,7 +30,7 @@ Command: npx -y @weppy/roblox-mcp
 
 ## Teste de Conexao
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **WROX** → **Connect**
+1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
 2. Inicie uma nova conversa no **Codex App** e teste:
    ```
    Diga-me o que esta selecionado atualmente no Roblox Studio

package/docs/pt-br/installation/ai-apps/codex-cli.md

@@ -40,7 +40,7 @@ args = ["-y", "@weppy/roblox-mcp"]
 
 ## Teste de Conexao
 
-1. Inicie o **Roblox Studio** → Aba Plugins → **WROX** → **Connect**
+1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
 2. Inicie o **Codex CLI** e digite:
    ```
    Diga-me o que esta selecionado atualmente no Roblox Studio

package/docs/pt-br/installation/ai-apps/cursor.md

@@ -45,7 +45,7 @@ Depois de editar a configuração, recarregue a janela do Cursor ou reinicie o a
 
 ## Teste de conexão
 
-1. Abra o **Roblox Studio** → aba Plugins → **WROX** → **Connect**
+1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
 2. No **Cursor**, digite:
    ```
    Tell me what's currently selected in Roblox Studio

package/docs/pt-br/installation/ai-apps/gemini-cli.md

@@ -81,7 +81,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblo
 
 ## Teste de conexão
 
-1. Abra o **Roblox Studio** → aba Plugins → **WROX** → **Connect**
+1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
 2. Execute o **Gemini CLI** e digite:
    ```
    Me diga o que está selecionado atualmente no Roblox Studio

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

@@ -1,19 +1,19 @@
-# WROX Roblox Explorer (Extensão VSCode)
+# 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 WROX, e não uma integração Roblox independente.
+Esta é uma extensao complementar do WEPPY, e não uma integração Roblox independente.
 
-![WROX Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![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)
-- O Sync ja gerou `wrox-project-sync/place_*/.sync-meta.json` na raiz do projeto
+- O Sync ja gerou `weppy-project-sync/place_*/.sync-meta.json` na raiz do projeto
 
 ## Instalação
 
-Pesquise **WROX Roblox Explorer** na barra lateral de Extensões do VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) e clique em **Install**.
+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:
 
@@ -37,7 +37,7 @@ A navegação basica da arvore funciona a partir dos arquivos sincronizados em d
 
 | Configuração | Padrão | Descrição |
 |--------------|--------|-----------|
-| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `wrox-project-sync`. Se estiver vazio, e detectado automaticamente. O WROX usa `{projectRoot}/wrox-project-sync`. |
+| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `weppy-project-sync`. Se estiver vazio, e detectado automaticamente. O WEPPY usa `{projectRoot}/weppy-project-sync`. |
 | `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. |
@@ -46,11 +46,11 @@ A navegação basica da arvore funciona a partir dos arquivos sincronizados em d
 
 | Comando | Descrição |
 |---------|-----------|
-| `WROX Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
-| `WROX Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
-| `WROX Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
-| `WROX Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
-| `WROX Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
+| `WEPPY Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
+| `WEPPY Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
+| `WEPPY Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
+| `WEPPY Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
+| `WEPPY Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
 
 ## Relacionado
 

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

@@ -25,9 +25,9 @@ Nota:
 
 ## 3. Verificar a Instalacao
 
-Apos reiniciar, o botao **WROX** aparecera na aba Plugins.
+Apos reiniciar, o botao **WEPPY** aparecera na aba Plugins.
 
-![Botao WROX](../../assets/screenshots/plugin/installation/toolbar-button.png)
+![Botao WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
 
 ## 4. Conectar ao Agente de IA
 
@@ -48,7 +48,7 @@ O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
 ### Conectar
 
 1. Abra qualquer projeto no **Roblox Studio**
-2. Aba **Plugins** -> **WROX**
+2. Aba **Plugins** -> **WEPPY**
 3. Clique em **Connect**
 4. Quando aparecer **"Connected"**, esta pronto
 

package/docs/pt-br/pro-upgrade.md

@@ -48,7 +48,7 @@ Você só precisa ativar a licença uma vez, no plugin ou no dashboard. As duas
 
 ### Ativar no plugin
 
-1. Abra o **WROX** no Roblox Studio e conecte ao servidor MCP.
+1. Abra o **WEPPY** no Roblox Studio e conecte ao servidor MCP.
 2. Abra a seção **Settings > License** no plugin.
 3. Cole a chave comprada no campo `License key`.
 4. Clique em **Activate** para ativar a licença.

package/docs/pt-br/sync/luau-lsp.md

@@ -1,19 +1,19 @@
-# Usar `luau-lsp` com WROX Sync
+# Usar `luau-lsp` com WEPPY Sync
 
-O WROX Sync pode gerar automaticamente os arquivos sourcemap que o `luau-lsp` precisa, para que voce habilite recursos de editor com contexto de Roblox sem montar um projeto Rojo separado.
+O WEPPY Sync pode gerar automaticamente os arquivos sourcemap que o `luau-lsp` precisa, para que voce habilite recursos de editor com contexto de Roblox sem montar um projeto Rojo separado.
 
-## O que o WROX grava
+## O que o WEPPY grava
 
-Depois que o Full Sync termina, o WROX grava:
+Depois que o Full Sync termina, o WEPPY grava:
 
-- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
-- Arquivo representativo da raiz: `wrox-project-sync/sourcemap.json`
+- Place sourcemap: `weppy-project-sync/place_<id>/sourcemap.json`
+- Arquivo representativo da raiz: `weppy-project-sync/sourcemap.json`
 
-Para a maioria dos usuarios, o caminho recomendado e `wrox-project-sync/sourcemap.json`.
+Para a maioria dos usuarios, o caminho recomendado e `weppy-project-sync/sourcemap.json`.
 
 ## O que melhora
 
-Quando o `luau-lsp` usa o sourcemap do WROX, melhora:
+Quando o `luau-lsp` usa o sourcemap do WEPPY, melhora:
 
 - Autocomplete de `game.*`
 - Navegacao entre scripts sincronizados
@@ -21,8 +21,8 @@ Quando o `luau-lsp` usa o sourcemap do WROX, melhora:
 
 ## Configuracao recomendada
 
-1. Execute o Full Sync uma vez para que o WROX crie `wrox-project-sync/sourcemap.json`.
-2. Aponte a configuracao de sourcemap do `luau-lsp` no seu editor para `wrox-project-sync/sourcemap.json`.
+1. Execute o Full Sync uma vez para que o WEPPY crie `weppy-project-sync/sourcemap.json`.
+2. Aponte a configuracao de sourcemap do `luau-lsp` no seu editor para `weppy-project-sync/sourcemap.json`.
 3. Se o seu cliente puder desativar a geracao automatica com Rojo, defina `luau-lsp.sourcemap.autogenerate` como `false`.
 
 Exemplo de configuracao no VSCode:
@@ -31,11 +31,11 @@ Exemplo de configuracao no VSCode:
 {
   "luau-lsp.sourcemap.enabled": true,
   "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "wrox-project-sync/sourcemap.json"
+  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
 }
 ```
 
 ## Observacao sobre Multi-place
 
-`wrox-project-sync/sourcemap.json` acompanha o place representativo atual do projeto.
-Se voce precisar fixar um place especifico, aponte o `luau-lsp` diretamente para `wrox-project-sync/place_<id>/sourcemap.json`.
+`weppy-project-sync/sourcemap.json` acompanha o place representativo atual do projeto.
+Se voce precisar fixar um place especifico, aponte o `luau-lsp` diretamente para `weppy-project-sync/place_<id>/sourcemap.json`.

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

@@ -18,16 +18,16 @@ Sem Sync, a IA so enxerga trechos colados no chat. Com Sync ativo, ela trabalha
 2. Incremental Sync: atualizacao continua das mudancas novas
 3. Rastreamento de History/Status: ver o que mudou, quando e em qual direcao
 
-Os dados de Sync ficam em `{projectRoot}/wrox-project-sync/place_{placeId}/explorer`.
-Alem disso, o WROX grava um sourcemap por place em `{projectRoot}/wrox-project-sync/place_{placeId}/sourcemap.json` e mantem o arquivo representativo recomendado na raiz em `{projectRoot}/wrox-project-sync/sourcemap.json`.
-Para integracoes de editor como `luau-lsp`, o caminho da raiz e o recomendado. Os passos de configuracao estao em [Usar `luau-lsp` com WROX Sync](./luau-lsp.md).
+Os dados de Sync ficam em `{projectRoot}/weppy-project-sync/place_{placeId}/explorer`.
+Alem disso, o WEPPY grava um sourcemap por place em `{projectRoot}/weppy-project-sync/place_{placeId}/sourcemap.json` e mantem o arquivo representativo recomendado na raiz em `{projectRoot}/weppy-project-sync/sourcemap.json`.
+Para integracoes de editor como `luau-lsp`, o caminho da raiz e o recomendado. Os passos de configuracao estao em [Usar `luau-lsp` com WEPPY Sync](./luau-lsp.md).
 
 ### Explorar dados sincronizados no VSCode
 
-Instale a extensao [WROX 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](../explorer/overview.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.
 
-![WROX 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
@@ -40,7 +40,7 @@ O Explorer le os arquivos de sync gerados aqui e tambem pode mostrar status sync
 | Direcao de sync | Studio -> Local | Bidirecional |
 | Direction por tipo | Nao suportado | Suportado (Scripts / Values / Containers / Data / Services) |
 | Apply Mode por tipo | Nao suportado | Suportado (Auto / Manual) |
-| APIs de status/historico | Nao suportado | Suportado (`status`, `history`, `progress`) |
+| APIs de status/historico | Nao suportado | Suportado (`status_current_place`, `history`, `progress`) |
 | Ferramenta `manage_sync` | Nao suportado | Suportado |
 | Sync multiplace | Nao suportado | Suportado (ate 3 places) |
 
@@ -87,7 +87,7 @@ No Pro, voce controla Direction e Apply Mode por tipo.
 
 | Acao | Descricao | Parametros principais |
 |------|------|-----------|
-| `status` | Consultar estado atual de sync de um place | `placeId` |
+| `status_current_place` | Consultar o estado atual de sync do Place conectado | `-` |
 | `history` | Consultar historico de mudancas | `placeId`, `query.limit`, `query.offset` |
 | `directions` | Obter direcoes por tipo | `placeId` |
 | `read_file` | Ler arquivo sincronizado | `placeId`, `instancePath` |
@@ -148,6 +148,6 @@ Nomes que contem `~` sao escapados como `~~` (ex: `Part~2` → `Part~~2/`). Regr
 
 ## Documentos relacionados
 
-- [Usar `luau-lsp` com WROX Sync](./luau-lsp.md)
+- [Usar `luau-lsp` com WEPPY Sync](./luau-lsp.md)
 - [Cobertura de ferramentas (Tools Overview)](../tools/overview.md)
 - [Guia de upgrade Pro](https://weppyai.com/en/plans)

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

@@ -227,7 +227,7 @@ Politica de Sync:
 
 | Acao | Descricao | Tier |
 |------|-----------|------|
-| `status` | Obter status de sincronizacao de um Place | Pro |
+| `status_current_place` | Obter o status de sincronizacao do Place conectado no momento | Pro |
 | `history` | Obter historico de mudancas | Pro |
 | `directions` | Obter direcoes de sincronizacao por tipo | Pro |
 | `read_file` | Ler um arquivo sincronizado | Pro |

package/docs/pt-br/tools/playtest.md

@@ -86,10 +86,10 @@ Edit --play--> Running --stop--> Edit
 
 ### 5. Escrita de relatorios
 
-Os relatorios e logs sao gravados em `{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
+Os relatorios e logs sao gravados em `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
 
 ```text
-{projectRoot}/wrox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
 ├── test-report.md
 └── test-log.txt
 ```

package/docs/troubleshooting.md

@@ -5,7 +5,7 @@
 **Symptom:** "Connection failed" or plugin shows disconnected in Roblox Studio.
 
 1. Make sure the MCP server is running: `npx -y @weppy/roblox-mcp`
-2. In Roblox Studio: Plugins tab → WROX → Connect
+2. In Roblox Studio: Plugins tab → WEPPY → Connect
 3. Confirm nothing is blocking `localhost:3002` (firewall, antivirus, VPN)
 4. Try restarting both Roblox Studio and the MCP server
 

package/install.ps1

@@ -1,5 +1,5 @@
 #
-# WROX — One-line install script (Windows PowerShell)
+# WEPPY — One-line install script (Windows PowerShell)
 #
 # Usage:
 #   irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
@@ -10,7 +10,7 @@
 #
 
 $ErrorActionPreference = "Stop"
-$script:InstallLogPath = Join-Path ([System.IO.Path]::GetTempPath()) ("wrox-install-{0:yyyyMMdd-HHmmss}.log" -f (Get-Date))
+$script:InstallLogPath = Join-Path ([System.IO.Path]::GetTempPath()) ("weppy-install-{0:yyyyMMdd-HHmmss}.log" -f (Get-Date))
 $script:TranscriptStarted = $false
 $script:NpmCommandPath = $null
 
@@ -118,7 +118,7 @@ function Add-AntigravityMcpConfig($configPath) {
     if (-not (Test-Path $parentDir)) { New-Item -ItemType Directory -Path $parentDir -Force | Out-Null }
     $env:MCP_CONFIG_PATH = $configPath
     try {
-        node -e @"
+        node --input-type=commonjs -e @"
 const fs = require('fs');
 const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
@@ -168,7 +168,7 @@ function Test-CodexConfigConfigured($configPath) {
 
     $env:MCP_CODEX_CONFIG_PATH = $configPath
     try {
-        node -e @'
+        node --input-type=commonjs -e @'
 const fs = require('fs');
 
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
@@ -589,7 +589,7 @@ function Add-McpToConfig($configPath) {
     if (-not (Test-Path $parentDir)) { New-Item -ItemType Directory -Path $parentDir -Force | Out-Null }
     $env:MCP_CONFIG_PATH = $configPath
     try {
-        node -e @"
+        node --input-type=commonjs -e @"
 const fs = require('fs');
 const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
@@ -605,7 +605,7 @@ fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
 
 # ── Header ──
 Write-Host ""
-Write-Host "WROX Installer" -ForegroundColor White -BackgroundColor DarkCyan
+Write-Host "WEPPY Installer" -ForegroundColor White -BackgroundColor DarkCyan
 Write-Host "AI-powered Roblox Studio integration" -ForegroundColor DarkGray
 Write-Host ("=" * 40)
 
@@ -635,11 +635,22 @@ if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
         if (-not (Test-Path $npxPath)) {
             $npxPath = "npx"
         }
-        & $npxPath -y "@weppy/roblox-mcp" --setup
-        if ($LASTEXITCODE -ne 0) {
-            Write-Warn "Setup encountered a warning (non-blocking)"
-        } else {
-            Write-Ok "Setup complete"
+        $setupWorkingDir = Join-Path ([System.IO.Path]::GetTempPath()) ("weppy-setup-" + [System.Guid]::NewGuid().ToString("N"))
+        $previousLocation = Get-Location
+
+        try {
+            New-Item -ItemType Directory -Path $setupWorkingDir -Force | Out-Null
+            Set-Location $setupWorkingDir
+            & $npxPath -y @weppy/roblox-mcp --setup
+            if ($LASTEXITCODE -ne 0) {
+                Write-Warn "Setup encountered a warning (non-blocking)"
+            } else {
+                Write-Ok "Setup complete"
+            }
+        }
+        finally {
+            Set-Location $previousLocation
+            Remove-Item $setupWorkingDir -Recurse -Force -ErrorAction SilentlyContinue
         }
     }
     catch {
@@ -874,7 +885,7 @@ Write-Host "Installation complete!" -ForegroundColor Green
 Write-Host ""
 Write-Host "  Next steps:"
 Write-Host "  1. Restart Roblox Studio"
-Write-Host "  2. Look for the WROX button in the Plugins tab"
+Write-Host "  2. Look for the WEPPY button in the Plugins tab"
 Write-Host "  3. Click Connect and start building with AI!"
 Write-Host ""
 Write-Host "  Auto registration: Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity"

package/install.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# WROX — One-line install script (macOS/Linux)
+# WEPPY — One-line install script (macOS/Linux)
 #
 # Usage:
 #   curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
@@ -22,9 +22,9 @@ DIM='\033[2m'
 BOLD='\033[1m'
 NC='\033[0m'
 
-INSTALL_LOG_FILE="$(mktemp "${TMPDIR:-/tmp}/wrox-install-XXXXXX.log" 2>/dev/null || true)"
+INSTALL_LOG_FILE="$(mktemp "${TMPDIR:-/tmp}/weppy-install-XXXXXX.log" 2>/dev/null || true)"
 if [ -z "${INSTALL_LOG_FILE:-}" ]; then
-  INSTALL_LOG_FILE="${HOME}/wrox-install-error.log"
+  INSTALL_LOG_FILE="${HOME}/weppy-install-error.log"
   : > "$INSTALL_LOG_FILE"
 fi
 
@@ -92,7 +92,7 @@ add_mcp_to_config() {
   local parent_dir
   parent_dir=$(dirname "$config_path")
   mkdir -p "$parent_dir"
-  MCP_CONFIG_PATH="$config_path" node -e '
+  MCP_CONFIG_PATH="$config_path" node --input-type=commonjs -e '
 const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
@@ -108,7 +108,7 @@ is_json_mcp_configured() {
 
   [ -f "$config_path" ] || return 1
 
-  MCP_CONFIG_PATH="$config_path" node -e '
+  MCP_CONFIG_PATH="$config_path" node --input-type=commonjs -e '
 const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
 try {
@@ -126,7 +126,7 @@ add_antigravity_mcp_config() {
   local parent_dir
   parent_dir=$(dirname "$config_path")
   mkdir -p "$parent_dir"
-  MCP_CONFIG_PATH="$config_path" node -e '
+  MCP_CONFIG_PATH="$config_path" node --input-type=commonjs -e '
 const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
@@ -154,7 +154,7 @@ is_antigravity_mcp_configured() {
 
   [ -f "$config_path" ] || return 1
 
-  MCP_CONFIG_PATH="$config_path" node -e '
+  MCP_CONFIG_PATH="$config_path" node --input-type=commonjs -e '
 const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
 function isJsonObject(value) {
@@ -185,7 +185,7 @@ is_codex_config_configured() {
   local config_path="$1"
 
   [ -f "$config_path" ] || return 1
-  MCP_CODEX_CONFIG_PATH="$config_path" node <<'NODE' >/dev/null 2>&1
+  MCP_CODEX_CONFIG_PATH="$config_path" node --input-type=commonjs <<'NODE' >/dev/null 2>&1
 const fs = require("fs");
 
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
@@ -615,7 +615,7 @@ resolve_optional_cli_command() {
 
 # ── Header ──
 # shellcheck disable=SC2059
-printf "\n${BOLD}WROX Installer${NC}\n"
+printf "\n${BOLD}WEPPY Installer${NC}\n"
 # shellcheck disable=SC2059
 printf "${DIM}AI-powered Roblox Studio integration${NC}\n"
 printf "%s\n" "════════════════════════════════════"
@@ -641,10 +641,23 @@ success "Node.js $(node -v) detected"
 step "1/2" "Setup Roblox Studio Plugin"
 
 if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
-  if npx -y @weppy/roblox-mcp --setup; then
-    success "Setup complete"
+  setup_tmp_dir=""
+  if setup_tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/weppy-setup-XXXXXX" 2>/dev/null); then
+    :
+  elif setup_tmp_dir=$(mktemp -d 2>/dev/null); then
+    :
+  fi
+
+  if [ -n "${setup_tmp_dir:-}" ] && [ -d "$setup_tmp_dir" ]; then
+    if (cd "$setup_tmp_dir" && npx -y @weppy/roblox-mcp --setup); then
+      success "Setup complete"
+    else
+      warn "Setup encountered a warning (non-blocking)"
+    fi
+
+    rm -rf "$setup_tmp_dir"
   else
-    warn "Setup encountered a warning (non-blocking)"
+    warn "Setup encountered a warning (failed to create temp working directory)"
   fi
 else
   warn "Setup skipped"
@@ -872,7 +885,7 @@ printf "${BOLD}Installation complete!${NC}\n\n"
 printf "  ${BOLD}Next steps:${NC}\n"
 printf "  1. Restart Roblox Studio\n"
 # shellcheck disable=SC2059
-printf "  2. Look for the ${BOLD}WROX${NC} button in the Plugins tab\n"
+printf "  2. Look for the ${BOLD}WEPPY${NC} button in the Plugins tab\n"
 printf "  3. Click Connect and start building with AI!\n\n"
 printf "  Auto registration: Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity\n\n"
 # shellcheck disable=SC2059