Различия

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

--- help:qgen [2013/10/10 20:52]
newsash создано
+++ help:qgen [2025/07/20 14:55] (текущий)
aleks_versus ctrl + spacebar
@@ Строка 1: / Строка 1: @@
-Работа с редактором игр
+[[help:qspider|Назад: qSpider]]
-Top Previous Next
+====== Quest Generator ======
-Программа "Quests Generator" ("qgen.exe") предназначена для создания игр (текстовых адвентюр, квестов) под платформу "Quest Soft Player".
+Статья актуализирована для **Quest Generator** версии **4.0.0 Beta**.
-После загрузки редактора вы увидите список существующих локаций. Пока здесь присутствует лишь одна локация - "Начало". С неё начинается выполнение игры. Обычно это вступительная часть, в которой указывают название игры, её автора, ценные советы по прохождению и др.
+===== Что такое QGen? =====
+**QGen**, он же **Quest Generator**, — является основным средством разработки текстовых игр и квестов на платформе **QSP**.
+Если вы новичок в написании игр на **QSP** или в принципе новичок в программировании, рекомендуем для начала научиться работать в **Quest Generator** и лишь затем, если это будет необходимо, переходить на работу в текстовом редакторе с использованием утилиты **[[help:txt2gam|TXT2GAM]]**.
-Щёлкните по её названию два раза. Откроется окно кода локации, условно поделенное на 3 части: описание локации, окно кода "Выполнить при посещении" и 2 поля для быстрой и наглядной вставки возможных действий на локации.
+[[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** - быстрый запуск игры в плеере.
-Левое поле - список. Здесь перечислены названия базовых действий. Справа от списка действий - текстовое поле, код в котором будет выполнен лишь при выборе выделенного действия.
+Не дублируются "Панелью инструментов":
+  * **Ctrl + Spacebar** - вставка ключевого слова. Работает, если введён хотя бы один символ. Например, если ввести ''t'' и нажать данное сочетание клавиш, вставится ''TRIM''.
+  * **TAB** - сдвиг выделенных строк кода на один отступ вправо.
+  * **Shift + TAB** - сдвиг выделенных строк кода на один отступ влево.
+  * **Home** - перемещение в начало строки.
+  * **End** - перемещение в конец строки.
+  * **PgUp** - перемещение курсора к первому абзацу.
+  * **PgDn** - перемещение курсора к последнему абзацу.
+Вы можете настроить полезное сочетание клавиш самостоятельно для вставки повторяющихся фрагментов кода. Для этого зайдите в "Настройки (**Ctrl+P**) → Комбинации клавиш → Добавить".
-PS:
+===== Ответы на вопросы по QGen =====
-Создание, удаление, переименование локаций и действий происходит посредством выбора соответствующего пункта меню (или с помощью панели инструментов).
+**Для чего нужен файл с расширением ''%%.qproj%%'' в папке с игрой?**
+Он хранит информацию о папках локаций. Если вы его удалите, с самой игрой ничего не случится, но в **Quest Generator** вам придётся снова создавать папки и рассортировывать по ним локации.
+**Как запустить справку по QSP?**
+''%%Скачать → ПКМ → Разблокировать%%'', в QGen ''%%Помощь → указать путь к файлу справки%%''.
+**Не подсвечиваются некоторые операторы и функции, что делать?**
-Для того, чтобы посмотреть готовый квест, загрузите программу "QSP" и откройте нужный файл (или ассоциируйте файлы "GAM" с QSP, чтобы потом можно было открывать GAM-файлы двойным щелчком).
+Скачайте свежую таблицу ключевых слов с гитхаба: [[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
Сайт Форум