editor.md 13 KB


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

brief: Данное руководство представляет собой обзор внешнего вида и принципов работы редактора Defold, а также навигации в нем.

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

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

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

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

Домашняя страница : Показывает список недавно открытых проектов для быстрого доступа. Это представление используется по умолчанию.

Новый проект : Нажмите, если хотите создать новый проект Defold. Затем выберите, хотите ли вы использовать базовый шаблон (вкладка From Template), следовать пошаговому руководству (вкладка From Tutorial) или попробовать один из демонстрационных проектов (вкладка From Sample).

new project

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

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

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

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

Editor 2

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

  • Двойной клик — открыть файл в соответствующем редакторе.
  • Перетаскивание — добавить файлы с диска или переместить существующие по структуре проекта.
  • Правый клик — открыть контекстное меню для создания, переименования, удаления, отслеживания зависимостей и т.д.

Панель Editor

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

  • Панорамирование: Alt + левая кнопка мыши.
  • Масштабирование: Alt + правая кнопка (трёхкнопочная мышь) или Ctrl + кнопка мыши (однокнопочная). Колесо прокрутки тоже работает.
  • Вращение в 3D: Ctrl + левая кнопка мыши.

На панели инструментов в правом верхнем углу редактора сцены находятся инструменты: Move, Rotate, Scale, а также 2D Mode, Camera Perspective и Visibility Filters.

toolbar

Панель Outline

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

  • Клик — выбрать элемент. Удерживайте Shift или Option для множественного выбора.
  • Перетаскивание — переместить элементы. Объекты можно делать дочерними.
  • Правый клик — открыть контекстное меню для добавления или удаления элементов и других операций.

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

toolbar

Панель Properties

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

Панель Tools

Содержит несколько вкладок: Console (вывод ошибок и логов во время выполнения), Build Errors, Search Results, Curve Editor (редактирование кривых в редакторе частиц) и средства отладки.

Панель Changed Files

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

  • Двойной клик — открыть дифф-файл в редакторе.
  • Правый клик — открыть меню с действиями: просмотр различий, откат, показать в файловой системе и др.

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

Если открыто несколько файлов, вверху отображаются вкладки. Чтобы открыть 2 редактора рядом, правый клик по вкладке и выберите Move to Other Tab Pane.

2 panes

Можно также поменять панели местами или объединить их обратно.

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

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

Select object

Выбор объектов

Кликните по объекту в главном окне, и он выделится зелёной рамкой. Также он подсветится в панели Outline.

Можно также:

  • Клик и перетаскивание — выделить область объектов.
  • Клик по элементу в Outline.

Удерживайте Shift, ⌘ (Mac) или Ctrl (Win/Linux) для множественного выбора.

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

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

Move object

Выбранный объект отображает набор манипуляторов (квадратов и стрелок). Щёлкните и перетащите зелёный центральный квадратный маркер, чтобы свободно переместить объект в экранном пространстве. Щёлкните и перетащите стрелки, чтобы переместить объект вдоль осей X, Y или Z. Также имеются квадратные маркеры для перемещения объекта в плоскости X-Y и (если камера повёрнута в 3D) в плоскостях X-Z и Y-Z.

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

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

Move object

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

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

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

Scale object

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

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

Позволяют включать/отключать отображение компонентов, ограничивающих рамок и направляющих.

Visibility filters

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

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

Правый клик в панели Assets → New... ▸ [file type]:

create file

Введите имя нового файла. Полное имя с расширением отображается под строкой Path:

create file name

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

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

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

Import files

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

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

Update from project selection

Update from editor

Настройки

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

Журналы редактора

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

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

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

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

FAQ

:Editor FAQ