Добро пожаловать в Cave Engine!

Cave — это простой, быстрый 3D-движок для настольных игр, созданный для разработки игр без лишних сложностей с инструментами. Редактор предоставляет привычные строительные блоки коммерческого игрового движка, такие как сцены, сущности, компоненты, ассеты, физика, анимация, UI, аудио, таймлайны, Python-скрипты и многое другое, при этом рабочий процесс разработан быть максимально прямолинейным. Вам не нужно компилировать игровой код или ждать компиляции шейдеров, чтобы начать экспериментировать.

В этом учебном квесте вы пройдёте путь от первого запуска Cave до создания, тестирования и экспорта базового игрового проекта. Этот первый урок посвящён только правильной установке редактора и его безопасному запуску.

Что понадобится

Перед началом убедитесь, что у вас есть:

• Действующая лицензия на Cave Engine.
• Компьютер с обновлёнными графическими драйверами: Cave требует драйверы с поддержкой OpenGL 4.3 или выше. Этот Graphics API был выпущен в 2012 году, так что большая часть современных машин уже его поддерживает.
• Обычная локальная папка, куда вы можете распаковать движок: на Windows это может быть простой путь, например C:\Cave Engine\. Точное имя папки выбирайте сами — оно должно быть коротким, легко доступным и не располагаться в папках с синхронизацией облака.

Установка Cave Engine

Cave Engine распространяется в виде сжатой папки (ZIP). Уникальная сборка движка будет скомпилирована и предоставлена вам нашим сервером здесь. Она персональна для вас, и её нельзя передавать или распространять — это запрещено нашим Лицензионным соглашением с конечным пользователем.

Для установки распакуйте весь пакет движка в отдельную папку.

Важно:

• Не запускайте Cave напрямую из .zip файла.
• Не распаковывайте Cave в папку, где уже есть посторонние файлы.
• Не разбивайте файлы движка по разным папкам.

После распаковки в папке с движком должны быть исполняемый файл редактора, исполняемый файл игры/плеера и важные вспомогательные папки, например Editor и Lib. Конкретные имена файлов могут немного отличаться в зависимости от ОС и сборки, но главное правило простое: держите распакованную папку цельной.

> Cave требует сохранять файловую структуру. Если вы переместите, переименуете или удалите случайные файлы из папки движка, редактор может не запуститься.

Устранение проблем с путём установки

При запуске Cave проверяет некоторые типичные проблемы с путём установки. Эти проблемы могут вызывать сбои, отсутствие файлов или неправильное поведение, особенно на Windows. Используйте путь, который соответствует следующим требованиям:

• Держите Cave вне папок OneDrive, Dropbox, Google Drive и подобных синхронизируемых папок.
• Не распаковывайте движок на рабочий стол, особенно если ваш рабочий стол синхронизируется через OneDrive.
• Не используйте в пути папки символы вне ASCII, например буквы с ударениями или иные специальные символы.
• Пусть путь будет достаточно коротким.
• Избегайте папок, помеченных как офлайн, виртуальные или только облачные.

Хороший пример:

C:\Cave Engine\

Рисковые примеры:

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\

Если Cave выдаёт предупреждение «Invalid Install Path», переместите всю распакованную папку движка в более чистый локальный путь и запустите снова.

Запуск редактора

Для запуска Cave откройте исполняемый файл Cave Editor внутри папки движка. На Windows это обычно файл с расширением .exe. Вы можете создать ярлык на рабочем столе или закрепить программу на панели задач, но ярлык делайте на исполняемый файл внутри папки движка, не перемещайте этот файл.

Если Cave запускается корректно, вы увидите окно Project Manager. Это стартовый экран редактора, откуда можно создать новый проект, открыть недавний или выбрать существующий:

Основные файлы движка

Перед тем как перейти к деталям работы с движком, давайте лучше разберёмся с файлами в папке движка. Движок состоит из инструментов для создания игры и времени выполнения для запуска экспортированной игры.

• Исполняемый файл редактора — программа, с помощью которой вы создаёте и редактируете проекты.
• Исполняемый файл игры/плеера — используется в экспортированных проектах для запуска готовой игры.
• Папка Editor содержит данные редактора: иконки, стандартные ассеты, шрифты, файлы интерфейса и другие ресурсы, необходимые редактору.
• Папка Lib содержит нужные библиотеки времени выполнения, включая файлы для работы Python скриптинга.

Пока не нужно разбираться со всеми файлами. Просто запомните правило:

> Запускайте редактор из распакованной папки Cave и храните содержимое папки вместе.

Решение распространённых проблем первого запуска

Если окно Project Manager не появляется или редактор запускается и сразу закрывается, проверьте следующее:

1. Движок не был корректно распакован

Если Cave не может найти нужный файл, например Editor/imgui.ini, значит движок либо распакован не полностью, либо исполняемый файл был перемещён из папки с остальными файлами.

Исправьте это, распаковав весь пакет заново в чистую папку. Затем запустите редактор из этой папки.

2. Движок находится в проблемной папке

Если редактор предупреждает про путь установки, переместите Cave в более простую локальную папку. Избегайте облачных папок, синхронизируемого рабочего стола, символов вне ASCII и слишком длинных путей.

3. Антивирус удалил или заблокировал файлы

Некоторые антивирусы могут помещать новые файлы в карантин. Если после распаковки файлов не хватает, восстановите их из карантина или скачайте и распакуйте Cave заново.

В случае сомнений распакуйте Cave в чистую папку и убедитесь, что все файлы на месте.

4. Устаревшие драйверы графики

Cave использует 3D рендеринг на рабочем столе, поэтому важно, чтобы драйвер графики был актуален. Если редактор падает при запуске, открывается пустое окно или появляются ошибки рендеринга, обновите драйвер GPU с сайта производителя.

Это особенно важно для ноутбуков, старых компьютеров или после свежей установки Windows.

5. Вы запускаете не тот файл

Для создания проектов используйте исполняемый файл редактора. Исполняемый файл игры/плеера нужен только для запуска готовых проектов. Чтобы создавать игры, открывайте Cave Editor.

Что дальше

Когда откроется Project Manager, Cave готов к созданию вашего первого проекта.

В следующем уроке вы создадите новый проект, выберете стартовый шаблон, при необходимости настроите масштаб редактора и разберётесь, что именно Cave создаёт для вас.