Bienvenue dans Cave Engine!

Cave est un moteur de jeu 3D simple, rapide et de bureau conçu pour construire des jeux sans avoir à se battre d'abord avec l'outil. L'éditeur vous fournit les éléments de base habituels d'un moteur de jeu commercial, tels que des scènes, des entités, des composants, des actifs, de la physique, de l'animation, de l'interface utilisateur, de l'audio, des timelines, du scripting Python, et bien plus, mais le flux de travail est conçu pour rester direct. Vous n'avez pas besoin de compiler le code du jeu ou d'attendre la compilation des shaders juste pour commencer à expérimenter.

Dans cette quête pour débutants, vous passerez de l'ouverture de Cave pour la première fois à la création, au test et à l'exportation d'un projet de jeu de base. Cette première leçon porte uniquement sur l'installation correcte de l'éditeur et son lancement en toute sécurité.

Ce dont vous avez besoin

Avant de commencer, assurez-vous d'avoir :

• Une licence valide de Cave Engine.
• Un ordinateur avec des pilotes graphiques mis à jour : Cave nécessite des pilotes OpenGL 4.3 ou supérieurs pour fonctionner. Cette API graphique a été publiée en 2012, donc votre machine devrait probablement déjà la prendre en charge.
• Un dossier local normal où vous pouvez extraire le moteur : Sous Windows, un emplacement simple tel que C:\Cave Engine\ est un bon choix. Le nom exact du dossier dépend de vous, mais il doit être court, facile à trouver et ne pas se trouver dans un dossier cloud synchronisé.

Installation de Cave Engine

Cave Engine est distribué sous forme de dossier compressé (ZIP). Une version unique du moteur sera compilée et mise à votre disposition par notre serveur ici. Elle est unique pour vous et le partage ou la redistribution en sont interdits par notre contrat de licence utilisateur final.

Pour l'installer, extrayez l'ensemble du package du moteur dans un dossier dédié.

Important :

• Ne lancez pas Cave directement depuis le fichier .zip.
• Ne l'extrayez pas dans un dossier qui contient déjà des fichiers non liés.
• Ne divisez pas les fichiers du moteur en différents emplacements.

Après extraction, le dossier du moteur doit contenir l'exécutable de l'éditeur, l'exécutable de jeu/joueur, et des dossiers de support importants tels que Editor et Lib. Les noms de fichiers exacts peuvent varier légèrement selon le système d'exploitation et la version du moteur, mais la règle importante est simple : gardez le dossier extrait ensemble.

> Cave a besoin que ses fichiers restent dans la même structure de dossiers. Si vous déplacez, renommez ou supprimez des fichiers au hasard du dossier du moteur, l'éditeur risque de ne pas s'ouvrir.

Résoudre les problèmes de chemin d'installation

Cave vérifie plusieurs problèmes courants de chemin d'installation lors de son démarrage. Ces problèmes peuvent causer des plantages, des fichiers manquants ou un comportement étrange, notamment sous Windows. Utilisez un chemin de dossier qui suit ces règles :

• Gardez Cave en dehors de OneDrive, Dropbox, Google Drive et d'autres dossiers synchronisés.
• Évitez de l'extraire sur le Bureau, surtout si votre Bureau est synchronisé par OneDrive.
• Évitez les caractères non ASCII dans le chemin de dossier, tels que les lettres accentuées ou d'autres caractères spéciaux.
• Gardez le chemin raisonnablement court.
• Évitez les dossiers marqués comme hors ligne, virtuels ou uniquement cloud.

Bon exemple :

C:\Cave Engine\

Exemples risqués :

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Bureau Avec Accents\Cave Engine\
C:\Très\Long\Dossier\Chemin\Avec\Beaucoup\Beaucoup\De\Dossiers\Imbriqués\Cave Engine\

Si Cave affiche un avertissement "Chemin d'installation invalide", déplacez l'ensemble du dossier extrait du moteur vers un chemin local plus propre et ouvrez-le à nouveau.

Démarrer l'éditeur

