Guia de Scripts

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

A aba Script contém ferramentas para escrever e testar scripts. Você só pode acessar esta aba quando estiver visualizando ou editando um script.

Script tab indicated in Studio toolbar

A seção Navegar permite que você rapidamente pule entre qualquer script aberto.

AçãoAtalhoDescrição
Voltar (Windows) (Mac)Navega para o script aberto anterior.
Avançar (Windows) (Mac)Navega para o próximo script aberto.

Editar

A seção Editar permite que você pesquise e edite qualquer parte do script, bem como selecione instâncias dentro da janela Explorer para ações em massa.Veja Atalhos do Studio para atalhos padrão vinculados a essas ações.

Edit tools indicated in Script tab
AçãoDescrição
Encontrar

Abre um menu pop-up com as seguintes ferramentas:

  • Encontrar — Localiza todas as instâncias de sua entrada no script.:
  • Encontrar Próximo — Localiza a próxima partida encontrada no widget "Encontrar".:
  • Encontrar Anterior — Localiza a partida anterior encontrada no widget "Encontrar.":
  • Encontrar Todos — Localiza todas as instâncias de sua entrada dentro de um local, mesmo fora do script atualmente selecionado.:
  • Ir para a Linha — Navega para uma linha específica dentro do script.:
  • Abrir Rápido — Procura todas as instâncias na janela do Explorer.:
  • Ações de Abertura Rápida — Procura todas as ações do Studio.:
  • Filtro de Função de Script Aberto — Procura todas as funções dentro do script ativo e seus scripts de módulo necessários.
Substituir Permite que você substitua uma (ou todas / todos) partidas em um script por uma nova string / cadeia / texto.
Selecione

Abre um menu pop-up com as seguintes ferramentas:

  • Selecionar Todos — Seleciona todo o conteúdo de um script.:
  • Selecionar Crianças — Seleciona todos os descendentes de uma instância selecionada na janela do Explorer.

Padrão

A seção Formato permite que você formate seções ou a totalidade do script para legibilidade.O menu suspenso permite que você selecione Seleção de Formato ou Formulário de Formato .

Format options indicated in Script tab
AçãoAtalhoDescrição
Seleção de Formato (Windows) (Mac)Formata a porção atualmente selecionada do script com o layout e indenção apropriados.
FormatarDocumento Formata todo o script independentemente da seleção atual.

Pausar e retomar scripts

Durante o teste do jogo, os botões Pausar Scripts e Resumir Scripts são úteis para pausar tanto os scripts quanto o renderimento, sem pausar a física.

Pause Scripts and Resume Scripts buttons available during playtesting in Studio.

Ferramentas de depuração

A seção Depurador deixa você controlar o depurador.

Debugging tools indicated in Script tab
AçãoAtalhoDescrição
Entre em F11Mova o depurador para a função na linha atual. Se não houver função na linha atual, o depurador se move para a próxima linha.
Passar por cima F10Mova o depurador para a próxima linha de código, sem se mover para funções.
Passo Fora ShiftF11Mova o depurador para fora da função atual e para a próxima linha de código após a função ter sido inicialmente chamada.Se a linha atual não estiver dentro de uma função, o depurador se move para a próxima linha.

Você pode optar por tratar erros de script como pontos de interrupção improvisados.

AçãoDescrição
Nunca Desabilita a depuração de script improvisada.
Em todas as exceções Marca todos os erros, mesmo aqueles que ocorrem dentro do pcall.
Sobre exceções não tratadas Apenas sinaliza erros que ocorrem no modo não protegido; o depurador ignora erros que ocorrem dentro de pcall.

Outras ações

A seção Ações mais à direita contém ações de script miscelâneas.

AçãoAtalhoDescrição
Vá para Erro de Script Navega o cursor para a primeira instância de um erro dentro do seu script.
Reiniciar script CtrlR (Windows) R (Mac)Aplica quaisquer alterações que tenham sido feitas em um script para o teste de jogo ativo.As alterações não são salvas no script fora do teste de jogo a menos que suas configurações do Studio estejam definidas para salvar automaticamente as alterações no script de tempo de execução ou você confirme para salvar as alterações após interromper o teste de jogo.Essa ação só está disponível durante o teste de jogo.
Cometer Envia quaisquer alterações no script para que o script atualizado esteja disponível para outros desenvolvedores dentro da sua Equipe.Essa ação só está disponível durante sessões colaborativas.
Alternar Comentário Ctrl/ (Windows) / (Mac)Alterna se uma linha de script é um comentário ou não.
Expandir todas as dobras CtrlE (Windows) E (Mac)Expande todas as dobras colapsadas no script.
Dobre todos os itens de colapso (Windows) (Mac)Colapsa todas as seções dobradiças do script.