@weppy/roblox-mcp 1.0.2 → 1.2.0

package/docs/pt-br/README.md

@@ -6,80 +6,53 @@
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
-## O que você pode fazer
+## Funcionalidades principais
 
-### De uma ideia a um jogo jogável
+### 1) MCP Tool: execucao direta no Studio via linguagem natural
 
-"Cria um jogo de sobrevivência estilo Minecraft com ciclo dia/noite, coleta, crafteo e defesa de ondas." — Uma frase e a IA projeta a estrutura, constrói o mapa, cria os objetos e escreve todos os scripts.
+O primeiro eixo do Roblox MCP e a **execucao de MCP Tool**.
+A IA consegue operar diretamente scripts, instancias, propriedades, terreno, iluminacao, assets, audio e animacao dentro do Studio.
 
-> **Dica**: Peça "primeiro faz um plano", revise e diga "executa" para melhores resultados.
+- "Adiciona particulas + som + cooldown quando o jogador pular."
+- "Cria uma arena de boss no centro do mapa e coloca spawns sem colisao."
+- "Muda a interface deste modulo e atualiza todos os scripts dependentes."
 
-### Uma IA que leu seu projeto inteiro
+Nao e apenas geracao de codigo. Sao **acoes executaveis para fluxo real de desenvolvimento**.
 
-A IA sincroniza seu projeto Roblox para arquivos locais e aprende cada script, objeto e estrutura. Dezenas de arquivos entendidos de uma vez, modificados de forma consistente.
+### 2) Sync: mantem contexto completo do projeto para a IA
 
-- "Encontra todos os lugares que usam RemoteEvents e mapeia o fluxo de chamadas."
-- "Refatora todos os scripts de IA inimiga para usar uma máquina de estados unificada."
-- "Resume só as mudanças perigosas feitas desde ontem."
+O segundo eixo e o **Project Sync**.
+A IA trabalha com um espelho local sincronizado, entao alteracoes em varios arquivos continuam consistentes.
 
-Gerencie múltiplos Places simultaneamente. Rastreie o histórico completo de mudanças.
+- Basic: sincronizacao unidirecional (Studio -> Local)
+- Pro: sincronizacao bidirecional + Direction/Apply Mode por tipo + historico + multiplace
 
-### Scripts: escrever, refatorar, debugar — em arquivos relacionados de uma vez
+Assim voce mantem clara a fonte de verdade e evita perder contexto de mudancas.
 
-Não só o arquivo que você apontar. A IA cuida de toda a cadeia de dependências.
+## Valor imediato para o usuario
 
-- "Quando o jogador pular, adiciona partículas, som e cooldown."
-- "Encontra todas as conexões de eventos que podem vazar memória e corrige de forma segura."
-- "Muda a interface deste módulo e atualiza todos os scripts que o referenciam."
+- Comprimir trabalho repetitivo: transformar muitas edicoes manuais em um pedido
+- Alterar arquivos relacionados juntos: nao apenas um arquivo alvo
+- Reduzir risco: decidir com base no estado do sync e no historico
+- Melhor eficiencia de tokens (Pro): menos round trips com acoes em massa
 
-### Criar e posicionar objetos — centenas com um único comando
+## Documentacao detalhada
 
-"Alinha 50 postes ao longo desta estrada", "Coloca 20 casas de tijolos pelo distrito com rotações aleatórias" — a IA cria direto no Studio. Atualize propriedades em qualquer número de objetos com um único comando.
+- [Cobertura de ferramentas (Tools Overview)](tools/overview.md)
+- [Guia detalhado de Sync](sync/overview.md)
 
-### Iluminação, clima e atmosfera em uma frase
+## Comecar
 
