Skip to content
ItemsAdder

Scripting

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