Editor de Script

O Editor de Scripts no Studio é o principal tool para scripting no Roblox. É um ambiente de autopróspera que pode ajudá-lo a escrever código de alto impacto, reduzir seu tempo de desenvolvimento e itera em suas experiências. Ele pode melhorar sua experiência de scripting por:

• Formatação e destacação de sintaxe em seu código.
• Oferecendo maneiras de autocompletar frases em seu código enquanto você digitar.
• Ajuda você navegar pelo código saltando para declarações de variáveis e funções.
• Ajuda você encontrar e substituir código em scripts abertos ou todos os scripts.
• Fornecendo 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 Autocompletar

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

• Sugestões informadas sobre como completar frases enquanto você digita-as que são contextuais ao modelo de dados da experiência. Por exemplo, se você tiver um Class.Model em Model chamado 0> RocketShip</

  

  Use as teclas ↑ e ↓ para pesquisar as sugestões, então pressione Tab ou 1> Enter1> para aceitar uma sugestão e inserir a frase completa.

• Preencher nomes automaticamente para variáveis e funções que você declarar, ajudando você a evitar tipos de pesquisa.

  

• Pop-ups de documentação com exemplos de código que são semelhantes aos da API REFERÊNCIA DO MOTOR, dando-lhe contexto sobre o uso da API (Interface de Programação para Aplicações).

  

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

  

• Diagnósticos de script on-ховер com informações que você pode usar para detectar erros.

  

• 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 ao segurar Ctrl em Windows ou ⌘ em Mac ao clicar no chamado, ou clicando com o botão direito em seu chamado e clicando em Ir para a Declaração .

Filter de Função de Script

O Script Filter Function Filter exibe uma lista de todas as funções declaradas em um script. Para abri-lo, pressione AltF no Windows ou 2> ⌥2> 5> F5> no Mac. Com a lista aberta, você pode pesquisar pelas assinaturas para cada função, filtrar por nome e clicar duas vezes em um para跳到其声明。

Encontre e Substitua

O widget Encontrar/Substituir permite que você encontre e substitua o código em um script aberto. O widget suporta correspondência de caso, correspondendo à palavra inteira e pesquisa por expressões regulares. Para abri-lo, pressione CtrlF em Windows ou 2>⌘2> em Mac.

Feedback em Tempo Real

Análise de Script

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

Janela de Saída

A Janela Saída, acessível a partir da guia Vista, exibe erros capturados ao executar scripts, mensagens do motor Roblox, mensagens de chamadas para print() e erros de chamadas para 2> arn()2>. Para detalhes sobre configurá-lo para o seu fluxo de trabalho, veja 5>Saída de Janela5>.

Assistência de Código

Ajuda de Código é uma função que sugiere linhas ou funções de código enquanto você digitar, ajudando você a codificar mais eficientemente e ficar focado. Com base em contextos do 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 o suficiente de contexto para uma sugestão.
• Manualmente com atalho Alt∖ no Windows ou ⌥ 1> ∖ 1> no Mac (você pode 4> personalizar 4> este atalho).

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

Melhorando Sugestões

Para obter sugestões mais precisas e relevantes, recomenda-se que você siga as práticas de codificação limpa, independentemente da ajuda, e:

• Divid seu código em funções menores.
• Use nomes de script descritivos que capturam a intenção geral do que cada script faz. Por exemplo, nomeie um script SincronizarSonsCustomos 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 1> gen1> . Usar funções nomeadas em vez de funções anônimas pode também produzir melhores dicas.
• Inclua consistentemente comentários bem escritos que descrevem a tarefa que você está implementando e o que os insumos/saídas devem ser.

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

Limitações

A ferramenta ajuda a automatizar tarefas de codificação básicas, mas ela não sempre sugiere código perfeito. Limitações conhecidas incluem:

