Библиотека датапаков для управления игроками через кинематографические движения камеры с поддержкой сплайнов и эффектов сглаживания.
Скачать
Версия игры
26.2
26.3
Категория
Библиотеки
Последние файлы
Ссылка на сайт
modrinth.com
Скачиваний:
0
Обновлено:
16.11.2026
ID:
Cinemalya предоставляет инструменты для создания плавных кинематографических сцен, позволяя перемещать игроков по заданным траекториям с использованием сплайнов и эффектов сглаживания.
⚠️ Важно: Cinemalya является библиотекой и требует наличия установленных датапаков LanternLoad и Bookshelf Spline для корректной работы.
Cinemalya — это библиотека датапаков для создания плавных кинематографических сцен в Minecraft. Она позволяет перемещать игроков по сложным траекториям с использованием сплайнов, эффектов сглаживания и шлейфов частиц, обеспечивая высокую точность поворотов камеры.
Библиотека предоставляет набор функций для управления камерой и игроками в различных сценариях:
| Действие | Вызов | Описание |
|---|---|---|
| Перелет к координатам | [launch] | Перемещение игрока в указанную точку. |
| Запуск из командного блока | [launch_here] | Использование относительных координат (~ и ^). |
| Перелет к сущности | [launch_at_entity] | Движение к позиции конкретной сущности. |
| Перелет по точкам | [launch_path] | Движение через несколько контрольных точек. |
| Интро с титром | [intro] | Остановка на кадре с названием сцены. |
| Остановка | [stop] | Завершение сцены. |
| Сигналы | [signals] | События при старте или завершении. |
| Настройки | [options] | Тонкая настройка параметров. |
execute as <player> run function #cinemalya:v1/launch {with:{x:19.5,y:82.5,z:23.5,duration:60,arc_side:1}}
Параметры x, y и z определяют финальную точку, где игрок окажется в конце движения. Важно учитывать, что эти координаты указывают на место стоянки игрока, а не на точку остановки камеры.
Эта функция предназначена для работы с относительными координатами. Поскольку NBT-данные не могут хранить символы тильды (~), данная точка входа позволяет задавать направление через позиционирование командного блока.
execute positioned ~12 ~8 ~-4 rotated 90 20 as @a[distance=..30] run function #cinemalya:v1/launch_here {with:{duration:60,arc_side:1}}
Обратите внимание на порядок команд: positioned разрешается относительно командного блока до того, как as меняет исполнителя. Таким образом, точка назначения фиксируется, в то время как каждый игрок начинает движение от своих ног.
execute as <player> run function #cinemalya:v1/launch_at_entity {with:{target:"@e[tag=camera_anchor,limit=1]",duration:60,ease:"ease_in_out"}}
Функция позволяет перемещать игрока через последовательность явных контрольных точек. В этом режиме координаты точек являются позициями камеры и используются буквально.
execute as <player> run function #cinemalya:v1/launch_path {with:{duration:90,ease:"ease_in_out",waypoints:[{args:[-112,75,-21,-30,4]},{args:[-116,77,28,-121,16]},{args:[-72,68,20,92,-11.7]}]}}
Первый элемент списка waypoints[0] — это начальная точка. Если указана только одна точка, путь начинается из текущего положения игрока. Контрольную точку можно описать тремя способами:
| Ключ | Пример | Описание |
|---|---|---|
| args | {args:[x,y,z,yaw,pitch,duration]} | Плоские данные. Целые числа допустимы. |
| pos / rot | {pos:[0.5,90.0,0.5],rot:[0.0,20.0]} | Явное описание позиции и поворота. |
| at | {at:"~30 ~12 ~-30",rot:[135,20]} | Относительно места выполнения команды (~ или ^). |
Если отсутствует rot, сохраняется предыдущий поворот; если отсутствует duration, он распределяется поровну между сегментами. Параметр at имеет приоритет над pos. При использовании локальных координат ^ необходимо добавить rotated при запуске из командного блока.
Сглаживание на уровне пути формирует движение всего маршрута: ускорение от первой точки, равномерное движение в середине и замедление к последней. Сглаживание на уровне конкретной точки влияет только на переход к ней.
execute as <player> run function #cinemalya:v1/launch_path {with:{waypoints:[{args:[-112,75,-21,-30,4]},{args:[-116,77,28,-121,16,55],ease:"ease_out"},{args:[-72,68,20,92,-11.7,25],ease:"ease_in"}]}}
Используется для создания сцены с названием: камера замирает на кадре, отображается название сцены, игроки телепортируются на свои места и начинают движение.
execute positioned 36.29 102.97 81.36 rotated 145.55 21.76 run function #cinemalya:v1/intro {with:{title:"Warden Forest",subtitle:"by Stoupy",display_time:130,duration:50}}
Параметр target_function выполняется для каждого игрока и служит для телепортации их на свои места; если он не указан, игроки остаются на месте. Также поддерживаются параметры selector, sound, title_color, subtitle_color и все поля из стандартного launch.
execute as <player> run function #cinemalya:v1/stop {with:{}}
Игрок остается в той точке, где находилась камера, поэтому вы сами определяете его финальное положение. Параметр restore:false оставляет игрока в режиме наблюдателя.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| duration | int | 60 | Длительность пути в тиках. |
| smoothing | int | 2 | Тики между кадрами. Выше — плавнее и дешевле для сервера. |
| delay | int | 0 | Тики ожидания перед началом движения. |
| ease | string | linear | linear, ease_in, ease_out, ease_in_out |
| spline | string | auto | bezier (для 2 точек) или catmull_rom (для большего количества) |
| arc_side | float | 0.0 | Боковой размах дуги (доля от половины расстояния). |
| arc_height | float | 20.0 | Высота пика дуги выше конечной точки. |
| particle | string | none | Частицы, оставляемые за камерой. |
| gamemode | string | restore | restore (восстановить), keep (оставить в спектаторе), none |
| tags | list | [] | Дополнительные теги для кинематографической сущности. |
| precise_rotation | bool | true | Использование высокой точности поворота. |
| yaw / pitch | float | цель | Переопределение конечного поворота. |
Для каждой точки входа параметры подставляются в соответствующий блок: launch принимает x/y/z, launch_at_entity — target, launch_path — waypoints, а launch_here не принимает ни того, ни другого. Параметры yaw/pitch не применяются к launch_path, так как каждый вейпоинт имеет свои собственные данные поворота.
Вы можете добавить собственные функции к следующим тегам. Оба сигнала выполняются от лица и в позиции игрока:
- #cinemalya:v1/signals/on_launch — непосредственно перед тем, как камера начнет движение. Используется для отмены таймеров паркура, боевых тегов или любых других эффектов, которые должны прерваться при телепортации.
- #cinemalya:v1/signals/on_finish — срабатывает после того, как игрок будет установлен на место и его режим игры будет восстановлен.
Чтение состояния: тег #entities cinemalya.data подсчитывает количество одновременно проигрываемых кинематографиков. Это позволяет ограничивать запуск новых сцен:
execute if score #entities cinemalya.data matches 1.. run return 1.
Точность поворота: Minecraft квантует повороты до шага 1.40625°, что может вызывать видимые «ступенчатые» движения при использовании /spectate. Cinemalya решает эту проблему, переключая флаг OnGround у сущности каждый тик, что заставляет сервер отправлять данные с полной точностью. Это работает по умолчанию, но можно отключить через precise_rotation:false.
Принцип работы: кинематографик представляет собой невидимую сущность item_display, которую просматривает игрок. Путь вычисляется один раз в момент запуска: Bookshelf берет контрольные точки сплайна и формирует плотную полилинию. Каждый сегмент получает ровно столько кадров, сколько позволяет его длительность. Во время воспроизведения сервер просто отправляет данные кадра за кадром, что делает стоимость воспроизведения минимальной независимо от длины пути.
Ограничения: все аргументы, участвующие в циклах, ограничиваются (clamped) при запуске. Это гарантирует, что опечатка в параметрах приведет к некорректному визуальному эффекту, а не к зависанию сервера. Например, duration ограничен 36000 тиками (30 минут), а количество вейпоинтов — 128.
Войдите, чтобы поставить оценку и оставить отзыв.
| Канал | Файл | Игра | Модлоадер | Язык | Скачиваний | Загружен | |
|---|---|---|---|---|---|---|---|
| Релиз | Cinemalya_datapack_with_libs.zip 163 KB | 26.3 | — | — | 0 | 06.10.2026 | |
| Релиз | Cinemalya_datapack_with_libs.zip 163.2 KB | 26.2 | — | — | 0 | 12.09.2026 |
Скачать
Версия игры
26.2
26.3
Категория
Библиотеки
Последние файлы
Ссылка на сайт
modrinth.com
Скачиваний:
0
Обновлено:
16.11.2026
ID: