Introdução ao Scripting | Documentação - Central de Criadores Roblox (2024)

Em Introdução ao Roblox Studio, você aprendeu a criar e manipular peças no Roblox Studio. Neste Tutorial, você aprenderá a aplicar um script às peças para fazer uma plataforma aparecer e desaparecer. Você pode usar isso em uma experiência de plataforma para cobrir uma brecha, desafiando os usuários a cronometrar seus saltos com cuidado para chegar ao outro lado.

Configurando a Cena

desligado, você precisa de uma Parte para atuar como a plataforma. Fazer e mover peças deve ser familiar para você a partir de 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 facilmente pular.

Insira uma Parte e renomeie-a para DisappearingPlatform.
Redimensione-o para ser grande o suficiente para um usuário pular.
Mova-o para um local apropriado para que você possa alcançá-lo e pular sobre ele ao testar sua experiência.
Defina a propriedade Anchored para true na janela Properties .

Lembre-se que definir a propriedade Anchored de uma peça para true faz com que ela fique no lugar, não importa o que aconteça. Sua plataforma cai se não estiver ancorada.

Inserindo um Script

O código no Roblox é escrito em uma linguagem chamada Luau que você pode colocar em scripts dentro de vários recipientes no Explorer . Se você colocar um script em uma Part , o Roblox rodará o código do script quando a parte for carregada no jogo.

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 Desaparecer .
Apague o código padrão dentro.

Lembre-se de renomear peças e scripts assim que você as criar para não perder o controle das coisas no Explorer .

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 . Depois que uma variável é criada, ela pode ser usada repetidas vezes. Você pode alterar 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 só será usada no bloco do script onde é declarada. O sinal = é usado para definir o valor da variável. Os nomes das variáveis são normalmente escritos em caixa de camelo . Isso é em minúscula com cada palavra após a primeira sendo capitalizada, justLikeThis .

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


local platform = script.Parent

script.Parent é usado para encontrar o objeto em que o script está localizado. Como você pode ter adivinhado, script se refere ao script que você está escrevendo e o Parent do script é onde ele está localizado.

Função Desaparecer

É hora de fazer a plataforma desaparecer. É sempre melhor agrupar o código para alcançar 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, indica o início da função e nomeia-a como disappear . O código de uma função vai entre a primeira linha e end.

Propriedades da peça

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 peças têm várias propriedades que podem ser usadas aqui. Lembre-se de que você pode ver as propriedades de uma peça se você selecioná-la e olhar para a janela Propriedades .

Uma peça pode ser feita invisível alterando a propriedade Transparency. 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 direto pela peça. Se você configurá-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.

Na função disappear, defina a propriedade CanCollide da plataforma para false .

Na linha a seguindo, defina a propriedade Transparency para 1 .


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

Você pode notar que o Studio automaticamente insere seu código dentro de uma função. Sempre certifique-se de inserir seu código como este, ajuda a indicar onde a função começa e termina, o que torna seu código mais legível.

Chamando a função

Depois de declarar uma função, você pode rodá-la escrevendo seu nome com parênteses ao lado dela. Por exemplo, disappear() rodará a função disappear. Isso é conhecido como chamando uma função.

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


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

Teste o código pressionando o botão Play . Se o seu código funcionar, a plataforma deve ter desaparecido quando o usuário aparecer no jogo.

Função de Aparência

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

Apague a linha disappear() do script.
Declare uma nova função chamada appear .

No corpo da função, defina a propriedade CanCollide para true e a propriedade Transparency para 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 Looping

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

Um loop temporário roda o código dentro dele enquanto a declaração **** após while permanece verdadeira. Este loop específico precisa correr para sempre, então a declaração deve ser true. Crie um while true loop 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

Alternando a Plataforma

No loop temporário, você precisa escrever código para esperar alguns segundos entre o desaparecimento e o reaparecimento da plataforma.

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) .

O que quer que você faça, nunca faça um while true loop sem incluir um task.wait() e não teste seu código antes de colocar um! Se você não esperar, seu jogo irá congelar porque o Studio nunca terá a chance de sair do loop e fazer qualquer outra coisa.

Três segundos é um ponto de partida razoável para o tempo entre cada estado da plataforma.

No loop temporário, chame a função task.wait() com 3 entre parênteses.
Chame a função disappear.
Chame a função task.wait() novamente com 3 entre parênteses.
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 achar 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 uma brecha maior, mas você precisa alterar os tempos de espera em cada script. Caso contrário, as plataformas desaparecerão ao mesmo tempo e os usuários nunca poderã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