Habilidades

Habilidades na Biblioteca de Controladores de Personagem (CCL) avaliam o que um personagem pode fazer, como a capacidade de correr, pular, escalar e nadar. Em vez de depender de estados rígidos de personagem definidos pelo mecanismo, como aqueles em Enum.HumanoidStateType, a CCL permite uma composição de comportamentos flexíveis, como um personagem ser capaz de se mover enquanto também mira e se agacha.

Habilitar CCL

O CCL é opcional através da janela de Configurações de Avatar do Studio. Para habilitá-lo:

1. Na aba Avatar, abra as Configurações de Avatar.

   

2. Selecione a aba Movimentação no lado esquerdo da janela e, na seção Habilidades, selecione Biblioteca de Controladores de Personagens.

   

3. Todas as habilidades padrão como Correr, Pular e Escalar estão habilitadas por padrão. Para desabilitar qualquer uma delas em tempo de execução, desmarque a caixa associada.

   Não é recomendado desabilitar Correr, pois isso impedirá que os personagens se movam no chão. Além disso, você deve sempre manter Levantar-se habilitado se Cair estiver habilitado, pois uma incompatibilidade permitirá que os personagens caiam (tropecem) mas nunca se levantem.

Configuração

Enquanto seu jogo está em execução (ou através de um script que roda a partir de ServerScriptService), você pode experimentar as configurações de habilidades incorporadas. Você também pode modificar controladores específicos controllers para ajustar a simulação física do personagem e sua interação com o ambiente, como a velocidade base de movimento do personagem.

Tempo de Execução

Para experimentar com configurações de habilidades em tempo de execução:

1. Inicie um teste de jogo.

2. No Explorer, localize o modelo do personagem em Workspace e expanda a árvore Abilities sob AbilityManagerActor:

   

3. Selecione uma das habilidades incorporadas e, na seção Attributes da janela Properties, personalize atributos como aqueles notados abaixo.

   Habilidade	Atributos
   Escalada	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Climbing) MultiplicadorDeVelocidade — Multiplicador para a propriedade ClimbController.MoveSpeedFactor quando o personagem está escalando.
   Morto	Habilitado — O personagem morre quando a saúde é 0 ou menor. Saúde  ⇔  Humanoid.Health SaúdeMáxima  ⇔  Humanoid.MaxHealth ExigePescoço  ⇔  Humanoid.RequiresNeck
   DireçãoDeMovimento	Habilitado  ⇔  Humanoid.AutoRotate
   Caindo	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.FallingDown)
   QuedaLivre	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Freefall) MultiplicadorDeVelocidade — Multiplicador para a propriedade AirController.MoveSpeedFactor quando o personagem está em queda livre. Note que o efeito pode ser sutil quando o personagem cai livremente por uma duração muito curta.
   Levantando	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp)
   Pulando	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping) AlturaDoSalto  ⇔  Humanoid.JumpHeight ForçaDoSalto  ⇔  Humanoid.JumpPower UsarForçaDoSalto  ⇔  Humanoid.UseJumpPower
   SemLocomoção	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.PlatformStanding)
   Correndo	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Running) MultiplicadorDeVelocidade — Multiplicador para a propriedade GroundController.MoveSpeedFactor quando o personagem está correndo.
   Sentado	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Seated)
   Nadando	Habilitado  ⇔  Humanoid:SetStateEnabled(Enum.HumanoidStateType.Swimming) HabilitarAumentoRápido — Subir à superfície mais rapidamente segurando a entrada de salto. MultiplicadorDeVelocidade — Multiplicador para a propriedade SwimController.MoveSpeedFactor quando o personagem está nadando.

Com Script

Para definir configurações de habilidades para todos os personagens através de um script:

1. Crie um novo Script do lado do servidor dentro de ServerScriptService e renomeie-o para AbilitiesScript.

2. Copie e cole o seguinte código no novo script. Este exemplo multiplica a velocidade base de movimento para a habilidade Correndo por 2. Sinta-se à vontade para ajustar outros atributos de habilidades, como os descritos na tabela acima.

   Script em ServerScriptService
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	local AbilityManagerActor = character:WaitForChild("AbilityManagerActor")
   	local Abilities = AbilityManagerActor:WaitForChild("Abilities")
   
   	local Running = Abilities:FindFirstChild("Running")
   	if Running then
   		-- Dobrar a velocidade de movimento base
   		Running:SetAttribute("SpeedMultiplier", 2)
   	end	
   end
   
   local function onPlayerAdded(player)
   	if player.Character then
   		onCharacterAdded(player.Character)
   	end
   	player.CharacterAdded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)