v1.4.1

Supported versions: 1.21 - 26.1, Skript 2.14+
Likely the last 1.X version of skript particle, so this is built off the legacy-ev-fix branch rather than main.

Changelog

• Fixed compatibility with Skript 2.15 (small issue with event-value registration on my part)

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.4.0 - 2.14 compatability

Supported versions: 1.21 - 1.21.11, Skript 2.14+

Changelog

• Fixed compatibility with Skript 2.14
• Some major breaking syntax changes were made, as Skript now has competent particles support.
• the custom particle expression has been removed in favor of Skript's own particle system.
• the draw particle effect has likewise been removed.
• the custom particle section has had its data entry removed, as that should be taken care of via Skript's particle system:

a custom dust particle with:
  data: dustOptions(red, 1)
  velocity: inwards
vs
a custom red dust particle with:
  velocity: inwards

• skript-particle's custom particles should behave exactly like Skript's particle effects in Skript's syntaxes. (e.g. you can set scale/velocity/distribution like normal)
• skript-particle now only supports Java 21 versions (1.21+)

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.4 - 2.12 compatability

Supported versions: 1.19.4 - 1.21.7, Skript 2.10+

Changelog

• Fixed compatibility with Skript 2.12.2
• Some breaking syntax changes were required to avoid conflicts:
• (length|width|height) of %shape% -> shape (length|width|height) of %shape%
• scale of -> shape scale of
• locations of -> (particle|point) locations of
• Added docs to ExprBezierCurve

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.3 - 2.10.2 compatibility

Supported versions: 1.19.4 - 1.21.4, Skript 2.10+

Changelog

• Fixed compatibility with Skript 2.10.2
• Fixed NPE with EffRotateShape in debug verbosity

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.2 - Bug Fixes and Skript 2.10 Compatability

Supported versions: 1.18 - 1.21.4, Skript 2.10+

Changelog

• Fixed compatibility with Skript 2.10
• Fixed a bug with points of %shape% returning true for isSingle()
• Fixed a bug where some line constructing patterns returned false for isSingle()

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.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.