Text Adventure Parser

Руководство искателя приключений

В отличие от большинства движков текстовых приключений, здесь очень мало глобальных команд.
Независимо от того, где вы находитесь, вы можете ввести команду:

показать инвентарь

... или его псевдоним:

показать элементы

... чтобы показать, что вы несете. Аналогичным образом, чтобы проверить состояние переносимых предметов, введите команду:

показать состояние

... или его псевдоним:

показать форму

... и игра отобразит состояние предметов, у которых он есть.

Движок поддерживает составную выдачу команд (выполнение нескольких действий одновременно), разделяя команды знаками «и» или «то». Для этой цели вы даже можете использовать ", и " или ", затем " в качестве разделителей.

Если у вас есть какие-либо квесты, вы можете проверить их статус с помощью команд:

показать квесты

... и:

показать детали квеста

Все остальные команды специфичны для каждой комнаты приключения.
Удачи и удовольствия!

Руководство для создателей приключений

Файлы приключений представляют собой обычные текстовые файлы с расширением .tap в формате, описанном ниже.

Основной синтаксис команды:

[название комнаты]
описание комнаты
command1=result
command2=[специальный аргумент]

Во всех файлах приключений должна быть комната под названием main. В этой комнате должна быть команда start, результатом которой должно быть имя комнаты — именно в этой комнате начинается игра. В главной комнате также должно быть в первой строке после названия комнаты приветственное сообщение для всего приключения (котороеможет быть пустым).

Пример:

[main]
Добро пожаловать в учебник!
start=square

[квадрат]
... здесь находится остальная часть файла приключения...

Комнаты также могут иметь команды, вызывающие особый результат. Есть две основные команды:

command1=[квадрат деформации]

и

command2=[kill Сообщение, отображаемое при смерти игрока]

Команда warp принимает в качестве единственного аргумента название комнаты, в которую нужно телепортироваться.
Команда kill завершает приключение и отображает следующее сообщение.

Для поддержки инвентаризации существует множество команд:

Доступна глобальная команда — показать предметы (эта команда работает независимо от того, в какой комнате вы находитесь, и отображает содержимое вашего инвентаря).

Чтобы показать состояние/форму предметов вашего инвентаря, используйте глобальную команду «показать состояние». Глобальная команда «показать форму» делает то же самое.

Простые команды управления инвентарем:

command3=[захватить имя-предмета]
Текст, который будет отображаться, когда у игрока НЕТ предмета.
Текст, который будет отображаться, когда предмет уже есть у игрока.

command4=[имя-названия-предмета]
=Текст для отображения или специальная команда для запуска, когда у игрока его НЕТ
=Текст для отображения или специальная команда, выполняемая, когда она есть у игрока

Команда захвата добавляет предмет в ваш инвентарь, если у вас его еще нет.
Команда have используется для определения того, находится ли предмет в инвентаре или нет.
Команды Have могут НЕ быть вложенными. Знак = передтребуется какой-либо текст или специальные команды. Специальной командой может быть любая другая команда, не связанная с инвентарем, а также команды усиления, потери или однократного усиления.

Результаты команды могут быть объединены в цепочку, чтобы выполнить несколько действий в командной строке. Результаты команды, которые необходимо объединить в цепочку, разделяются символом «&&» (без «кавычек»). Цепочки результатов команд можно использовать везде, где требуется результат.

Другой пример:

[main]
Добро пожаловать в Chain Test!
start=circle

[circle]
tryme=Это текст для цепочки. && Это вторая строка текста.
... здесь находится остальная часть файла приключения...

Команды Grab и Have также могут принимать в качестве аргументов несколько элементов, разделенных знаком «&» (без «кавычек»). Это сообщает синтаксическому анализатору продолжать работу только в том случае, если ВСЕ названные предметы присутствуют в инвентаре, и не проходит тест в противном случае, в случае команды have. С этим улучшением команды захвата работают по-другому: вместо сбоя, если ЛЮБОЙ из элементов не удалось захватить, они завершаются сбоем только в том случае, если НИ ОДИН из названных элементов не удалось захватить.

