skript-particle

Skript-particle - это аддон для Skript, который позволяет создавать сложные эффекты частиц с минимальными усилиями. Если ты когда-нибудь пытался сделать красивые партиклы на сервере, то знаешь, что стандартные синтаксисы вроде SkBee есть, но для создания сложных фигур нужно много кода и знаний. Этот аддон решает именно эту проблему.

Требования: Skript 2.7+, Java 17+, Paper 1.18 - 1.20.4

Скачать можно на странице релизов.

Зачем это нужно?

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

Как это работает?

Основная идея простая: ты создаешь набор форм (круги, линии, многоугольники и т.д.) относительно центральной точки, а потом рисуешь их в конкретном месте с нужным поворотом. Формы можно вращать как группу одной строкой кода.

Вот пример кода:

command /magic:
    trigger:
        set {_shapes::outer-circle} to a circle of radius 2.225
        set {_shapes::inner-circle} to a circle of radius 2
        set {_shapes::tiny-circle} to a circle of radius 0.875

        set {_shapes::triangle-1} to a triangle with radius 2
        set {_shapes::triangle-2} to a triangle with radius 2
        rotate shapes {_shapes::triangle-2} around y axis by 60 degrees

        set particle of {_shapes::*} to electric spark

        loop 200 times:
            set {_view} to vector from yaw player's yaw and pitch player's pitch
            set {_yaw} to yaw of {_view}
            # figure out the rotation needed to rotate the shape 
            set {_rotation} to rotation from vector(0, 1, 0) to {_view}
            draw the shape {_shapes::*} at player's eye location ~ {_view}:
                # only happens for this draw call, the original shape is not modified
                # note that this is called once for each shape, hence `drawn shape` and not `drawn shapes`
                rotate drawn shape by {_rotation}
                # the shape takes the shortest path to rotate to the desired rotation, but that causes it to appear to rotate as we turn.
                # so we'll correct for it by rotating the shape around the y axis by the yaw of the player
                rotate drawn shape around relative y axis by -1 * {_yaw}

            wait 1 tick 

Что уже есть?

Формы:

• Кривые Безье
• Круги, эллипсы, сферы и эллипсоиды
• Цилиндры и эллиптические цилиндры
• Дуги и сферические сегменты
• Спирали (геликсы)
• Линии
• 2D правильные и неправильные многоугольники и призмы
• Правильные многогранники (полиэдры)
• Прямоугольники и кубоиды

Отрисовка:

• Три стиля: контур, поверхность и заливка. Некоторые формы поддерживают только один или два стиля.
• Поворот в любую ориентацию.
• Масштабирование и смещение.
• Отрисовка нескольких форм за раз.
• Настройка видимости частиц (для конкретного игрока).
• Кастомные данные частиц и плотность для каждой формы.
  • Полная поддержка синтаксиса данных частиц из SkBee.
• Отладочные оси для наглядной визуализации ориентации формы.
• Формы вычисляются только при изменении, так что можно рисовать одну и ту же форму много раз без потери производительности.
• Опция синхронного расчета и отрисовки (по умолчанию асинхронно).
  • Возможность непрерывной отрисовки формы в течение времени (только асинхронно).
• Динамические позиции - частицы могут следовать за сущностью без дополнительных усилий.

Частицы:

• Выражение для кастомных частиц.
• Секция для кастомных частиц.

Анимация:

• Возможность растянуть отрисовку формы во времени.

Что планируется?

Формы:

• Кастомные формы, задаваемые функцией.
• "Сложные в кодинге" формы вроде сердечек, звезд и т.д.

Отрисовка:

• Объединение форм в кастомную форму для отрисовки как единой.
• Градиентные цветовые поля с кастомными цветовыми узлами.

Анимация:

• Настройка готовой анимации в кастомной структуре, воспроизведение одним вызовом отрисовки.

Важно знать

Если ты собираешь сервер с магическими эффектами или просто хочешь добавить красивые визуалы - этот аддон must-have. На слабом железе лучше использовать асинхронную отрисовку по умолчанию, чтобы не лагало. Главное - проверь совместимость с другими аддонами на частицы, особенно если используешь SkBee.

Синтаксис доступен на skUnity и SkriptHub.