Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them.
2.6.x
will be the last version working with 1.12 and lower. Security patches and other kind of fixes might be ported to this version, but keep in mind that features won't be added.Welcome back to yet another release! This update may be super small but if fixes a pretty major bug with variables.
2.6.x
will be the last version working with 1.12 and lower. Security patches and other kind of fixes might be ported to this version, but keep in mind that features won't be added.Welcome back to yet another release!
We know it's been a while, but we are still working hard to bring brand new features and fixes to Skript. This update brings support for Minecraft 1.17 and all of its new features. As such, the aliases have been updated to include the new 1.17 blocks and items. You can see the full list of changes below.
As always, if you encounter any issues please report them at https://github.com/SkriptLang/Skript/issues. If you have any ideas or input for the future development of Skript, you can share those too at https://github.com/SkriptLang/Skript/discussions.
Anyways, with that out of the way, off to the change log!
If you were missing an alias for
minecraft:basalt
, the aliasbasalt
(plural form just hass
on the end) would be created.
Please note that the
dust_color_transition
andvibration
particles are currently missing and will be added in a future update.
parse if conditional
(https://github.com/SkriptLang/Skript/pull/4121, closes https://github.com/SkriptLang/Skript/issues/2037, https://github.com/SkriptLang/Skript/issues/1449)This condition is just like the
if statement
, but it is prefixed with the wordparse
. If the condition does not pass in aparse if statement
, the code in its section will not be loaded. Example:on load: parse if plugin "SkBee" is enabled: # SkBee addon stuff here
do while loop
(https://github.com/SkriptLang/Skript/pull/4122)This is just like the while loop, but it will always run at least one time. Example:
on load: set {_x} to 0 while {_x} > 5: add 1 to {_x} # {_x} = 0 set {_x} to 0 do while {_x} > 5: add 1 to {_x} # {_x} = 1
This also [re]adds the ability to teleport synchronously by prefacing the effect with
force
(e.g.force teleport the attacker to the victim
) Please note that the keyword 'force' indicates that the effect will not be delayed. This may cause lag spikes or server crashes when teleporting entities to unloaded chunks.
Please note that this fix removes the ability to damage an entity with a custom damage cause. This only worked because of a bug that has been fixed for a long time. If you still wish to use a custom damage cause (retain this functionality) you can use the last damage cause expression (https://github.com/SkriptLang/Skript/blob/master/src/main/java/ch/njol/skript/expressions/ExprLastDamageCause.java - https://skriptlang.github.io/Skript/expressions.html#ExprLastDamageCause)
Addons may also choose to disable hooks in
JavaPlugin#onLoad
by callingSkript#disableHookRegistration
. They may also check whether a hook is enabled throughSkript#isHookEnabled
.
2.6.x
will be the last version working with 1.12 and lower. Security patches and other kind of fixes might be ported to this version, but keep in mind that features won't be added.It's been 5 months since the last release, however this doesn't mean we haven't progressed at all during this time. There were some issues on the administrative aspect of the project which have just been recently resolved, hence why there's a lack of updates recently and we sincerely apologize for that. That being said, I'll start with the changes in the organization to begin with this release and then introduce the changelog for the first alpha of 2.6! Stay tuned.
I am glad to announce two new team members to the organization, @TPGamesNL who has been greatly contributing to the project with amazing patches and @TheLimeGlass who has always been a mindful part of the overall community and has also made great contributions in the past.
Another thing to note for addon developers and people who wish to contribute to the project, we have moved the main discussion area to the skUnity discord. While Skript-chat was good enough we need to reflect our rapidly growing community's needs and we will achieve this by taking it to the largest Skript community in place.
This doesn't mean skUnity documentation/forums are handled by the SkriptLang organization as they take part of their own service. We'll still maintain our own documentation at https://skriptlang.github.io/Skript and support any other services such as SkriptHub/Skript-MC to continue taking part of this community!
All of that done, now let's go through the changelog.
lower than
as an option for smaller than
in the comparison condition (https://github.com/SkriptLang/Skript/pull/3712, thanks to @TheDGOfficial)on leave
as an option for the quit event (https://github.com/SkriptLang/Skript/pull/3799, closes https://github.com/SkriptLang/Skript/issues/3789, thanks to @TheDGOfficial)This makes platforms such as Magma or Mohist more compatible but they're not yet supported by our project.
The RGB literal has been changed from
RED: %integer%, GREEN: %integer%, BLUE: %integer%
to(rgb|RGB) %integer%, %integer%, %integer%
Color support has been added to the note particle effectnote [(of|with) [colo[u]r] %number%]
font, f
, example: <font:uniform>uniform text
) (https://github.com/SkriptLang/Skript/pull/3877, closes https://github.com/SkriptLang/Skript/issues/3745)Event priorities can be read about here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/EventPriority.html For most users, you will not need to worry about this. However, it is useful in cases where you want to be sure that Skript is determining the outcome of the event. Keep in mind that LOWEST priority events are called first and MONITOR priority events called last.
log player commands
value in the config is now marked as false
by default, as servers already default to logging command usage (https://github.com/SkriptLang/Skript/pull/3972, closes https://github.com/SkriptLang/Skript/issues/3855)applied enchantments
effect documentation (https://github.com/SkriptLang/Skript/pull/3591, thanks to @MrScopes)This fix also adds a new expression, ExprPlain. A plain item is an item with no modifications. It can be used to convert items to their default state or to match with other default items. This is to provide a replacement for using
if player's tool is a diamond named ""
(you would instead useif the player's tool is a plain diamond
)
myFunction() + otherFunction()
) (https://github.com/SkriptLang/Skript/pull/3862, closes https://github.com/SkriptLang/Skript/issues/1532, https://github.com/SkriptLang/Skript/issues/2261, https://github.com/SkriptLang/Skript/issues/2416, https://github.com/SkriptLang/Skript/issues/3046)NOTICE: This rework removes the following syntaxes:
[the] list [of] %objects% (doesn't|does not|do not|don't) contain %objects%
[the] list [of] %objects% contain[s] %objects%
(all|any|none) of %strings% contain[s] %strings%
While Skript 2.5.2 brought some lovely new features, it also brought a couple big bugs along for the ride. Our goal with this update was to squash those pesky bugs and provide a more stable release. This may be a small update, but it’s going to take care of some things that needed some attention.
FIXED:
blocks within
expression returning a smaller cuboid than expected (closes #3615)Don’t worry, its not all serious, we did add a bunch of new stuff too
ADDED:
entity portal
event which is called when an entity uses a portalOh, never mind, it was just the two.
Enjoy!
This update brings some much needed bug fixes as well as some new features. As always it is recommended to backup any important data before update. Also it is advised to do some testing on your server before going live with an update.
FIXED:
ADDED:
API:
Skript 2.5.1 is a much larger update than we anticipated. Not only does it fix a lot of bugs, it also brings a few handfuls of new features. With that said, new features, and sometimes bug fixes, may also create new bugs. Please be sure to backup any important data before updating to this version. And as usual please report any bugs on our Issue Tracker
ADDED:
FIXED:
I want to start off by extending a big thank you to everyone who helped with this update. Not only did our team do a lot of work, we had PLENTY of help from contributors. So thank you to everyone who helped make this update possible.
Below is a list of almost everything that was added/fixed/changed since 2.4.1. I left out issues which pertain to things that were broken along the way during the development of 2.5.
This update had a lot of new things added, but here are a few notable additions we thought you'd love to hear about.
We added a blockdata type, as well as expression for getting block data. BlockData is very similar to how you would set a block with the vanilla Minecraft /setblock
command. This allows users to better customize blocks in the world, without having to struggle figuring out the aliases they need. For more info see the BlockData Type and BlockData Expression in the docs.
We added an info sub-command to the /skript
command which will provide links to docs and aliases, and also includes Skript version, server version as well as installed addons (including their versions and websites). This will be super helpful in the future, when a user is asking for help, rather than having to ask them a bunch of questions about versions, you can simply say "hey, could you please send me the output of /sk info
"
We added all of the Minecraft 1.16 related stuff, including item/block aliases, entities, enchantment (just one), particles and biomes. We also added support for 1.16's HEX text colors.
final damage
returning the same value as damage
%number% of %itemtype%
expressionis between
condition not comparing when the first number is larger than the latterchunk is loaded
condition forcing chunks to load therefor always returning trueWarning: This is the forth public beta release of Skript 2.5. It may contain some bugs. While the beta releases have proven to be fairly stable, it is not recommended to run these releases on a live/production server. If you choose to, please ensure you backup any important data beforehand.
Warning: This is the third public beta release of Skript 2.5. It may contain some bugs. While the beta releases have proven to be fairly stable, it is not recommended to run these releases on a live/production server. If you choose to, please ensure you backup any important data beforehand.
chunk is loaded
condition forcing chunks to load therefor always returning true (closes #2716)is redstone powered
condition to support “indirectly powered” (thanks @Romitou closes, #3294)Warning: This is the second public beta release of Skript 2.5. It is likely to contain some bugs - do NOT run it outside of a test server. Skript 2.4 will continue to receive critical bug fixes until 2.5 is stable, which may take a while.
is between
condition not comparing when the first number is larger than the latter (closes #3111)