Сложные команды управления запасами:

Для разовых операций существуют еще две команды работы с инвентарем — команды drop и loss. В команде drop or loss можно перечислить несколько элементов, разделив каждый из них знаком «&», точно так же, как команды «захватить» и «иметь». Команды «Отбросить и потерять» выполняются успешно, если ВСЕ названные предметы присутствуют в инвентаре, и не выполняются в противном случае — аналогично тому, как работают командык. За командами удаления также следуют два сообщения, как и за командами захвата. Первый отображается, если сброс выполнен успешно. Второй отображается, если сброс не удался. Если выбросить или потерять успешно, ВСЕ перечисленные предметы удаляются из инвентаря. В отличие от команд drop, команды loss не отображают никаких сообщений в случае успеха или неудачи — они просто удаляют предмет(ы) из вашего инвентаря — и поэтому их можно безопасно использовать в результатах команды have.

Пример:
[main]
Добро пожаловать в Drop Test!
start=getstuff

[getstuff]
В этой комнате есть вещи.
takething=[взять мусорное ведро, мусор и накрыть]
Вы берете три предмета.
У вас уже есть вещи.
положите вещи обратно=[бросьте мусорный бак, мусор и накройте]
Вы кладете три предмета туда, где их нашли.
У вас нет того, что вы пытаетесь найти. чтобы положить обратно.
discardthing=[lose мусорное ведро, мусор и крышку]
... остальная часть файла приключения находится здесь...

Команды Oncegrab, OnceGain и Gain также поддерживаются для управления инвентарем. В любой из этих команд можно указать несколько элементов, разделив их знаком «&», как и в команде захвата. Команды Oncegrab и Oncegain завершаются успешно, если ВСЕ названные предметы присутствуют в инвентаре И еще не были схвачены, и завершаются неудачей в противном случае - очень похоже на то, как работают команды захвата, за исключением того, что вы можете захватить предмет(ы) только один раз - даже если вы их потеряете позже. Команды получения выполняются успешно, если полученные предметы НЕ присутствуют.ent в инвентаре и в противном случае потерпит неудачу - точно так же, как команды захвата. За командами Oncegrab также следуют два сообщения, как и за командами захвата. Первый отображается, если захват успешен. Второй отображается, если захват не удался. Команды Gain и OnceGain НЕ содержат сообщений после них, в отличие от OnceGrab.

Пример OnceGrab:

[main]
Добро пожаловать в Grab Once Test!
start=getstuff

[getstuff]
В этой комнате есть вещи.
takething=[однажды возьмите мусорное ведро, мусор и крышку]
Вы берете три предмета.
Вы уже взяли вещи и не можете взять их снова.
puff back=[выбросить мусорный бак, мусор и накрыть]
Вы кладете три предмета туда, где их нашли.
У вас нет вещи, которые вы пытаетесь положить обратно.
discard Stuff=[lose мусорный бак, мусор и крышку]
... остальная часть файла приключений находится здесь...

Следующим будет выполнено удаление входных данных, прежде чем будет выполнена какая-либо обработка команд. В игре используются префиксы «идти» и «путешествовать», «а», «ан», «the» и «to» в середине команд и знаки препинания в конце. Он также удаляет символы начала и конца команды «[» и «]», а также разделитель результата «=". Наконец, он преобразует двойные пробелы в одинарные и удаляет лишние пробелы.

Замена синонимов будет выполнена после удаления ввода, но до выполнения какой-либо обработки команды. Слова, которые заменяются во вводе пользователя, определяются вкладкой синонимов.le, расположенный в комнате, имя которой является значением команды в главной комнате под названием «syntab». Формат таблицы синонимов следующий:

[имя таблицы синонимов]

