MythicMobs Integration

Configuration, parameters, and syntax for dropping EmakiItem items directly from MythicMobs Drops are given so each example can be copied as-is. Prerequisite: MythicMobs is installed; with it installed, EmakiItem items can be dropped directly from MythicMobs Drops without duplicating them into MythicMobs' own item definitions

Enabling

MythicMobs is an optional dependencies.server entry in paper-plugin.yml. Without MythicMobs installed EmakiItem skips this bridge, and nothing else is affected

Main configuration:

mythicmobs:
  enabled: true
  drops:
    enabled: true
    names:
      - "emakiitem"
      - "ei_item"

Field	Type	Required	Default	Range	Description
mythicmobs.enabled	boolean	No	true	true / false	Master switch for MythicMobs integration. No drops are registered while it is off
mythicmobs.drops.enabled	boolean	No	true	true / false	Whether to register the MythicMobs custom drop
mythicmobs.drops.names	list	No	emakiitem, ei_item	—	Recognised drop names; an empty list falls back to those defaults. Names are normalized (lowercased, spaces to underscores) before matching

How to apply: run /ei reload after editing. Registration happens during plugin enable, so changing mythicmobs.enabled or mythicmobs.drops.enabled requires a server restart. Verification: once applied, a Drop written in the format below makes the mob drop the EmakiItem item when it dies

Custom Drop

Minimal example:

Drops:
  - emakiitem{id=example_item}

With amounts:

Drops:
  - emakiitem{id=example_item;amount=1}
  - ei_item{id=starter_sword;amount=2}

Parameters:

Parameter	Default	Description
id	none (required)	The EmakiItem item id. A missing id, or one that resolves to no definition, skips the drop and logs a warning
amount	1	Base amount. Accepts a number or an expression
amount_formula	%amount% * %drop_amount%	Final amount formula

Variables available in amount_formula:

Variable	Description
%amount%	The base amount after resolving the amount parameter
%drop_amount%	The drop amount multiplier supplied by MythicMobs
%metadata_amount%	The amount from the MythicMobs DropMetadata
%generations%	The MythicMobs DropMetadata generations value
%tick%	The MythicMobs DropMetadata tick value
%id%	The target EmakiItem item id
%drop%	The drop name that actually matched

When amount is not a plain number it is evaluated as an expression first. The variables available at that point are %drop_amount%, %metadata_amount%, %generations% and %tick%

The final amount is floored. A result of 0 or below skips the drop, and anything above the item's maximum stack size is clamped to that maximum

Drop Examples

Always drop one

Drops:
  - emakiitem{id=example_item;amount=1}

Scale with the drop amount multiplier

Drops:
  - emakiitem{id=example_item;amount=1;amount_formula="%amount% * %drop_amount%"}

When MythicMobs passes a drop amount multiplier of 3, three items drop

Boss dropping more per generation

Drops:
  - ei_item{id=starter_sword;amount=1;amount_formula="%amount% + %generations%"}

What the Item Contains

Items produced by the drop match items from /ei give: they go through the same item factory, so random variables, PDC identity, attribute payloads, skill bindings and set membership are all written normally. Items with random elements are re-evaluated on every drop

Difference from the EmakiLevel Drop

Module	Drop type	Effect
EmakiItem	Physical drop	Drops an EmakiItem item
EmakiLevel	Non-physical drop	Produces no item and grants level experience directly

Both can appear in the same Drops list