Editor de scripts

O editor de scripts no Studio é a ferramenta principal para scriptar no Roblox.É um ambiente de autoaperfeiçoamento que pode ajudá-lo a escrever código de alto impacto, reduzir o tempo de desenvolvimento e iterar sobre suas experiências.Ele pode melhorar sua experiência de scripting por:

• Formatar e destacar a síntese na sua código.
• Oferecendo maneiras de autocompletar frases em seu código enquanto você digitar.
• Ajudando você a navegar por código saltando para declarações de variáveis e funções.
• Ajudando você a encontrar e substituir código em aberto ou todos os scripts.
• Fornecer feedback em tempo real sobre a qualidade e performancedo seu código.

O Editor de Scripts suporta todos os tipos de scripts e abre automaticamente quando você cria um novo script ou clica duas vezes em um script existente na janela Explorer.

Recursos de preenchimento automático

Os recursos de preenchimento automático do Editor de Script geram informações relacionadas a códigos que podem melhorar a eficiência de sua programação, como:

• Sugestões informadas sobre como completar frases enquanto as digita que são contextuais ao modelo de dados da experiência .Por exemplo, se você tiver um Model em Workspace chamado RocketShip , a autocompletar sugere RocketShip quando você digita workspace.roc e indica que é um Model .

  

  Use as teclas ↑ e ↓ para navegar pelas sugestões, então pressione Tab ou Enter para aceitar uma sugestão e inserir a frase completa.

• Preencha automaticamente nomes para variáveis e funções que você declarar, ajudando-o a evitar digitações problemáticas.

  

• Pop-ups de documentação com amostras de código semelhantes às da Referência da API do Motor, dando-lhe contexto sobre o uso da API (Interface de Programação para Aplicações).

  

• Dicas de ferramentas em destaque que você pode personalizar com sua própria documentação definida.

  

• Diagnósticos de análise de script em destaque com informações que você pode usar para solucionar problemas.

  

• Assinaturas de função quando você digita um argumento, fornecendo uma referência para seus parâmetros e valores de retorno.

  

Navegação de código

Ir para a declaração

Você pode pular para a declaração de uma função ou variável segurando Ctrl no Windows ou ⌘ no Mac ao clicar na chamada, ou clicando com o botão direito na chamada dela e clicando em Ir para a Declaração .

filtrode função de script

O Filtro de Função de Script exibe uma lista de todas as funções declaradas em um script.Para abrí-lo, pressione AltF on Windows ou ⌥F on Mac.Com a lista aberta, você pode navegar pelas assinaturas para cada função, filtrá-las por nome e clicar duas vezes em uma para saltar para sua declaração.

Encontrar e substituir

O widget Pesquisar/Substituir permite que você encontre e substitua código em um script aberto.O widget suporta caso de correspondência, correspondendo a toda a palavra e buscando por expressões regulares.Para abrí-lo, pressione CtrlF on Windows ou ⌘F on Mac.

Feedback em tempo comentário/retorno

Análise de Scripts

A janela Análise de Script , acessível a partir da aba Ver, realiza análise estática em seus scripts e exibe erros e avisos ativos.Para mais informações sobre os erros e avisos, consulte a documentação Luau linting.

Produção

A janela Saída , acessível a partir da aba Ver, exibe erros capturados ao executar scripts, mensagens do Roblox Engine, mensagens de chamadas para print() e erros de chamadas para warn().Para detalhes sobre como configurá-lo para o seu fluxo de trabalho, veja Saída.

Assistência de Código

Assistência de Código é uma característica que sugere linhas ou funções de código enquanto você digitar, ajudando você a codificar mais eficientemente e permanecer focado.Com base nos contextos de seu comentário e código, sugestões serão acionadas de duas maneiras:

• Automaticamente quando você pausa em uma linha por alguns segundos e o modelo de IA tem contexto suficiente para uma sugestão.
• Manualmente com atalho Alt∖ em Windows ou ⌥∖ em Mac (você pode personalizar esse atalho).

Pressione Tab para aceitar uma sugestão, ou ignore-a continuando a digitar.Atualmente, seu script precisa conter pelo menos algumas linhas de código para disparar uma sugestão.

Melhorar sugestões

Para obter sugestões mais precisas e relevantes, é recomendado que você siga práticas de codificação limpa, independentemente de ajuda, e:

• Quebre seu código em funções menores.
• Use nomes de scripts descritivos que capturem a intenção geral do que cada script faz.Por exemplo, nomeie um script SyncCustomSounds em vez de apenas Sons .
• Atribua nomes descritivos para parâmetros, funções e scripts.Por exemplo, nomeie uma parte GreenSphere em vez de simplesmente grs , ou nomeie uma função generateSphere() em vez de gen().Usar funções nomeadas versus funções anônimas também pode produzir dicas melhores.
• Consistentemente inclua comentários bem escritos que descrevam a tarefa que você está implementando e quais devem ser os inputs/outputs.

  • Considere incluir algumas chamadas de amostra com resultados esperados em comentários.
  • Sugira como resolver um problema, por exemplo -- Use raycast .
  • Use a função ou o nome da variável exato que você definiu, por exemplo -- Create 10 greenSphere objects em vez de -- Create 10 spheres.
• Se você é um programador novato, comece com projetos básicos como "fazer o jogador pular quando tocar na peça" ou use a ferramenta para gerar pequenos trechos de código que você pode expandir à medida que seu conhecimento cresce.

Limitações

A ferramenta ajuda a automatizar tarefas de codificação básicas, mas nem sempre sugere código perfeito. As limitações conhecidas incluem:

