English language

(Ниже есть русский язык)

CutScenePacket

Developer: meowhiks
Version: 0.0.73

---

CREATES AND PLAYS CUTSCENES WITH CAMERA MOVEMENT

Description EN

CutScenePacket is a plugin for Paper/Spigot 1.21+ that allows you to create and play cutscenes with smooth camera movement. Players are guided through predefined points with customizable speed and easing. Scenes can be triggered manually or automatically via triggers (zone entry, right-click). Trigger logic can be described in a custom scripting language in scripts/packet.csp.

Features: create scenes with camera points, smooth camera movement with Catmull-Rom splines, customizable easing types (linear, smooth, ease_in, ease_out, ease_in_out, hold), visual markers for editing, automatic chunk preloading, path visualization with particles, scene persistence in separate YAML files, trigger system with conditions, custom CSP scripting language. Everything configurable via commands and YAML files.

---

How to Use

Command /csp or /cutscenepacket opens the main menu.

Basic workflow:

1. Create a scene: /csp addscene <id>
2. Select scene for editing: /csp switchscene <id>
3. Add camera points: /csp addpoint (minimum 2 points required)
4. Play scene: /csp playscene <id>

Player will switch to spectator mode and smoothly fly through the points; after completion returns to original position and gamemode.

Commands:

• /csp addscene <id> — create scene
• /csp switchscene <id> — select scene for editing
• /csp addpoint — add camera point at current position
• /csp setpoint <index> <parameter> [value] — configure point (duration, fov, yaw, pitch, x, y, z, ease)
• /csp removepoint <index> — remove point
• /csp clearpoints [id] — clear all points in scene
• /csp record start|stop — record mode (adds points every 0.5 seconds)
• /csp scenesetting speed <ticks> — default speed between points
• /csp scenesetting markers on|off — toggle visual markers
• /csp scenesetting name <text> — set display name
• /csp visual [on|off] — toggle markers for current scene
• /csp showpath [on|off] — show path with white DUST particles
• /csp playscene <id> [all] — play scene (all = for all players)
• /csp stopscene — stop current cutscene
• /csp smooth <id> — smooth flight (add intermediate points)
• /csp listscenes — list all scenes
• /csp deletescene <id> — delete scene
• /csp reload — reload configuration (scenes, triggers, scripts)
• /csp reloadcsp — reload packet.csp script
• /csp trigger — trigger management (add, remove, list, target, condition)

---

Configuration

