Bienvenue dans Cave Engine !

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

Dans cette quête de prise en main, 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 basique. Cette première leçon concerne uniquement l'installation correcte de l'éditeur et son lancement sécurisé.

Ce dont vous avez besoin

Avant de commencer, assurez-vous d'avoir :

• Une licence valide de Cave Engine.
• Un ordinateur avec des pilotes graphiques à jour : Cave nécessite des pilotes OpenGL 4.3 ou plus récents pour fonctionner. Cette API graphique a été publiée en 2012, donc votre machine la supporte probablement déjà.
• Un dossier local normal où vous pouvez extraire le moteur : Sous Windows, un emplacement simple comme C:\Cave Engine\ est un bon choix. Le nom exact du dossier vous appartient, 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 vous est unique et le partage ou la redistribution sont interdits par notre Contrat de Licence Utilisateur Final.

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

Important :

• Ne lancez pas Cave directement depuis le fichier .zip.
• N'extrayez pas Cave dans un dossier contenant déjà des fichiers non liés.
• Ne dispersez pas les fichiers du moteur dans différents emplacements.

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

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

Résolution des problèmes liés au chemin d'installation

Cave vérifie plusieurs problèmes courants de chemin d'installation au démarrage. Ces problèmes peuvent provoquer des plantages, des fichiers manquants ou un comportement étrange, surtout sous Windows. Utilisez un chemin de dossier respectant ces règles :

• Gardez Cave en dehors de OneDrive, Dropbox, Google Drive et autres dossiers synchronisés.
• Évitez de l'extraire sur le Bureau, surtout si celui-ci est synchronisé avec OneDrive.
• Évitez les caractères non ASCII dans le chemin, comme 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 à risque :

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Desktop With Accents\Cave Engine\
C:\Very\Long\Folder\Path\With\Many\Many\Nested\Folders\Cave Engine\

Si Cave affiche un avertissement "Invalid Install Path", déplacez l'intégralité du dossier du moteur extrait vers un chemin local plus simple et ouvrez-le à nouveau.

Lancement de l'éditeur

Pour démarrer Cave, ouvrez l'exécutable Cave Editor dans le dossier du moteur. Sous Windows, ce sera généralement 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 sans déplacer ce dernier hors du dossier du moteur.

Lorsque Cave s'ouvre correctement, vous devriez voir la fenêtre du Project Manager. C'est le premier écran de l'éditeur. À partir de là, vous pouvez créer un nouveau projet, ouvrir un projet récent ou parcourir pour en sélectionner un 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 plusieurs types de fichiers 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 éditer des projets.
• L'exécutable du 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 de l'éditeur comme des icônes, des assets par défaut, des polices, des fichiers d'interface et d'autres ressources nécessaires à l'éditeur.
• Le dossier Lib contient les bibliothèques runtime requises, y compris les 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 juste cette règle :

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

Dépannage : problèmes courants au premier lancement

Si le Project Manager n'apparaît pas, ou si l'éditeur s'ouvre puis se ferme immédiatement, vérifiez d'abord ces points :

1. Le moteur n'a pas été complètement extrait

Si Cave ne trouve pas un fichier requis comme Editor/imgui.ini, c'est probablement que le moteur n'a pas été extrait correctement, ou que l'exécutable a été déplacé en dehors du dossier avec les autres fichiers.

Réparez-le en extrayant à nouveau le package complet dans un dossier propre. Puis lancez l'éditeur depuis ce dossier.

2. Le moteur est dans un dossier problématique

Si l'éditeur avertit à propos du chemin d'installation, déplacez Cave dans un dossier local plus simple. Évitez les dossiers cloud, les dossiers 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 puis extrayez Cave à nouveau.

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

4. Les pilotes graphiques sont obsolètes

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

Ceci est particulièrement important pour les ordinateurs portables, les machines plus anciennes ou les installations Windows récentes.

5. Vous lancez le mauvais fichier

Utilisez l'exécutable de l'éditeur pour créer des projets. L'exécutable du jeu/joueur sert à lancer des jeux exportés, pas à éditer des projets sources. Pour créer un jeu, ouvrez Cave Editor.

Et ensuite ?

Une fois le Project Manager ouvert, Cave est prêt pour votre premier projet.

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