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

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

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

Что вам нужно

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

• Действующая лицензия Cave Engine.
• Компьютер с обновленными графическими драйверами: Cave требует драйверов OpenGL 4.3 или выше, чтобы работать. Этот графический 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\Рабочий стол с акцентами\Cave Engine\
C:\Очень\Длинный\Путь\К\Папке\С\Многими\Многими\Вложенными\Папками\Cave Engine\

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

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

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

Когда Cave откроется правильно, вы должны увидеть окно Менеджера проектов. Это первый экран редактора. Отсюда вы можете создать новый проект, открыть недавний проект или просмотреть существующий:

Понимание основных файлов движка

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

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

На данный момент вам не нужно понимать каждый файл в папке. Просто помните это правило:

> Открывайте редактор из извлечённой папки Cave и держите содержимое папки вместе.

Поиск и устранение неполадок: распространенные проблемы при первом запуске

Если Менеджер проектов не появляется или редактор открывается и немедленно закрывается, сначала проверьте следующее:

1. Движок не был полностью извлечён

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

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

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

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

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

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

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

4. Графические драйверы устарели

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

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

5. Вы запускаете неправильный файл

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

Что дальше

Как только Менеджер проектов откроется, Cave готов к вашему первому проекту.

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