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 um jogo de plataforma para atravessar um espaço, desafiando os usuários a temporizar seus saltos cuidadosamente para chegar ao outro lado.

Defina a cena

Primeiro, você precisa de uma Parte para agir 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 consigam pular facilmente.

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

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

3. Mova-a para um local apropriado para que você possa alcançá-la e pular sobre ela ao testar seu jogo.

   

4. Defina a propriedade Anchored como true na janela Properties.

   

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 no jogo.

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

   

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

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 mudar o valor conforme necessário.

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

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 de variáveis são tipicamente escritos em camel case. Isso é minúsculo, com cada palavra após a primeira sendo capitalizada, justLikeThis.

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

local platform = 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 você a organizar seu código e usá-lo em vários lugares sem escrevê-lo novamente. Crie uma função no script e chame-a de disappear.

local platform = script.Parent

local function disappear()

end

A primeira nova linha declara a função — ela indica o início da função e a nomeia como disappear. 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 como passar informações para funções em um curso posterior.

Propriedades da parte

Quando a plataforma desaparece, ela precisa ser invisível e os usuários precisam cair através dela — mas você não pode simplesmente destruir a plataforma, pois ela 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 selecioná-la e olhar na janela Properties.

Uma parte pode ser tornada invisível alterando a propriedade Transparency. 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ê definir como false, os usuários cairão através da 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 disappear, defina a propriedade CanCollide da plataforma como false.

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

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.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, disappear() executará a função disappear. Isso é conhecido como chamar uma função.

1. Chame a função disappear no final do script.

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.Transparency = 1
   end
   
   disappear()

2. Inicie um teste de jogo. Se seu código funcionar, a plataforma deve ter desaparecido quando o usuário aparecer.

Função aparecer

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

1. Exclua a linha disappear() do script.

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

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

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.Transparency = 1
   end
   
   local function appear()
       platform.CanCollide = true
       platform.Transparency = 0
   end

Código de loop

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 em particular precisa rodar para sempre, então a declaração deve ser apenas true. Crie um loop while true no final do seu script.

local platform = script.Parent

local function disappear()
    platform.CanCollide = false
    platform.Transparency = 1
end

local function appear()
    platform.CanCollide = true
    platform.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 desaparecendo e reaparecendo.

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

Três segundos é um ponto de partida sensato para o tempo 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 disappear.
3. Chame a função task.wait() novamente com 3 nos parênteses.
4. Chame a função appear.

while true do
   task.wait(3)
   disappear()
   task.wait(3)
   appear()
end

O código para a plataforma agora está completo! Teste seu código agora e você deve 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 precisaria mudar os tempos de espera em cada script. Caso contrário, as plataformas desaparecerão todas ao mesmo tempo e os usuários nunca conseguirão atravessar.

Código final

local platform = script.Parent

local function disappear()
    platform.CanCollide = false
    platform.Transparency = 1
end

local function appear()
    platform.CanCollide = true
    platform.Transparency = 0
end

while true do
   task.wait(3)
   disappear()
   task.wait(3)
   appear()
end