Willkommen bei Cave Engine!

Cave ist eine einfache, schnelle 3D-Desktop-Spiel-Engine, die zum Erstellen von Spielen gedacht ist, ohne dass man zuerst mit dem Tool kämpfen muss. Der Editor bietet die üblichen Bausteine einer kommerziellen Spiel-Engine, wie Szenen, Entitäten, Komponenten, Assets, Physik, Animation, UI, Audio, Zeitlinien, Python-Scripting und mehr, aber der Workflow ist so gestaltet, dass er direkt bleibt. Du musst keinen Spielcode kompilieren oder auf die Shader-Kompilierung warten, nur um mit dem Experimentieren zu beginnen.

In diesem Einsteiger-Quest wirst du vom ersten Öffnen von Cave bis zum Erstellen, Testen und Exportieren eines einfachen Spielprojekts gelangen. Diese erste Lektion befasst sich nur damit, den Editor korrekt zu installieren und sicher zu starten.

Was Du Brauchst

Bevor du beginnst, stelle sicher, dass du:

• Eine gültige Cave Engine-Lizenz hast.
• Einen Computer mit aktualisierten Grafikkarten-Treibern: Cave benötigt OpenGL 4.3 oder höhere Treiber, um zu funktionieren. Diese Grafik-API wurde bereits 2012 veröffentlicht, daher unterstützt dein Computer sie wahrscheinlich bereits.
• Einen normalen lokalen Ordner, in den du die Engine extrahieren kannst: Unter Windows ist ein einfacher Ort wie C:\Cave Engine\ eine gute Wahl. Der genaue Ordnername liegt bei dir, aber er sollte kurz, leicht zu finden und nicht in einem synchronisierten Cloud-Ordner liegen.

Installation von Cave Engine

Cave Engine wird als komprimierter Ordner (ZIP) verteilt. Ein einzigartiger Build der Engine wird von unserem Server für dich hier kompiliert und bereitgestellt. Er ist einzigartig für dich und das Teilen oder die Weiterverbreitung ist gegen unsere Endbenutzer-Lizenzvereinbarung, daher ist es verboten.

Um es zu installieren, extrahiere das gesamte Engine-Paket in einen eigenen Ordner.

Wichtig:

• Starte Cave nicht direkt aus der .zip-Datei.
• Extrahiere Cave nicht in einen Ordner, der bereits nicht verwandte Dateien enthält.
• Teile die Engine-Dateien nicht an verschiedenen Orten auf.

Nach dem Extrahieren sollte der Engine-Ordner die ausführbare Editor-Datei, die Spiel-/Spieler-executive Datei und wichtige Unterstützungsordner wie Editor und Lib enthalten. Die genauen Dateinamen können je nach Betriebssystem und Engine-Build leicht variieren, aber die wichtige Regel ist einfach: Halte den extrahierten Ordner zusammen.

> Cave benötigt, dass seine Dateien in der gleichen Ordnerstruktur bleiben. Wenn du zufällige Dateien aus dem Engine-Ordner verschiebst, umbenennst oder löschst, kann der Editor möglicherweise nicht geöffnet werden.

Fehlerbehebung des Installationspfads

Cave überprüft beim Starten auf mehrere häufige Installationspfadprobleme. Diese Probleme können Abstürze, fehlende Dateien oder seltsames Verhalten verursachen, insbesondere unter Windows. Verwende einen Ordnerpfad, der diesen Regeln folgt:

• Halte Cave außerhalb von OneDrive, Dropbox, Google Drive und ähnlichen synchronisierten Ordnern.
• Vermeide es, es auf dem Desktop zu extrahieren, insbesondere wenn dein Desktop von OneDrive synchronisiert wird.
• Vermeide nicht-ASCII-Zeichen im Ordnerpfad, wie z.B. Akzentzeichen oder andere spezielle Sprachzeichen.
• Halte den Pfad angemessen kurz.
• Vermeide Ordner, die als offline, virtuell oder nur in der Cloud markiert sind.

Gutes Beispiel:

C:\Cave Engine\

Riskante Beispiele:

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Desktop Mit Akzenten\Cave Engine\
C:\Sehr\Langer\Ordner\Pfad\Mit\Viel\Viel\Verschachtelten\Ordnern\Cave Engine\

Wenn Cave eine "Ungültiger Installationspfad"-Warnung anzeigt, verschiebe den gesamten extrahierten Engine-Ordner an einen saubereren lokalen Pfad und öffne ihn erneut.

Starten des Editors

