| icon | code |
|---|
{% hint style="warning" %}
This feature is a work in progress and may change, potentially affecting existing configurations and scripts. While I will strive to maintain compatibility, some disruptions are inevitable. {% endhint %}
ItemsAdder introduces a powerful scripting feature that lets you define advanced item behaviors beyond the built-in events and actions. With scripting, you can create dynamic and complex functionalities using a Java-like syntax.
Remember to update the vscode extension to get autocompletion and common errors checking of the new preview .jspp format.
The scripting engine uses Java under the hood but allows some JavaScript-inspired syntax for convenience.
📝 Note: Scripts written in ItemsAdder are compiled into Java code, ensuring performance equivalent to native server code. Unlike interpreted languages like Skript, there is no runtime interpretation overhead.
The following events are supported for scripting and are triggered by the events property in the item.
BlockBreakEventCustomBlockBreakEventInternalPlayerInteractEventEntityDamageByEntityEventEntityDeathEventPlayerInteractEntityEventPlayerDropItemEventPlayerDropHeldItemEventEntityShootBowEventEntityShootBowArrowEventPlayerItemConsumeEventFoodLevelChangeEventPlayerEditBookEventPlayerFishEventInventoryClickEventProjectileLaunchEventProjectileHitEventPlayerItemHeldEventInventoryDragEventPlayerPickupItemEventPlayerBucketEmptyEventPlayerBucketFillEventArmorEquipEventPlayerItemBreakEventPlayerSwapHandItemsEventPlayerEvent