Skip to content

Latest commit

 

History

History
76 lines (51 loc) · 6.09 KB

siaiz.md

File metadata and controls

76 lines (51 loc) · 6.09 KB
Raw

Краткая инструкция по установке QSP-Package для Sublimetext с нуля

Данная инструкция расчитана на пользователей Windows 10, у которых не установлен редактор SublimeText.

Для написания и запуска игр из SublimeText вам понадобится:

  1. Установленный плеер QSP;
  2. Установленный SublimeText;
  3. А так же последний релиз QSP-Package.

Внимательно прочитайте нижеследующую инструкцию, даже если какой-то из компонентов у вас уже установлен.

Этап 1. Установка плеера QSP

  1. Обязательно скачайте классический плеер QSP версии 5.8.0 и разместите его в папке "C:\Program Files\QSP\qsp580". Делается это так:
    • Скачайте zip-архив с плеером;
    • Откройте папку "C:\Program Files";
    • В ней создайте папку "QSP" и откройте;
    • В ней создайте и откройте папку "qsp580";
    • Откройте ранее скачаный zip-архив и все файлы из него скопируйте (можно просто перетащить) в папку "qsp580".
    • Таким образом путь до "qspgui.exe" должен выглядеть так: "C:\Program Files\QSP\qsp580\qspgui.exe". Запишите этот путь.
  2. Можете так же скачать любой другой нужный вам плеер и установить в систему.

Этап 2. Установка SublimeText

  1. Зайдите на sublimetext.com и скачайте последнюю версию SublimeText.
  2. Запустите установщик и следуйте инструкциям до завершения установки.

Этап 3. Установка пакета QSP в SublimeText

  1. Скачайте установочный файл из последнего релиза. Файл будет называться "install.QSP.sublime-package.XX.exe", где XX — номер версии.
  2. Запустите "install.QSP.sublime-package.XX.exe" и следуйте инструкциям. Пакет автоматически установится в SublimeText.
  3. Перезагрузите Sublime Text, если он был запущен.

Этап 4. Первая игра в SublimeText

  1. Откройте SublimeText.
  2. Зайдите в главное меню в пункты "Tools" → "QSP Tools" → "Make New Game".
  3. Напишите следующий код:
QSP-Game Testgame
# start
*pl "Hello world!"
- start
  1. Сохраните файл с расширением ".qsps". Например, как "test.qsps".
  2. Нажмите на клавиатуре одновременно клавиши "Ctrl + F5".
  3. Игра автоматически сконвертируется и запустится в плеере:
    Запуск тестовой игры.

Если вы установили плеер не по пути, указанном на этапе 1, игра соберётся, но не будет запущена.

Если игра нормально запустилась, рядом с файлом qsps вы найдёте два новых файла: "project.json" и "test.qsp". У последнего файла может быть другое имя, если вы ваш тестовый файл назвали иначе.

Файл "project.json" можно видоизменять. Именно такие файлы нужны, чтобы управлять сборкой игры из SublimeText.

Вы можете сразу создать готовый проект QSP в стандартизированном виде, если воспользуетесь меню "Tools" → "QSP Tools" → "Make Quick Project".

Этап 5. Перевод проекта из Quest Generator в SublimeText

На этом этапе вы можете конвертировать все ваши QSP-файлы в файлы формата qsps.

  1. Обязательно сохраните резервную копию вашей игры формата QSP перед дальнейшими манипуляциями.
  2. Откройте любой файл из папки с вашей игрой в Sublime Text. Это может быть как QSP-файл, так и обычный текстовый файл, или файл "project.json" или даже ".qproj".
  3. В главном меню Sublime Text выберите Tools
  4. В меню Tools найдите и запустите Сплиттер Проекта: QSP tools → Splitters → Split Project.

Рядом с вашей QSP-игрой будет создана одноимённая папка, в которой появятся разбитые на отдельные qsps-файлы все локации вашей игры.

Если в папке был не один QSP-файл, то на каждый из таких файлов будет создано по своей папке с локациями.

Остаётся только разместить "project.json" в папке с игрой и прописать в нём параметры сборки: из каких папок подтягивать локации, в какой файл собирать готовую QSP-игру.

Другая информация

Подробнее о настройке "project.json" можно прочитать в полной инструкции: README.md