Modos de teste do Studio

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Devido ao modelo cliente-servidor subjacente do Roblox Engine, é importante que você teste seu jogo em vários modos antes de liberá-lo ao público. Todas as opções de teste estão acessíveis na parte esquerda do mezzanino.

Controles de teste indicados no mezzanino do Studio.

Teste de jogo

Existem três opções comuns para testar um jogo. Escolha a opção desejada no menu suspenso e clique no botão Play à sua direita para iniciar o teste.

Opção de teste no menu suspenso de modos de teste do mezzanino do Studio.
ModoAtalhoDescrição
TesteF5Começa a simular o jogo, inserindo seu avatar em um SpawnLocation ou em coordenadas ao redor de (0, 100, 0).
Teste AquiComeça a simular o jogo, inserindo seu avatar na frente da posição atual da câmera.
ExecutarF8Começa a simular o jogo, mas não insere seu avatar. A simulação começa na posição atual da câmera e você pode navegar usando os controles de câmera do Studio.

Uma vez que um teste de jogo esteja em execução, opções adicionais ficam disponíveis no mezzanino.

Opções adicionais disponíveis durante um teste de jogo a partir do mezzanino do Studio.
AçãoAtalhoDescrição
Pausar / RetomarPermite que você pause/retome a física e animações.
PararShiftF5Para a simulação do jogo e redefine todos os objetos e instâncias para como estavam antes do teste.
Cliente / ServidorDurante o teste em modo "solo" (Teste ou Teste Aqui), alterna entre o modo Cliente e o modo Servidor. Veja alternar cliente/servidor para detalhes.

Alternar cliente/servidor

Ao testar em modo Teste ou Teste Aqui, o Studio executa duas simulações separadas — uma simulação cliente e uma simulação servidor — que podem fornecer uma impressão mais precisa de como o jogo será executado em produção.

Enquanto testa em modo solo, você pode alternar entre os modos Cliente e Servidor clicando no botão de alternância Cliente/Servidor. Quando você alterna, o botão muda para refletir o modo de simulação atual.

Cliente
Servidor

Dependendo do modo de simulação, o controle do seu personagem e da câmera muda da seguinte forma:

No modo Cliente, a visualização 3D é cercada por uma borda azul e a simulação usa os controles do seu personagem e a configuração da câmera. Este modo de teste é uma simulação próxima do jogo rodando no aplicativo Roblox, sem múltiplos jogadores.

Dentro da hierarquia da janela Explorer, certos objetos existem apenas em seus contêineres esperados.

Janela Explorer mostrando itens que existem apenas no cliente
No modo Cliente, os objetos esperados do lado do cliente estão presentes na hierarquia, incluindo aqueles copiados de StarterPack para o Backpack do jogador e de StarterPlayer para os PlayerScripts do jogador.
Janela Explorer mostrando itens que existem apenas no servidor
No modo Servidor, os objetos esperados do lado do servidor estão presentes na hierarquia, incluindo scripts em ServerScriptService e objetos que você colocou em ServerStorage.

Na janela Output, as mensagens são rotuladas como azuis (cliente) ou verdes (servidor), indicando sua origem do cliente ou servidor. Para mensagens de saída de ModuleScripts, a cor do rótulo é determinada por se o módulo foi chamado de um LocalScript do lado do cliente ou de um Script do lado do servidor.

Janela de saída mostrando rótulo verde para saída do servidor e rótulo azul para saída do cliente

Pausar/retomar

Enquanto testa em modo solo, o botão Pausar/Retomar é útil para depurar cenas e mecanismos efêmeros, sem desativar a renderização.

Botão Pausar/Retomar indicado no mezzanino do Studio.

Por padrão, pausar e retomar atua tanto no cliente quanto no servidor. Se você deseja pausar ou retomar apenas o cliente ou o servidor:

  1. Defina a alternância cliente/servidor com base em qual simulação você deseja pausar/retomar.
  2. Clique na pequena seta no botão Pausar/Retomar e selecione a opção alternativa de Pausar/Retomar Cliente ou Pausar/Retomar Servidor. Clicar no botão irá pausar ou retomar apenas aquele lado da simulação.

Quando a simulação está pausada, você pode avançar 1/60 de segundo (60 Hz) clicando no botão Avançar. Assim como o botão Pausar/Retomar à sua esquerda, clicar na pequena seta permite que você selecione o avanço apenas para o cliente ou servidor com base na alternância cliente/servidor.

Botão Avançar indicado no mezzanino do Studio.

Observe os seguintes detalhes técnicos em relação a pausar/retomar:

  • Embora Animations não sejam baseadas em física, esses botões da barra de ferramentas também pausam/retomam animações.
  • Pausar ou retomar não tem efeito sobre scripts em execução.
  • Apenas os callbacks RunService PreAnimation, PreSimulation, PostSimulation, e Stepped pausam ou retomam através desses botões da barra de ferramentas. Outros callbacks (PreRender, Heartbeat, e RenderStepped) continuam a ser acionados, mantendo a funcionalidade normal de scripts de câmera, visualizações renderizadas e plugins.

