Read this manual in English

Обзор редактора Defold

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

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

При запуске редактора Defold, появляется экран выбора и создания проекта. Кликните мышью, в соответствии с желаемым действием:

Home

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

New Project

Позволяет создать новый проект Defold. Здесь вам необходимо выбрать, хотите ли вы использовать базовый шаблон (из вкладки From Template), следовать учебнику (вкладка From Tutorial) или попробовать один из проектов-примеров (вкладка From Sample).

При создании новый проект сохраняется на локальном диске, и все сделанные изменения сохраняются локально.

Подробнее о различных опциях можно узнать в руководстве по настройке проекта.

Панели редактора

Редактор Defold разделен на несколько панелей, или представлений, которые отображают определенную информацию.

Панель Assets

Содержит список всех файлов, являющихся частью проекта. Навигация по списку осуществляется посредством прокрутки мыши. В этом представлении могут быть выполнены любые файловые операции:

• Выполните двойной клик по файлу, чтобы открыть его в редакторе, соответствующем этому типу файлов.
• Перетащите и бросьте, чтобы добавить в проект файлы из других расположений на диске или переместить файлы и папки в новые расположения в пределах проекта.
• Выполните клик ПКМ, чтобы открыть контекстное меню, с помощью которого можно создавать новые файлы или папки, переименовывать, удалять, отслеживать файловые зависимости и многое другое.

Панель Editor

Представление по центру отображает текущий открытый файл в редакторе соответствующего типа. Все визуальные редакторы позволяют управлять видом камеры:

• Панорамирование: Alt + ЛКМ.
• Зумирование: Alt + ПКМ (трехкнопочная мышь) или Ctrl + Mouse button (однокнопочная мышь). Если мышь оснащена колесом прокрутки, его можно использовать для зумирования.
• Вращение в 3D: Ctrl + ЛКМ.

В правом верхнем углу представления сцены расположен тулбар, на котором можно найти инструменты манипулирования объектами: Move, Rotate и Scale.

Панель Outline

Это представление отображает содержимое редактируемого в данный момент файла в виде иерархической древовидной структуры. Outline отражает представление редактора, позволяя выполнять операции с элементами:

• Кликните по элементу, чтобы выделить его. Удерживайте Shift или Option, чтобы расширить выделение.
• Перетащите и бросьте элемент для перемещения. Бросьте какой-либо игровой объект на другой игровой объект в коллекции, чтобы сделать его дочерним.
• Кликните ПКМ чтобы открыть контекстное меню, с помощью которого можно добавлять, удалять выделенные элементы и т.д.

Панель Properties

Это представление отображает свойства (такие как Position, Rotation, Animation и т.д.), ассоциированные с текущим выбранным элементом.

Панель Tools

В этом представлении есть несколько вкладок. Вкладка Console отображает вывод какой-либо ошибки или целенаправленный вывод, осуществляемый вами во время выполнения игры. Рядом с консолью находятся вкладки Build Errors, Search Results, а также Curve Editor, используемый при редактировании кривых в редакторе частиц. Панель Tools также используется для взаимодействия со встроенным отладчиком.

Панель Changed Files

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

• Выполните двойной клик по файлу чтобы открыть представление отличий. Defold открывает файл в подходящем редакторе, так же, как и в представлении ассетов.
• Выполните клик ПКМ по файлу, чтобы открыть всплывающее меню, с помощью которого можно открыть представление отличий, отменить все изменения, сделанные в файле, найти файл в файловой системе и многое другое.

Двухпанельное редактирование

Когда открыто несколько файлов, для каждого из них в верхней части окна редактора отображается отдельная вкладка. Рядом друг с другом можно открыть 2 представления редактора. Выполните клик ПКМ по вкладке редактора, который хотите переместить, и выберите Move to Other Tab Pane.

С помощью меню вкладок можно также поменять местами две панели или объединить их в одну.

Редактор сцен

Двойной клик по файлу коллекции или игрового объекта приводит к открытию редактора сцены:

Выделение объектов

Клик по объектам в главном окне выделяет их. Прямоугольник, окружающий объект в представлении редактора, будет подсвечен зеленым цветом, указывая на то, какой элемент выделен. Выделенный объект также подсвечивается в представлении Outline.

Объекты можно выделять и другим способом:

• Кликните и перетащите, чтобы выделить все объекты, попавшие внутрь области выделения.
• Кликните по объекту в представлении Outline.

Для добавления к выделению зажмите и удерживайте Shift или ⌘ (Mac) / Ctrl (Win/Linux) при клике по объектам.

Инструмент перемещения

Для перемещения объектов используется инструмент Move. Активировать его можно на тулбаре в правом верхнем углу редактора сцены, или нажав клавишу W.

На выделенном объекте отображается набор манипуляторов (квадратики и стрелки). Перетаскивание центрального маркера, в виде зеленого квадратика, приводит к свободному перемещению объекта в пространстве экрана, перетаскивание стрелок позволяет перемещать объект по осям X, Y и Z. Здесь же имеются маркеры-квадратики для перемещения объекта в плоскости X-Y, а также (видно при повороте камеры в 3D) в плоскостях X-Z и Y-Z.

Инструмент вращения

Для вращения объектов используется инструмент Rotate, который можно активировать на тулбаре и нажатием клавиши E.

Данный инструмент состоит из четырех круговых манипуляторов: один оранжевый, вращающий объект в пространстве экрана, и по одному для вращения вокруг каждой из осей X, Y и Z. Поскольку вид является параллельным по отношению к осям X и Y, круги отображаются только как две прямые, пересекающие объект.

Инструмент масштабирования

Для масштабирования объектов используется инструмент Scale, который можно активировать на тулбаре и нажатием клавиши R.

