Skip to content

Datapack Features

Brian edited this page Sep 19, 2026 · 1 revision

Commands

The /allomancy (/ap) command can be used to:

  • query what powers a player has with /ap get [<targets>]
  • add a power with /ap add <type> [<targets>]
  • remove a power with /ap remove <type> [<targets>]

Where type is either a single metal name (iron), all, or random.

Recipes

Allomancy provides two custom recipe types, allomancy:vial_filling and allomancy:investing. The second is customizable, and controls what happens to an item when it is thrown into liquid Lerasium at the well. Example.

Tags

Allomancy reads many tags to determine certain mod behaviors.

Item tags

  • allomancy:tin_foil_hats: which equipment items protect their wearers from certain kinds of Allomancy
  • allomancy:well_seeking_helmets: which equipment will point the wearer to nearby Wells
  • allomancy:duralumin_pewter_instakill_weapons: which weapons create instant-kill abilities when wielded with pewter and duralumin burning

Additional tags such as allomancy:converts_to_lerasium are used for recipes only.

Entity tags

  • allomancy:killing_charges_earring: which entities are considered targets for the hemalurgy that produces Charged Earrings

Biome tags

  • allomancy:has_structure/well: determines where Wells can spawn

Structure tags

  • allomancy:seekable: determines which structures the items in allomancy:well_seeking_helmets will point to

Item components

The allomancy:flake_storage component can be used to create items that act like the metal vials when consumed.

Item consumption effects

Allomancy adds two on_consume_effects for use with the minecraft:consumable component.

  • allomancy:summon_lightning_on_consume: spawns visual lightning when consumed
  • allomancy:grant_allomancy_on_consume: grants access to the metals in the powers array.

For example, this command will give a nugget that only grants Iron allomancy:

/give @s minecraft:iron_nugget[minecraft:consumable={on_consume_effects:[{type:"allomancy:summon_lightning_on_consume"}, {type:"allomancy:grant_allomancy_on_consume", powers: [iron]}]}]

Advancements

Allomancy provides several custom advancement criteria:

  • allomancy:metal_used_on_entity: allows detecting when a certain metal is used against a certain type of entity
  • allomancy:metal_used_on_player: same, but specific to player targets
  • allomancy:activated_allomancy_block: detects when iron or steel is used on a special block like the Iron Button

Allomancy also provides one hidden, impossible advancement, allomancy:main/dna_entangled. Granting a player this advancement will prevent them from consuming Lerasium nuggets (but not other items with the grant_allomancy_on_consume effect).

Clone this wiki locally