Summoning
An EffectiveItem that spawns a custom entity when right-clicked on a block, like a vanilla spawn egg.
A subclass provides getSpawnEffectiveEntity and optionally getSpawnPlacement. Usually you don't subclass this directly — ru.hukm.effectiveSpigot.minecraft.entities.EffectiveEntityWithSpawnEgg creates one automatically for an entity type.
Functions
Registers a brewing-stand recipe that yields this item.
Registers a click handler for stacks of this custom item (matched by key). To instead handle a plain vanilla Material, register through EffectiveClickable.addClickHandler with a non-custom stack.
Resolves the persistent-data key for the declared additional arg name — use it to read the per-stack value via EffectiveDataContainerUtils. See getAdditionalArgs for the full flow.
Registers a shapeless recipe that yields this item.
Creates a single stack of this item, fully finalized (meta, identity, behaviours).
Creates a stack of amount copies of this item.
Hook run on the finished stack after meta, identity and behaviours are applied.
Configures the stack's meta (name, lore, model, …). Called during every createItemStack.
Whether item is a stack of this item (matched by namespaced key).
Whether effectiveItem is the same registered item as this one.
Declares extra, per-stack parameters this item accepts — values baked into an individual stack's persistent data at creation time, so two stacks of the same item can carry different settings (e.g. a "radius" or "power" tuned per stack).
Namespaced keys backing this item's getAdditionalArgs (key → PDC type), or null if none.
The base Material the item is built from.
Owning plugin and a plugin-unique id; together they form the getNamespacedName.
Unique identity of the item as "<plugin-name>/<id>", both lowercased.
Optional resource-pack texture/model info for this item. When non-null, the framework generates the pack model/texture for it, and createItemStack automatically sets the stack's item_model to <plugin-namespace>:<id> so the custom texture shows — unless editMeta already set one.
The entity type spawned when the egg is used.
Placement of the spawned entity relative to the clicked block (default: vanilla).
Gives this item a durability bar acting as a limited-use counter.
Makes this item throwable: right-clicking launches a snowball carrying the item, and onHit runs when it lands. The projectile is identified by the item stored inside it.
Prevents this item from being dropped, and keeps it in the inventory on death.
Allows this item to be equipped to the head slot (right-click or helmet-slot drag).
Whether the getAdditionalArgs values are appended to the item's lore automatically.