v1.3.1 - 1.20.6 compatability

Supported versions: 1.18 - 1.20.6

Changelog

• Fixed 1.20.6 compatibility.

Syntax

Syntax is available on SkUnity and SkriptHub!

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.3.0 - Animation Ordering and Bezier Curves

Supported versions: 1.18 - 1.20.4. 1.20.5/6 have not been tested yet.

Changelog

• Added Bezier curves.

[a] [bezier] curve from [start] %vector/entity/location% to [end] %vector/entity/location% (with|using) control point[s] %vectors/entities/locations%

• Added basic ordering for animations. More orderings coming later.

set the animation order of %shapes% to (default|lowest-to-highest|highest-to-lowest)

• Some updates to error handling to avoid console spam if you mess up.
• Fixed a few little bugs with nullability.

Syntax

Syntax is available on SkUnity and SkriptHub!

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.2.0 - Animations and Bug Fixes

Changelog

• Allowed omitting the first shape in rotate shape drawn shape...
• Added some basic animation for shapes. Draws a shape over a time period in the order its points are calculated. Future updates will likely add more options for animation order.

draw [an] (animation [of] [the]|animated) shape[s] [of] %shapes% [%-directions% %-locations/entities%] [to %-players%] over %timespan%

• Fixed issue where the particle density setter was the inverse of what it should have been. this is a breaking change!
• Some behind-the-scenes particle utilities updates, thanks shane.
• Allowed more lee-way in particle motion names.
• Fixed a few little bugs with nullability.
• Copying shapes now requires the "shape" keywords to prevent collisions. this is a breaking change!

[a] shape cop(y|ies) of %shapes%

Syntax

Syntax is available on SkUnity and SkriptHub!

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.1.1 - Small Improvements

Only minor changes this time. Support for icospheres and custom shapes (shapes made of other shapes and/or individual points) will be coming in 1.2.0.

Changelog

• Fixed NPEs when using debug verbosity
• Added lang entries for various types
• Fixed a conflict between SkBee's draw effect and draw shapes
• Made SecParticle much safer and better at erroring (thanks @ShaneBeee)

⚠️ Breaking Changes: ⚠️

My apologies for this change, but it was the only way to resolve a collision issue between the draw particle and draw shape effects when using variables.
The draw shape effect section now requires the use of the keyword shape to avoid conflicts:

[sync[hronously]] draw [the] shape[s] [of] %shapes% [%-directions% %-locations/entities%] [to %-players%]",
draw [the] shape[s] [of] %shapes% [%-directions% %-locations/entities%] [to %-players%] for [duration] %timespan% [with (delay|refresh [rate]) [of] %-timespan%]"

Syntax

Syntax is available on SkUnity and SkriptHub!

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

1.1.0 - Full Release

Changelog

No changes this time, but 2.7 is out so this addon can come out of beta!

Syntax is available on SkUnity and SkriptHub!

A Reminder on What Skript-Particle Is

Have you ever wanted to draw shapes in Minecraft? Using particles? With Skript? Well, now you have an alternative to learning a bunch of silly vector math or trying to get SkDragon to work on modern versions. Skript-Particle allows you to easily draw a number of different shapes using particles with no (well only a little) math knowledge necessary!

Attached is a script with a command that will run through a set of manipulations on all the current shapes, to help you get used to the syntax and how it works. It also contains the same command that can be found on the home page of this github, to draw a magic circle thingy in front of your face. I hope these are helpful for understanding!

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.0.2 - Third Beta Release

Changelog

Finally implemented particle motion:
When creating a custom particle, you can specify a velocity, which is normally a vector. Particle motions allow more complex velocities:

inwards motion
outwards motion
clockwise motion
counterclockwise motion
no motion

These motions are relative to the shape they are a part of. Inwards and Outwards are relative to the center point (so offsets will affect their motion). The two rotation motions are relative to the normal (relative y) axis of the shape.

More syntaxes related to particle motion will be coming in the future

• Fixed a casting error with the custom particle expression when using the block particle.
• Fixed issue with orientations not working with the axisAngle function

Disclaimer

