Skript 2.9.2

Skript 2.9.2 is here with more bug fixes and a few minor additions and tweaks. As always, you can report any issues on our issue tracker.

Happy Skripting!

Changelog

Additions
- #6942 Added Dutch language support.
- #7008 Added support trial spawners in the spawner type syntax.

Tweaks
- #6984 Enhanced and expanded the BStats charts.
- #7023 Improved the performance of the 'book authors' expression.

Bug Fixes
- #5073 Fixed an issue where items did not work with the 'is of type' condition.
- #6936 Fixed an issue with unreliable parsing of quotes in command arguments.
- #6942 Fixed a mistake in the German language support.
- #6982 Fixed some cases of incorrect word pluralization.
- #6983 Fixed a faulty error message in the 'return' effect.
- #6988 Fixed input validation errors that could occur with the 'hover list' expression on newer versions.
- #6996 Fixed a concurrency issue with default variables.
- #7018 Fixed the localization of the 'horse jump strength' attribute.
- #7016/#7022 Fixed additional version support issues with the 'play sound' effect.
- #7025 Fixed an issue with the 'vehicle' expression that could prevent Skript from loading on newer versions.

Click here to view the full list of commits made since 2.9.1

Notices

Help Us Test
We have an official Discord community for beta testing Skript's new features and releases.

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.9.1

Skript 2.9.1 is here to resolve some of the most notable issues reported with 2.9.0. We will continue to assess stability and make fixes as necessary. As always, you can report any issues on our issue tracker.

Happy Skripting!

Changelog

Additions
- #6906 Added some additional spawn reasons from 1.21.
- #6919 Added 'pufferfish' as an alias for the 'puffer fish' entity data.

Tweaks
- #6854 Updated the display name of potion effect types from 'potion' to 'potion effect type'.

Bug Fixes
- #6897 Fixed an issue where sorting the indices of a list with children caused an error.
- #6909 Fixed an issue with Timespan#getAs(), which was breaking timespan arithmetic.
- #6910 Fixed an issue where the 'play sound' effect would cause runtime errors on some server versions.
- #6926 Fixed an issue where Skript could fail to start on some 1.21 server versions.
- #6932 Fixed an issue with the SimplifiedChinese translation that caused a startup error.
- #6947 Fixed an issue where the 'remaining air' expression would cause runtime errors.
- #6948 Fixed an issue where using some events would cause parsetime errors.
- #6949 Fixed an issue where reloading the aliases would not automatically regenerate missing aliases.

Click here to view the full list of commits made since 2.9.0

Notices

Help Us Test
We have an official Discord community for beta testing Skript's new features and releases.

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.9.0

Skript 2.9.0 is here with dozens of new features, quality-of-life improvements, and bug fixes. Notably, this release includes support for Minecraft 1.21.

We especially want to thank the recent influx of new contributors, many of whom are included in this update. Every contributor means a little less work for the team and a little more progress for Skript, so please, if you want a feature in Skript, go ahead and try to make a pull request! New contributors are very welcome! You can review our contributing guide by clicking here.

Below, you can familiarize yourself with the changes. Additionally, by clicking here, you can view the list of new syntax on our documentation site. As always, report any issues to our issues page!

Per our new release model, we plan to release 2.9.1 on August 1st to address any immediate issues that are spotted with this release. Should it be necessary, an emergency patch release may come before then.

Happy Skripting!

You can view the full changelog here: https://github.com/SkriptLang/Skript/releases/tag/2.9.0

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.7
We're releasing 2.8.7 to fix some important issues that made their way into 2.8.6. We expect this to be the final version for Skript 2.8. You can report any issues through our issue tracker.

Happy Skripting!

Changelog
Bug Fixes
- #6757 Fixed an error that could occur when attempting to obtain the potion effects of a plain potion.
- #6758 Fixed arithmetic-related errors on Java 8 and when performing Vector-Vector multiplication.
- #6760 Fixed several particle definition conflicts that made it harder to use certain items and entity types with variables.
- #6763 Fixed an issue where reloading scripts with commands could cause an exception on Paper 1.20.5+.
- #6764 Fixed an issue where fireworks could not be spawned using the spawn effect/section.
- #6777 Fixed an issue with the text representation of the case expression.

