Bem-vindo ao Cave Engine!

Cave é um motor de jogo 3D simples, rápido e para desktop, feito para criar jogos sem que você tenha que lidar com a ferramenta primeiro. O editor oferece os blocos de construção usuais de um motor comercial, como cenas, entidades, componentes, assets, física, animação, UI, áudio, timelines, scripting em Python, e mais, mas o fluxo de trabalho foi pensado para ser direto. Você não precisa compilar código do jogo ou esperar compilação de shaders só para começar a experimentar.

Nesta missão de Introdução, você vai desde abrir o Cave pela primeira vez até criar, testar e exportar um projeto básico de jogo. Esta primeira lição é só sobre instalar o editor corretamente e iniciá-lo com segurança.

O Que Você Precisa

Antes de começar, certifique-se de que você tem:

• Uma licença válida do Cave Engine.
• Um computador com Drivers Gráficos atualizados: O Cave exige drivers OpenGL 4.3 ou superiores para funcionar. Essa API gráfica foi lançada em 2012, então sua máquina provavelmente já a suporta.
• Uma pasta local normal onde possa extrair o motor: No Windows, um local simples como C:\Cave Engine\ é uma boa escolha. O nome exato da pasta fica a seu critério, mas deve ser curto, fácil de encontrar e não estar dentro de uma pasta sincronizada na nuvem.

Instalando o Cave Engine

O Cave Engine é distribuído como uma pasta comprimida (ZIP). Uma build única do motor será compilada e disponibilizada para você pelo nosso servidor aqui. Ela é única para você e compartilhar ou redistribuir é contra nosso Contrato de Licença de Usuário Final, sendo proibido.

Para instalar, extraia todo o pacote do motor em uma pasta dedicada.

Importante:

• Não rode o Cave diretamente do arquivo .zip.
• Não extraia o Cave em uma pasta que já contenha arquivos não relacionados.
• Não separe os arquivos do motor em diferentes locais.

Depois de extrair, a pasta do motor deve conter o executável do editor, o executável do jogo/player e pastas importantes de suporte como Editor e Lib. Os nomes exatos dos arquivos podem variar um pouco dependendo do sistema operacional e da build do motor, mas a regra importante é simples: mantenha a pasta extraída inteira.

> O Cave precisa que seus arquivos permaneçam na mesma estrutura de pastas. Se você mover, renomear ou deletar arquivos aleatórios da pasta do motor, o editor pode falhar ao abrir.

Solução de Problemas no Caminho de Instalação

O Cave verifica vários problemas comuns no caminho de instalação ao iniciar. Esses problemas podem causar travamentos, arquivos faltando ou comportamentos estranhos, especialmente no Windows. Use um caminho de pasta que siga estas regras:

• Mantenha o Cave fora do OneDrive, Dropbox, Google Drive e pastas sincronizadas similares.
• Evite extraí-lo na Área de Trabalho, especialmente se ela for sincronizada pelo OneDrive.
• Evite caracteres não ASCII no caminho da pasta, como letras acentuadas ou outros caracteres especiais.
• Mantenha o caminho razoavelmente curto.
• Evite pastas marcadas como offline, virtuais ou só-nuvem.

Exemplo bom:

C:\Cave Engine\

Exemplos arriscados:

C:\Users\SeuNome\OneDrive\Desktop\Cave Engine\
C:\Users\SeuNome\Desktop Com Acentos\Cave Engine\
C:\Muito\Longo\Caminho\De\Pasta\Com\Muitas\Muitas\Subpastas\Cave Engine\

Se o Cave mostrar um aviso de "Caminho de Instalação Inválido", mova a pasta extraída inteira para um caminho local mais limpo e abra novamente.

Iniciando o Editor

Para iniciar o Cave, abra o executável Cave Editor dentro da pasta do motor. No Windows, normalmente será um arquivo .exe. Você pode criar um atalho na área de trabalho ou fixá-lo na barra de tarefas, mas crie o atalho para o executável sem mover o arquivo para fora da pasta do motor.

Quando o Cave abrir corretamente, você verá a janela do Gerenciador de Projetos. Essa é a primeira tela do editor. De lá, você pode criar um projeto novo, abrir um projeto recente ou navegar por um existente:

Entendendo os Arquivos Básicos do Motor

Antes de avançarmos para o Específico do Motor, vamos entender melhor os Arquivos do Motor. A pasta do motor contém mais de um tipo de arquivo porque o Cave é dividido nas ferramentas para criar um jogo e no runtime necessário para rodar o jogo exportado.

• O executável do editor é o aplicativo que você usa para criar e editar projetos.
• O executável do jogo/player é usado pelos projetos exportados. Ele roda o jogo final para os jogadores.
• A pasta Editor contém dados do editor, como ícones, assets padrão, fontes, arquivos da interface e outros recursos que o editor precisa.
• A pasta Lib contém bibliotecas de runtime necessárias, incluindo arquivos relacionados ao Python usados pelo sistema de scripting do Cave.

Por enquanto, você não precisa entender cada arquivo da pasta. Apenas lembre desta regra:

> Abra o editor de dentro da pasta extraída do Cave e mantenha todo o conteúdo da pasta junto.

Solução de Problemas: Problemas Comuns no Primeiro Lançamento

Se o Gerenciador de Projetos não aparecer, ou o editor abrir e fechar imediatamente, verifique o seguinte primeiro:

1. O Motor Não Foi Extraído Completo

Se o Cave não encontrar um arquivo necessário como Editor/imgui.ini, provavelmente o motor não foi extraído corretamente, ou o executável foi movido para longe dos demais arquivos.

Resolva extraindo o pacote completo novamente numa pasta limpa. Então, inicie o editor a partir dessa pasta.

2. O Motor Está Dentro de Uma Pasta Problema

Se o editor avisar sobre o caminho de instalação, mova o Cave para uma pasta local mais simples. Evite pastas na nuvem, pastas sincronizadas na Área de Trabalho, caracteres não ASCII e caminhos muito longos.

3. Antivírus Removeu ou Bloqueou Arquivos

Algumas ferramentas antivírus podem colocar arquivos de software recém-baixado em quarentena. Se arquivos estiverem faltando após extrair, restaure-os da quarentena do antivírus ou baixe e extraia o Cave novamente.

Em caso de dúvida, extraia o Cave numa pasta limpa e verifique se todos os arquivos do pacote continuam lá.

4. Drivers Gráficos Estão Desatualizados

O Cave usa um renderizador 3D de desktop, então seu driver gráfico é importante. Se o editor travar durante a inicialização, abrir uma janela em branco, ou mostrar erros de renderização, atualize o driver da GPU no site do fabricante da sua placa.

Isso é especialmente importante em notebooks, computadores antigos ou instalações frescas do Windows.

5. Você Está Rodando o Arquivo Errado

Use o executável do editor para criar projetos. O executável do jogo/player destina-se a rodar jogos exportados, não para editar projetos fonte. Se quiser fazer um jogo, abra o Cave Editor.

O Que Vem a Seguir

Quando o Gerenciador de Projetos abrir, o Cave estará pronto para o seu primeiro projeto.

Na próxima lição, você irá criar um novo projeto, escolher um template inicial, ajustar o zoom do editor se precisar e entender o que o Cave gera para você.