MythicMobs Integration

With MythicMobs 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	Description
mythicmobs.enabled	Master switch for MythicMobs integration. No drops are registered while it is off.
mythicmobs.drops.enabled	Whether to register the MythicMobs custom drop.
mythicmobs.drops.names	Recognised drop names. Defaults to emakiitem and ei_item; an empty list falls back to those defaults.

Run /ei reload after editing. Registration happens during plugin enable, so changing mythicmobs.enabled or mythicmobs.drops.enabled requires a server restart to take effect.

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

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 are identical to those 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.