qSpider 1.1.0
Вышла новая версия qSpider — 1.1.0.
Новые фичи:
— standalone сборка игры (плеер без полки игр и загрузкой игры из конфига)
— в online версию добавлена возможность использовать ссылку на игру из каталога
— улучшено отображение горячих клавиш в меню паузы (вместо meta теперь отображается название клавиши в зависимости от платформы (Ctrl на Window и ⌘ на Mac)
Список исправлений:
— исправлена работа savegame/opengame команд и их работа при nosave=1
— исправлен запуск aero игр в десктоп версии
— исправлена работа тега center в названии действий, предметов и пунктов меню
— исправлена поддержка загрузки лейаута из qspgui.cfg
— исправлено закрытие view панели
— исправлена поддержка кирилицы в названии файлов внутри zip архивов созданных в Windows
— исправлено падение плеера если горячая клавиша была нажата при открытом msg/input
— исправлено сохранение по имени (savegame '1') в десктоп версии
— исправлена поддержка gt без пробелов вокруг (>'loc') внутри ссылок
Например https://qspfoundation.github.io/qspider/?catalogId=125 — игра сказочка на ночь
Если игры еще нет на полке — она будет автоматически добавлена.
Когда игра на полке — она будет запущена.
Соотвествующий id можно взять из ссылки на qsp каталог — qsp.org/index.php?option=com_sobi2&sobi2Task=sobi2Details&sobi2Id=126&Itemid=55
необходимо взять значение параметра sobi2Id (126 в примере)
Особенности standalone сборки:
В релиз теперь включается архив с standalone версией — qspider-player-standalone.zip
Игру вместе с файлом конфига game.cfg необходимо поместить в папку game.
После этого игру вместе с плеером можно публиковать online.
Для создания desktop версии игры подготовлен шаблон репозитория с необходимыми скриптами для сборки. Будет необходим аккаунт на github.com и минимальные навыки работы с git.
Ссылку на игру можно найти в вкладке Settings -> Pages.
Ссылка на последний релиз будет доступна в правом сайдбаре на вкладке Code.
Для созданий новых релизов вместе с изменением файлов игры необходимо изменить версию в файле game.build.conf.json.
Новые фичи:
— standalone сборка игры (плеер без полки игр и загрузкой игры из конфига)
— в online версию добавлена возможность использовать ссылку на игру из каталога
— улучшено отображение горячих клавиш в меню паузы (вместо meta теперь отображается название клавиши в зависимости от платформы (Ctrl на Window и ⌘ на Mac)
Список исправлений:
— исправлена работа savegame/opengame команд и их работа при nosave=1
— исправлен запуск aero игр в десктоп версии
— исправлена работа тега center в названии действий, предметов и пунктов меню
— исправлена поддержка загрузки лейаута из qspgui.cfg
— исправлено закрытие view панели
— исправлена поддержка кирилицы в названии файлов внутри zip архивов созданных в Windows
— исправлено падение плеера если горячая клавиша была нажата при открытом msg/input
— исправлено сохранение по имени (savegame '1') в десктоп версии
— исправлена поддержка gt без пробелов вокруг (>'loc') внутри ссылок
Ссылки на игры из каталога в online версии
Теперь к ссылке на онлайн версию можно добавить параметр catalogId.Например https://qspfoundation.github.io/qspider/?catalogId=125 — игра сказочка на ночь
Если игры еще нет на полке — она будет автоматически добавлена.
Когда игра на полке — она будет запущена.
Соотвествующий id можно взять из ссылки на qsp каталог — qsp.org/index.php?option=com_sobi2&sobi2Task=sobi2Details&sobi2Id=126&Itemid=55
необходимо взять значение параметра sobi2Id (126 в примере)
Standalone версия плеера
Для тех кто хочет опубликовать свою игру онлайн без полки игр или же собрать desktop версию своей игры была добавлена standalone версия плеера (без полки игр и загрузкой игры из файла конфига).Особенности standalone сборки:
- если в файле конфига описано несколько игр — будет запущена первая из списка
- не поддерживаются архивы игр — их надо распаковать
В релиз теперь включается архив с standalone версией — qspider-player-standalone.zip
Игру вместе с файлом конфига game.cfg необходимо поместить в папку game.
После этого игру вместе с плеером можно публиковать online.
Для создания desktop версии игры подготовлен шаблон репозитория с необходимыми скриптами для сборки. Будет необходим аккаунт на github.com и минимальные навыки работы с git.
Создание репозитория
- заходим в репозиторий https://github.com/QSPFoundation/qspider-standalone-game-template
- в правом верхнем углу нажимаем Use this template и Create a new repository
- обязательно отмечаем Include all branches
- вводим название репозитория, выбираем public (необходимо для использования Github Pages для онлайн версии и файла автоапдейтов)
- создаем репозиторий
Добавление файлов игры и минимальные настройки для online публикации
- клонируем репозиторий
- копируем файлы игры в папку репозитория (в дальнейшем лучше разработку вести в ней)
- если у игры не было game.cfg файла — заполняем пустой файл из репозитория, указывая id, название и путь к qsp(или qsps) файлу игры
- коммитим файлы и пушим
Публикация только онлайн версии
- заходим на вкладку Actions в репозитории
- в левой панели выбираем Update github pages (game only)
- в правом верхнем углу таблицы нажимаем Run workflow и нажимаем кнопку Run workflow в появившейся панели
- выбираем All workflows в левой панели
- Ждем пока Update github pages (game only) и pages build and deployment (появится после завершения (Update github pages (game only))) завершатся
Ссылку на игру можно найти в вкладке Settings -> Pages.
Настройка desktop сборки
Генерация ключей для подписи автоапдейтов игры
Для этого шага необходимо установить NodeJS- открываем консоль (в windows это можно сделать нажав win + R и набрав cmd)
- запускаем команду
npx @tauri-apps/cli signer generate
- вводим пароль для нашего ключа
- копируем публичный ключ из вывода в консоли (строка случайных символов после слов Your public key was generated successfully:)
- открываем файл game.build.conf.json в папке репозитория и вставляем ключ в поле pubkey
- копируем приватный ключ из вывода в консоли (строка случайных символов после слов Your secret key was generated successfully — Keep it secret!)
- открываем вкладку Settings репозитория
- в левой панели выбираем Secrets and Variables — Actions
- в секции Repository secrets добавляем 2 записи:
- TAURI_PRIVATE_KEY, в значение вставляем скопированный приватный ключ
- TAURI_KEY_PASSWORD, в значение вводим пароль использованный при генерации ключей
Заполнение данных для десктоп сборки
- меняем иконку игры game-icon.png — размер 1024х1024 пикселей png с прозрачностью
- открываем файл game.build.conf.json в папке репозитория
- вводим название игры в поле package.productName
- изменяем версию в package.version если необходимо
- изменяем идентификатор сборки в поле tauri.bundle.identifier — только английские буквы разделенные точкой
- заполняем поля tauri.bundle.publisher, tauri.bundle.copyright, tauri.bundle.shortDescription и tauri.bundle.longDescription
- в поле tauri.updater.endpoints добавляем ссылку на github pages репозитория с /updater.json в конце
- настраиваем окно игры в секции tauri.window
- коммитим и пушим изменения
Создание релиза игры
- открываем вкладку Actions в репозитории
- в левой панели выбираем Game release
- в правом верхнем углу таблицы нажимаем Run workflow и нажимаем кнопку Run workflow в появившейся панели
- выбираем All workflows в левой панели
- ждем пока Game release успешно завершиться (может занять минут 10)
- в левой панели выбираем Update github pages (game and updater)
- в правом верхнем углу таблицы нажимаем Run workflow и нажимаем кнопку Run workflow в появившейся панели
- Ждем пока Update github pages (game and updater) и pages build and deployment (появится после завершения (Update github pages (game and updater))) завершатся
Ссылка на последний релиз будет доступна в правом сайдбаре на вкладке Code.
Для созданий новых релизов вместе с изменением файлов игры необходимо изменить версию в файле game.build.conf.json.