@weppy/roblox-mcp 2.5.0 → 2.6.0

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

@@ -1,85 +0,0 @@
-# Instalacao do Plugin Roblox
-
-Como instalar o plugin para conectar agentes de IA no Roblox Studio.
-
-## 1. Baixar o Plugin
-
-1. Abra [GitHub Releases](https://github.com/hope1026/weppy-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**
-3. Clique em **Plugins Folder**
-
-![Abrir Plugins Folder](../../assets/screenshots/plugin/installation/plugins-menu.png)
-
-4. **Copie** `WeppyRobloxMCP.rbxm` para a pasta de Plugins
-5. **Reinicie o Roblox Studio**
-
-## 3. Verificar a Instalacao
-
-Apos reiniciar, o botao **WEPPY** aparecera na aba Plugins.
-
-![Botao WEPPY](../../assets/screenshots/plugin/installation/toolbar-button.png)
-
-## 4. Conectar ao Agente de IA
-
-### Pre-requisitos
-
-O servidor MCP deve estar instalado. Complete primeiro o guia do seu app de IA:
-
-| Aplicativo de IA | Guia de Instalacao |
-|------------------|---------------------|
-| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
-| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
-| Cursor | [Como Configurar](ai-apps/cursor.md) |
-| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
-| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
-| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
-| Antigravity | [Como Configurar](ai-apps/antigravity.md) |
-
-### Conectar
-
-1. Abra qualquer projeto no **Roblox Studio**
-2. Aba **Plugins** -> **WEPPY**
-3. Clique em **Connect**
-4. Quando aparecer **"Connected"**, esta pronto
-
-![Tela Principal do Plugin](../../assets/screenshots/plugin/installation/main-screen.png)
-
-## 5. Configuracoes (Opcional)
-
-Use o botao de configuracoes no canto superior direito.
-
-![Tela de Configuracoes](../../assets/screenshots/plugin/installation/settings-screen.png)
-
-- **Conexao Automatica**
-- **Reconexao Automatica**
-- **Foco Automatico da Camera**
-- **Idioma**
-
-## Solucao de Problemas
-
-### O plugin nao aparece
-
-- 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
-- Clique em **Connect** novamente
-- Verifique conflito na porta 3002
-
-### A conexao cai frequentemente
-
-- Ative **Reconexao Automatica**
-- Reinicie o app de IA

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

@@ -1,96 +0,0 @@
-# Guia de Upgrade para Pro
-
-## Por que Pro?
-
-### Sync bidirecional para fluxos de desenvolvimento reais
-
-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.
-
-- **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.
-
-### Economize tokens de IA com workflows de alto impacto
-
-Ações em massa e avançadas reduzem chamadas repetitivas — faça mais por prompt.
-
-### IA que controla playtests diretamente
-
-A IA pode controlar os playtests do Roblox Studio diretamente. Ela pode iniciar e parar Play (F5) ou Run (F8), injetar scripts de teste, coletar logs e gerar relatórios automaticamente.
-
-- "Inicia um playtest no modo Run e verifica se o NPC chega ao alvo."
-- "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."
-
-### Mais recursos exclusivos do Pro
-
-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
-
-### Passo 1: Compre uma licença de assinatura Pro no Gumroad
-
-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 licença de assinatura Pro
-3. Copie a chave de licença que você recebe após a compra
-
-Você só precisa ativar a licença uma vez, no plugin ou no dashboard. As duas superfícies compartilham o mesmo estado local de licença do MCP, então a ativação feita em um lugar aparece no outro.
-
-### Ativar no plugin
-
-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.
-5. Se o status não atualizar imediatamente, clique em **Refresh**.
-6. Quando a ativação terminar, o status muda de Basic para Pro e os recursos Pro ficam disponíveis.
-
-![Tela de ativação de licença no plugin](../assets/screenshots/plugin/license/plugin-license-screen.png)
-
-### Ativar no dashboard
-
-1. Inicie o servidor MCP e abra **Settings > License** no dashboard.
-2. Confirme que o provider está definido como `gumroad`.
-3. Cole a chave comprada no campo `License Key`.
-4. Clique em **Activate License** para ativar a licença.
-5. Se necessário, use **Refresh License** para buscar o status mais recente.
-
-![Tela de ativação de licença no dashboard](../assets/screenshots/plugin/license/dashboard-license-screen.png)
-
-### Depois da ativação
-
-- Se o status da licença aparecer como `active` ou `grace`, os recursos Pro já estão disponíveis.
-- O plugin e o dashboard compartilham o mesmo estado de licença, então a ativação feita em um deles aparece no outro.
-- Use **Refresh** ou **Refresh License** sempre que quiser verificar o status mais recente novamente.
-
-## Comparação de Recursos
-
-| Recurso | Basic | Pro |
-|---------|:-----:|:---:|
-| 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

@@ -1,41 +0,0 @@
-# Usar `luau-lsp` com WEPPY Sync
-
-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 WEPPY grava
-
-Depois que o Full Sync termina, o WEPPY grava:
-
-- 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 `weppy-project-sync/sourcemap.json`.
-
-## O que melhora
-
-Quando o `luau-lsp` usa o sourcemap do WEPPY, 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 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:
-
-```json
-{
-  "luau-lsp.sourcemap.enabled": true,
-  "luau-lsp.sourcemap.autogenerate": false,
-  "luau-lsp.sourcemap.sourcemapFile": "weppy-project-sync/sourcemap.json"
-}
-```
-
-## Observacao sobre Multi-place
-
-`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

@@ -1,153 +0,0 @@
-# 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
-
-![Fluxo de Sync — arvore do Studio espelhada em arquivos locais](../../assets/screenshots/plugin/sync/sync-overview.png)
-
-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
-
-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 [WEPPY Roblox Explorer](../installation/roblox-explorer.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.
-
-![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
-- Badges de status de sync mostram estado modificado/conflito
-
-## 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_current_place`, `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_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` |
-| `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) Resolver conflitos
-
-Quando mudancas sao detectadas tanto no Studio quanto no local durante a sincronizacao bidirecional, um dialogo de resolucao de conflitos aparece.
-
-![Local Changes Detected — opcoes de resolucao de conflitos (Studio Priority / Local Priority / Per-File)](../../assets/screenshots/plugin/sync/sync-conflict.png)
-
-- **Studio Priority**: sobrescrever usando o estado do Studio como fonte de verdade
-- **Local Priority**: aplicar arquivos locais ao Studio
-- **Per-File**: escolher qual lado tem prioridade para cada arquivo individualmente
-
-### 4) Recuperar quando necessario
-
-- Acompanhe mudancas recentes com `history`
-- Inspecione o arquivo alvo com `read_file`
-- Restaure conteudo com `write_file` e valide no Studio
-
-## Formato de arquivos (v2 nested directory)
-
-Cada instancia Roblox e armazenada como seu proprio diretorio com arquivos meta dentro:
-
-```
-explorer/
-├── Workspace/
-│   ├── _tree.json
-│   ├── Part/
-│   │   └── Part.props.json
-│   ├── MyScript/
-│   │   └── MyScript.server.luau
-│   └── Coins/
-│       └── Coins.value.json
-```
-
-Convencoes de nomes:
-- Propriedades: `{Name}/{Name}.props.json`
-- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
-- Valores: `{Name}/{Name}.value.json`
-
-Instancias com nome duplicado usam o sufixo `~N` no diretorio (ex: `Part~2/Part.props.json`).
-Nomes que contem `~` sao escapados como `~~` (ex: `Part~2` → `Part~~2/`). Regra Odd-Count Tilde: um `~+N` final e interpretado como sufixo de colisao somente quando a quantidade de tildes e impar.
-
-## Documentos relacionados
-
-- [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/assets-and-effects.md

@@ -1,104 +0,0 @@
-# Assets e efeitos
-
-> Insira assets e controle tween, audio, particulas, animacao e grupos de colisao.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `manage_assets` | Pro | Busca na Creator Store, insere modelos e pacotes, consulta info do asset |
-| `manage_tween` | Pro | Cria, reproduz, pausa e cancela tweens |
-| `manage_animation` | Pro | Carrega, reproduz, para e inspeciona tracks de animacao |
-| `manage_audio` | Pro | Reproduz, para, pausa e retoma sons; configura o listener |
-| `manage_effects` | Pro | Emite particulas, limpa efeitos e alterna seu estado |
-| `manage_physics` | Pro | Registra grupos de colisao e configura colisoes |
-
-## Fluxos principais
-
-### Montar uma cena com assets
-
-```
-"Busque um modelo de arvore na Creator Store e coloque tres no Workspace."
-```
-
-Use `manage_assets.search_insert` para buscar e inserir em um unico passo.
-
-### Criar uma interacao visual
-
-```
-"Faca a porta abrir com um tween de 3 segundos quando for clicada."
-```
-
-Use `manage_tween.create` para definir o movimento e `manage_tween.play` para reproduzi-lo. Voce pode combinar com `manage_audio.play` para o som.
-
-### Combinar particulas e audio
-
-```
-"Reproduza um som de explosao e emita particulas quando o boss aparecer."
-```
-
-Use `manage_effects.emit` para as particulas e `manage_audio.play` para o som.
-
-## Referencia de acoes
-
-### Manage Assets (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `insert` | Inserir um modelo por ID de asset | Pro |
-| `info` | Obter metadados do asset | Pro |
-| `search` | Buscar na Creator Store | Pro |
-| `search_insert` | Buscar e inserir a primeira correspondencia | Pro |
-| `insert_free` | Inserir um modelo gratuito | Pro |
-| `insert_package` | Inserir um pacote | Pro |
-| `export` | Exportar a selecao atual | Pro |
-
-### Manage Tween (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `create` | Criar um tween com propriedades alvo | Pro |
-| `play` | Reproduzir um tween criado | Pro |
-| `pause` | Pausar um tween em execucao | Pro |
-| `cancel` | Cancelar um tween | Pro |
-
-### Manage Animation (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `load` | Carregar uma animacao em Humanoid ou AnimationController | Pro |
-| `play` | Reproduzir um track de animacao carregado | Pro |
-| `stop` | Parar uma animacao em reproducao | Pro |
-| `get_tracks` | Listar todos os tracks de animacao carregados | Pro |
-
-### Manage Audio (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `play` | Reproduzir um som e criar `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 o tipo ou alvo do listener de audio | Pro |
-
-### Manage Effects (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `emit` | Emitir particulas a partir de `ParticleEmitter` | Pro |
-| `clear` | Limpar todas as particulas | Pro |
-| `toggle` | Ativar ou desativar um efeito | Pro |
-
-### Manage Physics (Pro)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `register_group` | Registrar um grupo de colisao | Pro |
-| `set_collidable` | Definir se dois grupos podem colidir | Pro |
-| `get_groups` | Listar todos os grupos de colisao registrados | Pro |
-
-## Documentos relacionados
-
-- [Instancias e propriedades](instances-and-properties.md) - criar e posicionar objetos
-- [Mundo e ambiente](world-and-environment.md) - iluminacao, terrain e camera
-- [Lista completa de tools](overview.md)

package/docs/pt-br/tools/instances-and-properties.md

@@ -1,104 +0,0 @@
-# Instancias e propriedades
-
-> Busque, crie e edite instancias do Roblox Studio enquanto gerencia propriedades, atributos e tags.
-
-## Tools incluidas
-
-| Tool | Tier | Descricao |
-|------|:----:|-----------|
-| `query_instances` | Misto | Busca instancias, percorre a hierarquia e inspeciona informacoes de classe |
-| `mutate_instances` | Misto | Cria, exclui, clona, move e renomeia instancias |
-| `manage_properties` | Misto | Le e escreve propriedades, atributos e tags |
-
-## Fluxos principais
-
-### Entender a estrutura da cena
-
-```
-"Procure todos os Part dentro de Workspace e me diga a posicao e o tamanho."
-```
-
-Use `query_instances.search_class` para encontrar os Part e `manage_properties.mass_get` para ler `Position` e `Size` em lote.
-
-### Posicionar objetos em lote
-
-```
-"Coloque 4 SpawnLocation em um quadrado no centro do mapa e defina um TeamColor diferente para cada um."
-```
-
-Use `mutate_instances.mass_create` para criar tudo em uma solicitacao e `manage_properties.mass_set` para definir as propriedades.
-
-### Gerenciar por tag
-
-```
-"Encontre todos os objetos com a tag Collectible e mude Anchored para true."
-```
-
-Use `manage_properties.get_tagged` para reunir as instancias e `manage_properties.mass_set` para atualiza-las.
-
-## Referencia de acoes
-
-### 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` | Buscar o primeiro filho por nome e filtro opcional de classe | Basic |
-| `find_descendant` | Buscar o primeiro descendente por nome | Basic |
-| `wait_for_child` | Esperar um filho aparecer (com timeout) | Basic |
-| `class_info` | Obter informacoes de classe e propriedades validas | Basic |
-| `search_name` | Buscar instancias por padrao de nome (com 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 um novo pai | Basic |
-| `rename` | Renomear uma instancia | Basic |
-| `pivot` | Definir posicao de pivot ou CFrame | Basic |
-| `create_tree` | Criar uma arvore hierarquica de instancias | Pro |
-| `mass_create` | Criar varias instancias de uma vez | Pro |
-| `mass_delete` | Excluir varias instancias | Pro |
-| `mass_duplicate` | Duplicar varias instancias | Pro |
-| `smart_duplicate` | Duplicar com espacamento e quantidade | Pro |
-
-### Manage Properties (Misto)
-
-| Acao | Descricao | Tier |
-|------|-----------|------|
-| `get` | Obter o valor de uma propriedade | Basic |
-| `set` | Definir o valor de uma propriedade | Basic |
-| `get_all` | Obter todas as propriedades de uma instancia | Basic |
-| `set_multiple` | Definir varias propriedades de uma vez | Basic |
-| `get_attr` | Obter o valor de um atributo | Basic |
-| `set_attr` | Definir o valor de um atributo | Basic |
-| `get_all_attrs` | Obter todos os atributos | Basic |
-| `delete_attr` | Excluir um atributo | Basic |
-| `add_tag` | Adicionar uma tag a uma instancia | Basic |
-| `remove_tag` | Remover uma tag de uma instancia | Basic |
-| `check_tag` | Verificar se uma instancia possui 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 uma propriedade usando expressao matematica | Pro |
-| `set_relative` | Definir uma propriedade relativa ao valor atual | Pro |
-| `mass_set` | Definir uma propriedade em varias instancias | Pro |
-| `mass_get` | Obter uma propriedade de varias instancias | Pro |
-| `modify_children` | Modificar todos os filhos de um pai | Pro |
-
-## Documentos relacionados
-
-- [Scripts e execucao de codigo](scripting.md) - adicionar ou editar scripts em instancias
-- [Assets e efeitos](assets-and-effects.md) - inserir modelos, tween e efeitos
-- [Lista completa de tools](overview.md)