- Вывод текста
- Программирование
- Оформление
- Расширенные возможности
- Нюансы написания игр под разные плееры
-
- x AeroQSP
- Утилиты и средства разработки
Статья актуализирована для qSpider версии 1.3.1.
qSpider — это QSP-плеер с поддержкой полноценной браузерной HTML-вёрстки, то есть в нём можно использовать такой же HTML-код, как в обычном браузере.
Обучиться писать HTML-разметку можно, например, здесь:
Cуществует два варианта плеера:
Релиз последней версии плеера qSpider вы всегда можете найти по этой ссылке:
https://github.com/qspfoundation/qspider/releases
qSpider использует последнюю версию библиотеки qsplib
, а значит игры, написанные на классический плеер с той же версией библиотеки, полностью совместимы с qSpider.
Демонстрацию работы плеера можно посмотреть здесь:
image.jpg
", а в файле игры записано "Image.jpg
" или "image.JPG
", то плеер не сможет показать такую картинку;.mp3
как самый поддерживаемый (хорошая альтернатива — .webm
, у него меньше размер при том же качестве, но чуть хуже с поддержкой браузеров);wait
(кликом по странице);game.cfg
с описанием всех игр).Обратите внимание: чтобы запустить игру из архива, QSP-файл игры должен находится в корне архива (не в подпапке), а так же в корне должен быть только один QSP-файл (если используются дополнительные QSP-файлы, то они должны быть расположены в подпапках).
game.cfg
подключается, даже если игра не упакована в архив;Установка десктопного варианта будет несколько отличаться для разных операционных систем, но проблем у вас не возникнет, если вы хоть раз устанавливали программы на свой компьютер.
После установки запуск плеера ничем не отличается от запуска любой другой программы.
У пользователей устаревших операционных систем при установке могут возникнуть ошибки, похожие на эту:
В этом случае попробуйте установить webview2 вручную (скачать можно с этой страницы), а затем вновь запустите установку плеера.
Если ошибка не исправилась, воспользуйтесь браузерной версией плеера.
Десктопный qSpider запускается из Quest Generator точно так же, как и классический плеер. Достаточно прописать путь к qSpider в настройках QGen. Это делается через меню "Утилиты → Настройки" на вкладке "Пути" в поле "Путь к плееру".
Данная версия плеера может быть использована вами для размещения игр онлайн, то есть в интернете. Однако так же её можно запускать и на компьютере.
game
"; приоритет у индивидуальных файлов конфигураций;Стандалон-сборка
Прежде всего вам необходимо скачать архив "qspider-player-standalone.zip
" с web-версией плеера со страницы релизов. Содержимое архива распакуйте в любую папку, эта папка и будет местом расположения плеера.
Из-за ограничений безопасности плеер нельзя запустить просто открыв файл "index.html
" в браузере.
Поэтому для запуска необходим локально запущенный сервер — можно использовать один из списка.
Более простой способ запустить веб-версию — использовать VS Code с расширением Live Server: * Скачайте и установите бесплатный VS Code.
File → Preferences → Extensions
, или нажмите сочетание клавиш Ctrl + Shift + X
Live Server
".Install
.Go Live
"File → Open Folder...
"index.html
.Go Live
.Если вы всё сделали правильно, в браузере откроется qSpider.
Поскольку ни одна игра в qSpider не добавлена, в окне браузера будет проигрываться бесконечная анимация.
Для того, чтобы игра проигрывалась в браузерной версии плеера, нужно добавить игру и файл game.cfg
в папку game
, расположенную в папке с плеером.
Плеер с полкой игр
Порядок установки веб-версии плеера с полкой игр мало чем отличается от установки стандалон варианта для веб-версии. Единственное отличие заключается в том, что вам нужно скачать архив "qspider-player.zip
" с web-версией плеера со страницы релизов.
Далее всё делаем точно так же, как в выше изложенной инструкции.
После запуска сервера в браузере откроется qSpider с полкой игр. Эта версия qSpider ничем не будет отличаться от версии, доступной по ссылке qspfoundation.github.io/qspider.
game
" и добавить в неё свою игру, которую хотите разместить на гитхабе.game.cfg
" так, чтобы в нём присутствовали все необходимые секции настроек (см. статью "Конфигурационный файл").qspider-game
".aero
", "assets
", "game
", "locales
", "themes
".https://username.github.io/qspider-game
" станет доступна страничка с вашей игрой. (Соответственно вместо "username" будет ваш ник на гитхабе, а вместо "qspider-game" — название репозитория, который вы только что создали).Есть видео на тему: Размещение игры онлайн с использованием GitHub, однако там создание страницы производится другим способом, без создания ветки "gh-pages".
ВНИМАНИЕ!!! Возможность запуска игр по ссылке ограничена — на сервере, на котором лежит игра, должна быть включена поддержка CORS.
Важно! Запускать сторонние игры может только версия плеера со встроенным каталогом игр.
В чём смысл.
Нам не нужно, чтобы все игры, которые мы хотим запускать с нашего сайта, лежали прямо у нас на сайте. Мы можем запускать игры, которые лежат на других сайтах.
Например, qSpider у нас установлен по адресу "https://qspfoundation.github.io/qspider
", а игра лежит по адресу "https://aleksversus.github.io/merphy_law/game/merphy_law.qsp
".
Мы можем ввести в адресную строку, или вставить в атрибут href
гиперссылки следующий адрес, и он откроет нашу игру в указанном "плеере" qSpider:
https://qspfoundation.github.io/qspider/?game=https://aleksversus.github.io/merphy_law/game/merphy_law.qsp
При этом игра будет загружена на полку игр.
Открыть таким же образом игру в онлайн-плеере, в котором нет полки игр (то есть в плеере для стандалон-сборки), не получится.
Таким же образом можно загружать игры целым пакетом, сославшись на один конфигурационный файл (конфиг), в котором описаны сразу несколько игр:
https://qspfoundation.github.io/qspider/?config=https://aleksversus.github.io/QSP-storage/game/game.cfg
После загрузки всех игр на полку, самая первая игра в конфиге будет запущена автоматически.
А ещё можно упаковать несколько игр в zip-архив, поместить в корень архива конфигурационный файл, и сделать ссылку на архив — все игры из архива тоже будут загружены на полку.
Игру, опубликованную в каталоге игр qsp.org, можно запускать по прямой ссылке. Она автоматически добавится на полку и запустится. Чтобы получить такую ссылку:
https://qsp.org/index.php?option=com_sobi2&sobi2Task=sobi2Details&catid=6&sobi2Id=84&Itemid=55
https://qspfoundation.github.io/qspider/?catalogId=84
Для того, чтобы писать игры QSP в текстовом редакторе, был разработан специальный формат для текстовых файлов под названием TXT2GAM. Ещё его можно называть "формат QSPS" по названию общепринятого расширения ".qsps
", которое таким файлам назначается. Подробное описание формата вы найдёте в статье "TXT2GAM. Краткое руководство".
Обычно игры, написанные в этом формате, требуется сконвертировать в файл игр QSP с помощью специальной утилиты TXT2GAM. Однако qSpider позволяет запускать такие игры прямо из qsps-файлов, не конвертируя их.
Требования к играм, написанным в виде текстовых файлов:
.qsps
";Quest Generator позволяет экспортировать игру в qsps-файл именно в кодировке utf-16le, однако предпочтительнее использовать кодировку utf-8, поскольку в этом случае файл будет гораздо меньше по объёму.
ctrl+r
- перезапуск игры (Заново)ctrl+s
- меню сохраненияctrl+o
- меню загрузкиf5
- quicksave (быстрое сохранение)f9
- quickload (быстрая загрузка)PageUp
- увеличить громкостьPageDown
- уменьшить громкостьHome
- выключить звукEnd
- включить звукSpace
- единственное действие1 ... 9
- действия с 1 по 9 по порядку.