QQ: Server-side Scripting

Appearance

QQ: SSSserver-side scripting

Расширяйте механику квестов с помощью серверного JavaScript

Быстрый старт
Справочник API

Интеграция с переходами

Скрипты выполняются как действия в рамках переходов. Настраивайте гибкую логику, связывая события, условия и выполнение JavaScript-кода.

Управление состоянием

Сохраняйте прогресс с помощью командных (ctx.team) и глобальных (ctx.game) переменных. Выводите примитивные значения напрямую в игровой клиент.

Встроенный API движка

Управляйте игровым процессом напрямую из кода. Открывайте и закрывайте уровни, получайте доступ к введенным кодам и системной информации.

Структура документации ​

Документация разделена на логические блоки для последовательного изучения возможностей скриптового движка:

Руководство (Guide) ​

  • Введение — базовые принципы работы со скриптами, место скриптов в архитектуре движка.
  • Модель выполнения — как скрипты привязаны к переходам (событие ➔ условие ➔ действие), особенности многократного срабатывания триггеров (например, при событии «Старт» для нескольких команд).
  • Переменные и состояние — работа с контекстом ctx.team и ctx.game, правила сохранения данных в редакторе переменных, инициализация стейта и ограничения вывода сложных объектов в клиент.
  • Примеры использования — типовые сценарии: инициализация глобального конфига, обработка игровых предметов, сложная логика проверок.

Справочник (API Reference) ​

  • Системные переменные — доступ к контексту выполнения: teamId, code и другим параметрам, зависящим от события-триггера.
  • Функции движка — справочник доступных методов для управления игрой (например, LevelOpen, LevelClose).