Personalizar a câmera | Documentação - Central de Criadores Roblox

A câmera embutida do Roblox alimenta um modo terceira pessoa padrão e um modo primeira pessoa opcional, então você não precisa construir sua própria câmera de seguimento. Para cenários mais personalizados, você pode ajustar as propriedades padrão em Camera ou substituí-la completamente, como para visões sobre o ombro, isométricas e de mira de armas.

Configurações básicas

Você pode configurar as configurações comuns da câmera diretamente dentro do objeto StarterPlayer do Studio. Essas configurações incluem distância de zoom e vários modos de câmera, oclusão e movimento.

Na janela Explorer, selecione o objeto StarterPlayer.
Na janela Properties, role para baixo para localizar a seção Camera. Você pode configurar as seguintes propriedades diretamente ou através de um script.

Distância de zoom

Juntas, CameraMaxZoomDistance e CameraMinZoomDistance definem a faixa na qual os jogadores podem aproximar a câmera em relação ao seu personagem. Definir um máximo muito alto, como 500, permite que os jogadores afastem a câmera muito no espaço. Se você quiser travar a câmera a uma distância específica do personagem e impedir o zoom, defina ambas as propriedades para o mesmo valor.

LocalScript - Faixa de Zoom da Câmera

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 25
player.CameraMinZoomDistance = 50

Modo de câmera

A propriedade CameraMode define o comportamento geral da câmera entre duas opções:

Configuração	Descrição
Clássico	A câmera clássica de terceira pessoa do Roblox que pode ser aproximada para a primeira pessoa. Permite que os jogadores se aproximem e se afastem (a menos que o zoom esteja bloqueado) e girem a câmera ao redor de seu personagem.
TravarPrimeiraPessoa	Trava a câmera no modo de primeira pessoa. Quando neste modo, todas as partes/elementos do personagem do jogador ficam invisíveis para ele, exceto por Tools equipados.

Modo de oclusão

A propriedade DevCameraOcclusionMode controla o comportamento da câmera quando o jogador não pode ver seu personagem, como quando ele está obscurecido por um BasePart.

Configuração	Descrição
Zoom	Se o personagem do jogador se mover atrás de um objeto com Transparency inferior a 0.25, a câmera se aproxima muito do personagem para que ele possa ser visto. Uma vez que o personagem se mova de volta para uma posição visível, a câmera se afasta novamente.
Invisicam	Se o personagem do jogador se mover atrás de um objeto com Transparency inferior a 0.75, a câmera permanece imóvel, mas o objeto se torna semi-transparente para que o personagem possa ser visto. Uma vez que o personagem se mova de volta para uma posição visível, o objeto retorna à sua opacidade normal.

Modos de oclusão Zoom e Invisicam

Modo de movimento

O DevComputerCameraMovementMode (computador) e DevTouchCameraMovementMode (telefone/tablet) determinam como o jogador pode mover a câmera.

Configuração	Descrição
EscolhaDoUsuário	A câmera se moverá com base nas configurações de câmera do jogador no jogo.
Clássico	A câmera permanece na sua distância de zoom, acompanhando o personagem do jogador enquanto ele se move pelo mundo. Os jogadores também podem inclinar a visão da câmera para cima/baixo e orbitá-la ao redor de seu personagem.
Seguir	Semelhante ao Clássico, mas a câmera pode girar ligeiramente para encarar o personagem do jogador se ele estiver se movendo em qualquer direção que não seja paralela à direção em que a câmera está voltada.
Orbital	A câmera permanece a uma distância de zoom fixa e acompanha o personagem do jogador enquanto ele se move pelo mundo. Os jogadores podem orbitar a câmera ao redor de seu personagem, mas não podem inclinar a visão para cima ou para baixo.
AlternarCâmera	Funciona apenas em computadores (não em telefones/tablets) através de DevComputerCameraMovementMode. Quando o jogador clica com o botão direito do mouse, a câmera alterna entre o modo Clássico e um modo de "visão livre" onde mover o mouse olha ao redor do mundo.

Script a câmera

Cada cliente de jogador tem seu próprio objeto Camera residindo no Workspace local, acessível através da propriedade Workspace.CurrentCamera. Você pode substituir os scripts de câmera padrão do Roblox definindo seu CameraType para Scriptable e, em seguida, controlar a câmera através das seguintes propriedades.

Propriedade	Descrição
Camera.CFrame	O CFrame da câmera. Esta é a propriedade mais frequentemente usada para posicionar e orientar uma câmera Scriptable em um jogo.
Camera.FieldOfView	A extensão do espaço 3D observável que pode ser visto na tela, medida entre 1–120 graus na direção definida por Camera.FieldOfViewMode. O padrão é 70.
Camera.CameraType	Alterna entre os vários comportamentos de câmera descritos em Enum.CameraType, alguns dos quais imitam os modos de movimento selecionáveis. Definir isso como Scriptable dá a você controle total da câmera.
Camera.Focus	O ponto no espaço 3D onde a câmera está olhando. Se você definiu Camera.CameraType como Scriptable, deve atualizar esta propriedade a cada quadro, pois certos visuais são mais detalhados dependendo de quão próximos estão do ponto de foco.