Introdução à programação

Na Introdução ao Roblox Studio, você aprendeu como criar e manipular partes no Roblox Studio. Neste tutorial, você aprenderá como aplicar um script às partes para fazer uma plataforma aparecer e desaparecer. Você pode usar isso em uma experiência de plataforma para atravessar um espaço, desafiando os usuários a cronometrar seus saltos com cuidado para chegar do outro lado.

Defina a cena

Primeiro, você precisa de uma Parte para atuar como a plataforma. Criar e mover partes deve ser familiar para você a partir da Introdução ao Roblox Studio. Você não precisa de um mundo complicado além da plataforma — você só precisa de um espaço que seus usuários não podem pular facilmente.

1. Insira uma Parte e renomeie-a para PlataformaDesaparecendo.

2. Redimensione-a para ser grande o suficiente para um usuário pular em cima.

3. Mova-a para um local adequado para que você possa alcançá-la e pular sobre ela ao testar sua experiência.

   

4. Defina a propriedade Anchored como true na janela de Propriedades.

   

Insira um script

O código no Roblox é escrito em uma linguagem chamada Luau, que você pode colocar em scripts dentro de vários contêineres no Explorer. Se você colocar um script sob uma Parte, o Roblox executará o código do script quando a parte for carregada na experiência.

1. Passe o mouse sobre a parte PlataformaDesaparecendo na janela Explorer e clique no botão + para inserir um novo script na plataforma. Renomeie seu novo script como Desaparecer.

   

2. Exclua o código padrão dentro dele.

Primeira variável

É uma boa ideia começar seu script criando uma variável para a plataforma. Uma variável é um nome associado a um valor. Uma vez que uma variável é criada, ela pode ser usada repetidamente. Você pode alterar o valor conforme necessário.

Em Luau, uma variável é criada da seguinte forma: local nomeDaVariavel = valorDaVariavel.

O termo local significa que a variável será usada apenas no bloco do script onde foi declarada. O sinal = é usado para definir o valor da variável. Nomes para variáveis são normalmente escritos em camel case. Isso é minúsculo com cada palavra a seguir a primeira sendo capitalizada, justLikeThis.

Copie o seguinte código para criar uma variável para a plataforma chamada plataforma, onde o valor é script.Parent.

local plataforma = script.Parent

Função desaparecer

É hora de fazer a plataforma desaparecer. É sempre melhor agrupar o código para realizar uma ação específica em uma função. Uma função é um bloco de código nomeado que ajuda a organizar seu código e usá-lo em vários lugares sem escrevê-lo novamente. Crie uma função no script e a chame de desaparecer.

local plataforma = script.Parent

local function desaparecer()

end

A primeira nova linha declara a função — ela indica o início da função e a nomeia como desaparecer. O código para uma função vai entre a primeira linha e end.

Os parênteses são para incluir informações adicionais conforme necessário. Você aprenderá mais sobre passar informações para funções em um curso posterior.

Propriedades da Parte

Quando a plataforma desaparece, ela precisa ficar invisível e os usuários precisam cair através dela — mas você não pode simplesmente destruir a plataforma, pois precisa reaparecer mais tarde.

As partes têm várias propriedades que podem ser usadas aqui. Lembre-se de que você pode ver as propriedades de uma parte se a selecionar e olhar na janela de Propriedades.

Uma parte pode ser tornada invisível alterando a propriedade Transparência. A transparência pode ser um valor entre 0 e 1, onde 1 é totalmente transparente e, portanto, invisível.

A propriedade CanCollide determina se outras partes (e usuários) podem passar diretamente pela parte. Se você defini-la como false, os usuários cairão pela plataforma.

Assim como script.Parent, as propriedades são acessadas usando um ponto. Os valores são atribuídos usando um sinal de igual.

1. Na função desaparecer, defina a propriedade CanCollide da plataforma como false.

2. Na linha seguinte, defina a propriedade Transparency como 1.

   local plataforma = script.Parent
   
   local function desaparecer()
       plataforma.CanCollide = false
       plataforma.Transparency = 1
   end

Chame a função

Uma vez que você declarou uma função, pode executá-la escrevendo seu nome com parênteses ao lado. Por exemplo, desaparecer() executará a função desaparecer. Isso é conhecido como chamar uma função.

1. Chame a função desaparecer ao final do script.

   local plataforma = script.Parent
   
   local function desaparecer()
       plataforma.CanCollide = false
       plataforma.Transparency = 1
   end
   
   desaparecer()

2. Inicie um playtest. Se seu código funcionar, a plataforma deve ter desaparecido quando o usuário nasceu.

Função aparecer

Você pode facilmente fazer a plataforma reaparecer escrevendo uma função que faz exatamente o oposto da função desaparecer.

1. Exclua a linha desaparecer() do script.

2. Declare uma nova função chamada aparecer.

3. No corpo da função, defina a propriedade CanCollide como true e a propriedade Transparency como 0.

   local plataforma = script.Parent
   
   local function desaparecer()
       plataforma.CanCollide = false
       plataforma.Transparency = 1
   end
   
   local function aparecer()
       plataforma.CanCollide = true
       plataforma.Transparency = 0
   end

Loop de código

A plataforma deve estar constantemente desaparecendo e reaparecendo, com alguns segundos entre cada mudança. É impossível escrever um número infinito de chamadas de função — felizmente, com um loop while, você não precisa.

Um loop while executa o código dentro dele enquanto a declaração após while permanecer verdadeira. Este loop particular precisa rodar para sempre, então a declaração deve ser simplesmente true. Crie um loop while true no final do seu script.

local plataforma = script.Parent

local function desaparecer()
    plataforma.CanCollide = false
    plataforma.Transparency = 1
end

local function aparecer()
    plataforma.CanCollide = true
    plataforma.Transparency = 0
end

while true do

end

Alternar a plataforma

No loop while, você precisa escrever código para esperar alguns segundos entre a plataforma desaparecer e reaparecer.

A função embutida task.wait() pode ser usada para isso. Nos parênteses, o número de segundos para esperar é necessário: por exemplo, task.wait(3).

Três segundos é um ponto de partida sensato para a duração entre cada estado da plataforma.

1. No loop while, chame a função task.wait() com 3 nos parênteses.
2. Chame a função desaparecer.
3. Chame a função task.wait() novamente com 3 nos parênteses.
4. Chame a função aparecer.

while true do
   task.wait(3)
   desaparecer()
   task.wait(3)
   aparecer()
end

O código para a plataforma agora está completo! Teste seu código agora e você deverá descobrir que a plataforma desaparece após três segundos e reaparece três segundos depois em um loop.

Você poderia duplicar esta plataforma para cobrir um espaço maior, mas precisará alterar os tempos de espera em cada script. Caso contrário, as plataformas vão desaparecer todas ao mesmo tempo e os usuários nunca poderão cruzar.

Código final

local plataforma = script.Parent

local function desaparecer()
    plataforma.CanCollide = false
    plataforma.Transparency = 1
end

local function aparecer()
    plataforma.CanCollide = true
    plataforma.Transparency = 0
end

while true do
   task.wait(3)
   desaparecer()
   task.wait(3)
   aparecer()
end