Click here to view the full list of commits made since 2.8.6

Notices
Java 11
From Skript 2.9.0 onwards, we will be requiring a minimum Java version of 11 to run.

Help Us Test
We have an official Discord community for beta testing Skript's new features and releases.

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.6

Skript 2.8.6 is here. This release delivers more bug fixes with improved 1.20.5+ support. Additionally, a few quality-of-life features have made their way in. You can report any issues through our issue tracker.

Happy Skripting!

Changelog

Additions
- #6652 Added missing item drop event values (dropped item and itemstack)
- #6654 Improved the subcommand help colours in the /skript command.
- #6655 Added support for modifying the exploded blocks in an explode event.

Bug Fixes
- #6624 Fixed unexpected math parsing issues that could occur when using variables.
- #6642 Fixed an error that could occur from Skript attempting to normalize zero vectors.
- #6644 Fixed an issue with damaging and repairing items in slots.
- #6646 Fixed an issue where obtaining the max durability of a custom item did not work.
- #6679 Fixed an issue where beta releases were considered stable by the update checker.
- #6683 Fixed an issue where syntaxes could modify the stored values of literals.
- #6716 Fixed numerous particle issues that occurred when using Minecraft 1.20.5+.
- #6724 Fixed an issue where forcing an entity to at a vector failed.
- #6742 Fixed an issue with obtaining an entity's target that could occur when no blocks were within 100 meters.
- #6746 Fixed an issue where dropped items could not be spawned properly.
- #6747 Fixed an issue where obtaining the location of an inventory holder did not work.
- #6752 Fixed an issue where spawning specific fish types (other than tropical fish) did not work.

API Updates / For Addon Developers
- #6624 Expressions can now declare multiple potential return types. This allows for providing more context regarding the return type of an expression (for example, Entity and Block compared to their shared supertype Object).
- #6684 Our code standards for the project have been updated. Please review the linked PR for an overview of the changes.
- #6700 The manner in which failed JUnit tests are displayed has been improved.

Click here to view the full list of commits made since 2.8.5

Notices

Java 11
From Skript 2.9.0 onwards, we will be requiring a minimum Java version of 11 to run.

Help Us Test
We have an official Discord community for beta testing Skript's new features and releases.

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.5

Skript 2.8.5 is here with some more bug fixes and quality-of-life additions. There is also early support for 1.20.5/1.20.6 (Skript will run and some basic 1.20.5/1.20.6 features will work). Further support will come in the next releases. You can report any issues on our issue tracker.

Happy Skripting!

Changelog

Additions
- #6134 Added mushroom cow alias for mooshroom.
- #6163 Added tests for vector syntaxes.
- #6525 Added support for specifying charged creeper rather than powered creeper.
- #6526 Improved the documentation of the elements expression.
- #6528 Improved the documentation of the leash effect.
- #6628 The Skript artifact name now includes the plugin version (e.g. Skript-2.8.5.jar).
- #6632 Added basic support for the new Armadillo and Bogged entities.

Bug Fixes
- #6302 Removed the outdated Location to Chunk converter.
- #6523 Fixed an issue that could occur when attempting to spawn non-spawnable entities.
- #6561 Fix the move event's example.
- #6566 Removed redundant [the] in the hotbar expression.
- #6578 Fixed an error that could occur with the inventory click event.
- #6579 Fixed function parsing issues with ambiguous parameter lists.
- Fixes locations with no world causing an error:
- #6590 Entity look at effect.
- #6589 Blocks (below, above, etc.) expression.
- #6588 Explode effect.
- #6591 Fixed an incorrect internal check that determined whether an expression was nullable.
- #6594/#6604 Improved the efficiency of element input pattern checks.
- #6595 Fixed incorrect coloring with some error messages.
- #6600 Fixed an error that could occur when setting the value of a variable.
- #6619 Fixed an issue that could occur when reloading a command on newer Paper versions.
- #6617/#6630 Fixed multiple issues that could occur when using Skript on 1.20.5/1.20.6.

Click here to view the full list of commits made since 2.8.4

