Number Providers

Vanilla Minecraft has an API that provides Number Providers, which are used in Loot Tables, Advancements and other data-driven systems to get numbers. This library provides a few new Number Providers, as well as expanding the system with Item Stack Number Providers and Entity Number Providers, which are Number Providers parameterized with an Item Stack or Entity respectively. They are a numerical equivalent of Predicates (also called Loot Conditions).

---

Context Entity Property

Example:

{
    "type": "petrolpark:context_entity_property",
    "target": "this",
    "value": {
        "type": "petrolpark:experience_level"
    }
}

Targets an entity available in the Loot Context and returns some value from them. target can take these values:

• this - Loot Context Param: minecraft:this_entity. The entity which died (if this is a mob loot table), or the player in most loot tables.
• killer - Loot Context Param: minecraft:killer_entity. The entity which killed the entity that died (if this is a mob loot table)
• direct_killer - Loot Context Param: minecraft:direct_killer_entity. The direct entity that killed this entity (for example, direct_killer might be an Arrow Entity where killer was the Player that shot it)
• killer_player - Loot Context Param: minecraft:last_damage_player. The last player to do damage to this entity. Make sure you consult the Minecraft code to know which Loot Parameter corresponds to which entity in each circumstance.

value must be an Entity Number Provider.

---

Tool Property

Example:

{
    "type": "petrolpark:tool_property",
    "value": {
        "type": "petrolpark:count"
    }
}

Gets the tool Item Stack available in the Loot Context and returns some value from them. value must be an Item Stack Number Provider. Note that the minecraft:tool Loot Context Param is not available in some Loot Contexts (such as when an entity is killed, for which you might want to use a Context Entity Property Provider with an Equipment Property Provider to get the mainhand weapon).

---

Group Function Number Providers

This subset of Number Providers perform operations on lists of other Number Providers. They all have a field values which expects an array of other Number Providers (inline constant Number Providers are acceptable). Negative numbers work as expected.

Sum

Example:

{
    "type": "petrolpark:sum",
    "values": [
        1.0,
        2.0
    ]
}

Returns the sum of the return result of all Number Providers in the list (this example: 3.0).

Product

Example:

{
    "type": "petrolpark:product",
    "values": [
        1.0,
        2.0
    ]
}

Returns the product of the return result of all Number Providers in the list (this example: 2.0).

Max/Min

Example:

{
    "type": "petrolpark:max",
    "values": [
        1.0,
        2.0
    ]
}

Returns the maximum (or minimum, with "type": "petrolpark:min") of the return result of all Number Providers in the list (this example: 2.0).

Item Stack Number Providers

Item Stack Number Providers generate numbers based on properties of the Item Stack. Whenever they are used, a valid Item Stack will be available in context, but be aware that this may be empty.

Count

Example:

{
    "type": "petrolpark:count"
}

No fields. Returns the count of the Item Stack.

---

Enchantment

Example:

{
    "type": "petrolpark:enchantment_level",
    "enchantment": "minecraft:sharpness"
}

Returns the level of the given Enchantment on the Item Stack. If the Item Stack does not have that Enchantment it will give 0. The field enchantment must be the valid ID of an Enchantment.

---

Entity Number Providers

Entity Number Providers generate numbers based off of properties of an Entity. Whenever they are used, a valid Entity will be available in context.

Experience Level

Example:

{
    "type": "petrolpark:experience_level"
}

No fields. Returns the Experience Level of the Entity if they are a Player, or 0 otherwise.

---

Equipment Property

Example:

{
    "type": "petrolpark:equipment_property",
    "slot": "mainhand",
    "value": {
        "type": "petrolpark:count"
    }
}

Gets the Item in a slot of an Entity (if they have one) and gets some value from it. slot can be any of mainhand, offhand, feet, legs, chest or head. value must be an Item Stack Number Provider.