Bem-vindo ao Cave Engine!

Cave é um motor de jogo desktop 3D simples e rápido feito para construir jogos sem ter que lutar contra a ferramenta primeiro. O editor fornece os blocos básicos habituais de um motor de jogo comercial, como cenas, entidades, componentes, ativos, física, animação, UI, áudio, cronogramas, scripting em Python e mais, mas o fluxo de trabalho é projetado para ser direto. Você não precisa compilar o código do jogo ou esperar pela compilação de shaders apenas para começar a experimentar.

Neste guia de Introdução, você irá do primeiro acesso ao Cave até a criação, teste e exportação de um projeto de jogo básico. Esta primeira lição trata apenas da instalação correta do editor e da inicialização segura.

O Que Você Precisa

Antes de começar, certifique-se de ter:

• Uma licença válida do Cave Engine.
• Um computador com Drivers Gráficos atualizados: O Cave requer drivers OpenGL 4.3 ou superior para funcionar. Esta API Gráfica foi lançada em 2012, então sua máquina provavelmente já a suporta.
• Uma pasta local normal onde você 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 dentro de uma pasta de nuvem sincronizada.

Instalando o Cave Engine

O Cave Engine é distribuído como uma pasta compactada (ZIP). Uma versão única do motor será compilada e disponível para você pelo nosso servidor aqui. É única para você e compartilhar ou redistribuí-la é contra nosso Acordo de Licença de Usuário Final, portanto, é proibido.

Para instalá-lo, extraia todo o pacote do motor em uma pasta dedicada.

Importante:

• Não execute o Cave diretamente do arquivo .zip.
• Não extraia o Cave em uma pasta que já contém arquivos não relacionados.
• Não divida os arquivos do motor em lugares diferentes.

Após a extração, a pasta do motor deve conter o executável do editor, o executável do jogo/jogador e pastas de suporte importantes, como Editor e Lib. Os nomes exatos dos arquivos podem variar um pouco dependendo do sistema operacional e da versão do motor, mas a regra importante é simples: mantenha a pasta extraída junta.

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

Solucionando o Caminho de Instalação

O Cave verifica vários problemas comuns de caminho de instalação quando inicia. Esses problemas podem causar falhas, arquivos ausentes ou comportamento estranho, especialmente no Windows. Use um caminho para a pasta que siga estas regras:

• Mantenha o Cave fora do OneDrive, Dropbox, Google Drive e pastas semelhantes sincronizadas.
• Evite extrair para a área de trabalho, especialmente se a sua área de trabalho estiver sincronizada pelo OneDrive.
• Evite caracteres não-ASCII no caminho da pasta, como letras acentuadas ou outros caracteres especiais de idioma.
• Mantenha o caminho razoavelmente curto.
• Evite pastas marcadas como offline, virtuais ou apenas na nuvem.

Bom exemplo:

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\Pastas Aninhadas\Cave Engine\

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

Iniciando o Editor

Para iniciar o Cave, abra o executável Cave Editor dentro da pasta do motor. No Windows, isso geralmente parecerá 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 em vez de mover o executável para fora da pasta do motor.

Quando o Cave abrir corretamente, você deve ver a janela do Gerenciador de Projetos. Esta é a primeira tela do editor. A partir daí, você pode criar um novo projeto, 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 entre as ferramentas necessárias para criar um jogo e o tempo de execução necessário para jogar um jogo exportado.

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

Por enquanto, você não precisa entender todos os arquivos na pasta. Apenas lembre-se desta regra:

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

Solução de Problemas: Problemas Comuns na Primeira Inicialização

Se o Gerenciador de Projetos não aparecer, ou se o editor aparecer e fechar imediatamente, verifique estas primeiras:

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

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

Corrija isso extraindo o pacote completo novamente em uma pasta limpa. Então, inicie o editor dessa pasta.

2. O Motor Está Dentro de uma Pasta Problemática

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

3. O Antivírus Removed or Blocked Files

Alguns programas antivírus podem colocar arquivos em quarentena a partir de software recém-baixado. Se arquivos estiverem ausentes após a extração, restaure-os da quarentena do antivírus ou baixe e extraia o Cave novamente.

Quando em dúvida, extraia o Cave em uma pasta limpa e certifique-se de que todos os arquivos do pacote ainda estão lá.

4. Os Drivers Gráficos Estão Desatualizados

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

Isso é especialmente importante em laptops, computadores mais antigos ou instalações novas do Windows.

5. Você Está Executando o Arquivo Errado

Use o executável do editor para criar projetos. O executável do jogo/jogador é para executar jogos exportados, não para editar projetos fonte. Se você quiser fazer um jogo, abra o Cave Editor.

O Que Vem a Seguir

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

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