Notices

Java 11
From Skript 2.9.0 onwards, we will be requiring a minimum Java version of 11 to run.

Help Us Test
We have an official Discord community for beta testing Skript's new features and releases.

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.4

Skript 2.8.4 is here and it brings with it many bug fixes. You can report any issues on our issue tracker.

Happy Skripting!

Changelog
Bug Fixes
- #6413 Adds missing attributes for MC 1.20.5
- #6473 Fixes an issue where spawning a falling block would load the chunk at 0,0.
- #6475 Fixes issue when spawning an entity at a location with no world.
- #6484 Fixes error when trying to spawn en entity from a disabled datapack.
- #6495 Fixes strings in lists not getting sorted properly.
- #6497 Adds error message to catch null return types.
- #6502 Fixes error when using invalid amounts of random characters.
- #6510 Fixes Anvil Text examples, updates Location function examples.
- #6512 Fixes unparsed literal error with the random expression.

Click here to view the full list of commits made since 2.8.3

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.3

A new month means a new patch! Skript 2.8.3 is here and it brings with it many bug fixes. You can report any issues on our issue tracker.

Happy Skripting!

Notices
If, and only if, you have the case-insensitive-variables config option set to false, you may experience slight changes to code behavior in functions. Previously, function parameters did not respect this option. This means that if you relied the bug that made the following code work (despite your config option set to false), your code will no longer work in this update.

Code:

function test(TEST: text):
    broadcast {_test} # only {_TEST} is set now, not {_test}

Changelog
Bug Fixes
- #6233 Fixed an issue where event values for the inventory item move event were mistakenly removed.
- #6309 Fixed an issue that caused some click events to fire multiple times for a single event.
- #6192 Fixed an issue where using the groups expression with LuckPerms would cause an exception.
- #6328 Fixed an issue where multiplying or adding timespans could overflow into negative values.
- #6387 Fixed an exception when trying to get the components of a non-vector.
- #6388 Fixed function parameters not respecting the case-insensitive-variables config option.
- #6391 Fixed plain always getting the same item for aliases representing multiple items.
- #6392 Fixed bucket events returning the wrong event-block.
- #6463 Fixed the at time event failing to property trigger when a world's time was changed.
- #6455 Fixed a parser issue that caused parsing to fail for some syntax when special characters were used.

Click here to view the full list of commits made since 2.8.2

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.2​

We are releasing Skript 2.8.2 to patch a critical issue that prevented the plugin from loading on Spigot versions older than 1.18. You can report any issues on our issue tracker.

Happy Skripting!

Changelog​

Bug Fixes​

• #6399 Fixed an issue that prevented Skript from loading on Spigot versions older than 1.18.

Click here to view the full list of commits made since 2.8.1

As always, if you encounter any issues or have some minor suggestions, please report them at https://github.com/SkriptLang/Skript/issues.
If you have any bigger ideas or input for the future of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.

Skript 2.8.1​

Skript 2.8.1 is here to resolve some of the most notable issues reported with 2.8.0. We will continue to assess stability and make fixes as necessary. As always, you can report any issues on our issue tracker.

You can view the release on GitHub here.

Happy Skripting!

Additions​

• #6367 Added support for experimental entities from 1.20.3, breeze and wind charge.

Tweaks​

• #6357 armour is now valid for the player armor change event.

Bug Fixes​

• #6352 Fixed a mapping issue that could cause an error on shutdown.
• #6357 Fixed an issue that caused armor of %entities% to be considered a single value.
• #6358 Fixed an issue that allowed invalid function definitions to parse successfully.
• #6360 Fixed parsing issues that caused valid code like loop-value - 1 to error. Additionally, many improvements have been made to the arithmetic expression to greatly improve parsing and general stability.
• #6374 Fixed an issue that caused the scripts expression to return absolute paths for enabled scripts.
• #6375 Fixed an error that could occur when Skript attempted to interpret an unknown enumerator as a string.
• #6378 Fixed an invalid documentation link to the text tutorial.
• #6383 Fixed a syntax conflict that prevented the usage of the vector from coordinates expression.

Click here to view the full list of commits made since 2.8.0