Документация QSP
Сайт Форум

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
[[help:qspider|Назад: qSpider]]

====== Quest Generator ======

Статья актуализирована для **Quest Generator** версии **4.0.0 Beta**.

===== Что такое QGen? =====

**QGen**, он же **Quest Generator**, — является основным средством разработки текстовых игр и квестов на платформе **QSP**.

Если вы новичок в написании игр на **QSP** или в принципе новичок в программировании, рекомендуем для начала научиться работать в **Quest Generator** и лишь затем, если это будет необходимо, переходить на работу в текстовом редакторе с использованием утилиты **[[help:txt2gam|TXT2GAM]]**.

[[https://qsp.org/index.php?option=com_content&task=view&id=59&Itemid=56|Учебник по QGen]]

===== Возможности =====

  * Автосохранение через определенные промежутки времени (по умолчанию отключено).
  * Возможность сконвертировать игру в текстовый и **TXT2GAM** форматы для альтернативной разработки, а так же отладки кода (см.[[help:analyzer|Анализатор]]).
  * Гибкие настройки подсветки кода (подсветки синтакса).
  * Гибкие настройки интерфейса.
  * Поддержка макросов ([[glossary:snippet|сниппетов]]).
  * Простая работа с локациями (локация — как отдельный блок кода).

===== Интерфейс =====

{{https://wiki.qsp.org/_media/qgen.png?450| qgen}}

  * **Панель инструментов** — дает вам возможность не запоминать комбинации клавиш для тех или иных действий. Если автору удобней работать горячими клавишами с клавиатуры, то панель можно отключить за ненадобностью. Меню "Вид → Список окон → Панель инструментов".
  * **Список локаций** — здесь можно создавать папки для удобной сортировки локаций. Так же отключается через "Вид → Список окон → Окно списка локаций", или нажатием на крестик на самом окне.
  * **Окно "Описание"**. Оно же **"Базовое описание локации"**, или просто **"Описание локации"**. Использовать не обязательно, можно отключить в меню "Настройки → Основные", где нужно убрать галочку с "Показывать базовые описания локаций."
  * **Окно "Выполнить при посещении"**. Основное окно **QGen**а. В нём пишется весь код игры. Некоторые авторы предпочитают пользоваться только этим окном, так как использование окон **"Описание локаций"** и **"Базовые действия"** не обязательно, а более гибкое управление выводом текста и действий (например, действие по условию) возможно только через окно **"Выполнить при посещении"**.
  * **Окно "Базовые действия"**. Позволяет быстро создавать, удалять, редактировать действия доступные игроку. Использовать не обязательно. Можно закрыть через меню "Настройки → Основные", где нужно убрать галочку с пункта "Показывать базовые действия локаций".
  * **Строка состояния** показывает описание последнего оператора введенного автором. Отключить можно через меню "Вид → Список окон → Строка состояния".
  * **Вкладки локаций** — появляются только после открытия тех или иных локаций. Позволяют быстро перемещаться между редактируемыми локациям. Вкладки можно редактировать в режиме разделённого экрана. Для этого откройте хотя бы две локации, ухватите одну из вкладок курсором мыши и перетащите в нужную часть экрана. Когда увидите синий прямоугольник, показывающий, где будет располагаться новая секция экрана, отпустите вкладку. Две локации окажутся открыты одновременно на одном экране. Вновь открытые локации будут добавляться на экран к активной вкладке.

Какие из окон редактора использовать, решает сам автор. По факту можно отключить все окна и писать игру только в окне **"Выполнить при посещении"**, и переключаться между локациями с помощью **"Списка локаций"**. Кроме этого есть возможность регулировать размеры всех окон через меню "Настройки → Размеры".

===== Основные горячие клавиши =====

Нет необходимости запоминать все горячие клавиши, тем более некоторые из них дублирует **"Панель инструментов"**, однако их использование существенно упрощает и ускоряет работу в редакторе.

  * **Ctrl+Z** - отмена последнего действия.
  * **Ctrl+F** - поиск текста по всем локациям.
  * **Ctrl+S** - сохранение игры.
  * **F5** - быстрый запуск игры в плеере.

Не дублируются "Панелью инструментов":

  * **TAB** - сдвиг выделенных строк кода на один отступ вправо.
  * **Shift + TAB** - сдвиг выделенных строк кода на один отступ влево.
  * **Home** - перемещение в начало строки.
  * **End** - перемещение в конец строки.
  * **PgUp** - перемещение курсора к первому абзацу.
  * **PgDn** - перемещение курсора к последнему абзацу.

Вы можете настроить полезное сочетание клавиш самостоятельно для вставки повторяющихся фрагментов кода. Для этого зайдите в "Настройки (**Ctrl+P**) → Комбинации клавиш → Добавить".

===== Ответы на вопросы по QGen =====

**Для чего нужен файл с расширением ''%%.qproj%%'' в папке с игрой?**

Он хранит информацию о папках локаций. Если вы его удалите, с самой игрой ничего не случится, но в **Quest Generator** вам придётся снова создавать папки и рассортировывать по ним локации.

**Как запустить справку по QSP?**

''%%Скачать → ПКМ → Разблокировать%%'', в QGen ''%%Помощь → указать путь к файлу справки%%''.

**Не подсвечиваются некоторые операторы и функции, что делать?**

Скачайте свежую таблицу ключевых слов с гитхаба: [[https://github.com/QSPFoundation/qgen/blob/master/misc/common/keywords.xml|keywords.xml]]

===== Другие вопросы =====

  * [[https://aleksversus.github.io/howdo_faq/docs/howdo/contents/quest%20generator/keybindings|Мне часто приходится вставлять одинаковые или почти одинаковые кусочки кода. Как автоматизировать этот процесс?]]
  * [[https://aleksversus.github.io/howdo_faq/docs/howdo/contents/quest%20generator/keybindings|Делаю преформатирование пробелами, чтобы появлялась вертикальная полоска, так нагляднее. Нет ли какой-то комбинации клавиш, чтобы не тыкать пробел по пять раз?]]
  * [[https://aleksversus.github.io/howdo_faq/docs/howdo/contents/quest%20generator/code_folding|Как свернуть кусочек кода, написанный под комментарием?]]

[[help:debugger|Вперёд: Отладчик]]
Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум
