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

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

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

При запуске редактора Defold вы увидите экран выбора и создания проекта. Выберите, что хотите сделать:

МОИ ПРОЕКТЫ (MY PROJECTS)

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

Если вы ещё не открывали проекты (или удалили все из списка), будет показано два варианта: вы можете нажать кнопку Открыть с диска… (Open From Disk…), чтобы найти и открыть существующий проект через системный файловый менеджер, или нажать кнопку Создать Проект (Create New Project), после чего произойдёт переключение на вкладку ИЗ ШАБЛОНОВ (TEMPLATES).

Если вы ранее открывали проекты, будет показан список ваших проектов, как на рисунке ниже:

Создать

ИЗ ШАБЛОНОВ (TEMPLATES)

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

ИЗ ТУТОРИАЛОВ (TUTORIALS)

Содержит проекты с пошаговыми обучающими материалами (tutorials), которые можно запускать, изучать и изменять, если вы хотите пройти обучение по руководству.

ИЗ ПРИМЕРОВ (SAMPLES)

Содержит проекты-примеры, подготовленные для демонстрации конкретных сценариев использования и возможностей движка.

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

Подробнее о доступных вариантах читайте в руководстве по настройке проекта.

Язык редактора

В левом нижнем углу стартового экрана находится выбор языка (Language). Здесь можно выбрать одну из доступных локализаций редактора (начиная с Defold 1.11.2). Тот же самый выбор доступен и уже внутри редактора через меню File ▸ Preferences ▸ General ▸ Editor Language (Файл ▸ Настройки ▸ Общие ▸ Язык редактора).

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

Редактор Defold разделён на несколько панелей (views), отображающих определённую информацию.

1. Панель ресурсы (Assets)

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

• Левый клик мыши — выбрать любой файл или папку; при удержании ⇧ Shift можно расширять выделение, а при удержании Ctrl/⌘ Cmd — добавлять или снимать выделение с элементов.
• Двойной клик — открыть файл в соответствующем редакторе для данного типа файла.
• Перетаскивание — добавить файлы с диска в проект или переместить существующие файлы и папки в новое место внутри структуры проекта.
• Правый клик — открыть контекстное меню, из которого можно создавать новые файлы и папки, переименовывать, удалять, отслеживать зависимости файлов и выполнять другие действия.

2. Панель редактор (Editor)

Центральная панель отображает текущий открытый файл в подходящем редакторе. Например, файлы скриптов открываются во встроенном pедактор кода, а визуальные компоненты в трёхмерном визуальном редакторе. Все визуальные редакторы позволяют изменять вид камеры:

• Панорамирование: Alt/⌥ Option + Левая кнопка мыши или Правая кнопка мыши.
• Масштабирование: Прокрутка колеса мыши или Alt/⌥ Option + Правая кнопка мыши
• Вращение в 3D: Ctrl/^ Control + Левая кнопка мыши.

Панель инструментов (Toolbar)

В правом верхнем углу окна сцены находится панель инструментов (Toolbar), где расположены инструменты манипулирования объектами (слева направо):

Инструмент перемещения (Move Tool - W), Инструмент вращения (Rotate Tool - E), Инструмент масштабирования (Scale Tool R), Настройки сетки ▦ (Grid Settings), Выровнять камеру 2D/3D 2D (Align Camera 2D/3D), Переключение перспективной/ортографической камеры (Camera Perspective/Orthographic Toggle) и Фильтры Видимости 👁 (Visibility Filters).

3. Панель структура (Outline)

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

• Левый клик мыши — выбрать элемент; при удержании ⇧ Shift можно расширять выделение, а при удержании Ctrl/⌘ Cmd — добавлять или снимать выделение с элементов.
• Перетаскивание — переместить элементы. Перетащите игровой объект (game object) на другой игровой объект в коллекции, чтобы создать связь родитель–потомок (parent-child).
• Правый клик — открыть контекстное меню для добавления или удаления элементов и других операций.

Можно переключать видимость игровых объектов и компонентов, щёлкнув по значку глаза 👁 справа от элемента (начиная с Defold 1.9.8).

4. Панель свойства (Properties)

