Editor de script

O editor de scripts no Studio é a principal ferramenta para criação de scripts na Roblox. É um ambiente que ajuda você a escrever código de alto impacto, reduzir o tempo de desenvolvimento e iterar suas experiências. Ele pode melhorar sua experiência de criação de scripts com os seguintes recursos:

• Formatação e destaque da sintaxe no seu código.
• Oferecendo formas autocompletar frases no seu código conforme você digita.
• Ajuda ao navegar pelo código pulando para declarações de variáveis e funções.
• Ajudando você a encontrar e substituir o código em scripts abertos ou em todos eles.
• Fornecendo feedback em tempo real sobre a qualidade e o desempenho do seu código.

O Editor de Script 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 do Explorador.

Preenchimento automático

O editor de scripts gera informações relacionadas ao código que podem melhorar a eficiência da sua programação.

• Autocompletar oferece sugestões de como completar as frases à medida que você as digita. Use as teclas de setas para cima e para baixo para navegar pelas sugestões e, em seguida, pressione Tab ou Enter para aceitar uma sugestão e insira a frase completa.

  

• Autocompletar está ligado ao modelo de dados da experiência. Se você tiver um Class. Part em Class. Workspace chamado CoolRocketShip, o preenchimento automático sugere CoolRocketShip quando você digita workspace.cool e indica que se trata de um `Class.

• 

• O preenchimento automático também oferece nomes para variáveis e funções que você declara, facilitando a prevenção de erros de digitação e a reutilização do código.

• 

• O pop-up de preenchimento automático fornece documentação e exemplos de código semelhantes aos da Referência da API de motor, fornecendo contexto sobre o uso de uma API.

• 

• Quando você digita um argumento em uma função, o pop-up de preenchimento automático também mostra a assinatura da função, o que fornece uma referência para seus parâmetros e valores de retorno.

• 

Navegação no código

Ir para Declaração

Você pode ir para a declaração de uma função ou variável clicando com o botão direito em Ir para Declaração. Também é possível ir para uma declaração pressionando Ctrl no Windows ou ⌘ no macOS ao clicar na chamada.

Filtro de funções de script

O Filtro de Funções de Script exibe uma lista de funções declaradas em um script. Para abri-lo, cliquei com o botão direito em qualquer lugar do editor e, em seguida, clique em Filtro de Funções de Script. Quando abrir a lista, navegue pelas assinaturas de cada função, filtre-as por nome e clique duas vezes em uma delas para mostrar a declaração correspondente.

Encontrar e substituir

O widget Encontrar e substituir permite que você encontre e substitua o código em um script aberto. O widget suporta diferenciação de minúsculas e maiúsculas, palavras inteiras e expressões regulares. Para abrir o widget Encontrar e substituir, pressione Ctrl + F no Windows ou ⌘ + F no macOS.

Feedback em tempo real

Análise de Scripts

A janela Análise de Scripts, disponível a partir da aba Visualizar, faz uma análise estática dos seus scripts e mostra os erros e avisos ativos. Para mais informações sobre como configurá-la no seu fluxo de trabalho, consulte Saída.

Janela de saída

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

Assistência de Código

A Assistência de Código é um assistente de IA que sugere linhas ou funções de código enquanto você digita, ajudando você a codificar de forma mais eficiente e manter o foco. Com base nos contextos do seu comentário e código, as sugestões serão acionadas de duas maneiras:

• Ocorre automaticamente quando você para em uma linha por alguns segundos e o modelo de IA tem contexto suficiente para uma sugestão.
• Ocorre manualmente com o atalho Alt + Barra invertida no Windows ou ⌥ + Barra invertida no MacOS (você pode personalizar este atalho).

Pressione Tab para aceitar uma sugestão e para ignorá-la continue digitando. Atualmente, seu script precisa conter pelo menos algumas linhas de código para acionar uma sugestão.

Melhorando Sugestões

Para ter sugestões mais precisas e relevantes, recomenda-se que você siga práticas de código, independentemente da assistência da IA:

• Divida seu código em funções menores.
• Use nomes de scripts descritivos que capturam a intenção geral do que cada script faz. Por exemplo, nomeie um script SyncCustomSounds em vez de apenas Sounds.
• Dê nomes descritivos para parâmetros, funções e scripts. Por exemplo, nomeie um trecho do código como GreenSphere em vez de simplesmente grs, ou nomeie uma função generateSphere() em vez de gen(). Usar funções nomeadas em vez de funções anônimas também pode produzir dicas melhores.
• Inclua consistentemente comentários bem escritos que descrevem a tarefa que você está implementando e quais as entradas/saídas devem ser.

  • Considere incluir algumas chamadas de exemplo com resultados esperados nos comentários.
  • Sugira como resolver um problema, por exemplo -- Use raycast.
  • Use a variável ou função exata que você definiu, por exemplo -- Create 10 greenSphere objects em vez de -- Create 10 spheres.
• Se for um programador iniciante, comece com projetos básicos como "fazer o jogador pular quando tocar em algum lugar" ou use a ferramenta para gerar snippets de código e expandi-los à medida que aprende mais.

Limitações

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

• O acionamento manual nem sempre gera uma sugestão.
• As sugestões são aprendidas por meio de machine learning que usa um corpus de código e, portanto, podem refletir algumas limitações do código usado para o treinamento. Por exemplo, as sugestões não podem usar APIs mais recentes em favor de APIs mais antigas, ou podem usar o Lua em vez de Luau.
• A ferramenta pode gerar informações incorretas ou enganosas que não são úteis para sua finalidade.
• Os filtros internos tentam bloquear linguagem ofensiva, mas não englobam todos os casos e há chance de a ferramenta gerar informações ofensivas ou tendenciosas.
• As sugestões podem ser iguais, similares ou diferentes entre usuários, mesmo usando os mesmos prompts. Seu código, no entanto, nunca será compartilhado com outras pessoas.
• A sugestão talvez esteja incompleta devido ao tamanho limitado de resultados dos modelos de aprendizagem.
• Há um limite diário para o número de sugestões e, uma vez que o limite é atingido, você não recebe mais sugestões até o dia seguinte.

Privacidade do código

Atualmente, a Roblox não usa dados não públicos para treinar os modelos de aprendizagem. A ferramenta usa apenas um pequeno subconjunto de ativos gratuitos do mercado para ajustar os modelos, e o subconjunto passou por várias verificações com 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 seu código não é usado para o treinamento de modelos, ele não será sugerido para outros usuários da Assistência de Código, com a exceção do código que é postado em itens gratuitos do mercado.

Vários cursores

O editor de scripts oferece suporte ao uso de vários cursores para fazer edições simultaneamente. Você pode adicionar cursores com base nas suas necessidades com um clique do mouse ou atalho do teclado. O cursor inicial é chamado de cursor primário e os outros são chamados de cursores secundários.

• As edições do cursor primário são copiadas para os secundários. Se você desfizer ou refizer uma edição enquanto usa a edição com vários cursores, o efeito se aplicará a todos os cursores.
• Os widgets como o Preenchimento automático aparecem no cursor principal mas não nos secondários.
• Os atalhos de teclado padrão para edição no editor de scripts, como indentação de código, alternação de comentários e exclusão de linhas, funcionam com a edição de vários cursores.

A tabela a seguir sumariza fluxos de trabalho multi-cursor e seus atalhos.

Adicionando Cursores

É possível remover cursores com uma combinação de atalhos de teclado e movimentos do mouse. Para remover todos os cursores secundários e sair da edição de vários cursores, pressione Esc ou clique em qualquer lugar no editor de scripts.

Na localização do mouse

Para adicionar um cursor na posição do mouse:

1. Pressione e segure Alt no Windows ou ⌥ no macOS.
2. Clique no editor de scripts onde você deseja adicionar o cursor.

Com o arrastar do mouse

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

Arrastar para selecionar

Para adicionar um cursor a uma seleção de texto:

1. Pressione e segure Alt no Windows ou ⌥ no macOS.
2. Clique e arraste o mouse sobre a seleção do texto.

Para selecionar o final de linhas e final de seleções

Para adicionar cursores ao final de cada linha em uma seleção de várias linhas e ao final da seleção:

Seleção de coluna/bloco

Para selecionar colunas e blocos de código ou espaço em branco, arraste o mouse enquanto pressiona ShiftAlt no Windows ou Shift⌥ no MacOS. Todas linha com um cursor são destacadas.

Acima e abaixo do cursor principal

Para adicionar um cursor diretamente acima ou abaixo do principal:

1. Pressione e segure Ctrl + Alt no Windows ou ⌘ + ⌥ no macOS.
2. Pressione as setas para cima e para baixo.

Para todas as seleções correspondentes

Você pode adicionar cursores para todas as correspondências de uma seleção ou para a próxima/anterior correspondência, e, opcionalmente, alterne se as correspondências diferenciam maiúsculas de minúsculas e/ou combinam com a palavra completa.

Recolher tudo

Para adicionar um cursor a todas as seleções correspondentes:

1. Selecione o código pelo qual deseja procurar correspondências.
2. Pressione Shift + Alt + L no Windows ou Shift + ⌥ + L no macOS.

Correspondência Próxima/Anterior

Para adicionar um cursor na próxima seleção correspondente:

1. Selecione o código pelo qual deseja procurar correspondências.
2. Pressione Ctrl + D no Windows ou ⌘ + D no macOS.
3. Continue pressionando Ctrl/⌘ + D até que você tenha selecionado todas as próximas correspondências desejadas.

Não há atalho padrão para adicionar um cursor à seleção correspondente anterior, mas você pode adicionar o seu próprio:

1. Também é possível criar um atalho abrindo a janela Personalizar atalhos em Arquivo > Avançado > Personalizar atalhos e editando o atalho para "Selecionar ocorrência anterior".

2. Na janela de atalhos, encontre Selecionar evento anterior.

   

3. A ocorrência anterior é selecionada e tem um segundo cursor.

   

4. Confirme sua configuração clicando OK no canto inferior direito da janela.

Correspondência de maiúscula/minúscula ou palavra inteira

Para cada um dos Fluxos de trabalho relacionados a correspondências acima, você pode corresponder a caixa e/ou palavra inteira da seguinte forma:

1. Abra a janela de abertura rápida com Ctrl + P no Windows ou ⌘ + P no macOS.

2. Use os botões de alternância para escolher se uma seleção correspondente diferencia maiúsculas de minúsculas e/ou combine apenas com a palavra inteira.

   

Removendo Cursores

Você pode remover 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 macOS.
2. Clique no cursor que deseja remover.

Adicionado mais recentemente

Para remover o cursor adicionado mais recentemente, pressione Ctrl + U no Windows ou ⌥ + U no macOS.

Copiando e colando cursores

Copiar uma seleção de texto inclui os cursores presentes nela. Colar depende do número de cursores na origem e o número de cursores no destino:

• Se o número de cursores for o mesmo, cada cursor copiado será colado em cada cursor de destino correspondente.
• Se o número de cursores for diferente, cada cursor no destino recebe a colagem completa com cada cursor copiado como uma nova linha.

Ir para Declaração

Pressionar enter/return irá indentar automaticamente cada cursor na nova linha em relação a a linha anterior. Se a linha anterior começar com um bloco incompleto, o formatador tentará completá-lo.

Atalhos de teclado

O editor de scripts tem os seguintes atalhos de teclado. Você também pode acessar muitos comandos clicando com o botão direito em qualquer lugar do editor.