-"Muda pra um deserto empoeirado ao pôr do sol", "Faz uma noite de tempestade onde os relâmpagos iluminam a área brevemente" — uma frase e iluminação, céu, atmosfera e névoa se atualizam de uma vez.
-
-### Esculpa terreno pela conversa
-
-"Montanhas no norte, um rio no centro, planícies abertas no sul" — gere qualquer paisagem conversando. Controle material, cor, altura e suavização. Construa mapas inteiros sem tocar o editor de terreno.
-
-### Busque no Creator Store e insira na hora
-
-"Encontra um modelo de castelo medieval, coloca no centro do mapa e aumenta 1.5x" — busca assets gratuitos e insere direto no seu projeto.
-
-### Inteligência espacial para design de níveis
-
-"Acha espaço aberto para uma nova arena do chefão", "Mostra só as áreas onde os monstros realmente conseguem patrulhar" — a IA cuida do raciocínio espacial complexo e da lógica de posicionamento.
-
-### Animações, física e áudio como sistemas conectados
-
-- "Enquanto a animação de dash toca, muda as regras de colisão jogador-inimigo."
-- "Fade in no BGM do chefão quando o ultimate ativa, e volta suavemente quando termina."
-
-Personagem, colisão e som funcionando juntos como sistema de jogo, não ferramentas separadas.
-
-### Execute qualquer código Roblox diretamente
-
-Quando as ferramentas integradas não são suficientes, a IA executa Luau arbitrário no Studio.
-
-- "Encontra todas as Parts no Workspace com Anchored=false e lista elas."
-- "Atualiza em lote os objetos correspondentes e registra cada mudança."
-
-> [Ver lista completa](tools/overview.md)
-
-## Começar
-
-A instalação tem dois passos:
+A instalacao tem dois passos:
 
 1. **Instalar plugin do Roblox Studio** — Faz a ponte entre Studio e IA
 2. **Registrar servidor MCP no app de IA** — Configura seu app de IA para reconhecer o Roblox MCP
 
-Leva 5 minutos. 👉 [Ver guia de instalação](installation/README.md)
+Leva 5 minutos. 👉 [Ver guia de instalacao](installation/README.md)
 
 ## Upgrade Pro
 
-Sync bidirecional, recursos avançados de criação e eficiência de tokens de IA — tudo em uma única atualização.
+Sync bidirecional, recursos avancados de criacao e eficiencia de tokens de IA — tudo em uma unica atualizacao.
 
 👉 [Guia de upgrade Pro](pro-upgrade.md)
 

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

@@ -61,7 +61,7 @@ Se variáveis de ambiente específicas forem necessárias:
 
 **CLI:**
 ```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
 ```
 
 **Arquivo de configuração:**
@@ -72,7 +72,7 @@ gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox
       "command": "npx",
       "args": ["-y", "@weppy/roblox-mcp"],
       "env": {
-        "MCP_PORT": "3002"
+        "HTTP_PORT": "3002"
       }
     }
   }

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