Simulação de múltiplos clientes

A opção Servidor & Clientes no menu suspenso permite que você inicie várias sessões do Studio, uma atuando como servidor e cada outra atuando como cliente. Este modo de teste é uma ferramenta valiosa para comparar como um cliente "vê" outros clientes dentro do jogo.

  1. Com a opção Servidor & Clientes selecionada no menu suspenso, escolha o número de sessões de cliente para testar. Normalmente, 1–2 clientes são suficientes, embora você possa simular até oito.

    Opção Servidor & Clientes no menu suspenso de modos de teste do mezzanino do Studio.
  2. Pressione o botão Play ou F7 para iniciar a simulação cliente-servidor.

  3. Quando terminar os testes, pressione o botão Encerrar Sessão de qualquer uma das sessões de simulação para fechar todos os clientes simulados e o servidor simulado.

    Encerrar Sessão indicado no mezzanino do Studio

Simulação de festa

O Simulador de Festa permite que você teste e depure jogos que usam APIs relacionadas a festas diretamente dentro do Studio, sem precisar publicar e coordenar vários dispositivos. Esta ferramenta permite que você configure e emule festas para jogadores de teste em seus testes de Servidor & Clientes.

Ao testar, o Simulador de Festa atribui automaticamente todos os jogadores de teste às festas simuladas configuradas.

Emulador de Festa exibindo festas simuladas e várias opções de atribuição

Se o Simulador de Festa estiver habilitado:

Você pode ajustar o número de jogadores de teste locais a qualquer momento usando a configuração de Servidor & Clientes do Studio. Quando a contagem de jogadores de teste muda, o emulador atualiza automaticamente para incluir ou remover jogadores na configuração.

Teste colaborativo

Se você está trabalhando em um jogo com outras pessoas no modo de colaboração, você pode testar com outros colaboradores da seguinte forma:

  1. Selecione Teste em Equipe no menu suspenso e pressione o botão Play para abrir uma nova sessão do Studio com seu personagem inserido.

    Opção Teste em Equipe no menu suspenso de modos de teste do mezzanino do Studio.
  2. Outros colaboradores podem então entrar pressionando o botão Play no mezzanino em sua sessão do Studio.

Simulação de dispositivos

Use o Simulador de Dispositivos para visualizar como sua experiência parece e se comporta em um dispositivo que você não tem à sua frente, incluindo suas dimensões de tela, densidade de pixels, teclado na tela e entrada por toque. O Simulador de Dispositivos emparelha com o Emulador de Controladores para emular os gamepads, controladores de VR, portáteis e controles remotos de TV que os jogadores usam para controlar sua experiência.

Simulação de rede

Use o Simulador de Rede para adicionar latência, jitter e perda de pacotes às conexões de teste de jogo do Studio e reproduzir as condições de rede que os jogadores encontram em conexões com fio, Wi-Fi e móveis. Isso é especialmente útil para testar jogos que usam Autoridade do Servidor, uma vez que mecanismos de previsão e rollback/resimulação são sensíveis às condições de rede, e para testar UnreliableRemoteEvents, que podem ser perdidos ou chegar fora de ordem.

Teste programático

Além das ferramentas de teste interativas acima, o Studio expõe serviços que permitem que você conduza testes programaticamente a partir de um plugin ou pipeline de construção. Todos os três serviços são exclusivos do Studio e não fazem nada quando executados em uma experiência publicada.

ServiçoPropósito
StudioDeviceSimulatorServiceSimulação de dispositivo programática. Navegue por predefinições de dispositivos, altere o dispositivo ativo, substitua a resolução e DPI, controle a orientação e escala, e crie perfis de dispositivos personalizados que persistem no disco.
StudioTestServiceSimulação de múltiplos clientes programática. Inicie um servidor com até 8 clientes simulados, adicione jogadores durante a sessão, passe argumentos para o teste, acione desconexões de clientes e finalize testes a partir do servidor.
VirtualInputEventos simulados de mouse, teclado e ponteiro que são processados exatamente como a entrada de hardware real. Obtenha uma instância de UserInputService:CreateVirtualInput().

Esses serviços permitem incluir testes multiplayer entre dispositivos (ciclar por perfis de dispositivos e iniciar um teste multiplayer em cada um), testes de estresse de entrada/saída de jogadores, testes de regressão de orientação e automação de fluxo de UI de ponta a ponta.

Headsets de VR

Se você gostaria de suportar headsets de realidade virtual (VR) para seu jogo, certifique-se de testar ou emular VR no Studio.

Emulação de VR

A emulação de VR permite que você teste jogos de VR no Studio sem um headset físico. Assim como emular qualquer outro dispositivo, use o Simulador de Dispositivos para escolher um dispositivo Headset como Meta Quest 2 ou Meta Quest 3. O Emulador de Controladores seleciona automaticamente o controlador apropriado para o headset.

O Emulador de Controladores com um controlador Quest 3.
Emulador com uma emulação Quest 3.