Отображает свойства выбранного объекта, такие как позиция, вращение, анимация и другие свойства, зависящие от типа компонента, а также пользовательские свойства для скриптов.

Вы также можете Перетащить вертикальный маркер ↕ рядом с числовым значением и перемещать мышь, чтобы изменять значение числового свойства (начиная с версии 1.10.2).

5. Панель инструменты (Tools)

Содержит несколько вкладок:

Консоль (Console)

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

Ошибки Сборки (Build Errors)

Показывает ошибки, возникшие в процессе сборки проекта.

Результаты Поиска (Search Results)

Отображает результаты поиска по всему проекту (Ctrl/⌘ Cmd + Shift + F), если нажата кнопка Сохранить результаты (Keep Results).

Редактор Кривых (Curve Editor)

Используется при редактировании кривых в редакторе частиц (Particle Editor).

Панель Инструменты (Tools) также используется для работы с интегрированным отладчиком (debugger). Подробнее об этом можно прочитать в Pуководстве по отладке.

6. Панель изменённые файлы (Changed Files)

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

• Левая клик мыши — выбрать элемент; при удержании ⇧ Shift можно расширять выделение, а при удержании Ctrl/⌘ Cmd — добавлять или снимать выделение с элементов. Если выбран один изменённый файл, можно нажать кнопку Сравнение (Diff), чтобы просмотреть отличие. Кнопка Откатить (Revert) позволяет отменить изменения во всех выбранных файлах.
• Двойной клик — открыть файл в редакторе, как и при открытии из панели Pесурсы.
• Правый клик — открыть меню с действиями: просмотр различий, откат, показать в файловой системе и др.

Строка меню (Menu Bar)

В верхней части окна редактора (или в системной строке меню на macOS) находится строка меню (Menu Bar) с шестью пунктами: Файл (File), Правка (Edit), Вид (View), Проект (Project), Отладка (Debug), Справка (Help). Их функции подробно описаны в отдельных руководствах.

Строка состояния (Status Bar)

В нижней части окна редактора находится узкая область, где отображается строка состояния (Status Bar), например:

• когда доступно новое обновление, появляется кликабельная кнопка Доступно Обновление (Update Available) — подробнее см. раздел “Обновление редактора” ниже;
• при сборке (Build) или упаковке (Bundle) проекта здесь отображается ход выполнения операции.

Размер и видимость панелей

Размер панелей можно изменять прямо в редакторе, Перетаскивание границы между описанными выше шестью основными панелями.

Видимость панелей можно переключать через меню Вид (View) или с помощью горячих клавиш:

• Переключить панель ресурсов (Toggle Assets Pane) (F6) — показать или скрыть панели Pесурсы (Assets) и Изменённые Файлы (Changed Files);
• Переключить изменённые файлы (Toggle Changed Files) — показ или скрытие только панели Изменённые Файлы (Changed Files);
• Переключить панель инструментов (Toggle Tools Pane) (F7) — показать или скрыть панель Инструменты (Tools);
• Переключить панель свойств (Toggle Properties Pane) (F8) — показать или скрыть панели Структура (Outline) и Cвойства (Properties).

В меню Вид (View) вы также можете включать/выключать различные элементы отображения, такие как сетка (Grid), направляющие (Guides), камера (Camera), а также подгонять вид под выделение (Вписать выделение в кадр (Frame Selection), клавиша F) или переключаться между стандартным 2D и 3D видом (Выровнять камеру (Realign Camera), клавиша .). Многие из этих функций также доступны с панели инструментов или через сочетания клавиш.

Вкладки (Tabs)

Если у вас открыто несколько файлов, в верхней части панели редактора отображается отдельная вкладка (tab) для каждого файла. Вкладки внутри одной панели можно переставлять — используйте Drag and Drop, чтобы менять их порядок в строке вкладок. Можно также:

