Willkommen bei Cave Engine!

Cave ist eine einfache, schnelle 3D-Desktop-Spiel-Engine, die entwickelt wurde, um Spiele zu erstellen, ohne sich zuerst mit dem Werkzeug herumschlagen zu müssen. Der Editor bietet dir die üblichen Bausteine einer kommerziellen Spiele-Engine, wie Szenen, Entities, Komponenten, Assets, Physik, Animation, UI, Audio, Timelines, Python-Scripting und mehr, aber der Workflow ist darauf ausgelegt, direkt zu bleiben. Du musst keinen Spielecode kompilieren oder auf Shader-Kompilierung warten, um einfach mit dem Experimentieren zu beginnen.

In diesem Getting Started Quest wirst du von der ersten Öffnung von Cave bis zum Erstellen, Testen und Exportieren eines einfachen Spieleprojekts geführt. Diese erste Lektion handelt lediglich davon, 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 besitzt.
• Einen Computer mit aktualisierten Grafiktreibern hast: 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 Gerät sie wahrscheinlich schon.
• Einen normalen lokalen Ordner, in den du die Engine entpacken kannst: Unter Windows ist ein einfacher Ort wie C:\Cave Engine\ eine gute Wahl. Der genaue Ordnername liegt bei dir, sollte aber kurz, leicht zu finden und nicht in einem synchronisierten Cloud-Ordner sein.

Installation der Cave Engine

Cave Engine wird als komprimierter Ordner (ZIP) verteilt. Ein einzigartiger Build der Engine wird dir von unserem Server hier zur Verfügung gestellt. Dieser Build ist nur für dich bestimmt und das Teilen oder Weiterverbreiten ist laut unserer Endbenutzer-Lizenzvereinbarung verboten.

Um sie zu installieren, entpacke das gesamte Engine-Paket in einen separaten Ordner.

Wichtig:

• Starte Cave nicht direkt aus der .zip-Datei.
• Entpacke Cave nicht in einen Ordner, der bereits nicht zusammenhängende Dateien enthält.
• Teile die Engine-Dateien nicht auf verschiedene Orte auf.

Nach dem Entpacken sollte der Engine-Ordner die Editor-Ausführungsdatei, die Spiel-/Player-Ausführungsdatei und wichtige Support-Ordner wie Editor und Lib enthalten. Die genauen Dateinamen können je nach Betriebssystem und Engine-Build leicht variieren, aber die wichtigste Regel ist einfach: Halte den entpackten Ordner zusammen.

> Cave benötigt seine Dateien in derselben Ordnerstruktur. Wenn du Dateien im Engine-Ordner verschiebst, umbenennst oder löschst, kann der Editor möglicherweise nicht starten.

Fehlerbehebung beim Installationspfad

Cave überprüft beim Starten mehrere häufige Probleme mit dem Installationspfad. Diese Probleme können Abstürze, fehlende Dateien oder merkwürdiges Verhalten verursachen, besonders unter Windows. Verwende einen Ordnerpfad, der folgende Regeln befolgt:

• Halte Cave außerhalb von OneDrive, Dropbox, Google Drive und ähnlichen synchronisierten Ordnern.
• Vermeide es, es auf dem Desktop zu entpacken, besonders wenn dein Desktop von OneDrive synchronisiert wird.
• Vermeide Nicht-ASCII-Zeichen im Pfad, z.B. Akzentbuchstaben oder andere Sonderzeichen.
• Halte den Pfad vernünftigerweise 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 With Accents\Cave Engine\
C:\Very\Long\Folder\Path\With\Many\Many\Nested\Folders\Cave Engine\

Wenn Cave eine Warnung "Invalid Install Path" zeigt, verschiebe den gesamten entpackten Engine-Ordner an einen saubereren lokalen Pfad und öffne ihn erneut.

Starten des Editors

Zum Starten von Cave öffne die ausführbare Datei Cave Editor im Engine-Ordner. Unter Windows ist das meist eine .exe-Datei. Du kannst eine Desktop-Verknüpfung erstellen oder es an die Taskleiste heften, aber erstelle die Verknüpfung zur ausführbaren Datei, anstatt die Datei aus dem Engine-Ordner zu verschieben.

Wenn Cave korrekt öffnet, solltest du das Fenster des Project Managers sehen. Dies ist der erste Bildschirm des Editors. Von hier aus kannst du ein neues Projekt erstellen, ein kürzlich geöffnetes Projekt laden oder ein bestehendes durchsuchen:

Verstehen der Grundlegenden Engine-Dateien

Bevor wir zu den Engine-spezifischen Details kommen, wollen wir die Engine-Dateien etwas besser verstehen. Der Engine-Ordner enthält verschiedene Arten von Dateien, weil Cave in die Werkzeuge zur Spieleerstellung und die Laufzeit für exportierte Spiele aufgeteilt ist.

• Die Editor-Ausführungsdatei ist die Anwendung, mit der du Projekte erstellst und bearbeitest.
• Die Spiel/Player-Ausführungsdatei wird von exportierten Projekten verwendet. Sie startet das fertige Spiel für die Spieler.
• Der Editor-Ordner enthält Editordaten wie Icons, Standard-Assets, Schriftarten, Schnittstellendateien und andere Ressourcen, die der Editor benötigt.
• Der Lib-Ordner enthält erforderliche Laufzeitbibliotheken, inklusive Python-bezogener Dateien, die vom Cave-Skriptsystem genutzt werden.

Im Moment musst du nicht jede Datei im Ordner verstehen. Merke dir nur folgende Regel:

> Öffne den Editor aus dem entpackten Cave-Ordner heraus und halte die Ordnerinhalte zusammen.

Fehlerbehebung: Häufige Probleme beim ersten Start

Wenn der Project Manager nicht erscheint oder der Editor sofort schließt, prüfe zuerst:

1. Die Engine wurde nicht vollständig entpackt

Wenn Cave eine benötigte Datei wie Editor/imgui.ini nicht findet, wurde die Engine wahrscheinlich nicht korrekt entpackt oder die ausführbare Datei wurde von den anderen Dateien getrennt.

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

2. Die Engine befindet sich in einem Problemordner

Wenn der Editor eine Warnung zum 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 Antivirus-Programme setzen Dateien von frisch heruntergeladener Software in Quarantäne. Wenn Dateien nach dem Entpacken fehlen, stelle sie aus der Antivirus-Quarantäne wieder her oder lade und entpacke Cave erneut.

Im Zweifelsfall entpacke Cave in einen sauberen Ordner und prüfe, ob alle Dateien aus dem Paket noch vorhanden sind.

4. Grafiktreiber sind veraltet

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

Das ist besonders wichtig bei Laptops, älteren Rechnern oder frischen Windows-Installationen.

5. Falsche Datei wird gestartet

Verwende die Editor-Ausführungsdatei zum Erstellen von Projekten. Die Spiel/Player-Ausführungsdatei dient zum Ausführen exportierter Spiele, nicht zum Bearbeiten der Quellprojekte. Wenn du ein Spiel erstellen möchtest, öffne Cave Editor.

Was als Nächstes kommt

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

In der nächsten Lektion erstellst du ein neues Projekt, wählst eine Startervorlage, passt die Editor-Zoomstufe bei Bedarf an und verstehst, was Cave für dich generiert.