Lönn (произносится как "лённ"), также упоминаемый как Loenn и Lonn - редактор карт Celeste с графическим интерфейсом, пришедший на смену Ahorn.
Установка[]
Lönn можно установить и открыть с помощью соответствующих пунктов в меню Olympus. Также есть возможность сделать это без использования загрузчика. На GitHub размещён исходный код программы и билды под разные ОС. Для запуска Olympus и Lönn на Linux должен также быть установлен LÖVE. Исключение составляет AppImage билд, не требующий каких-либо зависимостей.
Интерфейс[]
Верхняя панель[]
Находится в верхней части окна и содержит различные инструменты для работы с Lönn и картами:
- File - инструменты для работы с файлом.
- New - создание новой карты.
- Open - открытие существующей карты.
- Recent - последние открытые карты.
- Save - сохранение карты.
- Save as - сохранение карты в конкретный файл.
- Exit - выход из программы.
- Edit - общие инструменты для редактирования.
- Undo - отмена последнего действия.
- Redo - возвращение последнего действия.
- Settings - открытие меню настроек Lönn.
- View - параметры внешнего вида редактора.
- Layers - выбор типов объектов, которые будут отображаться на холсте.
- Dependencies Only - выбор типов модовых объектов, которые не будут отображаться в списке для размещения, если не присутствуют в зависимостях проекта.
- Zoom to Extents - центрирование карты и изменение масштаба до уровня, при котором она будет полностью умещаться на холсте. Если карта слишком далеко, она будет приближена.
- Map - инструменты для работы с картой.
- Stylegrounds - открытие меню настроек стайлграундов.
- Metadata - открытие меню настроек метаданных.
- Dependencies - открытие меню управления зависимостями, где можно их добавлять и убирать.
- Save Map Image - сохранение карты как изображения.
- Room - инструменты для работы с комнатами.
- Add - добавление комнаты.
- Edit - открытие настроек выбранной комнаты.
- Delete - удаление выбранной комнаты.
- Debug - работа в режиме отладки. Данная вкладка появляется только при включенных настройках Enable Debug Menu или Display Console в меню настроек Lönn.
- Reload - перезагрузить определённый тип или все объекты карты.
- Redraw Map - повторно отобразить карту.
- Test Console - перейти к работе с консолью. Работает только при включенной настройке Display Console в меню настроек Lönn. В этом режиме нельзя напрямую взаимодействовать с интерфейсом редактора.
- Help - инструменты помощи.
- Check For Updates - проверка на наличие обновлений.
- Open Config Directory - открытие директории конфигурации.
- About - информация о Lönn.
Панель комнат[]
Располагается в левой части окна. Содержит в себе список существующих на карте комнат и поисковую строку для ориентирования по нему. Кликнув ЛКМ по комнате, её можно выбрать, при этом выбранная комната будет приближена на экране. За нажатием ПКМ последует открытие контекстного меню, через которое можно удалить комнату или перейти в меню её настроек.
Панель инструментов[]
Панель инструментов
Располагается в правой части окна. Содержит в себе различные инструменты для редактирования карты. Большинство из них связано с размещением и удалением объектов. Первые шесть используются для размещения тайлов и по принципу работы схожи со своими аналогами из графических редакторов. На панели присутствуют следующие инструменты:
- Brush (Кисть) оставляет одиночные тайлы на месте указателя.
- Bucket (Заливка) заполняет ограниченное тайлами или границами комнаты пространство.
- Circle (Круг), Ellipse (Эллипс), Line (Линия) и Rectangle (Прямоугольник) позволяют создать соответствующие фигуры, причём у двумерных фигур можно выбрать между созданием полого и полностью заполненного тайлами вариантами.
- Placement позволяет размещать остальные объекты. Некоторые размещаются поодиночке, в то время как у других (к примеру, у воды и шипов) можно выбрать область размещения.
- Selection позволяет выделять объекты и их группы. Присутствует возможность как выделять все объекты сразу, так и с фильтрацией по определённому типу.
- Rooms позволяет двигать комнаты с зажатой ЛКМ и открывать их параметры с помощью ПКМ. В режиме Place Room можно также создавать комнаты, выбирая на свободной части холста территорию с зажатой ЛКМ. Режим Select Room позволяет тем же образом выделить одну или несколько комнат.
Пока выбран один из инструментов для размещения объектов, правее будет располагаться их список, в который будут включены как ванильные объекты, так и те, что добавляются установленными у пользователя модами. Ниже располагается поисковая строка для навигации по списку. Чтобы отфильтровать для определённого мода, надо начать ввод с @, а затем начать ввод с названия мода или vanilla для ванильных объектов.
Меню настроек Lönn[]
Настройки Lönn
Открывается кнопкой Settings во вкладке Edit верхней панели. Содержит в себе настройки программы:
- General - основные настройки
- Celeste Game Directory - выбор директории игры.
- Remember Full Screen - запоминать выбор полноэкранного режима между сессиями.
- Remember Window Position - запоминать позицию окна между сессиями.
- Remember Window Size - запоминать размер окна между сессиями.
- Number of Recent Files - число карт, отображаемых во вкладке Recent на верхней панели.
- Check Dependencies on Save - проверять наличие всех требуемых зависимостей в Everest.yaml.
- Sort Rooms on Save - сортировать комнаты по алфавиту в списке комнат при сохранении проекта.
- Enable backups - разрешить создание бэкапов.
- Backup Rate - частота создания бэкапов в секунду.
- Maximum Number of Backups - максимальное число хранимых бэкапов.
- Editor - настройки редактора.
- Theme - выбор темы редактора.
- Adapt List Width to Content - сделать ширину списков на боковых панелях динамической, позволяя ей подстраиваться под самое широкое название, находящееся на экране.
- Use Clipboard to Copy - использовать буфер обмена для копирования объектов.
- Paste Centered - вставлять объекты по центру курсора. Если отключено, курсор будет приходиться на верхний левый край вставленного объекта.
- Remember Tool Settings Across Tools - применять настройки одного инструмента ко всем похожим. К примеру, если выбрать для кисти размещение задних тайлов, другие инструменты для работы с тайлами тоже будут их размещать. В противном случае каждый инструмент будет запоминать свой режим.
- Trimmed Trigger Names - не показывать название мода на размещённых триггерах.
- Use Trigger Category Colours - использовать разные цвета у триггеров в зависимости от их категории.
- Case Sensitive Search - выбор того, в каких случаях поисковые строки будут чувствительны к регистру.
- Always Use Fuzzy Search - использовать размытый поиск. Он не требует чёткого названия объекта и предлагает варианты, близкие по значению.
- Show Closest Matches First - показывать наиболее точные совпадения в поиске выше.
- Hotkeys - настройки управления и горячих клавиш редактора.
- Graphics - настройки графики.
- Display FPS - показывать FPS.
- VSync - включить вертикальную синхронизацию.
- Always Redraw Unselected Rooms - обновлять все комнаты при изменении одной.
- Lazy Load External Atlases - прогружать только необходимые текстуры для повышения производительности.
- Pre-Render Rooms In Background - заранее прогружать комнаты вне зоны видимости.
- Debug - настройки отладки.
- Enable Debug Menu - включить режим отладки. В основном нужно разработчикам Lönn и плагинов на него. После сохранения настроек требует перезапуска. При следующем использовании редактора в верхней панели появится новая вкладка Debug.
- Display Console - показать консоль. После сохранения настроек требует перезапуска. При следующем использовании редактора в верхней панели появится новая вкладка Debug и запустится консоль, представляющая из себя log-журнал, отображающий процессы и ошибки загрузки различных файлов. Закрытие окна консоли приведёт к закрытию окна редактора.
- Log Plugin Loading - регистрировать в консоли процесс загрузки плагинов.
- Log Image Loading - регистрировать в консоли процесс загрузки изображений.
- Warn on Missing Handler - вывести в консоли предупреждение при загрузке карты, включающей в себя объекты, для которых не был найден обработчик.
- Warn on Missing Texture - вывести в консоли предупреждение при загрузке объекта, для которого не была найдена текстура.
Меню настроек стайлграундов[]
Настройки стайлграундов
Открывается кнопкой Stylegrounds во вкладке Map верхней панели. В левой верхней части меню находится список всех стайлграундов, используемых на карте. Стайлграунды накладываются друг на друга сверху вниз, чем выше стайлграунд в списке, тем ближе он к зрителю. В правой верхней части находится предпросмотр выбранного стайлграунда, если он возможен. Ниже находится набор параметров стайлграундов, для каждого типа стайлграундов он свой, но всем присущи следующие параметры:
- Rooms - названия комнат, в которых будет отображаться стайлграунд. Названия комнат записываются через запятую, допустимо использование текстовых масок.
- Exclude - названия комнат, в которых не будет отображаться стайлграунд. Названия комнат записываются через запятую, допустимо использование текстовых масок. Если комната одновременно указана в полях Rooms и Exclud, то в этой комнате стайлграунд отображаться не будет.
- Tag - Тэг стайлграунда. Используется для удобного обращения к стайлграунду в коде.
- Flag - номера флагов, при достижении которых стайлграунд начнёт отображаться.
- Not Flag - номера флагов, при достижении которых стайлграунд перестанет отображаться. Имеет приоритет над полем Flag.
В нижней части меню находятся кнопки для управления списком стайлграундов.
- Первое поле отвечает за выбор типа стайлграунда для создания.
- New - создать новый стайлграунд выбранного типа.
- Remove - удалить выбранный стайлграунд.
- Update - обновить отображение стайлграундов.
- Move up - переместить выбранный стайлграунд вверх в списке.
- Move down - переместить выбранный стайлграунд вниз в списке.
- Move to foreground/Move to background - переместить стайлграунд на передний/задний план. Передний план находится перед тайлами и основной части карты, задний план находится за тайлами и является фоном. Стайлграунды, отображающиеся на переднем плане, отмечены в списке галочкой.
Меню настроек метаданных[]
Настройки метаданных
Открывается кнопкой Metadata во вкладке Map верхней панели. Содержит в себе следующие параметры:
- General - основные настройки карты.
- Intro Type - тип анимации, проигрывающейся в самом начале карты.
- Colour Grade - цветовой фильтр карты.
- Wipe - анимация воскрешения героини.
- Darkness Alpha - степень прозрачности темноты. Чем значение выше, тем темнее будет карта.
- Bloom Base - базовое значение свечения объектов.
- Bloom Strength - значение силы свечения объектов. В действительности уровень свечения определяется как произведение Bloom Base на Bloom Strength.
- Core Mod - начальное значение режима Средоточия.
- Starting Inventory - начальный набор способностей игрока, таких как наличие рюкзака, количество рывков, возможность восстанавливать рывки от касания поверхности.
- Starting Room - начальная комната карты.
- Postcard Sound ID - айди звука почтовой карточки.
- End Level on Heart - завершать карту сбором хрустального сердца.
- Seeker Slowdown - наличие эффекта искажения при приближении к сикерам.
- Theo in Booster - можно ли игроку держать кристалл Тео или другие объекты, которые можно носить, при движении в пузырях.
- Dreaming - является ли карта сном героини.
- Override A-Side Meta - использование метаданных Сторон А.
- Interlude - является ли карта вступительной.
- Overworld - метаданные, отвечающие за настройки карты вне игрового процесса. В основном это настройки карты в меню выбора главы.
- Title Banner Icon - путь к файлу иконки карты, отображающейся при выборе главы.
- Title Base Colour - основной цвет заголовка карты. Определяет цвет фона, на котором написано название карты.
- Title Accent Colour - акцентирующий цвет заголовка карты. Определяет цвет надписи номера главы.
- Title Text Colour - цвет надписи названия карты.
- XML - настройки метаданных, кодирующихся XML разметкой.
- Foreground Tiles - путь к XML файлу, отвечающему за распознавание пути к файлам текстур модовых тайлсетов переднего плана.
- Background Tiles - путь к XML файлу, отвечающему за распознавание пути к файлам текстур модовых тайлсетов заднего плана.
- Animated Tiles - путь к XML файлу, отвечающему за распознавание пути к файлам текстур модовых тайлсетов анимированных тайлов.
- Portraits - путь к XML файлу, отвечающему за распознавание пути к файлам текстур для модовых диалогов.
- Sprites - путь к XML файлу, отвечающему за распознавание пути к файлам спрайтов других модовых объектов.
- Music - метаданные, связанные с музыкой карты.
- Map Music - выбор музыки начала карты.
- Map Ambience - выбор эмбиента начала карты.
- Cassette Song - выбор музыки кассеты.
- Max Beats - максимальное количество битов до зацикливания музыки кассеты.
- Beats Per Tick - количество битов музыки кассеты в тик.
- Ticks Per Swap - количество тиков между переключениями кассетных блоков.
- Leading Beats - количество битов затишья перед началом кассетной музыки при входе в комнату с кассетными блоками.
- Beat Index Offset - смещением между значениями битов музыки, указанных в редакторе, и значениями музыкальных параметров, которые получит игра.
- Tempo Multiptier - темп музыки кассеты. Чем значение выше, тем быстрее будет музыка в комнатах с кассетными блоками.
- Number of Colours - количество цветов кассетных блоков.
- Old Behaviour - старый тип поведения кассетных блоков.
- Active During Transition - начинать музыку кассеты при переходе между комнатами. Убирает затишье перед началом музыки кассеты.
- Ignore Room Layer - игнорировать выбранные в комнатах активные слои музыки.
Меню настроек комнаты[]
Настройки комнаты
Позволяет управлять настройками, применяющимся отдельно для конкретной комнаты. Меню можно открыть следующими способами:
- Нажав на Edit во вкладке Room на верхней панели, если выбрана одна комната
- С помощью контекстного меню, открывающегося при использовании ПКМ на комнату на левой панели
- Кликнув ПКМ по комнате с выбранным инструментом Rooms
- Аналогичное меню появляется при создании комнаты любым способом
Здесь можно изменить следующие параметры:
- Room Name - название комнаты.
- Colour - цвет комнаты в редакторе и режиме отладки.
- X и Y - координаты комнаты на карте в тайлах.
- Width и Height - ширина и высота комнаты в тайлах. Соотношение 40x23 соответствует минимальному размеру экрана.
- Camera Offset X и Camera Offset Y - смещение камеры в комнате в тайлах по обеим осям.
- Wind Pattern - выбор режима ветра. Влияет на его скорость и направление.
- Underwater - делает комнату полностью подводной.
- Disable Down Transition - делает падение в пропасть в комнате смертельным, даже если снизу есть другая комната.
- Checkpoint - делает комнату чекпоинтом.
- Dark - делает комнату полностью тёмной.
- Whisper - добавляет в комнату фоновый звук шёпота.
- Music Layer (1-4) - выбор активных слоёв музыки.
- Music - выбор музыки в комнате.
- Music Progress - номер секции в прогрессе музыки.
- Ambience - выбор эмбиента в комнате.
- Ambience Progress - номер секции в прогрессе эмбиента.
Управление[]
Работа в редакторе основана использовании горячих клавиш и нескольких дополнительных функций.
Горячие клавиши[]
Здесь указаны значения горячих клавиш по умолчанию, всех их можно изменить в меню настроек Lönn. У некоторых из них нет значения по умолчанию, а некоторые можно привязать только к кнопкам мыши или только к клавишам клавиатуры.
- General - основные горячие клавиши.
- New Map
Ctrl + N- создать новую карту. - Open Map
Ctrl + O- открыть существующую карту. - Save
Ctrl + S- сохранить карту. - Save As
Ctrl + Shift + S- сохранить карту в конкретный файл. - Undo
Ctrl + Z- отменить последнее действие. - Redo
Ctrl + Shift + Z- вернуть последнее действие. - Toggle Fullscreen
F11- включить/выключить полноэкранный режим.
- New Map
- Map Veiw - горячие клавиши, отвечающие за работу с камерой редактора.
- Tool Action
ЛКМ- использовать выбранный инструмент. - Move Map View
ПКМ- перемещать камеру редактора. - Context Menu
ПКМ- открыть меню настроек выделенного объекта. - Zoom In
Ctrl + Plus- приблизить камеру. - Zoom Out
Ctrl + Minus- отдалить камеру. - Zoom to Map Extents
Mouse Button 3- центрировать карту и изменить масштаб до уровня, при котором она будет полностью умещаться на холсте. Если карта слишком далеко, она будет приближена. Требуется двойное нажатие горячей клавиши.
- Tool Action
- Tools - горячие клавиши, позволяющие быстро выбирать инструменты в панели инструментов.
- Select Room Tool
1- выбрать инструмент работы с комнатами. - Select Placement Tool
2- выбрать инструмент размещения. - Select Selection Tool
3- выбрать инструмент выделения. - Select Brush Tool
4- выбрать кисть для размещения тайлов. - Select Rectagle Tool
5- выбрать инструмент для размещения тайлов в форме прямоугольника. - Select Bucket Tool
6- выбрать инструмент для заполнения тайлами ограниченной области. - Select Line Tool
7- выбрать инструмент для размещения тайлов в форме прямой линии. - Select Circle Tool
8- выбрать инструмент для размещения тайлов в форме круга. - Select Ellipse Tool
9- выбрать инструмент для размещения тайлов в форме овала.
- Select Room Tool
- Selections - горячие клавиши, связанные с выделением и перемещением объектов.
- Copy Selection to Clipboard
Ctrl + C- Скопировать выделенные объекты в буфер обмена. - Cut Selection to Clipboard
Ctrl + X- Вырезать выделенные объекты в буфер обмена. - Paste from Clipboard
Ctrl + V- Вставить объекты из буфера обмена. - Add to Selection (Modifier)
Shift- Добавить объект в выделение. Нужно зажать эту горячую клавишу и выделить новые объекты. - Select All
Ctrl + A- Выделить все объекты в комнате. - Deselect
Ctrl + Shift + A- Снять выделение со всех объектов. - Add Node
N- Добавить узел для выделенного объекта. Применимо только для сущностей, триггеров и самих узлов. - Clone Object
Mouse Button 3- дублировать выделенные объекты. - Delete Object
Delete- Удалить выделенные объекты. - Flip Horizontal
H- Отразить выделенные объекты по горизонтали. - Flip Vertical
V- Отразить выделенные объекты по вертикали. - Rotate Anti-Clockwise
L- Повернуть выделенные объекты против часовой стрелки. - Rotate Clockwise
R- Повернуть выделенные объекты по часовой стрелке. - Increase Precision (Modifier)
Ctrl- Увеличить точность движений. По умолчанию возможно только потайловое перемещение/изменение размеров объектов, то есть минимум на 8 пикселей. При зажатии данной горячей клавиши это ограничение снимается и становиться возможным перемещение/изменение размеров объектов на любое количество пикселей. Применимо для перемещения/изменения размеров как горячими клавишами, так и движениями мыши. Неправильно работает для тайлов переднего и заднего плана. - Axis-Bound Movement (Modifier)
Shift- Перемещение с привязкой по оси. При зажатии данной горячей клавиши появятся линии, ограничивающие перемещение выделенных объектов, станет невозможным смещение объектов сразу по двум осям. - Move Up
Up- Переместить выделенные объекты вверх. - Move Down
Down- Переместить выделенные объекты вниз. - Move Left
Left- Переместить выделенные объекты влево. - Move Right
Right- Переместить выделенные объекты вправо.
- Copy Selection to Clipboard
- Использование приведённых ниже горячих клавиш применимо только для объектов, у которых можно менять размер, к примеру, для триггеров.
- Grow Top - Нарастить размер объекта вверх.
- Grow Bottom
D- Нарастить размер объекта вниз. - Grow Left - Нарастить размер объекта влево.
- Grow Right
E- Нарастить размер объекта вправо. - Shrink Top - Сократить размер объекта сверху.
- Shrink Bottom
A- Сократить размер объекта снизу. - Shrink Left - Сократить размер объекта слева.
- Shrink Right
Q- Сократить размер объекта справа.
- Rooms - горячие клавиши, отвечающие за работу с комнатами.
- Add Room
Ctrl + T- Создать новую комнату. - Delete Room
Alt + Delete- Удалить комнату. - Configure Current Room
Ctrl + Shift + T- Открыть меню настроек выбранной комнаты. - Move Up
Alt + Up- Переместить комнату вверх. - Move Down
Alt + Down- Переместить комнату вниз. - Move Left
Alt + Left- Переместить комнату влево. - Move Right
Alt + Right- Переместить комнату вправо. - Grow Top - Нарастить размер комнаты вверх.
- Grow Down - Нарастить размер комнаты вниз.
- Grow Left - Нарастить размер комнаты влево.
- Grow Right - Нарастить размер комнаты вправо.
- Shrink Top - Сократить размер комнаты сверху.
- Shrink Bottom - Сократить размер комнаты снизу.
- Shrink Left - Сократить размер комнаты слева.
- Shrink Right - Сократить размер комнаты справа.
- Add Room
- Lists - горячие клавиши, отвечающие за работу со списками.
- Previous Element
Up- Следующий элемент списка. - Next Element
Down- Предыдущий элемент списка. - Rearrange Elements (Modifier)
Alt- Поменять порядок элементов в списке. При использовании Previous Element или Next Element с зажатой данной горячей клавишей, выделенный элемент сместится в соответствующую сторону. Применимо только для списков, у которых можно менять порядок, к примеру, списку стайлграундов.
- Previous Element
- Search - горячие клавиши, отвечающие за работу с поисковой строкой.
- Exit Search
Escape- Выйти из поисковой строки. - Clear And Exit Search
Enter- Выйти из поисковой строки и очистить её. - Select And Exit Search
Tab- Выбрать текущий найденный элемент и выйти из поисковой строки. - Focus Search
Ctrl + F- Начать работу с поисковой строкой. Применимо только для поисковой строки списка объектов для инструментов.
- Exit Search
- Debug - горячие клавиши, отвечающие за работу в режиме отладки.
- Reload Entities
F5- Перезагрузить сущности. - Refresh Map View
F6- Повторно отобразить карту. - Reload Tools
F7- Перезагрузить инструменты. - Reload Everything
Ctrl + F5- Перезагрузить всё. - Restart Lönn
Ctrl + Shift + F5- Перезапустить Lönn.
- Reload Entities
Дополнительные функции[]
- При выполнении некоторых действий, к примеру, выхода из редактора, при наличии несохранённых изменений, в правом нижнем углу будет всплывать контекстное меню, запрашивающее подтверждение.
- Перетаскивание файла карты в область окна редактора приведёт к открытию этой карты.
- Выделение объектов выполняется посредством клика на конкретный объекты или выделения целого ряда объектов. Перемещение курсора с зажатой
ЛКМв области выделения позволит перемещать выделенные объекты. - Повторное нажатие на выделенный объект позволить выделить объект под ним, переход между слоями объектов происходит от меньшего к большему.
- Выделить сразу все одинаковые объекты в комнате можно неизменяемым сочетанием
Shif + ЛКМ. Требуется двойное нажатие. Не применимо к тайлам. - Выделить сразу все абсолютно одинаковые объекты в комнате можно неизменяемым сочетанием
Shif + Ctrl + ЛКМ. Требуется двойное нажатие. Не применимо к тайлам. Это выделение более строгое, к примеру, если в комнате присутствуют несколько блоков соединённых шипов разной длины, то использование данного сочетания клавиш приведёт к выделению шипов только одинаковой длины. - Использование
Mouse Button 3с выбранным инструментом размещения тайлов позволит поменять размещаемый тайл на тот, что находится под курсором. - Двойное нажатие
ЛКМна элемент списка позволить сделать его избранным. Обычно приоритет элементов списка основан на алфавитном порядке. Избранные элементы обладают большим приоритетом, независимо от своего алфавитного порядка. Это означает, что избранные элементы всегда будут находиться в списке выше неизбранных. В свою очередь, избранные элементы сортируются между собой так же в алфавитном порядке. Избранные элементы списка отмечены звёздочкой слева от своего названия. - При фильтровании элементов поисковой строке, она будет автоматически выбирать верхний из подходящих по фильтру элемент.
