@weppy/roblox-mcp 2.5.0 → 2.6.0

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

@@ -1,277 +0,0 @@
-# Ferramentas do Roblox MCP
-
-Para parametros detalhados, consulte as definicoes de ferramentas MCP diretamente.
-
-## Guias por fluxo
-
-Consulte estes guias orientados a fluxo de trabalho:
-
-| Categoria | Descricao | Tools incluidas |
-|-----------|-----------|-----------------|
-| [Instancias e propriedades](instances-and-properties.md) | Busca, criacao, edicao e tags de instancias | `query_instances`, `mutate_instances`, `manage_properties` |
-| [Scripts e execucao de codigo](scripting.md) | Gerenciamento de scripts e execucao de Luau | `manage_scripts`, `execute_luau` |
-| [Mundo e ambiente](world-and-environment.md) | Iluminacao, terrain, consultas espaciais e camera | `manage_lighting`, `manage_terrain`, `spatial_query`, `manage_camera` |
-| [Assets e efeitos](assets-and-effects.md) | Insercao de assets, tween, animacao, audio e efeitos | `manage_assets`, `manage_tween`, `manage_animation`, `manage_audio`, `manage_effects`, `manage_physics` |
-| [Playtest e testes automatizados](playtest.md) | Controle de playtest e validacao automatica | `system_info` (`play`, `stop`, `pause`, `resume`, `play_status`, `run_test`) |
-| [Sync](../sync/overview.md) | Sincronizacao entre Studio e arquivos locais | `manage_sync`, `workspace_state` |
-| [Sistema e depuracao](system-and-debugging.md) | Conexao, logs, selecao e execucao em lote | `system_info` (`ping`, `connection`, `usage`, ...), `manage_logs`, `manage_selection`, `batch_execute` |
-
-Documentacao relacionada:
-- [Guia detalhado de Sync](../sync/overview.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_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 |
-| `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 |
-| `play` | Iniciar playtest em modo Play (F5) ou Run (F8) | Pro |
-| `stop` | Parar o playtest ativo | Pro |
-| `pause` | Pausar o playtest ativo em modo Run | Pro |
-| `resume` | Retomar o playtest pausado em modo Run | Pro |
-| `play_status` | Obter estado do playtest e acoes disponiveis | Pro |
-| `run_test` | Injetar um script temporario de teste, executar o playtest, coletar logs e gerar relatorios locais | 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/docs/pt-br/tools/playtest.md

@@ -1,140 +0,0 @@
-# Playtest e testes automatizados
-
-> Controle o playtest do Roblox Studio com IA, injete scripts de teste e gere logs e relatorios locais automaticamente.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `system_info` | Pro | acoes `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` |
-
-> Para outras acoes de `system_info` como `ping`, `connection` e `usage`, consulte [Sistema e depuracao](system-and-debugging.md).
-
-## Fluxos principais
-
-### Controle manual de playtest
-
-```
-"Inicie o jogo em modo Play (F5)."
-"Pare o playtest atual."
-```
-
-Fluxo tipico: `play` -> `play_status` -> `stop`.
-
-### Executar um teste automatizado
-
-```
-"Escreva e execute um teste que verifique se o SpawnLocation esta posicionado corretamente."
-```
-
-`run_test` injeta o script de teste, inicia o playtest automaticamente, coleta logs e faz a limpeza.
-
-### Validacao estilo CI
-
-```
-"Execute um teste em modo Run (F8) que verifique se o NPC chega ao objetivo e me mostre os logs se falhar."
-```
-
-Use `run_test` com `mode: "run"` para validacoes focadas no servidor.
-
-## Maquina de estados do playtest
-
-```text
-Edit --play--> Running --stop--> Edit
-                  |               ^
-                pause             |
-                  |               |
-                  v               |
-               Paused --resume--> Running
-```
-
-| Estado | Acoes disponiveis |
-|--------|-------------------|
-| `edit` | `play` |
-| `running` | `stop`, `pause` (apenas modo Run) |
-| `paused` | `resume`, `stop` |
-
-- Modo Play (F5): simulacao de cliente + servidor, sem pausa ou retomada
-- Modo Run (F8): simulacao apenas de servidor, com pausa e retomada
-
-## Fluxo de `run_test`
-
-`run_test` orquestra estas etapas automaticamente:
-
-### 1. Preparacao
-
-- Ler informacoes do place com `place_info`
-- Limpar o buffer de logs existente
-
-### 2. Injecao do script
-
-- Criar `ServerScriptService.__MCP_TestRunner` com um script de teste encapsulado
-- O wrapper cuida dos sinais `START` e `FINISHED` e dos tracebacks de erro
-
-### 3. Execucao e monitoramento
-
-- Iniciar o playtest em modo Play ou Run
-- Consultar logs a cada 500 ms
-- Finalizar quando `[WEPPY_TEST]:FINISHED` for detectado
-- Parar automaticamente ao atingir timeout (60 segundos por padrao, 300 no maximo)
-
-### 4. Limpeza
-
-- Parar o playtest automaticamente
-- Excluir o script de teste injetado
-- Coletar os logs finais
-
-### 5. Escrita de relatorios
-
-Os relatorios e logs sao gravados em `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
-
-```text
-{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
-├── test-report.md
-└── test-log.txt
-```
-
-Exemplo de `test-report.md`:
-
-```markdown
-# Test Report
-
-- Status: passed
-- Test Name: spawn_location_test
-- Mode: run
-- Place ID: 123456
-- Duration (ms): 1523
-- Total Logs: 12
-- Signal Count: 2
-
-## Signals
-
-- START: 2026-03-12T10:30:00.000Z
-- FINISHED: 2026-03-12T10:30:01.523Z
-```
-
-## Referencia de acoes
-
-| Acao | Descricao | Parametros | Tier |
-|------|-----------|------------|------|
-| `play` | Iniciar playtest em modo Play (F5) ou Run (F8) | `mode`: `"play"` \| `"run"` | Pro |
-| `stop` | Parar o playtest atual | - | Pro |
-| `pause` | Pausar um playtest em modo Run | - | Pro |
-| `resume` | Retomar um playtest pausado em modo Run | - | Pro |
-| `play_status` | Obter o estado do playtest e as acoes disponiveis | - | Pro |
-| `run_test` | Injetar script de teste, executar playtest, coletar logs e escrever relatorios | `script` (obrigatorio), `test_name`, `mode`, `timeout` | Pro |
-
-### Parametros de `run_test`
-
-| Parametro | Tipo | Obrigatorio | Descricao |
-|-----------|------|:-----------:|-----------|
-| `script` | string | ✅ | Corpo do codigo Luau de teste a executar |
-| `test_name` | string | - | Nome exibido no relatorio |
-| `mode` | `"play"` \| `"run"` | - | Modo de playtest, padrao `"play"` |
-| `timeout` | number | - | Timeout em segundos, padrao 60, maximo 300 |
-
-## Documentos relacionados
-
-- [Sistema e depuracao](system-and-debugging.md) - acoes de conexao e gerenciamento de logs
-- [Scripts e execucao de codigo](scripting.md) - escrever scripts e executar Luau
-- [Lista completa de tools](overview.md)

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

@@ -1,66 +0,0 @@
-# Scripts e execucao de codigo
-
-> Gerencie o codigo-fonte de scripts e execute Luau arbitrario dentro do Roblox Studio.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `manage_scripts` | Misto | Criar, ler, editar, buscar e analisar dependencias de scripts |
-| `execute_luau` | Pro | Executar Luau arbitrario no sandbox do Roblox Studio |
-
-## Fluxos principais
-
-### Editar um script
-
-```
-"Altere maxPlayers de 12 para 24 no script GameManager dentro de ServerScriptService."
-```
-
-Use `manage_scripts.search` para encontrar a linha correta e `manage_scripts.edit_replace` para atualiza-la.
-
-### Refatorar varios scripts (Pro)
-
-```
-"Substitua OldModule por NewModule em todos os scripts."
-```
-
-Use `manage_scripts.replace` para aplicar a mudanca em varios scripts em uma solicitacao.
-
-### Inspecionar dados de runtime (Pro)
-
-```
-"Calcule a media de Health de todos os Humanoid que estao em Workspace."
-```
-
-Use `execute_luau` para rodar Luau personalizado e ler dados do runtime atual.
-
-## Referencia de acoes
-
-### 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 em um script | Basic |
-| `edit_insert` | Inserir linhas em uma posicao | Basic |
-| `edit_delete` | Excluir linhas especificas | Basic |
-| `search` | Buscar texto em scripts | Basic |
-| `get_dependencies` | Obter dependencias de um script | Basic |
-| `replace` | Substituicao em massa em scripts | Pro |
-
-### Execute Luau (Pro)
-
-Executa Luau arbitrario dentro do sandbox do Roblox Studio.
-
-- Servicos bloqueados: `HttpService`, `DataStoreService`, `MessagingService`
-- APIs inacessiveis: `CoreGui`, `CorePackages`
-
-## Documentos relacionados
-
-- [Instancias e propriedades](instances-and-properties.md) - criar ou mover instancias de script
-- [Playtest e testes automatizados](playtest.md) - injetar e executar scripts de teste
-- [Lista completa de tools](overview.md)

package/docs/pt-br/tools/system-and-debugging.md

@@ -1,93 +0,0 @@
-# Sistema e depuracao
-
-> Verifique a conexao, gerencie logs, controle a selecao do Studio e execute lotes para fluxos de depuracao.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `system_info` | Misto | `ping`, `connection`, `usage`, `place_info`, `services`, `studio_settings` |
-| `manage_logs` | Basic | Consultar logs, limpar buffers e filtrar erros recentes |
-| `manage_selection` | Misto | Ler, substituir e monitorar a selecao do Studio |
-| `batch_execute` | Pro | Executar varios comandos em um unico lote |
-
-> Para as acoes de playtest de `system_info`, como `play`, `stop` e `run_test`, consulte [Playtest e testes automatizados](playtest.md).
-
-## Fluxos principais
-
-### Verificar a conexao
-
-```
-"Confira se o Studio esta conectado corretamente."
-```
-
-Use `system_info.ping` para uma verificacao rapida.
-
-### Depurar erros recentes
-
-```
-"Mostre os erros mais recentes."
-```
-
-Use `manage_logs.errors` para obter apenas erros recentes. `manage_logs.get` tambem suporta consulta incremental com cursor `sinceSeq`.
-
-### Executar um fluxo em lote (Pro)
-
-```
-"Deixe todos os Part do Workspace vermelhos e depois foque a camera no primeiro."
-```
-
-Use `batch_execute` para agrupar varios comandos em uma unica solicitacao.
-
-## Referencia de acoes
-
-### System Info (Misto)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `ping` | Testar a conexao | Basic |
-| `connection` | Obter informacoes de conexao do servidor e plugin | Basic |
-| `usage` | Obter o tier atual (`basic` ou `pro`) | Basic |
-| `place_info` | Obter Place ID, nome e criador | Pro |
-| `services` | Listar todos os servicos Roblox | Pro |
-| `studio_settings` | Obter preferencias do Studio | Pro |
-
-### Manage Logs (Basic)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `get` | Obter logs filtrados com suporte opcional ao cursor `sinceSeq` | Basic |
-| `clear` | Limpar o buffer de logs | Basic |
-| `errors` | Obter apenas erros recentes | Basic |
-
-### Manage Selection (Misto)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `get` | Obter a selecao atual | Basic |
-| `set` | Substituir a selecao atual | Basic |
-| `clear` | Limpar a selecao | Basic |
-| `cached` | Obter a selecao em cache sem round-trip | Basic |
-| `context` | Obter contexto detalhado com codigo-fonte e propriedades | Pro |
-| `details` | Obter detalhes hierarquicos com ancestrais e descendentes | Pro |
-| `add` | Adicionar itens a selecao | Pro |
-| `remove` | Remover itens da selecao | Pro |
-| `watch` | Monitorar mudancas de selecao | Pro |
-
-### Manage Context (Basic)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `begin` | Inicia um contexto de execucao estruturado para o escopo atual de sessao/place | Basic |
-| `update` | Atualiza a intencao, as areas afetadas ou os metadados de replay do contexto ativo | Basic |
-| `end` | Encerra o contexto de execucao ativo e persiste o snapshot final | Basic |
-
-### Batch Execute (Pro)
-
-Executa varios comandos em um unico lote. Cada comando inclui nome da tool e argumentos, roda em ordem e pode continuar apos erros se configurado.
-
-## Documentos relacionados
-
-- [Playtest e testes automatizados](playtest.md) - acoes de playtest em `system_info`
-- [Scripts e execucao de codigo](scripting.md) - executar Luau para investigacao e depuracao
-- [Lista completa de tools](overview.md)

package/docs/pt-br/tools/world-and-environment.md

@@ -1,102 +0,0 @@
-# Mundo e ambiente
-
-> Construa e inspecione o mundo do jogo com lighting, terrain, consultas espaciais e ferramentas de camera.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `manage_lighting` | Pro | Configura Lighting, Atmosphere, Sky e hora do dia |
-| `manage_terrain` | Pro | Gera e edita terrain, incluindo dados voxel |
-| `spatial_query` | Pro | Raycasts, busca de solo, validacao de posicionamento e mapas de altura |
-| `manage_camera` | Basic | Inspeciona o estado da camera, move o foco e sugere visoes |
-
-## Fluxos principais
-
-### Definir a atmosfera (Pro)
-
-```
-"Mude o mapa para um clima de por do sol com ceu laranja, nevoa mais densa e horario 18:00."
-```
-
-Use `manage_lighting.time` para a hora, `manage_lighting.atmosphere` para a nevoa e `manage_lighting.sky` para o ceu.
-
-### Construir terrain (Pro)
-
-```
-"Crie uma colina de grama com raio 200 no centro do mapa e coloque agua ao redor."
-```
-
-Use `manage_terrain.fill_ball` para a colina e `manage_terrain.fill_block` para a agua ao redor.
-
-### Validar posicionamento (Pro)
-
-```
-"Encontre uma area plana onde eu possa colocar este predio."
-```
-
-Use `spatial_query.find_flat` para achar candidatos, `spatial_query.check_placement` para valida-los e `manage_camera.focus_position` para inspecao visual.
-
-## Referencia de acoes
-
-### 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 e de agua de Terrain | Pro |
-| `time` | Definir hora do dia | Pro |
-
-### Manage Terrain (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `fill_block` | Preencher terrain em forma de bloco | Pro |
-| `fill_ball` | Preencher terrain em forma de esfera | Pro |
-| `fill_cylinder` | Preencher terrain em forma de cilindro | Pro |
-| `fill_wedge` | Preencher terrain em forma de cunha | Pro |
-| `clear_region` | Limpar terrain em uma regiao | Pro |
-| `clear_bounds` | Limpar terrain dentro de limites | Pro |
-| `replace_material` | Substituir material em uma regiao | Pro |
-| `colors_get` | Obter cores de material | Pro |
-| `colors_set` | Definir cores de material | Pro |
-| `read_voxel` | Ler um voxel individual | Pro |
-| `read_voxels` | Ler dados voxel em lote | Pro |
-| `write_voxels` | Escrever dados voxel em lote | Pro |
-| `generate` | Gerar terrain procedural | Pro |
-| `smooth` | Suavizar terrain | Pro |
-
-### Spatial Query (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `raycast` | Lancar um unico raio | Pro |
-| `find_ground` | Encontrar a posicao do solo abaixo de um ponto | Pro |
-| `check_placement` | Verificar se um posicionamento esta livre de colisao | Pro |
-| `multi_raycast` | Lancar varios raios em lote | Pro |
-| `scan_area` | Gerar um mapa de altura de uma area | Pro |
-| `find_flat` | Encontrar areas planas para construir | Pro |
-| `find_spawn` | Encontrar posicoes de spawn adequadas | Pro |
-| `analyze_walkable` | Analisar uma grade de navegacao | Pro |
-| `spatial_map` | Obter todas as posicoes de BasePart | Pro |
-| `find_space` | Encontrar espaco vazio para um objeto | Pro |
-| `bounds` | Obter caixas delimitadoras de instancias | Pro |
-| `snap_grid` | Ajustar uma posicao a grade | Pro |
-| `collision` | Verificar colisao AABB | Pro |
-
-### Manage Camera (Basic)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `info` | Obter posicao, rotacao, FOV e tamanho do viewport da camera | Basic |
-| `focus_path` | Mover a camera para focar uma instancia | Basic |
-| `focus_position` | Mover a camera para focar uma posicao | Basic |
-| `suggest` | Obter uma visao de camera sugerida para um alvo | Basic |
-
-## Documentos relacionados
-
-- [Instancias e propriedades](instances-and-properties.md) - posicionar objetos do mundo
-- [Assets e efeitos](assets-and-effects.md) - adicionar efeitos, audio e animacao
-- [Lista completa de tools](overview.md)