SI Convert

Этот скрипт облегчает написание паков для «Своей игры» на движке SiGame Владимира Хиля. Вместо использования десктопного редактора под Windows или блуждания в кнопках «добавить вопрос» других интерфейсов, просто создайте текстовый файл и фигачьте вопросы туда. А затем запустите:

si_convert pack.yml result.siq

В настоящий момент НЕ поддерживает формат SIQ v5. Помощь приветствуется.

Формат файла YAML

Для примера, скачайте любой пак из библиотеки вопросов и запустите с ним этот конвертер.

См. также:

Пакет

Ключ	Тип	Описание
name	строка	название пакета, обязательно
difficulty	число	сложность 1-10, обязательно
date	строка	дата обновления в формате дд.мм.гггг
logo	строка	картинка для отображения
language	строка	язык в формате ISO 639-1 + страна (например, `ru-RU` или `en-US`)
authors	массив строк	список авторов, обязательно
sources	массив строк	список источников
comments	строка	комментарий к пакету
publisher	строка	издатель
restriction	строка	ограничение по возрасту: 12+, 18+.
round1, round2, ...	раунд	вместо массива указываем номер раунда, `round1` обязателен.

Раунд

Ключ	Тип	Описание
name	строка	название раунда, обязательно
final	true/false	`true` для финального раунда
prices	массив чисел	стоимости вопросов раунда, обязательно для не-финала
themes	массив тем	каждая тема содежит только два поля: `name` с названием и `questions` с массивом вопросов, обязательно

Вопрос

Ключ	Тип	Описание
type	строка	тип вопроса, если он не обычный simple
cost	число	для типов `cat` и `bagcat` — реальная стоимость вопроса. Для выбора указывается массив из трёх чисел.
theme	строка	для типов `cat` и `bagcat` — реальная тема вопроса
self	true/false	для типа `bagcat` — можно ли забрать вопрос себе
knows	before/after/never	для типа `bagcat` — когда узнаётся тема и стоимость вопроса
answer	строка	ответ на вопрос, обязательно. Второй и последующие ответы пишите в `answer2`, `answer3` и т.д.
wrong	строка	неправильный ответ. Другие варианты — в `wrong2` и т.д.
scenario	массив	если нужно показать несколько слайдов, вносите каждый из последующего списка в массив
text	строка	вопрос для отображения в слайде
say	строка	вопрос для озвучивания ведущим
image	название файла	картинка для отображения
voice	название файла	звук для проигрывания
video	название файла	видео для показа

Файлы должны располагаться в том же каталоге, что и файл yaml, либо в подкаталоге media, либо в правильном подкаталоге из Images, Audio или Video.

Один из элементов text, say, image, voice или video обязателен. Таким образом, минимальный вопрос — это один из этих элементов и answer с ответом.

Пример

name: Примерная игра
difficulty: 1
date: 12.31.2022
authors:
  - Илья Зверев
restriction: 18+

round1:
  name: Города
  prices: [100, 200]
  themes:
    - name: Столицы
      questions:
        - text: Столица Эстонии
          answer: Таллинн
          answer2: Таллин
        - scenario:
            - text: Где находится этот собор?
            - image: moscow-vasili-blazh.jpg
          answer: Москва
    - name: Вторые
      questions:
        - text: Где находится Медный всадник?
          answer: Петербург
          answer2: Санкт-Петербург
        - type: bagcat
          theme: Белый дом
          cost: [200, 500, 100]
          knows: before
          text: Самый известный Белый дом находится в этом городе.
          answer: Вашингтон

round2:
  name: Страны
  final: true
  themes:
    - name: Размер
      questions:
        - text: Эта страна самая большая в Европе
          answer: Украина
    - name: Штаты
      questions:
        - text: У этого государства когда-то было 15 республик
          answer: СССР

Сложно

Есть инструменты с нормальным интерфейсом:

SIQuester — официальный редактор. Требует Windows.
SIPacker — веб-редактор, ссылка есть в readme (заброшен).

Как играть?

В онлайне: SIGame Online. При создании игры выберите «из файла» и загрузите туда файл siq, созданный этим скриптом.

Author and License

Written by Ilya Zverev, published under ISC License.

Zverik / si_convert