Cutscene API

Cutscene API — это модификация, которая открывает перед создателями карт и модов возможность создавать кинематографические сцены с плавным движением камеры и разнообразными визуальными эффектами, воспроизводящимися непосредственно в игре в реальном времени.

Основные возможности

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

• Продолжительность в игровых тиках
• Траектория движения камеры
• Список разрешённых действий для игрока во время просмотра
• Плавные переходы в начале и конце
• Специальные эффекты для усиления визуального воздействия

Все эти элементы являются опциональными, но их грамотная комбинация позволяет создавать по-настоящему впечатляющие сцены.

Траектория камеры

Камера игрока может следовать по заранее определённому маршруту, состоящему из сегментов различных типов: прямые линии, кривые Безье, сплайны Кэтмулла-Рома, статичные точки или специальные точки с координатами, заданными математическими функциями. Аналогичным образом настраивается и вращение камеры, включая специальный режим слежения за определённой точкой.

Плавные переходы

Для более естественного погружения в катсцену предусмотрены различные типы переходов. Доступны плавное замедление при входе/выходе из сцены, а также затемнение экрана до любого цвета с возможностью динамического изменения оттенка.

Ограничения действий

Во время воспроизведения катсцены вы можете ограничить возможности игрока: запретить движение, поворот головы, разрушение блоков, использование предметов, получение урона или перевести в режим наблюдателя для защиты от враждебных мобов.

Визуальные эффекты

Помимо движения камеры, система поддерживает различные визуальные элементы: постепенно появляющийся текст, рисование простой геометрии с помощью треугольников, отображение прямоугольников и наложение текстур в указанных позициях.

Команды

/cutscene start <игрок> <тип> [at_preview | позиция] [начальный_поворот_камеры] [поворот_пути] — запускает катсцену для указанного игрока с заданными параметрами позиционирования и вращения

/cutscene stop [игрок] — останавливает воспроизведение катсцены

/cutscene preview set <тип> [начальная_позиция] [поворот_пути] — активирует режим предпросмотра траектории камеры

/cutscene preview hide — скрывает предпросмотр

Примеры использования

В исходном репозитории мода находится папка "Example Cutscenes" — это датапак с набором тестовых сцен, которые демонстрируют все возможности модификации. Хотя некоторые из них могут показаться необычными, они отлично справляются с задачей обучения.

Совместимость

Мод разработан с учётом максимальной совместимости с другими модификациями и не должен вызывать конфликтов. Большинство выпускаемых версий сохраняют обратную совместимость, особенно в отношении форматов данных.