HyperScript 1.5.0

Added

Events

• on entity damage (also written on hit): any entity taking damage. Values: attacker, victim, damage, cause, entity, %{event.location}%. Cancellable.
• on player jump: works on Spigot and Paper. Cancellable (the player is snapped back, so a small hop may be visible).
• on mob spawn: values entity, reason, %{event.location}%. Cancellable.
• on inventory click: values slot, item, %{event.click_type}%. Cancellable.

Event values

• Short words inside event blocks: attacker, victim, damage, cause, message, block, entity, killer, reason, slot, item. For example if message contains "badword":.
• Built-in placeholders can be written without %{ }% in conditions and expressions: event.cause, player.health, server.tps, arg.1.
• New placeholders: %{event.recipients}% (chat), %{event.drops}% and %{event.location}% (block break), %{player}%, %{player.location}%.
• is and is not as comparisons: if event.cause is "FALL":, if {player.frozen} is true:.

Documentation site

• events_metadata.json: every event with its values, whether it can be cancelled, who player is, and an example. Also served by app.py at /events_metadata.json and /api/events?name=....
• An Events reference page with a section per event and a "try it" box: click a value to add a line that uses it to a small script, then copy the result.
• Every event and every event value is in the search index, so searching attacker, damage or jump goes straight to the event.

Changed (check existing scripts)

• event's location now also works in on entity damage, on mob spawn and on player jump (the victim's, the spawn's and the player's position).
• %{event.entity}% is now set in on entity damage and on mob spawn as well as on entity death.
• %{event.item}% is now set in on inventory click as well as on right click.
• The words listed under "Event values" are now reserved inside expressions. item followed by a number is still the list lookup item 2 of <list>.