As of right now, skript-particle is in BETA. This means there will be issues. Things will break. I will likely be making many small releases as bugs pop up and I fix them. Please do not use this version on production servers. I've tested it a lot, but I certainly haven't tested everything.

If you are interested in using it, the syntax is currently available on the wiki of this github. I will be adding it to SkUnity and SkriptHub once the addon leaves beta, (v1.1.0). Note that skript-particle requires Skript 2.7 (of which there is only betas released), Java 17, and Paper 1.17.1+. I intend to maintain support for all Java 17 versions, but I will only guarantee support for the latest 3 versions. Currently, that means 1.17.1, 1.18.2, and 1.19.x. (I know 1.20's out, I'm a bit behind. It should work on 1.20 though.)

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.0.1 - Second Beta Release

Changelog

• Added syntax to draw multiple lines at once, as well as draw a line along a path of points.

[a] line[s] (from|between) %locations/entities/vectors% (to|and) %locations/entities/vectors%
[a] line (between|connecting) %locations/entities/vectors%

• Added the heart shape (does not support particle count, non-uniform density despite my best efforts, and solid form is very rough. It looks like a heart though!)

[a] [solid] heart [shape] (with|of) width %number%[,] [and] length %number%[[,] [and] eccentricity %-number%]

• Added the star shape (solid form is rather rough)

[a] [solid] star with %number% points(,| and) inner radius %number%[,] and outer radius %number%

• Added star radius and star points expressions (Very unsure about keeping the radius ones, may end up merging with normal radius)

star points of %shapes%
%shapes%'[s] star points

(inner|outer) radius of %shapes%
%shapes%'[s] (inner|outer) radius

• Handled an uncaught exception when attempting to draw particles without enough data.
• Fixed a casting error with the helix winding rate expression

Disclaimer

As of right now, skript-particle is in BETA. This means there will be issues. Things will break. I will likely be making many small releases as bugs pop up and I fix them. Please do not use this version on production servers. I've tested it a lot, but I certainly haven't tested everything.

If you are interested in using it, the syntax is currently available on the wiki of this github. I will be adding it to SkUnity and SkriptHub once the addon leaves beta, (v1.1.0). Note that skript-particle requires Skript 2.7 (of which there is only betas released), Java 17, and Paper 1.17.1+. I intend to maintain support for all Java 17 versions, but I will only guarantee support for the latest 3 versions. Currently, that means 1.17.1, 1.18.2, and 1.19.x.

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.

v1.0.0 - First Beta Release

Hello everyone! Skript-Particle v1.0.0 is finally out and I'm ready for you all to tear it apart!

Quick overview of what skript-particle is:

Have you ever wanted to draw shapes in Minecraft? Using particles? With Skript? Well, now you have an alternative to learning a bunch of silly vector math or trying to get SkDragon to work on modern versions. Skript-Particle allows you to easily draw a number of different shapes using particles with no (well only a little) math knowledge necessary!

Attached is a script with a command that will run through a set of manipulations on all the current shapes, to help you get used to the syntax and how it works. It also contains the same command that can be found on the home page of this github, to draw a magic circle thingy in front of your face. I hope these are helpful for understanding!

Disclaimer

As of right now, skript-particle is in BETA. This means there will be issues. Things will break. I will likely be making many small releases as bugs pop up and I fix them. Please do not use this version on production servers. I've tested it a lot, but I certainly haven't tested everything.

If you are interested in using it, the syntax is currently available on the wiki of this github. I will be adding it to SkUnity and SkriptHub once the addon leaves beta, (v1.1.0). Note that skript-particle requires Skript 2.7 (of which there is only betas released), Java 17, and Paper 1.17.1+. I intend to maintain support for all Java 17 versions, but I will only guarantee support for the latest 3 versions. Currently, that means 1.17.1, 1.18.2, and 1.19.x.

PLEASE REPORT ALL BUGS, SUGGESTIONS, AND OTHER FEEDBACK IN THE ISSUES TAB!!

If you have questions, small suggestions, or just need help, check out the skript-particle channel in the skript-chat discord.