Seguindo as etapas desta página, você aprenderá a criar, executar, editar e solucionar problemas de um programa em Verse que diz "Hello, world!" no Unreal Editor para Fortnite (UEFN).
Consulte Inicializando o Unreal Editor para Fortnite para saber como acessar o UEFN.
Seu primeiro programa em Verse
O modelo VKT - Jogos iniciais com dispositivo Verse funciona como uma introdução a dispositivos criados com Verse e contém vários dispositivos que você pode usar como exemplos. Nas etapas abaixo, você criará e modificará um novo dispositivo Verse nesse modelo.
Na janela do Navegador de Projetos, selecione Exemplos de funcionalidades para visualizar todos os exemplos de funcionalidades do UEFN.
Na lista de exemplos de funcionalidades, clique em Dispositivo Verse para marcá-lo.
Na parte inferior da tela, em Nome do Projeto, nomeie o projeto como MyVerseProject e clique em Criar.
Na barra de menus, acesse Verse > Explorador Verse.
No Explorador do Verse, clique com o botão direito do mouse no nome do seu projeto e escolha Adicionar novo arquivo Verse ao projeto para abrir a janela Criar código Verse.
Na janela Criar script Verse, clique em Dispositivo Verse para selecioná-lo como seu modelo e clique em Criar.
Na barra de menus, acesse Verse > Compilar Código Verse para garantir que seu dispositivo Verse recém-criado apareça na pasta do projeto.
No Navegador de Conteúdo, navegue até a pasta do seu projeto.
Se o Navegador de Conteúdo ainda não estiver aberto, clique em Janela na barra de menus e selecione Navegador de Conteúdo ou selecione Gaveta de Conteúdo na parte inferior esquerda da janela do UEFN.
O caminho deve ser Tudo > MyVerseProject > hello_world_device.
Clique e arraste hello_world_device até o nível.
Na barra de ferramentas, clique em Iniciar sessão para testar sua ilha.
Clique na imagem para ampliar.
Na janela Salvar conteúdo, clique em Salvar selecionados, para salvar as suas alterações no projeto.
Quando o servidor terminar de carregar o projeto, abra o menu principal e clique em Iniciar jogo.
No cliente, pressione Escape para abrir a tela do menu principal e clique em Configurações da ilha. Em seguida, clique em Log na barra de navegação superior para visualizar o log.
No log, encontre a linha que diz "Hello, world!" que é seguida por "2 + 2 = 4" na próxima linha. Essas linhas são do arquivo hello_world_device.verse. Como você adicionou o dispositivo criado com Verse ao seu nível, seu código foi executado quando você iniciou o jogo.
Agora que você executou o seu primeiro programa em Verse, vamos ver o código em hello_world_device.verse e alterá-lo. Mantenha o cliente em execução para a próxima seção.
Modifique o programa
Siga estas etapas para visualizar o arquivo hello_world_device.verse, que criou o dispositivo da seção anterior, e adicione uma nova linha de código.
Na barra de menus, clique em Verse > Explorador Verse para ver todos os arquivos Verse no seu projeto.
Abaixo do nome do projeto, clique duas vezes em hello_world_device.verse para abrir o arquivo.
O arquivo Verse é aberto no Visual Studio Code (VS Code), um editor para escrever programas. Se você não tiver o Visual Studio Code em seu computador, aparecerá uma mensagem solicitando que você o instale.
Clique na imagem para ampliar.
A extensão de código Verse é uma extensão para VS Code que fornece verificação de erro e marcação da sintaxe Verse, além de também permitir que você compile e envie alterações em seus scripts Verse diretamente do VS Code.
A extensão de Verse combinada com o UEFN é a única extensão de linguagem formalmente suportada para Verse. Essa extensão é habilitada automaticamente quando você inicia o UEFN. Se você desinstalar a extensão, ela será reinstalada quando você iniciar o UEFN novamente.
Você pode verificar a instalação da extensão de código Verse pela presença dos botões Foco do Editor, Compilar alterações em Verse e Enviar alterações em Verse na parte superior da janela do VS Code.
Clique na imagem para ampliar.
Você verá como o resto deste código funciona mais tarde. Por enquanto, qualquer código que você inserir na linha OnBegin<override>()<suspends>:void= será executado quando o jogo começar, portanto, adicione o seguinte código no final do arquivo:
Print("This is my first line of Verse code!")
Seu arquivo Verse agora deve ficar assim:
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }
# See https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse for how to create a verse device.
# A Verse-authored creative device that can be placed in a level
hello_world_device := class(creative_device):
# Runs when the device is started in a running game
Qualquer texto após o símbolo # é considerado um comentário de código e é ignorado pelo computador quando o programa é executado. Comentários de código são úteis para você e para qualquer outra pessoa que esteja lendo o seu código, pois podem conter explicações sobre o seu código. Neste exemplo, # Executa quando o dispositivo é iniciado em um jogo em execução e #PENDENTE: Substitua isto pelo seu código são ambos comentários de código.
Salve suas alterações
Salve o arquivo hello_world_device.verse no Visual Studio Code.
Na barra de ferramentas do UEFN, clique em Verse e, em seguida, clique em Compilar código Verse para compilar seu código.
Clique na imagem para ampliar.
Após a compilação bem-sucedida, uma marca de seleção verde aparecerá sobre o botão Verse. Se ocorrerem problemas durante a compilação, um ícone de parada vermelho aparecerá e você não poderá compilar seu código até resolver todos os erros. Se isso ocorrer, consulte Solução de problemas do seu código para obter dicas sobre como corrigir o código.
Clique na imagem para ampliar.
Quando o código terminar de ser compilado, as opções Enviar alterações e Enviar alterações de Verse serão exibidas na barra de ferramentas do UEFN. Enviar alterações atualiza seu cliente com todas as alterações feitas no editor, como adicionar e remover adereços, modificar propriedades de objetos e quaisquer alterações feitas no código Verse. A opção Enviar alterações de Verse atualiza apenas o código Verse e é mais rápida que Enviar alterações. sendo útil em situações em que você deseja fazer pequenas alterações incrementais no código sem atualizar sua sessão. Clique em Enviar alterações de Verse para atualizar seu cliente.
Clique na imagem para ampliar.
Quando o servidor terminar de atualizar o projeto, abra o menu principal e clique em Iniciar jogo.
No log, localize a linha que diz "Esta é minha primeira linha de código Verse!". Ela está no código que você acabou de adicionar ao script!
Execução sequencial
Quando você adicionou essa linha de código para imprimir texto no log, o texto “Esta é minha primeira linha de código Verse!” foi impresso no log após “2 + 2 = 4”. Ocorre porque essas linhas de código são executadas na ordem em que são escritas na linha OnBegin<override>()<suspends>:void=.
Se você alterar a ordem das linhas de impressão, o texto será impresso no log na nova ordem, com “Esta é minha primeira linha de código Verse!” aparecendo antes de “2 + 2 = 4”:
OnBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 2}")O código geralmente é executado linha por linha, na ordem em que as expressões aparecem. Isso é chamado de execução sequencial. À medida que você aprender mais sobre programação com Verse, você vai saber como moldar o fluxo de execução para alterar o comportamento do seu programa.
Solucione problemas do seu código
Agora que você escreveu e executou sua primeira linha de código Verse, veja como solucionar alguns dos problemas que você pode encontrar ao escrever o código.
Existem dois tipos de erros que você pode encontrar: erros do compilador e bugs.
Erros do compilador
Como acontece com qualquer tipo de escrita, você pode ter erros de digitação em seu código. Esses erros de digitação impedem que o compilador entenda o que você deseja que o programa faça. Eles são chamados de erros do compilador porque impedem a compilação do programa e geralmente são erros de sintaxe. Isso impede que você execute seu código em um teste de jogo.
O Visual Studio Code (VS Code) pode detectar alguns erros do compilador e informá-lo sobre eles alterando a cor do nome do arquivo para vermelho na aba Arquivo e no painel Explorer.
O VS Code também adiciona um rabisco vermelho sob a linha onde detecta um problema. Ao passar o mouse sobre o rabisco, uma mensagem de erro aparecerá com uma possível correção rápida, se houver uma que o VS Code possa fornecer.
O VS Code pode não detectar todos os erros do compilador, portanto, também é uma boa prática criar seu código antes de tentar executá-lo para detectar quaisquer erros no início. Para fazer isso, clique em Verse e em Compilar código Verse na barra de ferramentas do UEFN. Esta opção compila todos os arquivos Verse no projeto, que traduz o código que você escreveu em instruções executáveis por computador.
Clique na imagem para ampliar.
O log de saída mostrará uma mensagem de sucesso se seu código for criado com sucesso ou erros que você precisará corrigir antes de poder usar seu código durante o teste de jogo.
Quando você seleciona Compilar código Verse, uma mensagem de pop-up também aparecerá se houver um erro de compilação.
Selecionar Ver erros na mensagem de pop-up abrirá a janela Log de mensagens e mostrará todos os erros no código que o VS Code foi capaz de detectar.
Clique na imagem para ampliar.
Depois de corrigir os erros, você pode compilar o código novamente e verificar se o código foi compilado com sucesso clicando em Compilar scripts Verse novamente na barra de ferramentas do UEFN ou clicando em Recompilar na mensagem de pop-up.
Bugs
Quando seu código é compilado com sucesso, mas seu programa não está fazendo o que você espera, esses problemas são chamados de bugs. Bugs são problemas com lógica em seu código, e uma maneira de encontrá-los é imprimindo no log.
O código em hello_world_device é um bom exemplo de como a impressão no log é usada para verificar se o código está sendo executado quando você inicia o jogo.
OnBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 2}")Você também pode exibir no Log valores para testar se o seu código está fazendo o que você espera. Quando você executa o código a seguir, o texto “2 + 2 = 4” aparece no log:
Print("2 + 2 = {2 + 2}")
A expressão {2 + 2} foi calculada como 4, antes de o texto ser impresso no log. As chaves {} entre aspas duplas “ ” na última linha significam que a expressão deve ser avaliada antes de ser convertida em texto. Injetar um valor em uma string como essa é um exemplo de interpolação de string.
Se você alterar a expressão entre as chaves, o valor exibido será alterado. No exemplo a seguir, a expressão é alterada para {2 + 3}, então "2 + 2 = 5" aparecerá no log:
nBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 3}")
Próximas etapas
Agora que você teve uma breve introdução à linguagem Verse e a como executar e solucionar problemas do seu código, acesse Aprenda os fundamentos da escrita de código no Verse para ampliar seus conhecimentos de programação em geral e aprenda mais sobre como aproveitar essa ferramenta de programação.
Você também pode jogar o minijogo inicial de dispositivos Verse interagindo com o botão no console quando você surgir. Você pode aprender como este minijogo foi criado lendo o Modelo inicial em Verse e pode conferir os arquivos de código usados neste projeto no Explorador Verse!