Этот инструмент состоит из набора квадратных маркеров. Из них центральный равномерно масштабирует объект по всем осям (включая Z). Также имеется по одному маркеру для масштабирования вдоль каждой из осей X, Y и Z и по одному — для масштабирования в плоскостях X-Y, X-Z и Y-Z.

Создание новых файлов проекта

Создавать новые файлы ресурсов можно двумя способами: выполнив File ▸ New... и выбрав тип файла из меню, либо используя контекстное меню:

Выполните клик ПКМ в целевом расположении в браузере ассетов, затем выберите New... ▸ [тип файла]:

Введите подходящее имя для нового файла. Полное имя файла, включая суффикс типа файла, отображается в диалоге в строке Path:

Импортирование файлов в проект

Добавление в проект файлов ассетов (изображений, звуков, моделей и т.д.) осуществляется простым перетаскиванием их в нужную позицию в браузер ассетов. При этом создаются копии файлов в выбранном расположении файловой структуры проекта. За подробностями обращайтесь к нашему руководству по импортированию ассетов.

Обновление редактора

Редактор будет автоматически проверять наличие обновлений. При обнаружении обновление будет отображаться в правом нижнем углу окна редактора и на экране выбора проекта. При клике по ссылке Update Available будет произведена загрузка и обновление редактора.

Клавиатурные сокращения

Сокращения по умолчанию

Кастомизация сокращений

Клавиатурные сокращения можно настроить, если создать конфигурационный файл (например, keymap.edn в домашней директории). Затем необходимо выполнить File ▸ Preferences и в строку Path to custom keymap прописать путь к созданному файлу. Необходимо перезапустить Defold после изменения этой настройки, а также каждый раз при редактировании файла keymap.

Просмотреть и скачать файлы конфигурации клавиш можно здесь: Windows, MacOS, Linux

Журнал событий редактора

При возникновении проблем с редактором и при необходимости сообщить о проблеме, лучше всего предоставить лог-файлы из самого редактора. Лог-файлы редактора можно найти в следующих расположениях:

• Windows: C:\Users\ **Your Username** \AppData\Local\Defold
• macOS: /Users/ **Your Username** /Library/Application Support/ или ~/Library/Application Support/Defold
• Linux: ~/.Defold

Получить доступ к журналу редактора можно также во время его работы, если он запущен из терминала/командной строки. Для запуска редактора из терминала на macOS:

$ > ./path/to/Defold.app/Contents/MacOS/Defold

FAQ

Q: What are the system requirements for the editor?

A: The editor will use up to 75% of the available memory of the system. On a computer with 4 GB of RAM this should be enough for smaller Defold projects. For mid-sized or large projects it is recommended to use 6 GB or more of RAM.

Q: Are Defold beta versions auto-updating?

A: Yes. The Defold beta editor checks for an update at startup, just like the Defold stable version does.

Q: Why am I getting an error saying “java.awt.AWTError: Assistive Technology not found” when launching the editor?

A: This error is related to problems with Java assistive technology such as the NVDA screen reader. You probably have an .accessibility.properties file in your home folder. Remove the file and try launching the editor again. (Note: If you do use any assistive technology and require that file to be present then please reach out to us at info@defold.se to discuss alternative solutions).

Discussed here on the Defold forum.

Q: Why doesn’t the editor start or open my project?

A: Check if there are spaces in the path leading up to the Defold application. For instance, if you put the folder Defold-macosx containing the macOS version of the editor in your Applications folder, then you should be ok. If you rename the folder Defold macosx the editor might not start anymore. On Windows, putting Defold under C:\Program Files\ can trigger this problem. This is due to a known bug in the underlying Eclipse framework.

Q: Why am I getting an error saying “sun.security.validator.ValidatorException: PKIX path building failed” when launching the editor?

A: This exception occurs when the editor tries to make an https connection but the certificate chain provided by the server cannot be verified.

See this link for details on this error.

Q: Why am I am getting a “java.lang.OutOfMemoryError: Java heap space” when performing certain operations?

A: The Defold editor is built using Java and in some cases the default memory configuration of Java might not be sufficient. If this happens you can manually configure the editor to allocate more memory by editing the editor configuration file. The configuration file, named config, is located in the Defold.app/Contents/Resources/ folder on macOS. On Windows it is located next to Defold.exe executable and on Linux next to the Defold executable. Open the config file and add -Xmx6gb to the line starting with vmargs. Adding -Xmx6gb will set the max heap size to 6 gigabytes (the default is usually 4Gb). It should look something like this:

vmargs = -Xmx6gb,-Dfile.encoding=UTF-8,-Djna.nosys=true,-Ddefold.launcherpath=${bootstrap.launcherpath},-Ddefold.resourcespath=${bootstrap.resourcespath},-Ddefold.version=${build.version},-Ddefold.editor.sha1=${build.editor_sha1},-Ddefold.engine.sha1=${build.engine_sha1},-Ddefold.buildtime=${build.time},-Ddefold.channel=${build.channel},-Ddefold.archive.domain=${build.archive_domain},-Djava.net.preferIPv4Stack=true,-Dsun.net.client.defaultConnectTimeout=30000,-Dsun.net.client.defaultReadTimeout=30000,-Djogl.texture.notexrect=true,-Dglass.accessible.force=false,--illegal-access=warn,--add-opens=java.base/java.lang=ALL-UNNAMED,--add-opens=java.desktop/sun.awt=ALL-UNNAMED,--add-opens=java.desktop/sun.java2d.opengl=ALL-UNNAMED,--add-opens=java.xml/com.sun.org.apache.xerces.internal.jaxp=ALL-UNNAMED