Scripting

Requires ItemsAdder 4.0.10 or greater

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.

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.

---

🧫 Overview

The scripting engine uses Java or a Java-like language (JSPP) under the hood.

📝 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.

↺ Supported Events

The following events are supported for scripting and are triggered by the events property in the item.

• BlockBreakEvent

• CustomBlockBreakEventInternal

• PlayerInteractEvent

• EntityDamageByEntityEvent

• EntityDeathEvent

• PlayerInteractEntityEvent

• PlayerDropItemEvent

• PlayerDropHeldItemEvent

• EntityShootBowEvent

• EntityShootBowArrowEvent

• PlayerItemConsumeEvent

• FoodLevelChangeEvent

• PlayerEditBookEvent

• PlayerFishEvent

• InventoryClickEvent

• ProjectileLaunchEvent

• ProjectileHitEvent

• PlayerItemHeldEvent

• InventoryDragEvent

• PlayerPickupItemEvent

• PlayerBucketEmptyEvent

• PlayerBucketFillEvent

• ArmorEquipEvent

• PlayerItemBreakEvent

• PlayerSwapHandItemsEvent

• PlayerEvent