@weppy/roblox-mcp 0.1.11 → 1.0.0

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

@@ -1,21 +1,26 @@
 # Instalacao do Plugin Roblox
 
-Como instalar o plugin para conectar com agentes de IA no Roblox Studio.
+Como instalar o plugin para conectar agentes de IA no Roblox Studio.
 
 ## 1. Baixar o Plugin
 
-1. Baixe `weppy-roblox-mcp-basic-v{versão}.zip` em [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Extraia o arquivo ZIP — voce encontrara o arquivo `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
+1. Abra [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Baixe `weppy-roblox-mcp-v{version}.zip`
+3. Extraia o ZIP - voce encontrara `roblox-plugin/WeppyRobloxMCP.rbxm` e guias de instalacao
+
+Nota:
+- Basic usa o mesmo pacote com politica Basic (Studio -> Local, unidirecional)
+- Com licenca Pro por assinatura, sync bidirecional e recursos avancados mais amplos sao liberados
 
 ## 2. Instalar o Plugin
 
 1. Inicie o **Roblox Studio**
-2. Clique na aba **Plugins** no menu superior
-3. Clique no botao **Plugins Folder**
+2. Clique na aba **Plugins**
+3. Clique em **Plugins Folder**
 
 ![Abrir Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Copie** o arquivo `WeppyRobloxMCP.rbxm` da pasta extraida para a pasta de Plugins aberta
+4. **Copie** `WeppyRobloxMCP.rbxm` para a pasta de Plugins
 5. **Reinicie o Roblox Studio**
 
 ## 3. Verificar a Instalacao
@@ -28,7 +33,7 @@ Apos reiniciar, o botao **W-MCP** aparecera na aba Plugins.
 
 ### Pre-requisitos
 
-O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao seu aplicativo de IA:
+O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
 
 | Aplicativo de IA | Guia de Instalacao |
 |------------------|---------------------|
@@ -42,38 +47,38 @@ O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao
 ### Conectar
 
 1. Abra qualquer projeto no **Roblox Studio**
-2. Aba **Plugins** no topo → Clique em **W-MCP**
-3. Clique no botao **Connect** na janela do plugin
-4. Quando aparecer o status **"Connected"**, a conexao foi estabelecida!
+2. Aba **Plugins** -> **W-MCP**
+3. Clique em **Connect**
+4. Quando aparecer **"Connected"**, esta pronto
 
 ![Tela Principal do Plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Configuracoes (Opcional)
 
-Clique no botao de configuracoes no canto superior direito do plugin para modificar varias opcoes.
+Use o botao de configuracoes no canto superior direito.
 
 ![Tela de Configuracoes](../../assets/screenshots/settings.png)
 
-- **Conexao Automatica**: Conecta automaticamente ao servidor MCP ao iniciar o Studio
-- **Reconexao Automatica**: Tenta reconectar automaticamente quando a conexao e perdida
-- **Foco Automatico da Camera**: Move automaticamente a camera para objetos criados
-- **Idioma**: Alterar o idioma da interface do plugin
+- **Conexao Automatica**
+- **Reconexao Automatica**
+- **Foco Automatico da Camera**
+- **Idioma**
 
 ## Solucao de Problemas
 
 ### O plugin nao aparece
 
-- Feche completamente o Roblox Studio e reinicie
-- Verifique se o arquivo foi copiado corretamente para a Plugins Folder
-- Verifique se o arquivo `.rbxm` nao esta corrompido
+- Reinicie o Roblox Studio por completo
+- Verifique se o arquivo foi copiado corretamente
+- Verifique se `.rbxm` nao esta corrompido
 
 ### Nao consigo conectar
 
-- Verifique se o servidor MCP esta em execucao no aplicativo de IA
-- Clique novamente no botao **Connect** no plugin
-- Verifique se a porta 3002 nao esta sendo usada por outro programa
+- Verifique se o servidor MCP esta em execucao
+- Clique em **Connect** novamente
+- Verifique conflito na porta 3002
 
 ### A conexao cai frequentemente
 
-- Ative a opcao **Reconexao Automatica** nas configuracoes
-- Tente reiniciar o aplicativo de IA
+- Ative **Reconexao Automatica**
+- Reinicie o app de IA

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

@@ -2,50 +2,56 @@
 
 ## Por que Pro?
 
-**Economia de Tokens de IA** - Um unico comando de operacao em massa substitui dezenas de operacoes individuais. Menos tarefas repetitivas significam menor consumo de tokens e resultados mais rapidos.
+### Sync bidirecional para fluxos de desenvolvimento reais
 
-**Jogos de Alta Qualidade** - Com ferramentas de terreno, ambiente, ativos e espaciais, voce pode criar mundos de jogo completos, nao apenas prototipos.
+O Sync do Pro vai além do simples export. Edite scripts localmente e envie para o Studio. Faça mudanças no Studio e traga de volta para o disco. Pro mantém os dois lados sincronizados.
 
-## Ferramentas Adicionadas pelo Pro
+- **Sync bidirecional** — Mudanças fluem em ambas as direções entre Studio e arquivos locais.
+- **Direction por tipo** — Configure a direção independentemente para Scripts, Values, Containers, Data e Services.
+- **Apply Mode por tipo** — Escolha Auto ou Manual por tipo para equilibrar velocidade e controle.
+- **Full Sync / Resync** — Reconstrua o estado limpo do projeto após grandes mudanças ou reconexões.
+- **Histórico de mudanças** — Rastreie o que mudou, quando e em qual direção antes de aplicar.
+- **Sync multi-place** — Sincronize até 3 Roblox Places simultaneamente, cada um com armazenamento isolado e histórico próprio.
 
-| Categoria | Funcionalidade |
-|-----------|----------------|
-| **Operacoes em Massa** | Crie 100 arvores com um unico comando. Modifique todas as partes simultaneamente. |
-| **Geracao de Terreno** | Gere montanhas, cavernas e paisagens de forma procedural. |
-| **Gerenciamento de Ativos** | Pesquise na Creator Store e insira modelos diretamente. |
-| **Raycast** | Encontre posicoes de spawn, detecte colisoes, analise areas acessiveis. |
-| **Controle de Ambiente** | Configure iluminacao, atmosfera, ceu e hora do dia. |
-| **Visualizacao** | Exiba areas, crie marcadores, destaque zonas. |
+### Economize tokens de IA com workflows de alto impacto
 
-## Como Comprar
+Ações em massa e avançadas reduzem chamadas repetitivas — faça mais por prompt.
 
-### Passo 1: Compre no Gumroad
+### Capacidades avançadas mais amplas
 
-1. Acesse [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Baixe o plugin
+Geração de terrain, busca de assets, análise espacial, animação, áudio e automação em escala de produção.
 
-### Passo 2: Instale o Plugin
+## Assinatura e download
 
-1. Inicie o Roblox Studio
-2. Aba Plugins → Clique em **Plugins Folder**
-3. **Exclua** o `WeppyRobloxMCP.rbxm` existente (versao Basic)
-4. **Copie** o `WeppyRobloxMCP-Pro.rbxm` baixado para a pasta
-5. Reinicie o Roblox Studio
+### Passo 1: Assinar no Gumroad
 
-### Passo 3: Verificacao
+1. Acesse [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Conclua a compra da licenca Pro por assinatura
 
-1. Abra o plugin W-MCP
-2. Verifique se o emblema "Pro" e exibido
-3. Todas as ferramentas disponiveis!
+### Passo 2: Baixar no GitHub Releases
 
-## Comparacao de Recursos
+1. Abra [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Baixe `weppy-roblox-mcp-v{version}.zip`
+3. Extraia e copie `roblox-plugin/WeppyRobloxMCP.rbxm` para a pasta de Plugins do Roblox
+
+### Passo 3: Verificar
+
+1. Abra o W-MCP no Roblox Studio
+2. Confirme que o selo Pro aparece
+3. Execute uma acao Pro (por exemplo: `manage_sync` ou operacoes em massa)
+
+## Comparação de Recursos
 
 | Recurso | Basic | Pro |
 |---------|:-----:|:---:|
-| Instance, Script, Property | ✅ Acesso Total | ✅ Acesso Total |
-| Selection, Tag, Camera, Log | ✅ Acesso Total | ✅ Acesso Total |
-| Operacoes em Massa (Bulk) | ― | ✅ Ilimitado |
-| Pesquisa e Insercao de Ativos | ― | ✅ Ilimitado |
-| Geracao de Terreno (Terrain) | ― | ✅ Ilimitado |
-| Ambiente, Raycast, Espacial | ― | ✅ Ilimitado |
-| Ferramentas de Visualizacao | ― | ✅ Ilimitado |
+| 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 |
+| Full Sync | ❌ | ✅ |
+| Resync / Reconstruir estado | ❌ | ✅ |
+| Histórico de mudanças | ❌ | ✅ |
+| Sync multi-place | ❌ | ✅ Até 3 places com armazenamento isolado |
+| 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 |

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

@@ -2,6 +2,10 @@
 
 Conecte a IA ao Roblox Studio e automatize diversas tarefas. Veja o que voce pode fazer por categoria.
 
+Politica de Sync:
+- Basic: Studio -> Local (unidirecional)
+- Pro: Sync bidirecional + funcionalidades avancadas mais amplas (melhor eficiencia de tokens IA com operacoes em massa)
+
 ---
 
 ## Basic (Gratuito)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "0.1.11",
+  "version": "1.0.0",
   "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",
@@ -30,7 +30,9 @@
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "express": "^4.18.2"
+    "chokidar": "^5.0.0",
+    "express": "^4.18.2",
+    "lru-cache": "^10.4.3"
   },
   "engines": {
     "node": ">=18.0.0"

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

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