Protoparser.js – легковесный веб-движок (библиотека) для интерактивных текстовых игр с вводом команд («парсеров»).
Приставка «прото» в названии движка, в переводе с древнегреческого, означает «первый». Интерфейс командной строки протопарсера оперирует всего двумя понятиями: ГЛАГОЛ и СУЩЕСТВИТЕЛЬНОЕ. В этом он похож на первые текстовые игры-приключения. Вот основные особенности и возможности протопарсера:
🎮 Демо-игра «Фантазия» (онлайн)
📖 Руководство автора
📜 Список игр, написанных на protoparser.js
🗃️ protoparser.js в ifarchive (версия 8)
В архиве для скачивания есть руководство с примером создания игры, а также демо-игра.
Отредактировано johnbrown (03.09.2022 13:01)
Неактивен
По особенностям:
Protoparser.js платформонезависимый. Вы можете запускать и писать игры на любом устройстве, в котором есть браузер с поддержкой JavaScript. Не нужно компилировать исходники, устанавливать интерпретаторы, библиотеки, и пр. Все, что нужно, чтобы начать писать игру – любая программа в которой можно набрать и сохранить текст. Протопарсер работает даже на старых устройствах.
>Согласен. Только вот на небольшом экране смартфона, при включении поля ввода получается дикий масштаб и надо потом уменьшать экран, чтобы увидеть результат.
При желании, вы можете писать игру прямо в браузере, переключившись в «режим разработчика», если ваш браузер поддерживает такой режим.
Законченную игру можно выложить на сайт, где она будет доступна онлайн. Вы также можете запускать ее локально.
>Это прикольно
В протопарсере есть система автотестирования, которая избавит вас от необходимости после каждой правки вручную вбивать команды и проверять как все работает.
>Автотестирование это громко сказано. Скорее система проигрывания записанных команд, как в тадс и информ. Нашел случайно в исходниках как включить - в var game, свойство tests поставить true. Может описать эту процедуру в помощи + создание рядом скрипта команд?
Кроме того, благодаря наличию во многих современных браузерах «режима разработчика» вы можете в реальном времени проверять и изменять состояние игровых объектов.
Если вы даже не собираетесь писать игры на протопарсере, вы, тем не менее, можете использовать его как инструмент для быстрого прототипирования.
Protoparser.js написан на чистом JavaScript'е, и, кроме эмулятора терминала terminal.js, не использует иных библиотек или зависимостей.
Поскольку protoparser.js является веб-приложением вы можете использовать все возможности HTML, CSS и JS в своих играх: вставлять картинки, музыку, звуки, видео; устанавливать стили оформления; подключать дополнительные js-библиотеки, и многое другое.
Protoparser.js выполняется полностью на стороне клиента, и там же хранит все данные.
>Нормально
Protoparser.js поддерживает мульти-сохранение и загрузку игр.
>Как это сделать? Нет реакции на сохранить, загрузить игру.
Посмотрел код, это скорее библиотека для JS, позволяющая организовать парсерную игру, чем целая платформа. Потому что без знания javascript не получиться написать игру для авторами. Понятно, что по описанию она не стремится тягаться со "взрослыми" парсерными платформами, однако есть некий минимум для обработки - больше двух слов. Надо разрешить такие конструкции как "поговорить со стариком", "залезть на дерево". Ну и прописывать вручную склонения немного утомительно, может будут подвижки в этом направлении.
Что меня привлекает в платформе: клиентский код в браузере, легковесный.
Что меня отталкивает: лично я не стал бы пользоваться этой платформой. Дело даже не в том, что сырая. Не виден вектор развития. ТАДС и Информ давно покрыли текущий функционал и планируемый в части моделирования мира и обработки команд. Нужны годы, чтобы дойти до такого же уровня на JS, но тогда движок станет совсем не легковесным, а тяжёлым, уже не уверен что будет хорошо и быстро на клиенте работать, пропадёт первая цель. Мне было бы интересно воспользоваться каким-то спец-движком, например: парсерный движок для текстовых стратегий, тайм-менеджемтов и т.п. Он бы имел внутри себя модель предметной области и автор вводит только настройки модели и получает на выходе игру определённого жанра, потому что зачастую приходиться эту модель вводить с нуля.
Вцелом работа интересная, думаю, автор повысил свой левел в JS-пока писал её
PS: а куда можно отправить лог по игре фантазия?
Неактивен
Привет Антон! Спасибо за интерес к проекту.
>Согласен. Только вот на небольшом экране смартфона, при включении поля ввода получается дикий масштаб и надо потом уменьшать экран, чтобы увидеть результат.
Да, я заметил на разных смартфонах игра отображается со своими нюансами. Иногда это даже зависит от того включён интернет или нет, хотя движок полностью автономен. Пока главное что запускается, юзерэкспириенс будем допиливать после )
Автотестирование это громко сказано. Скорее система проигрывания записанных команд, как в тадс и информ. Нашел случайно в исходниках как включить - в var game, свойство tests поставить true. Может описать эту процедуру в помощи + создание рядом скрипта команд?
Это все есть. В руководстве этому целая глава посвящена. Скрипты для тестирования тоже есть. В папке с игрой. Если его включить игра сама себя пройдёт. Ну, и в корневой тоже, для удобства автора.
>Как это сделать? Нет реакции на сохранить, загрузить игру.
Реакция должна быть. Хотя бы "Ошибка при загрузке/сохранении". Пишите "сохранить названиефайласохранения", например: сохранить фантазия1
Посмотрел код, это скорее библиотека для JS, позволяющая организовать парсерную игру, чем целая платформа. Потому что без знания javascript не получиться написать игру для авторами
Инстед игры тоже пишутся на скриптовом языке - луа. Чем сложнее твоя игра тем больше ты должен знать. В обоих случаях знание базового синтаксиса необходимо.
Понятно, что по описанию она не стремится тягаться со "взрослыми" парсерными платформами, однако есть некий минимум для обработки - больше двух слов. Надо разрешить такие конструкции как "поговорить со стариком", "залезть на дерево".
В мире минюшек есть очень много платформ от казуальных до навороченых объектно-ориентированных, типа инстеда. Почему-то считается, что парсерки должны быть больше, выше, сильнее, обязательно все понимать, и вообще работать на нейронке. У меня немножко другой подход, устаревший ) Возможно он изменится, но возможно и нет.
Что меня привлекает в платформе: клиентский код в браузере, легковесный.
< 30 КБ
PS: а куда можно отправить лог по игре фантазия?
Логи можно слать в личку. Кстати, спасибо.
Неактивен
Движок интересный. Будут новые релизы - пиши сюда, что важное в них. И жду новых демо-игр.
PS. Может даже попробую свою игру написать.
Неактивен
Sonic написал:
Движок интересный. Будут новые релизы - пиши сюда, что важное в них. И жду новых демо-игр.
PS. Может даже попробую свою игру написать.
Спасибо! Да, конечно, о релизах буду сообщать. Думаю, новые фичи буду просто добавлять в Фантазию.
Неактивен
Версия 2(93)
Полный список изменений
спойлер…
Неактивен
ВЕРСИЯ 3(104)
Так получилось, что третий релиз, в основном, посвящен работе над ошибками и улучшению внутренней логики программы. Из-за этого не получилось добавить те фичи, которые я изначально планировал. Зато появились фичи, которые я вообще не планировал Итак, что нового:
Во-первых, продолжена начатая в прошлой версии работа над кастомизацией стандартных сообщений системы. В этой версии я сосредоточился на интерфейсе командной строки.
- теперь у автора появилась возможность установить символьное представления курсора, частоту и режим мигания;
- появилась возможность добавлять в строку ввода команду по-умолчанию. Это когда в командной строке уже находится какая-то команда. Разумеется, пользователь может удалить, отредактировать или выполнить ее. Я вижу применение этой функции, например, в организации интерактивного обучения или когда автор хочет дать игроку прямую подсказку;
- в командной строке появился симпатичный символ ">" - приглашение командной строки. Как и другие элементы командной строки его можно менять и отключать. Вообще, он задумывался для организации статус-бара - области командной строки, слева от поля ввода, куда могли бы выводиться игровые переменные, например, ходы, здоровье и все, что автор сочтет нужным. Кстати, в игре «Фантазия» появился пример такого статус-бара.
Вторая главная фича этого релиза - «горячие клавиши». Игрой теперь можно управлять не только набирая команды, но и используя специально определенные клавиши (пока это нумпад и пара функциональных клавиш). По-умолчанию, на них повешены наиболее часто употребляемые команды: передвижение, просмотр инвентаря, осмотр и пр. Все эти команды легко можно переназначить, исходя из особенностей своей игры.
В руководство добавились несколько новых разделов; информация в имеющихся обновлена, в соответствии с последними изменениями. Также обновлена игра «Фантазия». Все изменения можно протестировать прямо в ней.
Полный список изменений:
спойлер…
Неактивен
Бегло посмотрел игру "Фантазия". Парсер напряжения не вызывает, ограничение в два слова приводит к неожиданному эффекту - стало играть проще. Было бы неплохо добавить в парсер функцию истории - по курсору стрелка вверх - вниз вызывать предыдущие команды, чтобы редактировать - так удобнее.
В самой игре нашел несколько опечаток:
спойлер…
Неактивен
Неактивен
ВЕРСИЯ 4(114)
В этой версии не произошло каких-то глобальных изменений, но кое-что, все-таки, появилось.
Большинство изменений можно посмотреть в демо-игре "Фантазия".
П.С. Руководство тоже обновлено
Полный список изменений
спойлер…
Неактивен
ВЕРСИЯ 5(127)
В пятую юбилейную версию protoparser.js вошло несколько очень важных нововведений.
Полный список изменений
спойлер…
Неактивен
ВЕРСИЯ 6(145)
Первый осенний релиз принес несколько интересных фич, которые, я думаю, будут интересны как авторам, так и игрокам. Одна из них, кстати, появилась еще в прошлой версии, но, случайно, осталась без внимания. Итак!
Длинный коридор
Серые каменные стены коридора, кажется, покрыты пылью многих веков. На севере расположена невысокая дверь. Каменная спиральная лестница поднимается высоко вверх. Возле стены, стоит полный рыцарский доспех с опущенным забралом. Вас не покидает чувство, что за вами наблюдают.
> о дверь
Тяжелая дубовая дверь, кажется, помнит еще те времена, когда слово «рыцарь» было не просто красивым эпитетом.
> вв
После полумрака коридора яркий дневной свет на несколько секунд ослепляет вас. Открывшаяся вашему взору картина завораживает.
Башня
Открытая площадка башни позволяет видеть округу на много километров. В отдалении на севере блестит небольшое озеро и виднеется выход из парка. Вниз ведет лестница.
Здесь есть: шляпа.
> о шляпу
Серая широкополая шляпа выглядит весьма помятой. Сбоку к шляпе приколота какая-то лента с надписью.
> локации
1. Длинный коридор
Вы осмотрели: дверь.
2. Башня
Вы осмотрели: шляпу.
> о доспех
Ничем не примечательный доспех.
> о дос
Ничем не примечательный доспех.
> о до
Ничем не примечательный доспех.
И, даже так
> о пех
Ничем не примечательный доспех.
Вводить существительное можно начиная с любой его части: с начала, с середины, с конца. Обычно, достаточно трехбуквенного сокращения. Двухбуквенные тоже работают, но могут быть быть ошибки из-за того, что данный набор букв встречается в названии какого-то другого объекта.
function sleep() { t.print('Вам не хочется спать.') }
Стало
var game = { // свойство 1 sleep: 'Вам не хочется спать.' // свойство n }
Как обычно, обновлены руководство и демо-игра «Фантазия» в которой можно проверить работу новых фич.
Полный список изменений
спойлер…
Неактивен
Двухочковый "Плащ тьмы" на protoparser.js 6(145):
Есть два нетривиальных момента, обусловленных ограничениями платформы: реализация суррогатной тёмной комнаты (см. events.beforeAll и foyer.walk) и реализация суррогатной поверхности в пазле для получения первого очка (см. events.beforeAll и cloak.hang).
Неактивен
Это шикарно! Целых две концовки, даже больше, чем в "Фантазии"
Огромное спасибо за работу! У самого были мысли реализовать эту игру, но как-то руки не дошли...
Никита, можно включить ваш скрипт в дистрибутив протопарсера?
Неактивен
Плащ шикарен.
Вот еще бы хоть немного синонимов к глаголам; "вешать плащ" - это разве по-русски? )
Неактивен
johnbrown написал:
Никита, можно включить ваш скрипт в дистрибутив протопарсера?
Если считаете нужным, то да, конечно можно. Единственно там с крючком и тёмной комнатой скорей хаки, чем штатные возможности платформы, так что лучше "Плащ тьмы" приводить уже после пошагового объяснения "Фантазии" и с пометкой типа "Кстати, многое в ваших руках, если чего-то не хватает".
ASBer написал:
Вот еще бы хоть немного синонимов к глаголам; "вешать плащ" - это разве по-русски? )
Вешать это всего лишь дублирующий синоним. Основным и наиболее естественным вариантом команды я считаю "повесить".
gameCommands.hang = ['hang', ['повесить', 'вешать'], 1]
Вообще обычно в реализациях "Плаща тьмы" на различных платформах крючок является поверхностью, а "повесить" добавляется просто синонимом к команде "положить", но поскольку protoparser.js не имеет встроенной функциональности поверхностей и контейнеров, то здесь мы пишем всё с нуля, бросая плащ в локации, но посредством дополнительной обработки флага прямой видимости делаем вид, что он на крючке. В "Фантазии" такой же условный контейнер - это доспехи, из которых выпадает ключ, только там это разовая реакция, поэтому реализовать чуть проще, а с плащом пришлось сделать имитацию для многоразового использования.
Неактивен
@johnbrown, посмотри пожалуйста что получилось после того, как я убрал библиотеку
terminal.js
Неактивен
Навскидку, что успел заметить:
- game.commandTemplate, game.cursor, game.fireCursorInterval, game.prompt, game.shouldBlinkCursor - интерфейс командной строки отсутствует. При надевании часов вместо > должно было появится текущее время. Хотелось бы сохранить возможность кастомизации командной строки.
- после загрузки страницы нет никакой игровой информации, кроме строки ввода. Она появляется только если обновить страницу
- по команде "лог" открывается пустая страница
- при переходе из коридора в башню и обратно не происходит смены темы
Тестировал на android 8.1.0, браузер Chrome 68.0.3440.91
Хотелось бы ещё попробовать запустить оффлайн. 6 версия у меня на телефоне не запустилась.
Пока то, что заметил. Буду тестировать дальше. К сожалению, пока только с телефона.
Отредактировано johnbrown (29.12.2018 14:45)
Неактивен
johnbrown написал:
Навскидку, что успел заметить:
- game.commandTemplate, game.cursor, game.fireCursorInterval, game.prompt, game.shouldBlinkCursor - интерфейс командной строки отсутствует. При надевании часов вместо > должно было появится текущее время. Хотелось бы сохранить возможность кастомизации командной строки.
Вроде как командной строки больше нет. Есть поле ввода. Можно кастомизировать то, что отображается в пустом поле ввода, или выводить что-то перед полем....
johnbrown написал:
- после загрузки страницы нет никакой игровой информации, кроме строки ввода. Она появляется только если обновить страницу
Очевидно произошла ошибка. Что в консоле браузера?
johnbrown написал:
- по команде "лог" открывается пустая страница
Есть такое дело. Пока не разбирался. Возможно лог лучше выдавать в консоль?
johnbrown написал:
- при переходе из коридора в башню и обратно не происходит смены темы
Ну так теперь это не "терминальный" вариант. Изменение темы придётся переписать, с учётом того, что теперь тема состоит из большего числа элементов... шрифты, фоны, цвета (основной, вторичный, третичный и т.п.)...
johnbrown написал:
Тестировал на android 8.1.0, браузер Chrome 68.0.3440.91
Хотелось бы ещё попробовать запустить оффлайн. 6 версия у меня на телефоне не запустилась.
Пока то, что заметил. Буду тестировать дальше. К сожалению, пока только с телефона.
С телефонами пока есть некоторые проблемы.
Неактивен
Вроде как командной строки больше нет. Есть поле ввода. Можно кастомизировать то, что отображается в пустом поле ввода, или выводить что-то перед полем....
Да, я заметил, так правильнее. Просто хотелось бы чтобы все параметры, которые были сохранились. Только теперь это видимо будет задаваться через стили.
Очевидно произошла ошибка. Что в консоле браузера?
Не уверен, что в мобильном хроме есть режим разработчика. Приложил скрин.
Похоже, ошибка возникает только, если в настройке включена "мобильная версия".
Возможно лог лучше выдавать в консоль?
Потеряется форматирование. И потом это не очень user-friendly. Если только как дополнительный вариант.
Отредактировано johnbrown (30.12.2018 08:02)
Неактивен
Кстати, если terminal.js больше не планируется использовать, нужно добавить в движок обработчик хоткеев.
Отредактировано johnbrown (07.01.2019 17:38)
Неактивен
Madzi написал:
@johnbrown, посмотри пожалуйста что получилось после того, как я убрал библиотеку
Код:
terminal.js
Не сочтите за злонамеренную девальвацию ценности вашего вклада, но может быть использовать менее хипстерский JS, а то поддержка старых браузеров отваливается, например, Internet Explorer 11, который не может отрисовать такую страницу? С terminal.js всё работало даже в IE. Всё-таки это олдскульная текстовая игра, а не продвинутый браузерный 3D shooter, чтобы отцеплять старые браузеры, особенно если их поддержка дорого не обходится. Даже поисковый робот Google до сих пор ходит с движком Chrome 41 внутри и как сможет увидеть под ним, так и сохраняет в индекс, так что не все уж такие прогрессивные в реальном мире. Кому, как не авторам текстовых игр, заботиться о ретроградах?
johnbrown написал:
Кстати, если terminal.js больше не планируется использовать, нужно добавить в движок обработчик хоткеев.
Кстати, по поводу горячих клавиш... Решение по перехвату многих из них игрой представляется не самым удачным. Например, в Windows F6 - это перемещение по панелям интерфейса, образующим отдельные кластеры клавиатурной навигации, в том числе во всех основных браузерах, и с многими другими командами также. То есть ряд стандартных горячих клавиш protoparser.js сейчас блокирует целый блок нативных команд, являющихся конвенцией на уровне операционной системы. Например, можно было бы по умолчанию добавить ко всем командам модификатор Alt, чтобы избежать этих неприятных коллизий.
Отредактировано Nikita (07.01.2019 19:07)
Неактивен
Не сочтите за злонамеренную девальвацию ценности вашего вклада, но может быть использовать менее хипстерский JS, а то поддержка старых браузеров отваливается, например, Internet Explorer 11, который не может отрисовать такую страницу?
Хорошее предложение. Когда я писал пп, то всегда тестировал его на своем старом HTC с андроидом 2.3.6. Там тоже было не все гладко, но хотя бы играть можно было. Согласен с тем, что нужно сохранить максимальную совместимость с большинством браузеров. Возможно, хорошей идеей будет прогнать код через какой-нибудь babel. С другой стороны, тот код, который есть сейчас требует серьезного рефакторинга, а мои познания в современном js весьма скромны. Очень хорошо, что человек взялся за это дело.
Решение по перехвату многих из них игрой представляется не самым удачным
Интересная мысль, я об этом не задумывался. Наверное потому, что никогда не использую эти клавиши. А многие ли используют? А если у человека какой-нибудь Autohotkey запущен? Вариант с дополнительной клавишей мне не очень нравится, это неудобно.
Ещё хочу вот что добавить. Пп - такое же приложение, как Word или Excel, только ОС для него браузер. Ворд и Эксель не волнует, что там думает Windows или Mac по поводу F1. Почему с пп должно быть по-другому? Никто не запрещает пользователю переключиться в другую вкладку и сделать свои дела.
Отредактировано johnbrown (07.01.2019 21:03)
Неактивен
johnbrown написал:
Пп - такое же приложение, как Word или Excel, только ОС для него браузер. Ворд и Эксель не волнует, что там думает Windows или Mac по поводу F1. Почему с пп должно быть по-другому? Никто не запрещает пользователю переключиться в другую вкладку и сделать свои дела.
F1 в Windows - это резервированная команда для вызова справки именно приложения, так что с этим проблем особых как раз нет, если трактовать protoparser.js как приложение, но какой-нибудь F6 - это более тяжёлый случай. F6 - это один из нескольких распространённых способов попасть в адресную строку с клавиатуры во всех основных браузерах, а также перейти к избранному, закладкам и прочим общим элементам управления, важным на каждой вкладке. То есть клавиатурное управление protoparser.js блокирует ряд базовых пользовательских сценариев в браузере, например, когда я поиграл и теперь хочу пойти на ifiction.ru и написать комментарий, нажав F6 и введя адрес. По-моему это всё-таки слишком резко для web-приложения. Я понимаю позицию "лично я никогда этим не пользовался, но она не самая правильная в продуктовой разработке, там всё-таки надо соблюдать конвенции операционной системы, потому что кто-нибудь обязательно этим пользуется, если это стандартный способ управления. К тому же горячими клавишами в игре, в первую очередь, будут пользоваться как раз те, кто вообще по жизни привык с ними работать, так что этим пользователям с большой долей вероятности будут нужны и F6, и многое другое.
F3 занята функцией "Искать далее", F4 в ряде браузеров открывает адресную строку, F5 везде обновляет страницу, F6 в Windows переходит по панелям приложения, F7 в ряде браузеров отвечает за дополнительную клавиатурную навигацию, F8 в ряде браузеров управляет выделением, F10 в Windows является одним из способов для входа в строку меню приложения, F11 в ряде браузеров отвечает за включение и выключение полноэкранного режима, F12 в ряде браузеров открывает панель разработчика. Я бы не советовал ломать ничего из этого. Фактически безболезненно доступны только F2 и F9, ну и в какой-то мере F1, по крайней мере, я ничего такого там для браузеров не помню, так что в крайнем случае можно перейти на них, например, выбросив непомещающуюся команду "версия" с F2, для которой горячая клавиша всё равно не очень нужна.
Неактивен