• O gatilho manual não força sempre a geração de uma sugestão.
• As sugestões são aprendidas automaticamente a partir de um corpo de código e, portanto, podem refletir algumas limitações do código em que eles são treinados. Por exemplo, sugestões podem não usar APIs mais recentes em favor de APIs mais antigas, ou elas podem usar Lua em vez de Luau.
• A ferramenta pode gerar informações incorretas ou enganadoras que não são úteis para o seu propósito.
• Os filtros internos tentam bloquear linguagem ofensiva, mas eles não são abrangentes e há uma possibilidade de que a ferramenta gere informações ofensivas ou sesgadas.
• As sugestões podem ser as mesmas, semelhantes ou diferentes entre os usuários, mesmo com as mesmas solicitações. Seu código, no entanto, nunca será compartilhado com outros.
• A sugestão pode estar incompleta devido à limitação de comprimento da saída dos modelos de aprendizagem.
• Existe um limite diário para o número de sugestões e, uma vez que o limite for atingido, você não receberá sugestões até o próximo dia.

Privacidade de Código

Atualmente, o Roblox não usa nenhum dado não público para treinar os modelos de aprendizagem. A ferramenta só usa um pequeno conjunto de recursos do mercado livre para ajustar modelos de grande linguagem e o conjunto tem passado por vários testes de qualidade e segurança.

Além disso, todas as sugestões são geradas por o modelo de IA e não são transferidas de um usuário para outro. Como seu código não é usado para treinamento de modelos, não será recomendado para outros usuários de Ajuda de Código , com a única exceção de código postado para itens de mercado livre.

Multi-Cursor

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

• Edições que você faz na cópia principal do cursor para os cursors secundários. Cada edição conta como uma ação, então desfazer/refazer de uma edição aplica-se a todos os cursors.
• Os widgets, como autocompletar, aparecem no cursor principal, mas não nos cursores secundários.
• Todos os atalhos padrão de teclado para edição de scripts, incluindo a indentação de código, alternância de comentários e exclusão de linhas.

A tabela a seguir resume os fluxos de trabalho de múltiplos e seus atalhos.

Adicionando Cursors

Você pode adicionar cursors com uma combinação de atalhos de teclado e manobras de mouse. Cursors são sincronizados se eles ocuparem o mesmo espaço, como se você adicionar cursors com setas ou excluir todos os personagens entre os cursors.

Na localização do mouse

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

1. Segure Alt em Windows ou ⌥ em Mac.

2. Clique onde você quer adicionar o cursor.

Com Mouse Drag

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

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

1. Segure Alt em Windows ou ⌥ em Mac.

2. Clique e arraste o seu 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 principal:

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

2. Pressione as setas ↑ ou ↓.

Para Coincidir com Seleções

Você pode adicionar cursors a todos os matches de uma seleção ou para o próximo/anterior conferir, e opcionalmente alternar se os matches são sensíveis a maiúsculas e/ou a palavra inteira.

Para adicionar um cursor a todos os matchs de uma parte selecionada:

1. Selecione o código que você deseja pesquisar.

2. Pressione ShiftAltL em Windows ou Shift1> ⌥1> 3> L3> em Mac.

Removendo Cursors

Você pode remover os cursores com as seguintes atalhos de teclado e manobras de mouse. Alternativamente, você pode sair da edição de múltiplos cursores pressionando Esc .

Na localização do mouse

Para remover um cursor:

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

2. Clique no cursor que você deseja remover.

Mais Recente Adicionado

Para remover o cursor mais recentemente adicionado, pressione CtrlU em Windows ou ⌘2> U2> em Mac.

Copiar e Pastar Cursors

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

• Se o número de cursors for o mesmo, então cada cursor copiado cola para cada cursor correspondente.
• Se o número de cursors estiver diferente, então cada cursor no destino recebe todo o paste com cada cursor copiado como uma nova linha.

Formatação de On-Type

Pressionar enter/return vai fazer com que cada cursor seja automaticamente incrementado em relação à linha anterior. Se a linha anterior começar com um bloco incompleto, o formulador vai tentar completá-lo.

Configurações do Editor

Muitas opções de personalização estão acessíveis via Arquivo > Configurações do Studio ( Alt 0> S 0> em Windows; 3>⌥3> 5>S5> em 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 a partir da aba Scripts na barra de ferramentas do Studio sempre que estiver visualizando ou editando um script.