• Правый клик по вкладке — открыть контекстное меню;
• выбрать Закрыть (Close) (Ctrl/⌘ Cmd + W) — закрыть текущую вкладку;
• выбрать Закрыть остальные (Close Others) — закрыть все вкладки, кроме выбранной;
• выбрать Закрыть все (Close All) (Ctrl/⌘ Cmd + Shift + W) — закрыть все вкладки в активной панели;
• выбрать ➝| Открыть как (Open As) — открыть файл в другом, отличном от стандартного, редакторе или во внешнем инструменте, указанном в настройках Файл ▸ Настройки ▸ Код ▸ Пользовательский редактор (File ▸ Preferences ▸ Code ▸ Custom Editor). Подробнее см. руководство по настройкам редактора.

Редактирование в двух окнах

Редактор поддерживает одновременное открытие двух панелей редактора рядом друг с другом.

• Правый клик по вкладке нужного файла и выберите Переместить в другую панель вкладок (Move to Other Tab Pane), чтобы переместить текущую вкладку во вторую панель.

Также в меню вкладки можно выбрать Поменять с другой панелью вкладок (Swap with Other Tab Pane), чтобы поменять местами активную вкладку и содержимое другой панели, или Объединить панели вкладок (Join Tab Panes), чтобы объединить две панели редактора обратно в одну.

Редактор cцены

Двойной клик по файлу коллекции (collection), игрового объекта (game object) или визуального компонента открывает Редактор сцены. По умолчанию все визуальные сцены открываются в 2D-режиме с ортографической камерой:

Если вы работаете с 3D‑проектом, обратите внимание на панель инструментов и настройки Настройки сетки ▦ (Grid Settings), установить отображение сетки в плоскости Y или другой, более удобной для вас, переориентировать камеру и переключать 2D/3D отображение (2D или клавиша .), а также включить перспективную камеру через переключатель на панели инструментов или через меню Вид ▸ Перспективная камера (View ▸ Perspective Camera):

Манипуляции с объектами

Щёлкните левой кнопкой мыши по объекту в главном окне, чтобы выделить его. Прямоугольник (в 3D — параллелепипед) вокруг объекта подсветится бирюзовым цветом, показывая, какой элемент выбран. Выделенный объект также подсвечивается в панели Outline, как на изображении выше.

Можно также:

• Левый клик мыши и перетаскивание — выделить все объекты внутри рамки выделения.
• Клик по элементу в Структура (Outline); при удержании ⇧ Shift можно расширять выделение, а при удержании Ctrl/⌘ Cmd — добавлять или снимать выделение с элементов

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

Используйте Move Tool (клавиша W) или панель инструментов в правом верхнем углу.

Манипулятор (gizmo) изменится и будет отображать набор элементов управления — квадраты и стрелки (выбранный элемент подсвечивается оранжевым цветом), которые можно перетаскивание, чтобы перемещать объект:

• центральный бирюзовый квадрат позволяет перемещать объект в плоскости экрана;
• 3 стрелки красного, зелёного и синего цветов вдоль осей X, Y и Z позволяют перемещать объект строго по одной оси;
• 3 квадратных маркера красного, зелёного и синего цветов позволяют перемещать объект в соответствующих плоскостях: X‑Y (синий), X‑Z (зелёный) и Y‑Z (красный) — эти плоскостные манипуляторы становятся видны при повороте камеры в 3D.

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

Используйте Rotate Tool (клавиша E) или панель инструментов.

Инструмент вращения состоит из четырёх круговых манипуляторов (выбранный подсвечивается оранжевым), которые можно Drag, чтобы вращать объект:

• внешний бирюзовый круговой манипулятор вращает объект в плоскости экрана;
• 3 меньших круговых манипулятора красного, зелёного и синего цветов позволяют вращать объект вокруг осей X, Y и Z соответственно. В 2D‑ортографическом режиме два из этих кругов перпендикулярны осям X и Y, поэтому они выглядят как две пересекающиеся линии.

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

Используйте Scale Tool (клавиша R) или панель инструментов.

Инструмент масштабирования состоит из набора квадратных/кубических манипуляторов (выбранный подсвечивается оранжевым), которые можно Drag, чтобы изменять масштаб объекта:

• центральный бирюзовый куб масштабирует объект равномерно по всем осям (включая Z);
• 3 куба красного, синего и зелёного цветов масштабируют объект вдоль соответствующих осей X, Y и Z;
• ещё 3 кубических манипулятора красного, синего и зелёного цветов масштабируют объект в плоскости X‑Y, X‑Z или Y‑Z соответственно.