@@ -0,0 +1,104 @@
+# Guia detalhado de Sync no Roblox MCP
+
+Sync conecta o estado do Roblox Studio com arquivos locais para que a IA consiga ler e modificar o contexto completo do projeto com confianca.
+
+## Por que Sync importa
+
+Sem Sync, a IA so enxerga trechos colados no chat. Com Sync ativo, ela trabalha com o projeto inteiro.
+
+- Aplicar refactors de forma consistente em varios scripts
+- Revisar mudancas de risco rapidamente usando historico
+- Manter clara a fonte de verdade entre Studio e arquivos locais
+
+## Como funciona
+
+1. Full Sync: espelho inicial da arvore/instancias do Studio para local
+2. Incremental Sync: atualizacao continua das mudancas novas
+3. Rastreamento de History/Status: ver o que mudou, quando e em qual direcao
+
+O caminho local padrao e `roblox-project-sync/place_{placeId}/explorer`.
+
+## Basic vs Pro
+
+| Item | Basic | Pro |
+|------|------|-----|
+| 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`) |
+| Ferramenta `manage_sync` | Nao suportado | Suportado |
+| Sync multiplace | Nao suportado | Suportado (ate 3 places) |
+
+## Alvos de sync e exclusoes padrao
+
+Servicos sincronizaveis por padrao:
+
+- `Workspace`
+- `Lighting`
+- `ReplicatedStorage`
+- `ServerStorage`
+- `ServerScriptService`
+- `StarterGui`
+- `StarterPlayer`
+- `StarterPack`
+- `ReplicatedFirst`
+- `SoundService`
+- `Chat`
+- `LocalizationService`
+
+Exclusoes padrao:
+
+- Classes: `Terrain`, `Camera`
+- Caminhos restritos por seguranca: `CoreGui`, `CorePackages`, `RobloxScript`, `RobloxScriptSecurity`
+
+## Direction e Apply Mode
+
+### Direction (direcao por tipo)
+
+- `forward`: Studio -> Local
+- `reverse`: Local -> Studio
+- `bidirectional`: duas direcoes
+
+Os tipos sao gerenciados separadamente: `scripts`, `values`, `containers`, `data`, `services`.
+
+### Apply Mode (como mudancas reverse sao aplicadas)
+
+- `manual`: usuario confirma antes de aplicar no Studio
+- `auto`: mudancas detectadas sao aplicadas automaticamente
+
+No Pro, voce controla Direction e Apply Mode por tipo.
+
+## Guia de acoes `manage_sync` (Pro)
+
+| Acao | Descricao | Parametros principais |
+|------|------|-----------|
+| `status` | Consultar estado atual de sync de um place | `placeId` |
+| `config` | Obter configuracao de sync | `placeId` |
+| `history` | Consultar historico de mudancas | `placeId`, `query.limit`, `query.offset` |
+| `directions` | Obter direcoes por tipo | `placeId` |
+| `read_file` | Ler arquivo sincronizado | `placeId`, `instancePath` |
+| `write_file` | Escrever arquivo sincronizado | `placeId`, `instancePath`, `content` |
+| `progress` | Obter progresso/throughput em tempo real | `placeId` |
+
+## Fluxo recomendado
+
+### 1) Comecar com seguranca
+
+- Complete o Full Sync primeiro para estabelecer uma base estavel
+- Comece com modo `manual` para reduzir risco
+
+### 2) Trabalhar com IA
+
+- "Verifica o estado do sync e resume so mudancas de risco do historico recente"
+- "Refatora primeiro scripts de `ServerScriptService` e registra no historico"
+
+### 3) Recuperar quando necessario
+
+- Acompanhe mudancas recentes com `history`
+- Inspecione o arquivo alvo com `read_file`
+- Restaure conteudo com `write_file` e valide no Studio
+
+## Documentos relacionados
+
+- [Cobertura de ferramentas (Tools Overview)](../tools/overview.md)
+- [Guia de upgrade Pro](../pro-upgrade.md)

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

@@ -1,99 +1,259 @@
-# Funcionalidades do Roblox MCP
+# Ferramentas do Roblox MCP
 
-Conecte a IA ao Roblox Studio e automatize diversas tarefas. Veja o que voce pode fazer por categoria.
+Para parametros detalhados, consulte as definicoes de ferramentas MCP diretamente.
 
-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)
-
-### Gerenciamento de Objetos
-
-Crie, clone, delete e mova objetos do jogo como partes, modelos e pastas. Tarefas como "Crie uma parte vermelha" ou "Clone este modelo e coloque ao lado" sao possiveis.
-
-### Propriedades
-
-Leia e altere todas as propriedades dos objetos como tamanho, cor, posicao e material. Voce pode alterar varias propriedades de uma vez ou ajustar relativamente com base nos valores atuais.
-
-### Scripts
-
-Crie novos scripts, leia o codigo existente e modifique. Voce pode editar linhas especificas, buscar texto dentro de scripts ou identificar dependencias para ver quais modulos sao referenciados.
-
-### Selecao
-
-Verifique os objetos selecionados, altere a selecao e limpe a selecao. Essencial para entender e controlar com o que voce esta trabalhando no Studio.
-
-### Busca
-
-Encontre objetos no jogo por nome ou classe (tipo).
-
-### Tags
-
-Adicione ou remova tags de objetos e encontre todos os objetos com uma tag especifica de uma vez. Util para gerenciar grupos de objetos semelhantes.
-
-### Camera
-
-Mova a camera para objetos ou posicoes especificas. Conveniente para verificar rapidamente a area em que voce esta trabalhando.
-
-### Logs
-
-Confira logs de saida e erros que ocorreram durante a execucao do jogo. Ajuda a encontrar e corrigir bugs.
-
-### Conexao
-
-Verifique o status de conexao e uso entre o servidor MCP e o Roblox Studio.
-
----
-
-## Pro
-
-Se voce precisa de funcionalidades mais poderosas, pode fazer upgrade para o Pro.
+Documentacao relacionada:
+- [Guia detalhado de Sync](../sync/overview.md)
 
-### Selecao Avancada
-
-Obtenha o contexto detalhado da selecao com propriedades e codigo-fonte, explore a hierarquia de selecao, adicione/remova itens da selecao, e consulte informacoes do Place e servicos do jogo. Util para fluxos de trabalho avancados e automacao.
-
-### Scripts Avancados
-
-Substitua conteudo em multiplos scripts de uma vez ou execute codigo Luau instantaneamente. Util para modificacoes repetitivas de codigo ou testes rapidos.
-
-### Busca Avancada
-
-Explore a arvore de arquivos completa ou busque objetos por propriedade ou tag. Tenha uma visao completa da estrutura do projeto e consulte todos os descendentes ou ancestrais de objetos especificos.
-
-### Operacoes em Massa
-
-Crie, delete, modifique ou duplique centenas de objetos de uma vez. Lide rapidamente com tarefas em grande escala como plantar arvores no mapa, mudar a cor de todas as partes ou posicionar objetos segundo padroes.
-
-### Assets
-
-Busque modelos gratuitos no Roblox Creator Store e insira instantaneamente. Adicione assets por conversa como "Procure um modelo de castelo medieval" ou "Insira um modelo de arma".
-
-### Ambiente
-
-Configure iluminacao, ceu, nevoa, propriedades do terreno e hora do dia com linguagem natural. Solicitacoes como "Mude para clima de por do sol" ou "Coloque meia-noite" sao possiveis.
-
-### Gerenciamento de Estado
-
-Salve o estado atual do Workspace como snapshot e consulte mudancas recentes e o estado do viewport. Ajuda a entender o estado atual durante tarefas complexas.
-
-### Analise Espacial
-
-Determine com precisao o tamanho e posicao de objetos, encontre espacos vazios e verifique colisoes. Voce tambem pode alinhar objetos a uma grade.
-
-### Raycast
-
-Lance raios invisiveis para encontrar pontos de colisao com terreno ou objetos. Essencial para design de niveis: encontrar posicoes do chao, verificar se objetos podem ser colocados, buscar locais de spawn e analisar areas caminhaveis.
-
-### Terreno
-
-Preencha, escave e suavize terreno com diversas formas como blocos, esferas, cilindros e cunhas. Altere materiais e cores, ou gere proceduralmente terreno natural com montanhas e rios.
-
-### Visualizacao
-
-Exiba areas, marcadores e linhas na tela para confirmar visualmente o espaco de trabalho. Util para debugging e revisao de design de niveis.
-
-👉 [Guia de Upgrade para Pro](../pro-upgrade.md)
+Politica de Sync:
+- Basic: Studio -> Local sincronizacao unidirecional
+- Pro: Sincronizacao bidirecional + cobertura de acoes avancadas mais ampla (melhor eficiencia de tokens IA com fluxos em massa)
+
+## Query Instances (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `get` | Obter propriedades da instancia por caminho | Basic |
+| `children` | Obter filhos imediatos ou todos os descendentes | Basic |
+| `find_child` | Encontrar primeiro filho por nome e filtro de classe opcional | Basic |
+| `find_descendant` | Encontrar primeiro descendente por nome | Basic |
+| `wait_for_child` | Aguardar filho aparecer (com timeout) | Basic |
+| `class_info` | Obter informacoes da classe e propriedades validas | Basic |
+| `search_name` | Buscar instancias por padrao de nome (suporta curingas) | Basic |
+| `search_class` | Buscar instancias por nome de classe | Basic |
+| `file_tree` | Obter estrutura de arvore de arquivos a partir da raiz | Pro |
+| `project_structure` | Obter estrutura completa do projeto | Pro |
+| `descendants` | Obter todos os descendentes de uma instancia | Pro |
+| `ancestors` | Obter todos os ancestrais de uma instancia | Pro |
+| `search_property` | Buscar instancias por valor de propriedade | Pro |
+| `search_tag` | Buscar instancias por tag | Pro |
+
+## Mutate Instances (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `create` | Criar uma nova instancia | Basic |
+| `create_with_props` | Criar instancia com propriedades iniciais | Basic |
+| `delete` | Excluir uma instancia | Basic |
+| `clone` | Clonar uma instancia | Basic |
+| `move` | Mover instancia para novo pai | Basic |
+| `rename` | Renomear uma instancia | Basic |
+| `pivot` | Definir posicao pivot ou CFrame | Basic |
+| `create_tree` | Criar arvore hierarquica de instancias | Pro |
+| `mass_create` | Criar multiplas instancias de uma vez | Pro |
+| `mass_delete` | Excluir multiplas instancias | Pro |
+| `mass_duplicate` | Duplicar multiplas instancias | Pro |
+| `smart_duplicate` | Duplicar com espacamento e quantidade | Pro |
+
+## Manage Properties (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `get` | Obter valor de uma propriedade | Basic |
+| `set` | Definir valor de uma propriedade | Basic |
+| `get_all` | Obter todas as propriedades de uma instancia | Basic |
+| `set_multiple` | Definir multiplas propriedades de uma vez | Basic |
+| `get_attr` | Obter valor de atributo | Basic |
+| `set_attr` | Definir valor de atributo | Basic |
+| `get_all_attrs` | Obter todos os atributos | Basic |
+| `delete_attr` | Excluir um atributo | Basic |
+| `add_tag` | Adicionar tag a instancia | Basic |
+| `remove_tag` | Remover tag de instancia | Basic |
+| `check_tag` | Verificar se instancia tem uma tag | Basic |
+| `get_tags` | Obter todas as tags de uma instancia | Basic |
+| `get_tagged` | Obter todas as instancias com uma tag especifica | Basic |
+| `set_calculated` | Definir propriedade usando expressao matematica | Pro |
+| `set_relative` | Definir propriedade relativa ao valor atual | Pro |
+| `mass_set` | Definir propriedade em multiplas instancias | Pro |
+| `mass_get` | Obter propriedade de multiplas instancias | Pro |
+| `modify_children` | Modificar todos os filhos de um pai | Pro |
+
+## Manage Scripts (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `get_source` | Obter codigo-fonte do script | Basic |
+| `set_source` | Definir codigo-fonte do script | Basic |
+| `create` | Criar um novo script | Basic |
+| `delete` | Excluir um script | Basic |
+| `edit_replace` | Substituir linhas especificas do script | Basic |
+| `edit_insert` | Inserir linhas na posicao | Basic |
+| `edit_delete` | Excluir linhas especificas | Basic |
+| `search` | Buscar texto no script | Basic |
+| `get_dependencies` | Obter dependencias do script | Basic |
+| `replace` | Substituicao em massa em scripts | Pro |
+
+## Manage Lighting (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `lighting` | Definir propriedades do servico Lighting | Pro |
+| `atmosphere` | Definir propriedades de Atmosphere | Pro |
+| `sky` | Definir propriedades de Sky | Pro |
+| `terrain_props` | Definir propriedades visuais/agua de Terrain | Pro |
+| `time` | Definir hora do dia | Pro |
+
+## Manage Selection (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `get` | Obter selecao atual | Basic |
+| `set` | Substituir selecao atual | Basic |
+| `clear` | Limpar selecao | Basic |
+| `cached` | Obter selecao em cache sem ida e volta | Basic |
+| `context` | Obter contexto detalhado com fonte e propriedades | Pro |
+| `details` | Obter detalhes hierarquicos com ancestrais/descendentes | Pro |
+| `add` | Adicionar itens a selecao | Pro |
+| `remove` | Remover itens da selecao | Pro |
+| `watch` | Monitorar mudancas de selecao | Pro |
+
+## Manage Camera (Basic)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `info` | Obter posicao, rotacao, FOV e tamanho do viewport | Basic |
+| `focus_path` | Mover camera para focar em instancia | Basic |
+| `focus_position` | Mover camera para focar em posicao | Basic |
+| `suggest` | Obter visao de camera sugerida para alvo | Basic |
+
+## Manage Tween (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `create` | Criar tween com propriedades-alvo | Pro |
+| `play` | Reproduzir um tween criado | Pro |
+| `pause` | Pausar um tween em execucao | Pro |
+| `cancel` | Cancelar um tween | Pro |
+
+## Manage Audio (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `play` | Reproduzir som (cria Sound se necessario) | Pro |
+| `stop` | Parar um som em reproducao | Pro |
+| `pause` | Pausar um som em reproducao | Pro |
+| `resume` | Retomar um som pausado | Pro |
+| `set_listener` | Definir tipo/alvo do listener de audio | Pro |
+
+## Manage Animation (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `load` | Carregar animacao em Humanoid/AnimationController | Pro |
+| `play` | Reproduzir faixa de animacao carregada | Pro |
+| `stop` | Parar animacao em reproducao | Pro |
+| `get_tracks` | Listar todas as faixas de animacao carregadas | Pro |
+
+## Manage Physics (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `register_group` | Registrar grupo de colisao | Pro |
+| `set_collidable` | Definir se dois grupos podem colidir | Pro |
+| `get_groups` | Listar todos os grupos de colisao registrados | Pro |
+
+## Manage Effects (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `emit` | Emitir particulas do ParticleEmitter | Pro |
+| `clear` | Limpar todas as particulas | Pro |
+| `toggle` | Ativar ou desativar efeito | Pro |
+
+## Manage Terrain (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `fill_block` | Preencher terreno em forma de bloco | Pro |
+| `fill_ball` | Preencher terreno em forma de esfera | Pro |
+| `fill_cylinder` | Preencher terreno em forma de cilindro | Pro |
+| `fill_wedge` | Preencher terreno em forma de cunha | Pro |
+| `clear_region` | Limpar terreno na regiao | Pro |
+| `clear_bounds` | Limpar terreno nos limites | Pro |
+| `replace_material` | Substituir material na regiao | Pro |
+| `colors_get` | Obter cores de material | Pro |
+| `colors_set` | Definir cores de material | Pro |
+| `read_voxel` | Ler dados de voxel individual | Pro |
+| `read_voxels` | Ler dados de voxels em massa | Pro |
+| `write_voxels` | Escrever dados de voxels em massa | Pro |
+| `generate` | Gerar terreno procedural | Pro |
+| `smooth` | Suavizar terreno | Pro |
+
+## Spatial Query (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `raycast` | Lancar um unico raio | Pro |
+| `find_ground` | Encontrar posicao do chao abaixo do ponto | Pro |
+| `check_placement` | Verificar se a colocacao esta livre de colisoes | Pro |
+| `multi_raycast` | Lancar multiplos raios em lote | Pro |
+| `scan_area` | Gerar mapa de alturas da area | Pro |
+| `find_flat` | Encontrar areas planas para construcao | Pro |
+| `find_spawn` | Encontrar posicoes de spawn adequadas | Pro |
+| `analyze_walkable` | Analisar grade de transitabilidade | Pro |
+| `spatial_map` | Obter todas as posicoes de BasePart | Pro |
+| `find_space` | Encontrar espaco vazio para objeto | Pro |
+| `bounds` | Obter caixa delimitadora de instancias | Pro |
+| `snap_grid` | Ajustar posicao a grade | Pro |
+| `collision` | Verificar colisao AABB | Pro |
+
+## Manage Assets (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `insert` | Inserir modelo por ID de asset | Pro |
+| `info` | Obter metadados do asset | Pro |
+| `search` | Buscar na Creator Store | Pro |
+| `search_insert` | Buscar e inserir primeira correspondencia | Pro |
+| `insert_free` | Inserir modelo gratuito | Pro |
+| `insert_package` | Inserir pacote | Pro |
+| `export` | Exportar selecao atual | Pro |
+
+## Manage Sync (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `status` | Obter status de sincronizacao de um Place | Pro |
+| `config` | Obter configuracao de sincronizacao | Pro |
+| `history` | Obter historico de mudancas | Pro |
+| `directions` | Obter direcoes de sincronizacao por tipo | Pro |
+| `read_file` | Ler um arquivo sincronizado | Pro |
+| `write_file` | Escrever em um arquivo sincronizado | Pro |
+| `progress` | Obter progresso de sincronizacao em tempo real e largura de banda | Pro |
+
+## Workspace State (Pro)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `sync` | Obter estado atual do Workspace | Pro |
+| `snapshot` | Obter estrutura completa da arvore de instancias | Pro |
+| `changes` | Obter mudancas recentes | Pro |
+| `viewport` | Obter informacoes de camera e viewport | Pro |
+
+## Manage Logs (Basic)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `get` | Obter logs filtrados | Basic |
+| `clear` | Limpar buffer de logs | Basic |
+| `errors` | Obter apenas erros recentes | Basic |
+
+## System Info (Misto)
+
+| Acao | Descricao | Tier |
+|------|-----------|------|
+| `ping` | Testar conexao | Basic |
+| `connection` | Obter info de conexao servidor/plugin | Basic |
+| `usage` | Obter tier atual (basic/pro) | Basic |
+| `place_info` | Obter Place ID, nome, criador | Pro |
+| `services` | Listar todos os servicos Roblox | Pro |
+| `studio_settings` | Obter preferencias do Studio | Pro |
+| `run_command` | Executar comando do Studio | Pro |
+
+## Batch Execute (Pro)
+
+Executa multiplos comandos em um unico lote. Cada comando especifica um nome de ferramenta e argumentos. Os comandos sao executados sequencialmente com comportamento opcional de continuar em caso de erro.
+
+## Execute Luau (Pro)
+
+Executa codigo Luau arbitrario no sandbox do Roblox Studio. Servicos bloqueados: HttpService, DataStoreService, MessagingService. Nao pode acessar CoreGui/CorePackages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "1.0.2",
+  "version": "1.2.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",

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": "1.0.2",
+  "version": "1.2.0",
   "author": {
     "name": "hope1026"
   },