@weppy/roblox-mcp 2.2.2 → 2.3.1

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

@@ -16,7 +16,7 @@ Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e
 
 ## Instalação em um comando (Recomendado)
 
-Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
+Instale tudo com um único comando:
 
 **macOS / Linux**
 
@@ -40,13 +40,13 @@ Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação
 
 ## Instalação manual
 
-Este é o método alternativo para quando a instalação em um comando não funcionar, ou quando a instalação automática não puder ser usada no seu ambiente.
+Se a instalacao em um comando nao funcionar, ou quando a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
 
 ### Passo 1: Instalar plugin do Roblox Studio
 
 Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
 
-👉 [Guia de instalação do plugin](roblox-plugin.md)
+👉 [Guia de instalação do plugin](https://weppy-web.pages.dev/en/install#plugin)
 
 ---
 
@@ -73,7 +73,7 @@ Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte
 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.
 
-👉 [Guia de instalação do WROX Roblox Explorer](roblox-explorer.md)
+👉 [Guia de instalação do WROX Roblox Explorer](https://weppy-web.pages.dev/en/install#explorer)
 
 Instalação direta:
 - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)

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

@@ -25,9 +25,16 @@ A IA pode controlar os playtests do Roblox Studio diretamente. Ela pode iniciar
 - "Escreve um teste que verifica se o SpawnLocation está acima do chão e executa."
 - "Valida que o script que acabei de mudar funciona sem erros no playtest."
 
-### Capacidades avançadas mais amplas
+### Mais recursos exclusivos do Pro
 
-Geração de terrain, busca de assets, análise espacial, animação, áudio e automação em escala de produção.
+O Pro desbloqueia recursos adicionais além do fluxo de trabalho principal.
+
+- **Operações em massa** — Criar, modificar ou excluir múltiplas instâncias em uma única solicitação
+- **Geração de terrain** — Preencher com bloco, esfera, cilindro, cunha e substituir materiais
+- **Busca/inserção de assets** — Pesquisar no marketplace do Roblox e inserir assets diretamente
+- **Análise espacial** — Raycast, encontrar chão, busca de área plana, detecção de colisão
+- **Controle de ambiente** — Iluminação, atmosfera, céu e hora do dia
+- **Áudio/Animação** — Reprodução de som e carregar/reproduzir animações
 
 ## Comprar e ativar
 
@@ -70,13 +77,20 @@ Você só precisa ativar a licença uma vez, no plugin ou no dashboard. As duas
 
 | Recurso | Basic | Pro |
 |---------|:-----:|:---:|
-| Gerenciamento de Script, Instance, Property | ✅ Acesso total | ✅ Acesso total |
-| Selection, Tag, Camera, Log | ✅ Acesso total | ✅ Acesso total |
-| Direção do Sync | Studio → Local (unidirecional) | Bidirecional |
-| Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
-| Apply Mode por tipo | ❌ | ✅ Auto / Manual |
-| Histórico de mudanças | ❌ | ✅ |
-| Sync multi-place | ❌ | ✅ Até 3 places com armazenamento isolado |
-| Controle de Playtest (Reproduzir/Parar/Pausar/Retomar) | ❌ | ✅ |
-| Cobertura avançada de tools | Conjunto base | Conjunto avançado mais amplo |
-| Eficiência de tokens IA | Padrão | Melhor com ações em massa / de alto impacto |
+| Criação/edição de scripts | ✅ | ✅ |
+| Criar/excluir/mover instâncias | ✅ | ✅ + operações em massa |
+| Ler/modificar propriedades | ✅ | ✅ + alterações em massa |
+| Seleção, tags, busca | ✅ | ✅ |
+| Controle de câmera | ✅ | ✅ |
+| Monitoramento de logs | ✅ | ✅ |
+| Execução de código Luau | ✅ | ✅ |
+| Sincronização de projeto | Studio → Local unidirecional | Bidirecional + direção/modo por tipo |
+| Sync multi-place | — | Até 3 Places simultaneamente |
+| Histórico de mudanças | — | Rastrear mudanças antes de aplicar |
+| Controle de playtest | — | Reproduzir / parar / pausar / retomar + testes automáticos |
+| Geração/edição de terrain | — | Bloco, esfera, cilindro, cunha, substituição de material |
+| Busca/inserção de assets | — | Pesquisar no marketplace do Roblox e inserir diretamente |
+| Análise espacial | — | Raycast, encontrar chão, detecção de colisão |
+| Controle de ambiente | — | Iluminação, atmosfera, céu, hora do dia |
+| Áudio / Animação | — | Reprodução de som, carregar/reproduzir animações |
+| Eficiência de tokens IA | Ações individuais | Menos chamadas com ações em massa |

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

@@ -0,0 +1,41 @@
+# Usar `luau-lsp` com WROX 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 que o WROX grava
+
+Depois que o Full Sync termina, o WROX grava:
+
+- Place sourcemap: `wrox-project-sync/place_<id>/sourcemap.json`
+- Arquivo representativo da raiz: `wrox-project-sync/sourcemap.json`
+
+Para a maioria dos usuarios, o caminho recomendado e `wrox-project-sync/sourcemap.json`.
+
+## O que melhora
+
+Quando o `luau-lsp` usa o sourcemap do WROX, melhora:
+
+- Autocomplete de `game.*`
+- Navegacao entre scripts sincronizados
+- Resolucao de `require` entre scripts sincronizados
+
+## 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`.
+3. Se o seu cliente puder desativar a geracao automatica com Rojo, defina `luau-lsp.sourcemap.autogenerate` como `false`.
+
+Exemplo de configuracao no VSCode:
+
+```json
+{
+  "luau-lsp.sourcemap.enabled": true,
+  "luau-lsp.sourcemap.autogenerate": false,
+  "luau-lsp.sourcemap.sourcemapFile": "wrox-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`.

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

@@ -19,6 +19,8 @@ Sem Sync, a IA so enxerga trechos colados no chat. Com Sync ativo, ela trabalha
 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).
 
 ### Explorar dados sincronizados no VSCode
 
@@ -146,5 +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)
 - [Cobertura de ferramentas (Tools Overview)](../tools/overview.md)
-- [Guia de upgrade Pro](../pro-upgrade.md)
+- [Guia de upgrade Pro](https://weppy-web.pages.dev/en/plans)

package/docs/troubleshooting.md

@@ -19,7 +19,7 @@
 ## "Pro feature required" error
 
 The action you're requesting requires the Pro tier.
-See [Pro Upgrade Guide](en/pro-upgrade.md) for details.
+See [Pro Upgrade Guide](https://weppy-web.pages.dev/en/plans) for details.
 
 ## Sync not working