skript-particle - Skript粒子特效插件

💡Skript-Particle

Skript-Particle 是一个 Skript 插件扩展，旨在以最简化的方式创建复杂的粒子效果。它提供了一套强大且易于使用的语法，让你能够轻松定义和绘制各种粒子形状，并支持旋转、缩放等动态效果。

🎮基本信息

• 插件名称: skript-particle
• 功能: 为 Skript 提供创建复杂粒子效果的语法。
• 核心要求:
• Skript 2.10 或更高版本
• Java 17
• Paper 1.19.4 或更高版本
• 下载地址: releases page
• 帮助与反馈:
• 在 GitHub 的 Issues 页面 寻求帮助、提出建议或反馈问题。
• 加入 skript-chat Discord 进行讨论。

❓插件理念

现有的粒子插件（如 SkBee）虽然功能强大，但创建复杂形状往往需要大量代码和专业知识，且性能开销较大。Skript-Particle 的目标是提供一套灵活、强大且易于使用的语法来创建粒子形状。

其基本结构是：首先定义一系列独立于位置的基础形状（如圆形、线条、多边形等），这些形状相对于一个中心点。然后，通过绘图语法，可以将这组形状绘制到任意位置，并进行整体旋转。这意味着形状只需定义一次，便可在多处重复使用和旋转，极大地提升了效率和性能。

🔧语法与示例

完整的语法可在 skUnity 或 SkriptHub 上查询。

以下是一个简单的示例代码，展示了如何定义多个形状并让它们跟随玩家视角旋转：

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}
            # 计算旋转到视角方向所需的旋转量
            set {_rotation} to rotation from vector(0, 1, 0) to {_view}

            draw the shapes {_shapes::*} at player's eye location ~ {_view}:
                # 此处的旋转仅针对本次绘制，不会修改原始形状定义
                rotate shape drawn shape by {_rotation}
                # 修正因最短路径旋转导致的视觉偏差
                rotate shape drawn shape around relative y axis by -1 * {_yaw}
            wait 1 tick

✨当前功能特性

支持的形状

• 圆形、椭圆形、球体、椭球体
• 圆柱体、椭圆柱体
• 圆弧、球冠
• 螺旋线
• 线条
• 2D 规则/不规则多边形及棱柱
• 规则多面体
• 矩形和立方体

绘图功能

• 三种绘制样式: 轮廓、表面和填充（部分形状可能只支持其中一或两种）。
• 旋转: 可将形状旋转至任意方向。
• 变换: 支持缩放和偏移。
• 批量绘制: 可一次性绘制多个形状。
• 观众控制: 可指定哪些玩家能看到粒子。
• 粒子数据: 支持为每个形状自定义粒子类型和密度，完全兼容 SkBee 的粒子数据语法。
• 调试轴: 可显示坐标轴，便于可视化形状的方向。
• 性能优化: 形状仅在定义改变时重新计算，重复绘制无性能损耗。
• 同步/异步: 可选择所有计算和绘制为同步进行（默认为异步）。
• 持续绘制: 可在指定时间段内持续绘制一个形状（仅限异步模式）。
• 动态位置: 粒子可自动跟随实体移动，无需额外代码。

粒子控制

• 表达式和代码段支持自定义粒子。
• 支持为粒子设置自定义运动（向量、向内/向外、[逆]时针方向）。

⭐计划开发的功能

新形状

• 贝塞尔曲线
• 通过函数或结构定义的自定义形状
• 其他“常见但编码困难”的形状

绘图增强

• 将多个形状组合成一个自定义形状，以便作为单一形状绘制。
• 渐变颜色场，支持自定义颜色节点。

动画

• 将形状的绘制过程拉伸到一段时间内完成（形成动画）。
• 支持在自定义结构中设置预制的动画序列，并通过一次绘制调用进行播放。