The "We Need More Stuff" Update

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:

• Added a condition for isOccluding (thanks @Mr-Darth)
• Added support for block data in the send block change effect
• Added expressions for arrow pierce and critical state (thanks @Mr-Darth)
• Added an expression for projectile bounce state (thanks @deltarays)
• Added support for locations, chunks and “within” (blocks cuboid) in blocks expression
• Added support for “:” in play sound effect to allow for using minecraft namespace (closes #3404)
• Added item mending event
• Added heal amount expression (thanks @Romitou, closes #3337)
• Added expressions for last attacker and last damage (thanks @deltarays)
• Added support for decimals between in ExprNumbers (thanks @bluelhf, closes #2601)
• Added an expression for generating a random UUID (thanks @Mr-Darth)
• Added support for non living entities in spawn event (closes #3120)
• Added support for multiple strings in CondStartsEndsWith (thanks @deltarays, closes #3312)
• Added an effect to force attack (thanks @OfficialDonut)
• Added an effect to make an entity swing their hand (thanks @OfficialDonut)
• Added expressions for minecart’s derailed velocity and speed (thanks @deltarays)
• Added an expression for sea level (thanks @Mr-Darth)
• Added an effect to open a book to a player (thanks @OfficialDonut)
• Added an arm swing event (thanks @Romitou, closes #3114)
• Added a condition to check if a block is passable (thanks @Mr-Darth)
• Added a condition to check if an item is a fuel (thanks @Mr-Darth)
• Added a condition to check for a normalized vector (thanks @BluBoy3ch0)
• Added an inventory pickup event (thanks @deltarays)
• Added an expression to get the drops of a block (thanks @deltarays)

FIXED:

• Fixed an issue with zombie pigmen/zombified piglin’s name returning with parenthesis (closes #3400)
• Fixed an issue with block variations in the send block change effect
• Fixed more issues with Visual Effects (closes #3379)
• Fixed a parsing issue with ExprAmount (closes #3333)
• Fixed an issue with cmd: with $ symbol not working (closes #2706)
• Fixed an issue with Json messages using <> not working (closes #3328)
• Fixed an issue with all items in inventory expression not returning the correct value in loops (closes #2340)
• Fixed an issue with adding multiple numbers to a single variable (closes #3198)
• Fixed some issues with damage cause comparisons (closes #3022)
• Fixed delay issues in force respawn player effect
• Fixed some issues with aliases deleting themselves internally (closes #2672)
• Fixed an issue with adding/setting/reparing multiple items in an inventory (thanks @OfficialDonut, closes #2989)
• Fixed an issue with comparing inventory slots and equipment slots matching when they shouldn’t (closes #3430)
• Fixed some issues with item comparisons (closes #3405)
• Fixed an issue with missing end rod visual effect and some typos in the lang file for visual effects
• Fixed an issue with light grey color not working properly on 1.9-1.11.2
• Fixed some issues with entity datas not sending their correct and/or full name when in a string

2.5 has finally arrived

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.

⭐️ Notable Additions

This update had a lot of new things added, but here are a few notable additions we thought you'd love to hear about.

BlockData

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.

Skript Info Command

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"

Minecraft 1.16

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.

⭐️ Everything Else

• Added an effect and a condition for silencing entity sounds
• Added support for non-player entities to item pickup event
• Added location for block command senders
• Added recursive list size as an option to 'amount' expression
• Added an expression for toggling entity AI on and off
• Added an event for players propelling through air due to riptide enchantment
• Added a condition to check if entities are leashed
• Added more descriptive alternative syntax for 'blocking' condition
• Added an expression to get how long players have been online
• Added support for mooshroom variations
• Added an expression to get max durability of items
• Added different capitalization styles to 'case text'
• Added an effect and a condition for entity invulnerability
• Added syntaxes for Minecraft 1.14+ CustomModelData
• Added support for Paper's per-client view distance (not supported on all Paper versions)
• Added an expression to get all blocks destroyed by explosions
• Added a way to replace only first occurrance with replace effect
• Added an event value for selected hotbar button in inventory click events
• Added an event for armor changes
• Added support for taming entities
• Added an expression for counting characters in a string
• Added a way to convert unix timestamps to dates
• Added an event for sponge absorbing blocks
• Added support for item (tool or armor) damage
• Added an option to temp-ban players
• Added support for llamas in entity equip effect
• Added an expression to get/set number of arrows stuck in an entity
• Added an expression to get/set no damage ticks of entities
• Added support for creating fiery explosions within the explode effect
• Added syntax to replace existing potion effects
• Added syntax to get the entities in a chunk
• Added new line expression
• Added an effect and condition to change/check charged creepers
• Added some spawn reasons which were recently added to the Bukkit API
• Added explode creeper effect and ignition condition
• Added an expression to get all scripts, or just the enabled or disabled ones.
• Added a condition and expression for checking Redstone block power
• Added several syntaxes for enchanting events and their values
• Added Korean language support
• Added more preload functionality to the API for internal use and addon developers
• Added a ‘time since’ expression
• Added an expression for entity attributes
• Added an expression for entity fall distance
• Added several syntaxes relating to explosions
• Added syntaxes for world game rules
• Added the hit block event value to the on projectile hit event
• Added a heal reason type and expression to be used in the heal event
• Added a projectile collide event
• Added better handling of a stack overflow error
• Added an expression for first/last login of player
• Added a block fertilize event
• Added an effect to stop/restart the server
• Updated money expression to support offline player balances

⭐️ A few handfuls of bug fixes

• Fixed asterisks not being allowed in expressions in variable names
• Fixed flickering fireworks not working
• Fixed 'all foxes' not actually referring to all foxes
• Fixed exceptions caused by passing invalid arguments to functions
• Fixed player-specific weather not being always set correctly
• Fixed random fish spawning not working
• Fixed some types not being parseable
• Fixed comparisons between entities and entity types with similarly named aliases
• Fixed parsing of overlapping syntaxes in comparisons
• Fixed numerous conditions, expressions, and events using ItemStack instead of ItemType
• Fixed exception error in replace effect
• Fixed damage effect not showing damage
• Fixed some tree types not working in grow tree effect
• Fixed experience spawn event firing more than once after script reloads
• Fixed an issue with damaging items throwing console errors
• Fixed an issue with reloading functions throwing errors
• Fixed an issue with the item damage event missing an event-item value
• Fixed an issue with final damage returning the same value as damage
• Fixed an issue where setting a block would always set it to the default block state
• Fixed an issue with retrieving inventory names
• Fixed an issue with setting the player's tab list name
• Fixed an issue with spawning thrown potions
• Fixed an issue with spawning a dropped item of a specific item type
• Fixed an issue with level progress expression throwing errors
• Fixed an issue with teleporting ignoring yaw and pitch
• Fixed an issue with event-items
• Fixed an issue with default values in damage events
• Fixed an issue with event-value time states
• Fixed an issue with villager data in legacy versions causing issue to last spawned entity syntax
• Fixed an issue with ‘show inventory’ expression showing the wrong inventory
• Fixed a bug with %number% of %itemtype% expression
• Fixed an issue with the is between condition not comparing when the first number is larger than the latter
• Fixed an issue with not being able to parse experience
• Fixed an issue with filters throwing console errors
• Fixed an issue with some block datas not setting (ie: snow layers)
• Fixed an issue with setting item amount of inventory slots
• Fixed an issue with furnace slot expression not accounting for smoker and blast furnace
• Fixed an issue with not being able to compare some entities with a baby entity
• Fixed an issue with “item crack” particle not working
• Fixed an issue with custom inventories not actually returning an inventory
• Fixed an issue with data value expression not working on 1.12.2 and below
• Fixed an issue with chunk is loaded condition forcing chunks to load therefor always returning true
• Fixed an issue with some entities returning their super type
• Fixed an issue with viewers of inventory expression only returning a single value
• Fixed some issues with visual effects, namely offset issues and coloured dust particle issues
• Fixed an issue with the soft depends in the plugin.yml
• Fixed an issue with FAWE’s WorldGuard not working
• Fixed an issue with event-slot throwing errors when clicking outside of an inventory
• Fixed an issue with spawn egg aliases not working in 1.12.2

Forth Beta Release

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

• Fixed an issue with inventory owner and entity owner syntaxes clashing (closes #3344)
• Fixed an issue with named items failing (closes #3347)
• Fixed an issue with the soft depends in the plugin.yml
• Fixed an issue with FAWE’s WorldGuard not working (thanks @IronApollo, closes #2674)
• Fixed an issue with event-slot throwing errors when clicking outside of an inventory (closes #3359)

Third Beta Release

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.

• Fixed an issue with custom inventories not actually returning an inventory (closes #3304)
• Fixed an issue with data value expression not working on 1.12.2 and below (closes #2736)
• Fixed an issue with chunk is loaded condition forcing chunks to load therefor always returning true (closes #2716)
• Fixed an issue with some entities returning their super type (closes #3316)
• Fixed an issue with viewers of inventory expression only returning a single value (closes #3321)
• Fixed some issues with visual effects, namely offset issues and coloured dust particle issues (closes #2958 and #2740)
• Updated is redstone powered condition to support “indirectly powered” (thanks @Romitou closes, #3294)
• Updated money expression to support offline player balances
• Added Piglin Brute entity

Second Beta Release

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.

• Fixed an issue with the is between condition not comparing when the first number is larger than the latter (closes #3111)
• Fixed an issue with not being able to parse experience (thanks @Matocolotoe, closes #3265)
• Fixed an issue with filters throwing console errors (closes #3267)
• Fixed an issue with “any signs” alias not counting new nether signs (closes #3272)
• Fixed an issue with “any wooden trapdoor” alias on legacy versions (closes #3107)
• Fixed an issue with some block datas not setting (ie: snow layers) (closes #3026)
• Fixed an issue with setting item amount of inventory slots (closes #2707)
• Fixed an issue with furnace slot expression not accounting for smoker and blast furnace (closes #3286)
• Fixed an issue with not being able to compare some entities with a baby entity (closes #3252)
• Fixed an issue with “item crack” particle not working (closes #3012)
• Update docs for “chunk event” incorrectly stating the event can be cancelled (closes #2753)

First Beta Release

Warning: This is the first 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.

• Fixed a bug with %number% of %itemtype% expression (closes #3187)
• Fixed a bug in the scripts expression throwing an error (closes #3193)
• Fixed a parsing issue with HEX colors (closes #3213)
• Added the hit block event value to the on projectile hit event (thanks @deltarays)
• Added a heal reason type and expression to be used in the heal event (thanks @deltarays)
• Added a projectile collide event (thanks @deltarays)
• Added better handling of a stack overflow error (closes #2752)
• Added an expression for first/last login of player (thanks @deltarays)
• Added a block fertilize event (thanks @deltarays)
• Added block data as a variation to using item types for blocks (closes #2547)
• Added an effect to stop/restart the server (thanks @deltarays)

Another Alpha Release

Warning: This is the sixth public test release of Skript 2.5. It is likely to contain breaking 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.

With that warning stated, the alpha releases have been fairly stable. This alpha release adds a whole bunch of new stuff for the community to test out. We are hoping this will be our last alpha before moving into the beta phase.

• Fixed an issue with retrieving inventory names (closes #2069)
• Fixed an issue with setting the player's tab list name (closes #539)
• Fixed an issue with spawning thrown potions (closes #2891)
• Fixed an issue with spawning a dropped item of a specific item type
• Fixed an issue with level progress expression throwing errors (closes #2680)
• Fixed an issue with teleporting ignoring yaw and pitch (closes #996 and #3050)
• Fixed an issue with event-items (closes #2771)
• Fixed an issue with default values in damage events (thanks @TheLimeGlass, closes #1415 and #2218)
• Fixed an issue with event-value time states (thanks @TheLimeGlass, closes #671)
• Fixed an issue with villager data in legacy versions causing issue to last spawned entity syntax (closes #3063)
• Fixed an issue with ‘show inventory’ expression showing the wrong inventory (closes #3096)
• Added proper support for HEX color codes for Minecraft 1.16+ (closes #3106)
• Added several syntaxes for enchanting events and their values
• Added Korean language support (thanks @MaGyul)
• Added more preload functionality to the API for internal use and addon developers (thanks @TPGamesNL)
• Added a ‘time since’ expression
• Added an expression for entity attributes
• Added an expression for entity fall distance (thanks @deltarays)
• Added several syntaxes relating to explosions
• Added relation-based variables using the Persistent Data API (Temporarily removed due to critical bug)
• Added syntaxes for world game rules (thanks @ThatOneTqnk)

The Nether Alpha

Warning: This is the fifth public test release of Skript 2.5. It is likely to contain breaking 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.

This is a fairly small update with a main goal of adding the remaining new Minecraft 1.16 content.

• Updated the error-like updater message (thanks @APickledWalrus, closes #3074)
• Added a condition and expression for checking Redstone block power (thanks @Romitou, closes #3090)
• Added the rest of the new Minecraft 1.16 content (new entities, particles, biomes and an enchantment)

Another unstable alpha release

Warning: This is the fourth public test release of Skript 2.5. It is likely to contain breaking 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.

• Fixed an issue with the item damage event missing an event-item value (closes #2895)
• Fixed an issue with the reload script effect throwing errors (closes #2913)
• Fixed an issue with final damage returning the same value as damage
• Fixed an issue where setting a block would always set it to the default block state (closes #2292)
• Added an expression to get all scripts, or just the enabled or disabled ones. (thanks @APickledWalrus)
• Added more info to the /sk info command which includes Skript version, server version as well as installed addons (including their versions and websites)

Information regarding 1.16.x:

• This update adds aliases for all new 1.16 related items and blocks.
• This update DOES NOT include any other new 1.16 specific things such as entities, particles, biomes, enchantments, etc. These things will come in a future update.

Third 2.5 unstable alpha release

Warning: This is the third public test release of Skript 2.5. It is likely to contain breaking 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.

This release fixes a few bugs and also brings a handful of new syntaxes available for testing.

• Fixed some docs issues (usages in some Skript types showing up examples)
• Fixed a spelling mistake in the lang file resulting in incorrect docs for visual effects
• Fixed an issue with damaging items throwing console errors (closes #2755)
• Fixed an issue with reloading functions throwing errors (closes #2802)
• Fixed an issue with gradle tasks throwing errors (closes #2797)
• Added some spawn reasons which were recently added to the Bukkit API
• Added explode creeper effect and ignition condition (thanks @APickledWalrus)
• Updated script examples (thanks @Olyno)