Um Cave zu starten, öffne die ausführbare Cave Editor-Datei im Engine-Ordner. Unter Windows wird dies normalerweise wie eine .exe-Datei aussehen. Du kannst eine Desktop-Verknüpfung erstellen oder sie an die Taskleiste anheften, achte jedoch darauf, die Verknüpfung zur ausführbaren Datei zu erstellen, anstatt die ausführbare Datei aus dem Engine-Ordner zu verschieben.

Wenn Cave korrekt geöffnet wird, siehst du das Fenster des Projektmanagers. Dies ist der erste Bildschirm des Editors. Von dort aus kannst du ein neues Projekt erstellen, ein aktuelles Projekt öffnen oder nach einem bestehenden suchen:

Verständnis der grundlegenden Engine-Dateien

Bevor wir zu den enginespezifischen Dingen übergehen, lass uns die Engine-Dateien besser verstehen. Der Engine-Ordner enthält mehr als eine Art von Datei, da Cave in die Werkzeuge zum Erstellen eines Spiels und die Laufzeit zum Spielen eines exportierten Spiels aufgeteilt ist.

• Die ausführbare Editor-Datei ist die Anwendung, die du verwendest, um Projekte zu erstellen und zu bearbeiten.
• Die Spiel-/Spieler-executive Datei wird von exportierten Projekten verwendet. Sie führt das endgültige Spiel für die Spieler aus.
• Der Editor-Ordner enthält Editor-Daten wie Icons, Standard-Assets, Schriftarten, Schnittstellendateien und andere Ressourcen, die der Editor benötigt.
• Der Lib-Ordner enthält erforderliche Laufzeitbibliotheken, einschließlich der mit Python verbundenen Dateien, die von Caves Scripting-System verwendet werden.

Für den Moment musst du nicht jede Datei im Ordner verstehen. Denk einfach an diese Regel:

> Öffne den Editor aus dem extrahierten Cave-Ordner und halte den Ordnerinhalt zusammen.

Fehlerbehebung: Häufige Probleme beim ersten Start

Wenn der Projektmanager nicht erscheint oder der Editor erscheint und sofort schließt, überprüfe zuerst diese Punkte:

1. Die Engine Wurde Nicht Vollständig Extrahiert

Wenn Cave eine erforderliche Datei wie Editor/imgui.ini nicht finden kann, wurde die Engine wahrscheinlich nicht korrekt extrahiert oder die ausführbare Datei wurde von den übrigen Dateien verschoben.

Behebe es, indem du das vollständige Paket erneut in einen sauberen Ordner extrahierst. Starte dann den Editor von diesem Ordner aus.

2. Die Engine Befindet Sich In Einem Problemordner

Wenn der Editor eine Warnung über den Installationspfad anzeigt, verschiebe Cave in einen einfacheren lokalen Ordner. Vermeide Cloud-Ordner, synchronisierte Desktop-Ordner, nicht-ASCII-Zeichen und sehr lange Pfade.

3. Antivirus Hat Dateien Entfernt oder Blockiert

Einige Antivirenprogramme können Dateien aus frisch heruntergeladener Software quaranfinen. Falls Dateien nach dem Extrahieren fehlen, stelle sie aus der Quarantäne des Antivirenprogramms wieder her oder lade und extrahiere Cave erneut.

Wenn du Zweifel hast, extrahiere Cave in einen sauberen Ordner und stelle sicher, dass alle Dateien aus dem Paket noch vorhanden sind.

4. Die Grafikkartentreiber Sind Veraltet

Cave verwendet einen Desktop-3D-Renderer, daher ist dein Grafikkartentreiber wichtig. Wenn der Editor beim Start abstürzt, ein leeres Fenster öffnet oder Renderfehler anzeigt, aktualisiere deinen GPU-Treiber von der Website des GPU-Herstellers.

Dies ist besonders wichtig bei Laptops, älteren Computern oder frischen Windows-Installationen.

5. Du Führst Die Falsche Datei Aus

Verwende die ausführbare Datei des Editors, um Projekte zu erstellen. Die Spiel-/Spieler-executive Datei ist zum Ausführen exportierter Spiele gedacht, nicht zum Bearbeiten von Quellprojekten. Wenn du ein Spiel erstellen möchtest, öffne Cave Editor.

Was Kommt Als Nächstes

Sobald der Projektmanager geöffnet ist, ist Cave bereit für dein erstes Projekt.

In der nächsten Lektion wirst du ein neues Projekt erstellen, eine Startervorlage auswählen, den Zoom des Editors bei Bedarf anpassen und verstehen, was Cave für dich generiert.