Skript 2.10.1

Skript 2.10.1 is here to address some of the most prominent issues reported with 2.10.0.

As always, you can report any issues on our issue tracker.

Happy Skripting!

Breaking Changes
There have been a few minor breaking changes:
- When using "send" in the 'connect' effect, "server" is now a required keyword.
- Removed the pattern "[a] %\*color% %bannerpatterntype%"

Changelog

Bug Fixes
- #7450 Fixes an issue where tag lookups for the 'tag' expression would not check all possible tag sources.
- #7455 Fixes an issue with the experimental queue serialization.
- #7474 Fixes an issue where using 'or' in the 'is tagged' condition would not check against all tags.
- #7503 Fixes an issue where getting or changing the name of a block did not work.
- #7519 Fixes a syntax conflict between the 'send' effect and the 'connect' effect.
- #7521 Fixes multiple issues with 'fishing' documentation.
- #7525 Fixes an issue where the 'wearing' condition could check invalid slots, resulting in an exception.
- #7527 Fixes an issue where checking whether something is tagged as a different type (e.g. check if an entity is tagged as a type of item) would result in an exception.
- #7528 Fixes an issue where loot tables could not be serialized.
- #7537 Fixes an issue where the 'for each' loop did not fully iterate over the elements.
- #7540 Fixes an issue where some language entries could mistakenly be associated with non-Minecraft additions (e.g. custom biomes).
- #7546 Removes the pattern "[a] %\*color% %bannerpatterntype%" which caused significant parsing slowdowns in some Skript environments.
- #7557 Fixes an issue where the tests could fail if a locale other than English was used.
- #7559 Fixes an issue where some syntaxes contained "the" multiple times at the beginning.
- #7570 Fixes an issue where date variables from older versions would fail to load on 2.10.0.

API Changes
- #7526 Added support for regex-based highlighting for runtime errors.

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

Notices

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

Thank You
Special thanks to the contributors whose work was included in this version:
- @APickledWalrus
- @Burbulinis
- @erenkarakal
- @Fusezion
- @Moderocky
- @Phill310
- @ShaneBeee
- @sovdeeth
- @TheAbsolutionism
- @UnderscoreTud

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

We are excited to share that Skript 2.10.0 is now available! It is one of our largest updates, with more than 150 new features, bug fixes, and API updates to play around with!

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 release model, we plan to release 2.10.1 on February 1st to address any immediate issues that are spotted with this release. Should it be necessary, an emergency patch release may come before then.

For the full changelog, please visit our GitHub Release Page: https://github.com/skriptlang/skript/releases/tag/2.10.0

Happy Skripting!

Skript 2.9.5

Skript 2.9.5 is here with a handful of new bug fixes. As always, you can report any issues on our issue tracker.

Happy Skripting!

Changelog

Tweaks
- #7232 Improved the documentation of the 'projectile hit' event to be up to date with the 'victim' syntax.

Bug Fixes
- #7062 Fixed an error that would occur when attempting to place blocks between two points above the world limit.
- #7120 Fixed an issue where various expressions (enchant effect, replace effect, vector expressions, etc.) would overwrite the indices of list variables used.
- #7152 Fixed an issue where player skull textures would not immediately load on Paper (loading is now forced).
- #7188 Fixed an issue where plural event values did not work with 'past' and 'future' time states.
- #7195 Fixed a few Turkish language mistakes.
- #7199 Fixed multiple issues with playing sounds on 1.21.3+.
- #7202 Fixed an error that could occur when using invalid regular expression patterns in the split expression.
- #7210 Fixed long overflow when performing arithmetic.
- #7230 Fixed an issue that could occur when trying to grow new tree types (e.g. pale oak).

API Additions
- #7120 Added a new 'Expression#changeInPlace()' method for changing the elements of an expression without changing the entire object. For example, this allows the values of a list variable to be updated while preserving the indices.
- #7207 Updated the 'Arithmetics#exactOperationExists' and 'Arithmetics#exactDifferenceExists' methods to be public. They act as a safe way to check arithmetic operation existence during the registration period.

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

Notices

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

Thank You
Special thanks to the contributors whose work was included in this version:
- @Asleeepp
- @erenkarakal
- @ShaneBeee
- @sovdeeth
- @TheAbsolutionism
- @UnderscoreTud

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

Skript 2.9.4 is here with even more bug fixes and early support for Minecraft 1.21.3. As always, you can report any issues on our issue tracker.

Happy Skripting!

Changelog

Bug Fixes
- #7141 Fixes leather horse armor being unequipable.
- #7143 Fixed entries being case-sensitive, preventing using capital letters in entries like 'Usage: ' for commands.

Additions
- #7163/#7176 Added early support for Minecraft 1.21.3 features
This includes: Pale Garden biome, creaking entity, baby squid entity, baby glow squid entity, baby dolphin entity

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

Notices

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

Thank You
Special thanks to the contributors whose work was included in this version:
- @Efnilite
- @erenkarakal
- @sovdeeth

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

Skript 2.9.3 is here with even more bug fixes. As always, you can report any issues on our issue tracker.

We are also excited to welcome six new members to our team! These new members were selected from the numerous applications we received, and they have already been hard at work troubleshooting issues, patching bugs, and building new features. The full list of new members is as follows:
- @cheeezburga
- @Efnilite
- @erenkarakal
- @Pesekjak
- @Romitou
- @TenFont

Happy Skripting!

Changelog

Bug Fixes
- #7024 Fixed an error that could occur when using invalid inputs in the 'look at' effect.
- #7027 Fixed some bStats reporting issues from the recent changes.
- #7031 Fixed formatting issues when reloading a directory.
- #7036 Fixed numerous and/or warnings that occurred in the tests.
- #7038 Fixed the within condition returning wrong values when negated and given a null input.
- #7052 Fixed an issue where 'Dutch' was not one of the language options listed in the config.
- #7056 Fixed removing entries from the hover list in a server ping event.
- #7060 Fixed exponents capping at long max value.
- #7066 Fixed an issue where the 'swim toggle' event could be cancelled. An error is now printed as cancelling it has no effect.
- #7067 Fixed an internal testing issue with the parse structure.
- #7082 Fixed an issue with modifying world times.
- #7085 Fixed an error message that could occur from unregistered types in changers.
- #7087 Fixed an issue where legacy materials were used in places they shouldn't.
- #7091 Fixed a bug when setting the profile of a skull to an offline player without a username.
- #7121 Fixed a redundant material namespace check.

API Updates
- #6992 Removed the usage of Eclipse annotations package. The JetBrains annotations package is now preferred.
- #7089 Introduced an official checkstyle for code formatting warnings.
- #7095 Prevents delays from being used in the testing system (excluding JUnit).

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

Notices

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

Thank You
Special thanks to the contributors whose work was included in this version:
- @0XPYEX0
- @Asleeepp
- @cheeezburga
- @Efnilite
- @Moderocky
- @Pesekjak
- @sovdeeth
- @Sparky200
- @TenFont
- @TheLimeGlass

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