Scenes are stored in plugins/CutScenePacket/scenes/*.yml — each scene in a separate file. Triggers are stored in triggers.yml. Scripts are in scripts/packet.csp.

Easing types (default: linear):

• linear — linear movement
• smooth — smoothstep interpolation
• ease_in — acceleration at start
• ease_out — deceleration at end
• ease_in_out — smooth acceleration and deceleration
• hold — camera stays in place until segment end, then instantly moves to next point

Scene settings:

• displayName — display name
• defaultSpeedTicks — default duration between points (20 ticks = 1 second)
• showMarkers — show visual markers when editing

Point settings:

• Position: x, y, z
• Angles: yaw, pitch
• durationTicks — duration to reach this point (-1 = use scene default)
• fov — field of view (-1 = don't change)
• easeType — easing type for this segment

---

Features

• Camera movement: Smooth Catmull-Rom spline interpolation for positions, linear interpolation for angles
• Visual markers: Armor stands show point positions when editing
• Path visualization: White DUST particles show the path (optional)
• Chunk preloading: Automatically preloads chunks in scene radius via NMS
• Armor stand hiding: Camera armor stand is hidden from player via NMS (only server syncs)
• Player position: Player is positioned 1.8 blocks above armor stand (proper player height)
• Scene persistence: Each scene saved in separate YAML file (/scenes/*.yml)
• Trigger system: YAML-based triggers with conditions (item in hand/inventory, zone entry, right-click)
• CSP scripting: Custom scripting language for complex trigger logic
• Player quit handling: Player returns to original position and gamemode on quit
• Reload command: /csp reload reloads all configuration without server restart

---

Permissions

No permissions required by default (all players can use commands). Add permission checks if needed via other plugins.

---

Dependencies

Paper 1.21+ or Spigot.

---

Русский язык

CutScenePacket

Разработчик: meowhiks
Версия: 0.0.73

---

Описание RU

CutScenePacket — плагин для Paper/Spigot 1.21+, который позволяет создавать и воспроизводить катсцены с плавным движением камеры. Игроки проводятся по заданным точкам с настраиваемой скоростью и сглаживанием. Сцены можно запускать вручную или автоматически через триггеры (вход в зону, ПКМ). Логику триггеров можно описывать на кастомном скриптовом языке в scripts/packet.csp.

Возможности: создание сцен с точками камеры, плавное движение камеры по сплайнам Catmull-Rom, настраиваемые типы сглаживания (linear, smooth, ease_in, ease_out, ease_in_out, hold), визуальные маркеры для редактирования, автоматическая предзагрузка чанков, визуализация дороги через партиклы, сохранение сцен в отдельных YAML файлах, система триггеров с условиями, кастомный скриптовый язык CSP. Всё настраивается через команды и YAML файлы.

---

Как использовать

Команда /csp или /cutscenepacket открывает главное меню.

Базовый рабочий процесс:

1. Создайте сцену: /csp addscene <id>
2. Выберите сцену для редактирования: /csp switchscene <id>
3. Добавьте точки камеры: /csp addpoint (нужно минимум 2 точки)
4. Воспроизведите сцену: /csp playscene <id>

Игрок перейдёт в режим наблюдателя и плавно пролетит по точкам; по окончании вернётся в исходную позицию и режим.

Команды:

• /csp addscene <id> — создать сцену
• /csp switchscene <id> — выбрать сцену для редактирования
• /csp addpoint — добавить точку камеры в текущей позиции
• /csp setpoint <индекс> <параметр> [значение] — настроить точку (duration, fov, yaw, pitch, x, y, z, ease)
• /csp removepoint <индекс> — удалить точку
• /csp clearpoints [id] — очистить все точки сцены
• /csp record start|stop — режим записи (добавляет точки каждые 0.5 секунды)
• /csp scenesetting speed <тиков> — скорость по умолчанию между точками
• /csp scenesetting markers on|off — вкл/выкл визуальные маркеры
• /csp scenesetting name <текст> — установить отображаемое имя
• /csp visual [on|off] — вкл/выкл маркеры для текущей сцены
• /csp showpath [on|off] — показать дорогу белыми партиклами DUST
• /csp playscene <id> [all] — воспроизвести сцену (all = для всех игроков)
• /csp stopscene — остановить текущую катсцену
• /csp smooth <id> — сгладить полёт (добавить промежуточные точки)
• /csp listscenes — список всех сцен
• /csp deletescene <id> — удалить сцену
• /csp reload — перезагрузить конфигурацию (сцены, триггеры, скрипты)
• /csp reloadcsp — перезагрузить скрипт packet.csp
• /csp trigger — управление триггерами (add, remove, list, target, condition)

---

Конфигурация

Сцены хранятся в plugins/CutScenePacket/scenes/*.yml — каждая сцена в отдельном файле. Триггеры хранятся в triggers.yml. Скрипты в scripts/packet.csp.

Типы сглаживания (по умолчанию: linear):

• linear — линейное движение
• smooth — smoothstep интерполяция
• ease_in — ускорение в начале
• ease_out — замедление в конце
• ease_in_out — плавное ускорение и замедление
• hold — камера стоит на месте до конца сегмента, затем мгновенно переходит в следующую точку

Настройки сцены:

• displayName — отображаемое имя
• defaultSpeedTicks — длительность перехода между точками по умолчанию (20 тиков = 1 секунда)
• showMarkers — показывать визуальные маркеры при редактировании

Настройки точки:

• Позиция: x, y, z
• Углы: yaw, pitch
• durationTicks — длительность до достижения этой точки (-1 = использовать значение по умолчанию сцены)
• fov — поле зрения (-1 = не менять)
• easeType — тип сглаживания для этого сегмента

---

Возможности

• Движение камеры: Плавная интерполяция по сплайнам Catmull-Rom для позиций, линейная интерполяция для углов
• Визуальные маркеры: Арморстенды показывают позиции точек при редактировании
• Визуализация дороги: Белые партиклы DUST показывают путь (опционально)
• Предзагрузка чанков: Автоматически предзагружает чанки в радиусе сцены через NMS
• Скрытие арморстенда: Арморстенд камеры скрыт от игрока через NMS (только сервер синхронизируется)
• Позиция игрока: Игрок находится на 1.8 блока выше арморстенда (правильная высота игрока)
• Сохранение сцен: Каждая сцена сохраняется в отдельном YAML файле (/scenes/*.yml)
• Система триггеров: Триггеры на основе YAML с условиями (предмет в руке/инвентаре, вход в зону, ПКМ)
• Скриптовый язык CSP: Кастомный скриптовый язык для сложной логики триггеров
• Обработка выхода игрока: Игрок возвращается в исходную позицию и режим при выходе
• Команда перезагрузки: /csp reload перезагружает всю конфигурацию без перезапуска сервера

---

Разрешения

По умолчанию разрешения не требуются (все игроки могут использовать команды). Добавьте проверки разрешений при необходимости через другие плагины.

---

Зависимости

Paper 1.21+ или Spigot.

---

Автор: @meowhiks · Канал (ТГК): Morereworks