Pour commencer Cave, ouvrez l'exécutable Cave Editor à l'intérieur du dossier du moteur. Sous Windows, cela apparaîtra généralement sous la forme d'un fichier .exe. Vous pouvez créer un raccourci sur le Bureau ou l'épingler à la barre des tâches, mais créez le raccourci vers l'exécutable au lieu de déplacer l'exécutable hors du dossier du moteur.

Lorsque Cave s'ouvre correctement, vous devriez voir la fenêtre du Gestionnaire de projets. C'est le premier écran de l'éditeur. De là, vous pouvez créer un nouveau projet, ouvrir un projet récent ou rechercher un projet existant :

Comprendre les fichiers de base du moteur

Avant de passer aux spécificités du moteur, comprenons un peu mieux les fichiers du moteur. Le dossier du moteur contient plus d'un type de fichier car Cave est divisé entre les outils nécessaires pour créer un jeu et le runtime nécessaire pour jouer à un jeu exporté.

• L'exécutable de l'éditeur est l'application que vous utilisez pour créer et modifier des projets.
• L'exécutable de jeu/joueur est utilisé par les projets exportés. Il exécute le jeu final pour les joueurs.
• Le dossier Editor contient des données d'éditeur telles que des icônes, des actifs par défaut, des polices, des fichiers d'interface, et d'autres ressources dont l'éditeur a besoin.
• Le dossier Lib contient des bibliothèques runtime requises, y compris des fichiers liés à Python utilisés par le système de scripting de Cave.

Pour l'instant, vous n'avez pas besoin de comprendre chaque fichier dans le dossier. Retenez simplement cette règle :

> Ouvrez l'éditeur depuis l'intérieur du dossier extrait de Cave, et gardez le contenu du dossier ensemble.

Résoudre les problèmes : Problèmes courants lors du premier lancement

Si le Gestionnaire de projets n'apparaît pas, ou si l'éditeur apparaît et se ferme immédiatement, vérifiez d'abord les éléments suivants :

1. Le moteur n'a pas été entièrement extrait

Si Cave ne peut pas trouver un fichier requis tel que Editor/imgui.ini, le moteur n'a probablement pas été extrait correctement, ou l'exécutable a été déplacé loin du reste des fichiers.

Corrigez cela en extrayant à nouveau le package complet dans un dossier propre. Ensuite, lancez l'éditeur depuis ce dossier.

2. Le moteur est dans un dossier problématique

Si l'éditeur avertit au sujet du chemin d'installation, déplacez Cave vers un dossier local plus simple. Évitez les dossiers cloud, les dossiers de bureau synchronisés, les caractères non-ASCII et les chemins très longs.

3. L'antivirus a supprimé ou bloqué des fichiers

Certains outils antivirus peuvent mettre en quarantaine des fichiers provenant de logiciels fraîchement téléchargés. Si des fichiers manquent après extraction, restaurez-les depuis la quarantaine de l'antivirus ou téléchargez et extrayez à nouveau Cave.

En cas de doute, extrayez Cave dans un dossier propre et assurez-vous que tous les fichiers du package sont toujours là.

4. Les pilotes graphiques sont obsolètes

Cave utilise un moteur 3D de bureau, donc votre pilote graphique est important. Si l'éditeur plante lors du démarrage, ouvre une fenêtre vide ou affiche des erreurs de rendu, mettez à jour votre pilote GPU depuis le site Web du fabricant de votre GPU.

C'est particulièrement important sur les ordinateurs portables, les ordinateurs plus anciens, ou les nouvelles installations de Windows.

5. Vous lancez le mauvais fichier

Utilisez l'exécutable de l'éditeur pour créer des projets. L'exécutable de jeu/joueur est destiné à exécuter des jeux exportés, pas à éditer des projets source. Si vous voulez créer un jeu, ouvrez Cave Editor.

Qu'est-ce qui vient ensuite

Une fois le Gestionnaire de projets ouvert, Cave est prêt pour votre premier projet.

Dans la prochaine leçon, vous créerez un nouveau projet, choisirez un modèle de démarrage, ajusterez le zoom de l’éditeur si nécessaire et comprendrez ce que Cave génère pour vous.