• A ativação manual não gera sempre uma sugestão de forma forçada.
• Sugestões são aprendidas por máquina a partir de um corpus de código e, portanto, podem refletir algumas limitações do código em que são treinadas.Por exemplo, sugestões podem não usar novas APIs em favor de APIs mais antigas ou podem usar Lua em vez de Luau.
• A ferramenta pode gerar informações incorretas ou enganosas que não são úteis para o seu propósito.
• Os filtros internos tentam bloquear o idioma ofensivo, mas eles não são abrangentes e há uma possibilidade de a ferramenta gerar informações ofensivas ou parciais.
• As sugestões podem ser as mesmas, semelhantes ou diferentes entre os usuários, mesmo com os mesmos prompts. Seu código, no entanto, nunca será compartilhado com outros.
• A sugestão pode estar incompleta devido à limitada duração da saída dos modelos de aprendizagem.
• Há um limite diário para o número de sugestões e, uma vez atingido o limite, você não receberá sugestões até o dia seguinte.

privacidadedo código

Atualmente, o Roblox não usa nenhum dado não público para treinar os modelos de aprendizagem.A ferramenta usa apenas um pequeno subconjunto de recursos do mercado livre para ajustar grandes modelos de linguagem e o subconjunto passou por várias verificações para filtros de qualidade e segurança.

Além disso, todas as sugestões são geradas pelo modelo de IA e não são transferidas de um usuário para outro.Como o seu código não é usado para treinamento de modelo, não será sugerido a outros usuários do Assistência de Código , com a única exceção de código sendo postado em itens de mercado livre gratuitos.

Multi-currículo

O Editor de Scripts suporta o uso de vários cursores para fazer edições simultaneamente.Você pode adicionar cursores com base em suas necessidades com um clique do mouse ou atalho de teclado.O cursor inicial é chamado de cursor primário e os cursores adicionais são chamados de cursores secundários .

• Edições que você faz na cópia do cursor primário para os cursores secundários.Cada edição conta como uma ação, então desfazer/refazer uma edição se aplica a todos os cursores.
• Widgets como autocompletar aparecem no cursor primário, mas não nos cursores secundários.
• Todos os atalhos de teclado padrão para edição de scripts funcionam com edição de vários cursores, incluindo indenção de código, ativação de comentários e exclusão de linhas.

A tabela a seguir resume os fluxos de trabalho multicurso e seus atalhos.

Adicionar cursores

Você pode adicionar cursores com uma combinação de atalhos de teclado e manobras de mouse.Os cursores se mesclam se ocuparem o mesmo espaço, como se você adicionar cursores com teclas de seta ou excluir todos os caracteres entre os cursores.

Na localização do mouse

Para adicionar um cursor na localização do ponteiro do mouse:

1. Segure Alt em Windows ou ⌥ em Mac.

2. Clique onde você deseja adicionar o cursor.

Com arrastamento do mouse

Você pode arrastar o mouse para adicionar um cursor a uma seleção, dividir uma seleção multilinha em linhas ou selecionar colunas e blocos de código/ espaço em branco.

Para adicionar um cursor a uma seleção de código através de arrastamento:

1. Segure Alt em Windows ou ⌥ em Mac.

2. Clique e arraste o mouse sobre a seleção de código.

Acima e abaixo do cursor primário

Para adicionar um cursor diretamente acima ou abaixo do cursor primário:

1. Pressione e segure CtrlAlt on Windows ou ⌘⌥ on Mac.

2. Pressione as setas ↑ ou ↓.

Para correspondências de seleções

Você pode adicionar cursores a todas as partidas de uma seleção ou para a próxima/anterior conferir, e opcionalmente ativar se as partidas são sensíveis a maiúsculas e/ou correspondem a toda a palavra.

Para adicionar um cursor a todas as correspondências de uma parte selecionada:

1. Selecione o código que você deseja procurar por correspondências.

2. Pressione ShiftAltL on Windows ou Shift⌥L on Mac.

Remover cursores

Você pode remover os cursores com os seguintes atalhos de teclado e manobras de mouse.Alternativamente, você pode sair da edição de vários cursores pressionando Esc .

Na localização do mouse

Para remover um cursor:

1. Pressione e segure Alt no Windows ou ⌥ no Mac.

2. Clique no cursor que você deseja remover.

Mais recentemente adicionado

Para remover o cursor mais recentemente adicionado, pressione CtrlU on Windows ou ⌘U on Mac.

Copiar e colar cursores

Copiar uma seleção de código inclui os cursores dentro dela.O comportamento da colagem depende do número de cursores na fonte e do número de cursores no destino:

• Se o número de cursores for o mesmo, então cada cursor copiado é colado em cada cursor de destino correspondente.
• Se o número de cursores for diferente, então cada cursor no destino recebe toda a pasta com cada cursor copiado como uma nova linha.

Formatação em tipo on-line

Pressionar Enter/Return vai automaticamente indentar cada cursor na nova linha em relação à linha anterior.Se a linha anterior começar com um bloco incompleto, o formataador tentará concluí-la.

Configurações do editor

Muitas opções de personalização são acessíveis via Arquivo ⟩ Configurações do Studio ( AltS na Windows; ⌥S na Mac).

Opções comumente modificadas incluem:

Atalhos de teclado

O Editor de Scripts tem os seguintes atalhos de teclado.Você também pode acessar muitos comandos da aba Script que aparece na barra de ferramentas do Studio sempre que você estiver visualizando ou editando um script.