Update 5 Updates [1.7.0]

This update brings some changes to supported Hytale's "Update 5"

Notes:

Important

This release was built on Hytale Release version 0.5.0 (Update 5)
Hytale has changed all of their Vectors over to JOML Vectors (this shouldn't affect anyone)
Most of the changes here wont cause breaking changes

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

CHANGED:

• Mouse button click events no longer support Entity, so a Ref is returned instead:

- event-entity
+ event-entity-ref

• Item name/description expression now supports setting for ItemStacks (finally Hytale... finally)

INTERNAL:

• All Hytale vectors have been changed to Joml vectors (this is a change they made, this shouldn't affect anyone)

DOWNLOAD:

Download on CurseForge

Update 4 Updates [1.6.0]

This update brings some changes to supported Hytale's "Update 4"

Notes:

Important

This release was built on Hytale Release version 2026.03.26-89796e57b (Update 4)
Hytale has deprecated Inventory in favour of using InventoryComponents/ItemContainers
Most of the changes here wont cause breaking changes

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

• Added some functions to get Player/PlayerRef from name

REMOVED:

• Removed Inventory functions (they no longer work, Hytale removed the constructors)
• Inventory click events have been removed (Hytale removed the base event)

DEPRECATED:

• Deprecated anything related to Inventory (Hytale is moving away from this)
• Inventory of entity expression now returns a combined (hotbar/storage) ItemContainer (kept this for backwards compatibility )

DOWNLOAD:

Download on CurseForge

New Stuff [1.5.0]

This update brings some new stuff to try out, like entity animations.
It's a bit of a small update, but it brings some pretty important bug fixes.

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

Effects:

• Added an effect to play animations on entities

Expressions:

• Added an entity fall distance expression
• Added an expression to get all animations (as strings) for a specific Entity/Model

Conditions:

• Added a condition to check/set whether a ref (dropped item) can be picked up

Sections:

• Added a section to spawn "displays" (models/items/blocks)

Types:

• Added an AnimationSlot (represents the type of animation to play in the animation effect)

CHANGED:

• Changed the world daytime/nighttime duration expression to accept changers
• Changed the Ref type changer to not allow deleting players

FIXED:

• Fixed load/periodical/world time events firing too many triggers
• Fixed a parser bug where a space or optional couldn't be used between 2 expressions (Thanks @claude)
• Fixed a parser bug where errors were often cut off in weird places
• Fixed a bug where 2 variables could not be deleted at once time

OTHER:

• Added support for multi line comments, ex:

on load:
	send "pre"

###
blah blah blah

bloop bloop bloop
###

on load:
	send "post"

DOWNLOAD:

Download on CurseForge

Small Update [1.4.0]

This update brings some new stuff to try out, like camera effects.
It's a bit of a small update, but it brings a pretty important bug fix for variables.

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

Effects:

• Added an effect to apply a camera effect to players

Events:

• Added a teleport event

Conditions:

• Added a condition to check if a player is online

Types:

• Added a camera effect type

FIXED:

• Fixed a rather large bug where list/single variables could override each other if they had the same name

DOWNLOAD:

Download on CurseForge

Small Update [1.3.0]

This update brings some new stuff to try out, like map markers.
It also brings a slew of bug fixes.

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

Expressions:

• Added an expression to get map marker ids from a world/player
• Added string arithmetic so that strings can be joined using math functions

Effects:

• Added an effect to remove map markers from world/player
• Added an effect to open a page to a player
• Added an effect to close open windows of players
• Added an effect to apply/clear attack overrides for NPCs

Functions:

• Added returns and -> as options for return type of a function (To better match Skript)

Sections:

• Added a section to create a new map marker in a world or for a player

Events:

• Added some more detailed inventory events
  • I'll be honest, I'm not sure what half of these are truly called for so the docs are a bit blah

FIXED:

• Fixed an issue with variables not working in section entries
• Fixed an error when setting health of multiple entities at once
• Fixed entity damage event not being cancellable
• Fixed death event event-values not really working so well
• Fixed deleting of held item not working/throwing error
• Fixed players/locations in the play sound section not working

INTERNAL:

• Added a secondary way for addons to register, allowing them to be setup as plugins

DOWNLOAD:

Download on CurseForge

Some New Stuff [1.2.0]

This update brings some new stuff to try out, including particles, world creation, attitude adjustments and more.
21 new syntaxes to be exact :)

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

Effects:

• Added an effect to send particles
• Added an effect to create a world
• Added an effect to apply a model to Entities/Players, with an optional scale
• Added the option to teleport References in the teleport effect
• Added an effect to change the Attitude of an NPC Entity

Sections:

• Added a section to send particles with some extra options over the effect
• Added a section to create a world with some extra options over the effect

Expressions:

• Added an expression to get/set the rotation of a block
• Added "players" to the entities in radius expression
• Added an expression to get all worlds/world names
• Added an expression to get/reset a model of Entities/Players
• Added an expression to get all References in sphere/cuboid
• Added an expression to get specific components in sphere/cuboid
• Added an expression to get specific components from References (currently supports Player/NPCEntity/ItemComponent)
• Added an expression to get the reference from an Entity (probably useless right now)
• Added an expression to get/set the tint of a block
• Added an expression to get/set the locked target of an NPC Entity
• Added an expression to get the attitude of an NPC Entity

Types:

• Added a ModelAsset type
• Added a Reference (Ref) type
• Added an Attitude type

Events:

• Added an optional world to the periodical event (so the code executed in that event will run in said world)

FIXED:

• Fixed cancel event effect not working on some events
• Fixed the sever boot event never actually being triggered
• Fixed periodical events not stopping when a script is unloaded

INTERNAL:

• Fixed the json doc printer not printing some context values for some events
• Added an "addons" pie chart to bStats, helping servers understand which addons are used most

DOWNLOAD:

Download on CurseForge

Small Fixes [1.1.1]

This update brings a few small, but important, bug fixes.

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

FIXED:

• Fixed an issue with past/present/future context values not parsing
• Fixed variables not saving changes made to the object inside the variable
• Fixed variables not serializing if their explicit class type isn't registered

Download:

Download on CurseForge

A Big One [1.1.0]

It's time for a big ol update.
This update brings 79 new syntaxes to play around with.
Hopefully not that many bugs too.

Important

This release was built on Hytale Release version 2026.02.19-1a311a592

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

ADDED:

Effects:

• Added an effect to damage a block
• Added an effect to shut down the server
• Added an effect to open an ItemContainer to a player
• Added an effect to freeze/unfreeze entities
• Added an effect to tame/untame entities
• Added an effect to async load a chunk at a location
• Added an effect to make an entity ride/mount an entity/block:
  • When riding an entity, steering doesn't seem possible (at least on the sheep I rode)
  • Block mounting is currently not working. Hopefully I can fix this. (It said the player was mounted, but they weren't)
• Added an effect to remove an entity stat modifier

Expressions:

• Added an expression to get/set the health of a block
• Added an expression to get/set the date/time of a world
• Added an expression to get/set the environment at a location/within cuboid
• Added an expression to get/set the nameplate above an entity's head
• Added expressions for server/client view radius
• Added an expression to get/set the TPS (ticks per second) of a world
• Added expressions to get the current TPS/MSPT of a world
• Added an expression to get the daytime/nighttime durations of a world (currently no setters)
• Added an expression to offset a location by a vector3i/d
• Added an expression to get/set the coordinates (x/y/z) of a location/vector
• Added an expression to get the count of specific items in an inventory
• Added an expression to get the quantity of an ItemStack
• Added an expression to get a copy ItemStack with a new quantity
• Added an expression to get the name/description of an ItemStack (cannot be set)
• Added an expression to get the highest block at a location
• Added an expression to get rotation of a location
• Added an expression to get head rotation of an entity
• Added an expression to get/change scale of an entity
• Added some player based movement expressions (base speed, fly speed, jump force, mass, swim jump force)
• Added an expression to get the armor defense level of a player
• Added an expression to get/change the stamina of an entity
• Added an expression to get the ItemQuality of an Item/ItemStack
• Added a value within object expression (useful when trying to deal with the raw value of a variable)

Conditions:

• Added a condition to check if entities are frozen
• Added a condition to check if entities are alive
• Added conditions to check if a LivingEntity is tamed/tameable
• Added a condition to check if a Block/BlockType is solid
• Added a condition to check if game time of a world is paused (can be set)
• Added some player based movement conditions (can fly, falling, flying, idling, jumping, on ground, running, sitting, sleeping, sprinting, swimming, walking)
• Added a condition to check if the player has played before (useful in a player ready event)
• Added a condition to check if a chunk is loaded at a location
• Added a condition to check if an object is of a certain Type

Events:

• Added the player switch active slot event
  • For some reason this doesn't appear to get called for hotbar, only utility slot
• Added a time event, called every day in a world at the specified time
• Added a player pickup item event
• Added chat targets context value to the chat event

Sections:

• Added a send title section with more options like fade in/out, duration and icon

Types:

• Added an ItemQuality type (AssetStore)

Other:

• Added functions for Date, DateTime and Time
• Added some math functions for abs, ceil, cos, floor, sin
• Added a few functions to create new Inventories/ItemContainer
• Added config values to change default date/time formats
• Added effect commands for console
  • Its actually a command, so you have to put a space after the token
  • Example: ! some effect here

CHANGED:

• Added "give" and "subtract" to the change effect patterns
• PlayerRefs, when used as a variable name, will use their UUID just like a Player object
• Changed the all player expression to allow for also get all PlayerRefs
• Changed the world of expression to allow for getting the world of a PlayerRef

FIXED:

• Fixed strings taking a long time to parse if containing boolean operators
• Fixed boolean operators not working in conditions
• Fixed "me" not working as a context-value in effect commands
• Fixed not being able to set list based context values
• Fixed the default values expression not working (wasn't registered)
• Fixed the inventory expression not allowing more than 1 item added at a time
• Fixed the target entity expression being limited to a distance of 8 (now pulls from config's max block distance)

INTERNAL:

• Added a testing suite
• Executable Expressions finally have docs (Yay 🎉)
• Fixed the return type of a function not being used in the func expression, thus functions not working in some other expressions
• Gave functions their own registrar in SkriptRegistration

DOWNLOAD:

Download on CurseForge

Initial Stable Release [1.0.0]

It's about time for a stable release.

We're bringing you HySkript 1.0.0... the first stable release of HySkript.
This build has no changes since pre-release-4, it is just a version bump.

Important

This release was built on Hytale Release version 2026.02.06-aa1b071c2

Docs:

Issues:

If you find any bugs, please report them on our Issue Tracker

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

• No changes.

Fourth Pre Release [1.0.0-pre-release-4]

It's time for a fourth pre-release ... so much for the last one being the last one!
More bug fixes, and a few changes.

Since no bugs are being reported, I plan to release a stable release of HySkript in the next few days.
So this will be the last pre-release (most likely, I hope!).

If you find any bugs, please report them on our Issue Tracker

Docs on SkriptHub:

Warning

This is a pre-release and may contain bugs
Please DO NOT use on a production server
If you find an issue, please report it in our Issue Tracker

Important

This release was built on Hytale Release version 2026.02.06-aa1b071c2

Happy HySkripting!

🛠️ THIS UPDATE 🧑🏼‍🍳:

FIXED:

• Fixed yet another memory leak where local vars were carried across executions of multiples of the same event
• Fixed an issue with the location offset by direction expression causing the original location to change
• Fixed the world spawn location expression missing its world in the returned location
• Fixed the execute in world section only running the first statement within the section
• Fixed the spawn npc section not properly carrying variables and running the next statement.
• Fixed the previous variable name change being applied to ALL strings
• Fixed a couple patterns in a few elements that I screwed up