Read this manual in English

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

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

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

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

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

new project

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

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

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

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

Editor 2

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

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

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

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

toolbar

Панель 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.

2 panes

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

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

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

Select object

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

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

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

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

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

Move object

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

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

Move object

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

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

Scale object

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

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

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

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

create file

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

create file name

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

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

Import files

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

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

Update from project selection

Update from editor

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

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

Команда Windows macOS Linux
Add A A A
Add secondary Shift+A Shift+A Shift+A
Backwards tab trigger Shift+Tab Shift+Tab Shift+Tab
Beginning of file Ctrl+Home Cmd+Up Ctrl+Home
Beginning of line   Ctrl+A  
Beginning of line text Home Home Home
Build Ctrl+B Cmd+B Ctrl+B
Close Ctrl+W Cmd+W Ctrl+W
Close all Shift+Ctrl+W Shift+Cmd+W Shift+Ctrl+W
Continue F5 F5 F5
Copy Ctrl+C Cmd+C Ctrl+C
Cut Ctrl+X Cmd+X Ctrl+X
Delete Delete Delete Delete
Delete backward Backspace Backspace Backspace
Delete line   Ctrl+D  
Delete next word Ctrl+Delete Alt+Delete Ctrl+Delete
Delete prev word Ctrl+Backspace Alt+Backspace Ctrl+Backspace
Delete to end of line Shift+Ctrl+Delete Cmd+Delete Shift+Ctrl+Delete
Documentation F1 F1 F1
Down Down Down Down
End of file Ctrl+End Cmd+Down Ctrl+End
End of line End Ctrl+E End
Enter Enter Enter Enter
Erase tool Shift+E Shift+E Shift+E
Escape Esc Esc Esc
Find next Ctrl+G Cmd+G Ctrl+G
Find prev Shift+Ctrl+G Shift+Cmd+G Shift+Ctrl+G
Find text Ctrl+F Cmd+F Ctrl+F
Frame selection F F F
Goto line Ctrl+L Cmd+L Ctrl+L
Hide selected Ctrl+E Cmd+E Ctrl+E
Hot reload Ctrl+R Cmd+R Ctrl+R
Left Left Left Left
Move down Alt+Down Alt+Down Alt+Down
Move tool W W W
Move up Alt+Up Alt+Up Alt+Up
New file Ctrl+N Cmd+N Ctrl+N
Next word Ctrl+Right Alt+Right Ctrl+Right
Open Ctrl+O Cmd+O Ctrl+O
Open asset Shift+Ctrl+R Cmd+P Shift+Ctrl+R
Page down Page Down Page Down Page Down
Page up Page Up Page Up Page Up
Paste Ctrl+V Cmd+V Ctrl+V
Preferences Ctrl+Comma Cmd+Comma Ctrl+Comma
Prev word Ctrl+Left Alt+Left Ctrl+Left
Proposals Ctrl+Space Ctrl+Space Ctrl+Space
Quit Ctrl+Q Cmd+Q Ctrl+Q
Realign camera Period Period Period
Rebuild Shift+Ctrl+B Shift+Cmd+B Shift+Ctrl+B
Rebundle Ctrl+U Cmd+U Ctrl+U
Redo Shift+Ctrl+Z Shift+Cmd+Z Shift+Ctrl+Z
Reindent Ctrl+I Ctrl+I Ctrl+I
Reload stylesheet   Ctrl+R  
Rename F2 F2 F2
Replace next Shift+Ctrl+H Alt+Cmd+G Shift+Ctrl+H
Replace text   Alt+Cmd+F  
Right Right Right Right
Rotate tool E E E
Save all Ctrl+S Cmd+S Ctrl+S
Scale tool R R R
Scene stop Ctrl+T Cmd+T Ctrl+T
Search in files Shift+Ctrl+F Shift+Cmd+F Shift+Ctrl+F
Select all Ctrl+A Cmd+A Ctrl+A
Select beginning of file Shift+Ctrl+Home Shift+Cmd+Up Shift+Ctrl+Home
Select beginning of line   Shift+Ctrl+A  
Select beginning of line text Shift+Home Shift+Home Shift+Home
Select down Shift+Down Shift+Down Shift+Down
Select end of file Shift+Ctrl+End Shift+Cmd+Down Shift+Ctrl+End
Select end of line Shift+End Shift+Alt+Down Shift+End
Select left Shift+Left Shift+Left Shift+Left
Select next occurrence Ctrl+D Cmd+D Ctrl+D
Select next word Shift+Ctrl+Right Shift+Alt+Right Shift+Ctrl+Right
Select page down Shift+Page Down Shift+Page Down Shift+Page Down
Select page up Shift+Page Up Shift+Page Up Shift+Page Up
Select prev word Shift+Ctrl+Left Shift+Ctrl+Left Shift+Ctrl+Left
Select right Shift+Right Shift+Right Shift+Right
Show last hidden Shift+Ctrl+E Shift+Cmd+E Shift+Ctrl+E
Show palette Space Space Space
Split selection into lines Shift+Ctrl+L Shift+Cmd+L Shift+Ctrl+L
Step into F11 F11 F11
Step out Shift+F11 Shift+F11 Shift+F11
Step over F10 F10 F10
Stop debugger Shift+F5   Shift+F5
Tab Tab Tab Tab
Toggle breakpoint F9 F9 F9
Toggle comment Ctrl+Slash Cmd+Slash Ctrl+Slash
Toggle component guides Ctrl+H Ctrl+Cmd+H Ctrl+H
Toggle pane bottom F7 F7 F7
Toggle pane left F6 F6 F6
Toggle pane right F8 F8 F8
Toggle visibility filters Shift+Ctrl+I Shift+Cmd+I Shift+Ctrl+I
Undo Ctrl+Z Cmd+Z Ctrl+Z
Up Up Up Up
Up major Shift+Up Shift+Up Shift+Up
Zoom in Ctrl+'+' Cmd+'+' Ctrl+'+'
Zoom out Ctrl+'-' Cmd+'-' Ctrl+'-'

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

Клавиатурные сокращения можно настроить, если создать конфигурационный файл (например, 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.