A combinação de um headset e múltiplos controladores, cada um com rastreamento de movimento, torna a emulação de VR mais complexa:

  • Para emulação de rastreamento de movimento, pressione Alt1 (1) para bloquear e desbloquear o mouse da visualização.

  • Use Shift ou Shift para alternar entre combinações comuns do headset, controlador esquerdo e controlador direito. Por exemplo, você pode usar a opção Headset para olhar ao redor enquanto caminha para frente com o botão do controlador esquerdo, mas depois mudar para o Controlador Direito quando precisar usar controles de movimento para mirar em um alvo.

Configuração do headset

O Studio suporta testes para todos os headsets de VR que são compatíveis com OpenXR, o padrão da indústria de código aberto que fornece acesso à VR.

Para habilitar os testes do Studio em VR, você deve conectar seu headset ao seu PC e configurar o runtime do OpenXR antes de iniciar o Studio. Se você já lançou o Studio, saia e complete os passos de configuração primeiro.

Se você tiver apenas um headset de VR, instalar o aplicativo VR correspondente configura automaticamente o runtime para você. Se você tiver vários headsets, deve configurar o runtime manualmente e garantir que apenas configure aquele que deseja usar para testes.

Os seguintes passos são para os dois aplicativos de VR mais comuns:

  • SteamVR para headsets como HTC Vive e Valve Index.
  • Oculus para headsets como Meta Quest e Oculus Rift.
  1. Instale e abra o aplicativo SteamVR no seu computador.
  2. Em Configurações do SteamVR, selecione a aba Desenvolvedor. Em seguida, selecione Mostrar Configurações Avançadas.
  3. Defina o SteamVR como runtime do OpenXR.
  4. Ligue os controladores pressionando o botão Sistema até ouvir um som de bip.
    • Para desligar o controlador, pressione e segure o botão Sistema até ouvir o mesmo som de bip.

Se você seguir os passos corretamente, os ícones de status no aplicativo SteamVR e as luzes de status no hardware devem estar todos verdes, indicando que a configuração está concluída.

Aplicativo Roblox Quest

Você pode testar seu jogo no aplicativo Roblox no Quest sem conectar seu headset ao computador. Use os seguintes passos para acessar seu jogo no headset neste modo:

  1. No Studio, publique o jogo e defina o jogo como privado.
  2. Usando seu Painel do Criador ou o link no Studio, abra a página do jogo no seu navegador.
  3. Na página do jogo, adicione o jogo aos seus favoritos clicando no ícone Favoritar.
  4. Usando seu headset, abra o aplicativo Roblox autônomo.
  5. Role para baixo até a seção Favoritos na página inicial e execute seu jogo.

Modo VR do Studio

Após configurar seu headset, você pode ativar o modo de teste VR do Studio através dos seguintes passos:

  1. No menu Arquivo, selecione Configurações do Studio.
  2. Selecione Renderização.
  3. Nas configurações Gerais, ative Habilitar Modo VR.

Agora você pode testar seu jogo usando seu headset de VR com qualquer uma das opções de teste de jogo disponíveis. Durante uma sessão de teste em VR, se o cabo do seu headset desconectar ou se você fechar o aplicativo Roblox Studio Beta no headset, você precisará reiniciar o Studio para reexecutar o teste.

Emulação de jogador

Para emulação detalhada de localização de jogos e políticas de conteúdo, você pode testar através do Emulador de Jogador, acessível no menu Teste do Studio.

Com a janela do emulador aberta, ative Habilitar Perfil de Teste. A emulação permanecerá ativada (habilitada ou desabilitada) mesmo se você fechar a janela.

Mais abaixo na janela, opções comumente usadas incluem:

OpçãoDescrição
LocalidadePermite que você emule um idioma localizado enquanto testa.
PseudolocalizarTroca caracteres por caracteres semelhantes, mas ligeiramente diferentes, para que seja fácil identificar quais strings estão passando pelo sistema de tradução. Habilitar isso ajuda você a identificar texto não localizado sem precisar mudar o idioma de emulação. Por exemplo:
  • Bloxy Cola  ⟩  ßℓôж¥ Çôℓá
  • Dominus Empyreus  ⟩  Ðô₥ïñúƨ É₥ƥ¥řèúƨ
ElongarElonga strings de texto por um fator definido através do controle deslizante. Por exemplo:
  • Bloxy Cola  ⟩  Bloooxyy Coolaa (50% mais longo)
  • Dominus Empyreus  ⟩  Doomiinuus Eempyyreus (30% mais longo)
Usar elongação ajuda você a identificar lugares onde suas interfaces de usuário podem não conseguir lidar com texto que é mais longo do que o texto traduzido padrão. Observe que o espanhol é em média 30% mais longo que o inglês e o equivalente para o alemão é ainda mais longo. Também observe que isso afeta apenas o texto que passa pelo sistema de tradução.
RegiãoPermite que você emule o país/região de um jogador enquanto testa; essa seleção pode impactar outros alternadores e caixas de seleção na janela, conforme descrito em GetPolicyInfoForPlayerAsync().
©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.