Принципы работы с QSP: Редактор QGen и утилита TXT2GAM

Принцип работы
Принцип работы
Page 1 of 2
Top Previous Next
Работа с редактором игр - описана разработка игр с помощью специализированного редактора "QGen".
Работа с утилитой TXT2GAM - описана разработка игр с помощью обычного текстового редактора.
Принцип работы QSP - описана последовательность действий, производимых интерпретатором при
обработке локации.
Работа с редактором игр
Top Previous Next
Программа "Quests Generator" ("qgen.exe") предназначена для создания игр (текстовых адвентюр,
квестов) под платформу "Quest Soft Player".
После загрузки редактора вы увидите список существующих локаций. Пока здесь присутствует лишь
одна локация - "Начало". С неё начинается выполнение игры. Обычно это вступительная часть, в
которой указывают название игры, её автора, ценные советы по прохождению и др.
Щёлкните по её названию два раза. Откроется окно кода локации, условно поделенное на 3 части:
описание локации, окно кода "Выполнить при посещении" и 2 поля для быстрой и наглядной вставки
возможных действий на локации.
В поле "Описание локации" вводится базовый текст описания для данной локации. Вывод этого текста
состоится в любом случае, независимо от условий игры.
Поле кода локации ("Выполнить при посещении") служит для непосредственного программирования как
игровых, так и служебных локаций.
2 поля "Действия на локации" служат для вставки базовых (которые будут добавляться независимо от
условий игры при переходе на локацию) действий.
Левое поле - список. Здесь перечислены названия базовых действий. Справа от списка действий текстовое поле, код в котором будет выполнен лишь при выборе выделенного действия.
PS:
Создание, удаление, переименование локаций и действий происходит посредством выбора
соответствующего пункта меню (или с помощью панели инструментов).
Для того, чтобы посмотреть готовый квест, загрузите программу "QSP" и откройте нужный файл (или
ассоциируйте файлы "GAM" с QSP, чтобы потом можно было открывать GAM-файлы двойным щелчком).
Работа с утилитой TXT2GAM
Top Previous Next
Программа "TXT2GAM" ("txt2gam.exe") предназначена для создания игр под платформу QSP в обычном
текстовом редакторе.
Формат файла, обрабатываемого утилитой, представлен ниже.
Начало локации обозначается символом "#", после которого пишут название локации. Затем, построчно,
необходимые операторы, а заканчивается локация символом "-" (с новой строки), после которого может
идти всё, что угодно (в том числе ничего). Следующая локация опять начинается с символа "#" и т.д.
Пример исходного файла:
#Начало
'It''s only test of new utility.'
'That is all.'
act 'Далее':
goto 'next'
end
- (конец локации)
#next
$s='Это последняя локация примера.'
i=1
:loop
if i<=len($s):
*p mid($s,i,1)
file:///C:/Users/MonsterHak/AppData/Local/Temp/~hh544C.htm
02.01.2026
Принцип работы
Page 2 of 2
wait 200
i=i+1
jump 'loop'
-
end
*nl & 'Это всё.'
Пример запуска утилиты:
txt2gam.exe game.txt game.gam
Здесь: "game.txt" - имя исходного файла, "game.gam" - имя файла, в котором будет сохранена игра.
PS:
1) Между локациями может находиться любой текст, не начинающийся с символа "#". В
результирующем файле данный текст присутствовать не будет.
2) При указании параметра "u" в командной строке, исходный файл будет обрабатываться как
Unicode-файл (кодировка UCS-2 LE / UTF-16 LE).
3) Для получения дополнительной информации об утилите, запустите её в консоли без
параметров.
Принцип работы QSP
Top Previous Next
При обработке новой локации (например, при переходе с помощью операторов "GOTO, XGOTO,
GOSUB") выполняются следующие действия:
1) Очистка списка действий предыдущей локации, если был осуществлен непосредственный переход на
локацию (например, с помощью операторов "GOTO, XGOTO");
2) Обновление поля описания локации (замена существующего основного описания, либо добавление к
нему текста базового описания новой локации - в зависимости от того, каким образом был произведён
переход);
3) Добавление базовых действий новой локации;
4) Последовательное выполнение операторов, находящихся в поле "Выполнить при посещении";
5) При непосредственном переходе на локацию выполняется обработка локации-обработчика перехода
на новую локацию, если таковая указана;
6) Если переменная локации-счётчика не пуста, то происходит обработка соответствующей локации (по
умолчанию, 2 раза в секунду);
7) Обновление интерфейса (шрифт, цвета, заданные с помощью системных переменных) - также, по
умолчанию, 2 раза в секунду;
8) При выборе действия или предмета пользователем, происходит обработка локаций-обработчиков
выбора действий и предметов;
9) При загрузке или сохранении состояния игры, происходит обработка локаций-обработчиков загрузки и
сохранения игры;
10) Если пользователь щёлкает на действии, то выполняются операторы, определённые для этого
действия;
11) Если пользователь нажимает "Enter" в строке ввода, то происходит обработка локации-обработчика
строки ввода.
file:///C:/Users/MonsterHak/AppData/Local/Temp/~hh544C.htm
02.01.2026