Фильтры видимости

Нажмите на значок глаза (👁) на панели инструментов, чтобы открыть фильтры видимости (Visibility Filters) и включать/выключать отображение различных типов компонентов, а также рамок (bounding boxes) и направляющих (Переключить направляющие компонентов (Component Guides), сочетание клавиш Ctrl + H в Windows/Linux или ^ Ctrl + ⌘ Cmd + H на macOS).

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

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

Правый клик в панели Pесурсы (Assets) → Создать... ▸ [тип файла] (New... ▸ [file type]):

Введите подходящее Имя (Name) для нового файла и при необходимости измените Путь (Location). Полное имя файла вместе с расширением отображается в поле Просмотр (Preview) в диалоговом окне:

Шаблоны (Templates)

Можно задать собственные шаблоны файлов для каждого проекта. Для этого создайте новую папку с именем templates в корневом каталоге проекта и добавьте файлы с именем default.* с нужными расширениями, например, /templates/default.gui или /templates/default.script. Если в этих файлах используется маркер {{NAME}}, он будет заменён на имя файла, указанное в окне создания файла.

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

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

Для добавления ассетов (изображений, звуков, моделей и т.д.) перетащите их в нужное место панели Assets. Это создаст копии файлов в структуре проекта. Подробнее — в этом руководстве.

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

Редактор автоматически проверяет наличие обновлений. Если они доступны, появится уведомление в нижнем правом углу и на экране выбора проекта. Нажмите Доступно Обновление (Update Available) для загрузки и установки.

Нажмите на ссылку Доступно Обновление (Update Available), чтобы загрузить и установить обновление. Появится диалоговое окно с информацией — нажмите Загрузить Обновление (Download Update), чтобы продолжить.

Ход загрузки отображается в нижней строке состояния:

После завершения загрузки ссылка изменится на Перезапустить (Restart to Update). Нажмите её, чтобы перезапустить редактор и открыть обновлённую версию.

Настройки (Preferences)

Настройки редактора можно изменить в окне Настройки (Preferences). Чтобы открыть его, выберите в меню Файл ▸ Настройки… (File ▸ Preferences…) или используйте сочетание клавиш Ctrl/⌘ Cmd + ,.

Настройки редактора можно изменить в окне настроек.

Логи редактора (Editor Logs)

Если у вас возникла проблема с редактором и вы хотите сообщить об ошибке через Справка ▸ Сообщить о проблеме (Help ▸ Report Issue), полезно приложить лог‑файлы самого редактора. Чтобы открыть папку с логами в системном файловом менеджере, выберите пункт меню Справка ▸ Показать логи (Help ▸ Show Logs).

Подробнее читайте в руководстве по получению помощи.

Файлы логов редактора по умолчанию находятся по следующим путям:

• Windows: C:\Users\ **Ваше имя пользователя** \AppData\Local\Defold
• macOS: /Users/ **Ваше имя пользователя** /Library/Application Support/ или ~/Library/Application Support/Defold
• Linux: $XDG_STATE_HOME/Defold или ~/.local/state/Defold

Вы также можете получить доступ к логам редактора во время его работы, если запустите редактор из терминала или командной строки. Чтобы запустить редактор из терминала:

# Linux:
$ ./path/to/Defold/Defold

# macOS:
$ > ./path/to/Defold.app/Contents/MacOS/Defold

Сервер редакторa (Editor Server)

Когда редактор открывает проект, он запускает веб‑сервер на случайном порту. Этот сервер можно использовать для взаимодействия с редактором из других приложений. Начиная с версии 1.11.0, номер порта записывается в файл .internal/editor.port.

Кроме того, начиная с 1.11.0, исполняемый файл редактора поддерживает параметр командной строки --port (или кратко -p), позволяющий задать порт при запуске, например:

# Windows
.\path\to\Defold\Defold.exe --port 8181

# Linux:
./path/to/Defold/Defold --port 8181

# macOS:
./path/to/Defold.app/Contents/MacOS/Defold --port 8181

Оформление редактора (Editor Styling)

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

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 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