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

Third Pre-Release [1.0.0-pre-release-3]

It's time for a third pre-release.
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).

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 is empty condition not working:
  • It was trying to first compare a list to an object named "empty"
• Fixed functions allowing any object in params when called (Still needs more work)
• Fixed commands not unregistering when a script is unloaded/command removed from script

CHANGED:

• Config was re-configured (might want to delete it and let it regenerate)
• Config now also auto updates during HySkript updates.
• Global commands will now run in a player's world if a player executed the command
• Context values now allow the use of "event" instead of "context"
  • "context" is still an option
  • You can now do things like event-player

DOCS:

• Added context-values to the description of an event/structure with return type and description

INTERNAL:

• Refactored structure registration
• Refactored context values into their own expression
• Added an option to add a description to ContextValues