ключевое слово1, синоним1, синоним2, ...
ключевое слово2, синоним1, синоним2, ...
...

Эта пустая строка после имени таблицы синонимов важна. Если он опущен, первая строка таблицы синонимов не будет анализироваться.

Если запись syntab= опущена в основной комнате, замена синонимов не будет выполнена.

Пример поможет прояснить:

[main]
Добро пожаловать в Synonym Test!
start=комната тестирования
syntab=synonyms

[синонимы]

север, н
юг, юго-запад, запад
восток, восток

[комната для испытаний]
Это комната для испытаний.
north=Вы смотрите на север, но там ничего нет.
south=Вы смотрите на юг, но там ничего нет .
east=Вы смотрите на восток, но там ничего нет.
west=Вы смотрите на запад, но там ничего нет.
... остальная часть файла приключения находится здесь .. .

Ключевые слова заменяются на все остальное в той же строке таблицы. Если пользователь вводит «n», игра поймет, что это означает «север», найдя «n» в таблице синонимов.

Составные команды будут восприниматься анализатором ввода как цепочка команд, разделенных «и» или «то», и будут выполняться в введенном порядке.

Объекты, состояние которых необходимо отслеживать, но которых нет в инвентаре, можно сделать с помощью команд проверки и изменения.

Модификация команды alterопределяет состояние объекта, добавляя его в список, если он еще не существует. Команда check ведет себя очень похоже на команду have для инвентаризации, за исключением того, что вместо этого она работает с состояниями объектов. Команда alter поддерживает одновременное изменение нескольких объектов: перечислите каждый объект, а затем его новое состояние, парами, разделенными пробелами. Обратите внимание, что знаки = ОБЯЗАТЕЛЬНЫ для обоих результатов команды проверки.

Пример:

[main]
Добро пожаловать в тест состояния объекта!
start=statetest

[statetest]
В этой комнате есть различные предметы.
open сундук=[альтернативное открытие сундука] && Вы открываете сундук.
близко сундук=[альтернативное открытие сундука] && Вы закройте сундук.
take сундук=[проверьте, сундук открыт]
=Как вы думаете, что вы делаете, беря с собой открытый сундук?
=Сундук слишком тяжел, чтобы его можно было взять, даже в закрытом состоянии.
... здесь находится остальная часть файла приключений...

Поддержка квестов тоже существует! Чтобы начать квест:

[название квеста начала квеста]

Отметка квеста как выполненного:

[имя квеста завершения квеста]

... и самый сложный из них — проверка статуса квеста:

[статус квеста имя_квеста]
=Название квеста не начато.
=Название квеста выполняется.
=Название квеста завершено.

К обязательным знакам = применяются обычные правила, и вы можете использовать в результатах специальные команды, а также цепочки. Проверки статуса не могут быть вложенными.

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

[значение имени квеста набора квестов]
[значение имени квеста добавления квеста]

Примечание. Прогресс квеста должен находиться в диапазоне от 0 до 10 000, но не ограничивается
этими значениями.

Чтобы проверить значение и ветвь:

[quest get quest-name value]
=значение РАВНО прогрессу квеста
=значение МЕНЬШЕ, ЧЕМ прогресс квеста
=значение БОЛЬШЕ, ЧЕМ прогресс квеста

Чтобы проверить два значения:

[квест-тест имя-квеста значение1 значение2]
=прогресс квеста МЕЖДУ значением1 и значением2 ЭКСКЛЮЗИВНО
=прогресс квеста НЕ МЕЖДУ значением1 и значением2 ЭКСКЛЮЗИВНО

Конечно, существует глобальная команда, позволяющая пользователям также видеть свои квесты:

показать квесты

... а также глобальная команда для отображения подробностей:

показать детали квеста

Здесь перечислены все квесты и значение их прогресса в форме:

имя квеста: 54,27% выполнено (если значение прогресса 5427)

Удачи в приключениях!