View source for Minecraft:Number provider

<!--#REDIRECT [[Minecraft:Loot table#Number provider]]-->
{{For|a similar data structure used in enchantments|Enchantment definition#Level-based value}}
{{Exclusive|Java}}
{{Update|[[Minecraft:Java Edition 26.3 Pre-Release 1]]}}
{{wip|Add history, better specify the uses, talk about how it depends on the [[Minecraft:loot context]] and how each use defines the context.}}
A '''number provider''' or '''context number provider''' is a data structure used to provide a number, which can be a constant, a random number within a certain distribution, or read from [[Minecraft:scores]] or [[Minecraft:storage]] etc., and mathematical operations or conditional dispatches can be applied. Number providers are used in [[Minecraft:loot table]]s, [[Minecraft:predicate]]s, [[Minecraft:item modifiers]], [[Minecraft:Villager_trade_definition|villager trade]], [[Minecraft:trade sets]], the {{cmd|compute}} command, the {{cd|compute}} operation in the {{cmd|data modify}} command, and by reference in data components ({{DCL|compostable}}, {{DCL|cooking_fuel}}, and {{DCL|brewing_fuel}}).

== JSON definition ==
<div class="treeview">
*{{File|archive|''data pack name''.zip}} or {{File|directory|''data pack name''}}
**{{File|file|[[Minecraft:pack.mcmeta]]}}
**{{File|directory|data}}
***{{File|directory|''namespace''}}
****{{File|directory|context_float_provider}}
*****{{File|file|'''{{ph|name}}.json'''}}
****{{File|directory|context_int_provider}}
*****{{File|file|'''{{ph|name}}.json'''}}
****[[Minecraft:Data pack#Folder_structure|More directories&hellip;]]
</div>

== Use == 

Number providers can be written in-line in [[Minecraft:loot table]]s, [[Minecraft:predicate]]s, [[Minecraft:item modifiers]], [[Minecraft:Villager_trade_definition|villager trade]], and [[Minecraft:trade sets]]. 

They can additionally be registered by a data pack from the {{cd|context_float_provider}} or {{cd|context_int_provider}} [[Minecraft:registry]], and referenced using a [[Minecraft:namespaced identifier]]. References to registered number providers can be used in data components, such as {{DCL|compostable}}, {{DCL|brewing_fuel}} and {{DCL|cooking_fuel}}. Only a constant or [[Minecraft:namespaced identifier]] may be used here, not inline definitions, due to the data structure only being understood server-side.

Number providers can additionally be used in-line or by reference in {{cmd|compute}} and {{cmd|data modify}} to perform operations on data in scoreboards and storage. This is the only way to perform floating-point mathematics with commands.

=== Vanilla context_float_provider registries ===

These are registry context_float_providers used in the vanilla [[Minecraft:data pack]]

{{File|directory|brewing}}: Number providers used in the default component {{Data component link|brewing_fuel.speed_multiplier}}:{{JSON file|speed_default|1.0|desc=}}{{File|directory|cooking}}: Number providers used in the default component {{Data component link|cooking_fuel.speed_multiplier}}
{{JSON file|fast_speed_multiplier|2.0}}{{JSON file|normal_speed_multiplier|1.0}}{{JSON file/cooking|speed_default|"minecraft:cooking/normal_speed_multiplier"|"minecraft:cooking/fast_speed_multiplier"|desc=}}

=== Vanilla context_int_provider registries ===

These are registry context_int_providers used in the vanilla [[Minecraft:data pack]].

{{File|directory|brewing}}: Number providers used in the default component {{Data component link|brewing_fuel.uses}}:{{JSON file|uses_default|20|desc=}}

{{File|directory|compostable}}: Number providers used in the default component {{DCL|compostable}}:
{{JSON file|always_add_one|1}}
{{JSON file|low_medium|{
  "type": "minecraft:number_dispatcher",
  "cases": [
    {
      "condition": {
        "type": "minecraft:match_block",
        "blocks": "minecraft:composter",
        "state": {
          "level": "0"
        }
      },
      "value": 1
    }
  ],
  "default": {
    "type": "minecraft:weighted_list",
    "distribution": [
      {
        "data": 1,
        "weight": 50
      },
      {
        "data": 0,
        "weight": 50
      }
    ]
  }
<nowiki>}</nowiki>}}
{{JSON file|low|{
  "type": "minecraft:number_dispatcher",
  "cases": [
    {
      "condition": {
        "type": "minecraft:match_block",
        "blocks": "minecraft:composter",
        "state": {
          "level": "0"
        }
      },
      "value": 1
    }
  ],
  "default": {
    "type": "minecraft:weighted_list",
    "distribution": [
      {
        "data": 1,
        "weight": 30
      },
      {
        "data": 0,
        "weight": 70
      }
    ]
  }
<nowiki>}</nowiki>}}
{{JSON file|medium_high|{
  "type": "minecraft:number_dispatcher",
  "cases": [
    {
      "condition": {
        "type": "minecraft:match_block",
        "blocks": "minecraft:composter",
        "state": {
          "level": "0"
        }
      },
      "value": 1
    }
  ],
  "default": {
    "type": "minecraft:weighted_list",
    "distribution": [
      {
        "data": 1,
        "weight": 85
      },
      {
        "data": 0,
        "weight": 15
      }
    ]
  }
<nowiki>}</nowiki>}}{{JSON file|medium|{
  "type": "minecraft:number_dispatcher",
  "cases": [
    {
      "condition": {
        "type": "minecraft:match_block",
        "blocks": "minecraft:composter",
        "state": {
          "level": "0"
        }
      },
      "value": 1
    }
  ],
  "default": {
    "type": "minecraft:weighted_list",
    "distribution": [
      {
        "data": 1,
        "weight": 65
      },
      {
        "data": 0,
        "weight": 35
      }
    ]
  }
<nowiki>}</nowiki>}}{{File|directory|cooking}}:  Number providers used in the default component {{DCL|cooking_fuel.burn_time}}:{{JSON file|fast_burn_time_reduction_factor|2}}{{JSON file|normal_burn_time_reduction_factor|1}}{{JSON file|time_bamboo|{
  "type": "minecraft:div",
  "left": 50,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_blaze_rod|{
  "type": "minecraft:div",
  "left": 2400,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_boats|{
  "type": "minecraft:div",
  "left": 1200,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_coal_block|{
  "type": "minecraft:div",
  "left": 16000,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_coal|{
  "type": "minecraft:div",
  "left": 1600,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_dried_kelp_block|{
  "type": "minecraft:div",
  "left": 4001,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_dry_plants|{
  "type": "minecraft:div",
  "left": 100,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_hanging_signs|{
  "type": "minecraft:div",
  "left": 800,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_lava_bucket|{
  "type": "minecraft:div",
  "left": 20000,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_roots|{
  "type": "minecraft:div",
  "left": 300,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wood_blocks|{
  "type": "minecraft:div",
  "left": 300,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wood_items_extra_small|{
  "type": "minecraft:div",
  "left": 100,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wood_items_large|{
  "type": "minecraft:div",
  "left": 200,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wood_items_small|{
  "type": "minecraft:div",
  "left": 300,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wood_slabs|{
  "type": "minecraft:div",
  "left": 150,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}{{JSON file|time_wool_carpets|{
  "type": "minecraft:div",
  "left": 67,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}
{{JSON file|time_wool_slabs|{
  "type": "minecraft:div",
  "left": 50,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}
{{JSON file|time_wool|{
  "type": "minecraft:div",
  "left": 100,
  "right": {
    "type": "minecraft:conditional",
    "condition": "minecraft:block/fast_cooking",
    "on_false": "minecraft:cooking/normal_burn_time_reduction_factor",
    "on_true": "minecraft:cooking/fast_burn_time_reduction_factor"
  }
<nowiki>}</nowiki>}}See {{Slink|Composter|Composting}} for a list of items that use such number providers in the component {{cd|compostable}} by default.
<!--
=== [[Minecraft:Loot table]] ===

In the {{cd|rolls}} and {{cd|bonus_rolls}} fields of pool, a number provider is used. 

<div class="treeview">
* {{nbt|compound}} The root.
** {{nbt|int}}{{nbt|compound|rolls}}: Specifies the number of rolls on the pool.
** {{nbt|float}}{{nbt|compound|bonus_rolls}}: (Optional. Defaults to {{cd|0.0}}). Specifies the number of bonus rolls on the pool per level of luck (including [[Minecraft:Attributes#Attributes_for_players|luck attribute]] and [[Minecraft:Enchantment definition|fishing_luck_bonus]] on fishing tool). Rounded down after multiplying. [[Minecraft:Enchantment definition|Fishing_luck_bonus]] applies only to fishing. In vanilla games, luck attribute is from the [[Minecraft:Luck]] status effect, and [[Minecraft:Enchantment definition|fishing_luck_bonus]] is from the [[Minecraft:Luck of the Sea]] enchantment.
</div>

Loot tables also use fields with, for example, item predicates and item modifiers, which also use number provider.

{| class="wikitable"
! Register
! [[Minecraft:NBT path]]
! type
! Number format
! [[Minecraft:Loot context]]
! Default
! Use
|-
|rowspan="2"| [[Minecraft:Loot table]]
| pools[].rolls
| -
| {{nbt|int}} Int
| The same as the loot table.
| -
| Specifies the number of rolls on the pool.
|-
| pools[].bonus_rolls
| -
| {{nbt|int}} Int
| The same as the loot table.
| {{cd|0.0}}
| Specifies the number of bonus rolls on the pool per level of luck. 
{{cd|count {{=}} rolls + floor(bonusRolls &times; luck)}}
|-
|}

-->

== Format ==
{{Update|section=Integer Number Providers|reason=[[Minecraft:Java Edition 26.3 Pre-Release 1]]}}{{Incomplete section|Floating Point Number Providers}}
A a number provider can be an {{nbt|int}} or {{nbt|float}}. They can either be defined as a constant value or as an object. 

<div class="treeview">
* {{nbt|float}}: Constant number provider.
</div>

Or:
<div class="treeview">
* {{nbt|compound}}: The root tag. Shorthand for a uniform distribution{{Until|Java 26.3}}.
** {{nbt|float}}{{nbt|compound|min}}: Number provider. The minimum value.
** {{nbt|float}}{{nbt|compound|max}}: Number provider. The maximum value.
</div>

Or:
<div class="treeview">
* {{nbt|string}}: Namespaced ID pointing to an element of number provider [[Minecraft:registry]]. See {{Slink||Vanila registries}}.
</div>

Or:
<div class="treeview">
* {{nbt|compound}}: The root tag.
** {{nbt|string|type}}: The number provider type as a [[Minecraft:resource location]]. <!--It can be {{cd|binomial|constant|enchantment_level|environment_attribute|score|storage|sum|uniform|d=comma}},{{cd|conditional}}{{Upcoming|Java 26.3}}, {{cd|number_dispatcher}}{{Upcoming|Java 26.3}}, and {{cd|weighted_list}}{{Upcoming|Java 26.3}}-->.
** Extra fields of the number provider, described below.
</div>

=== Number providers types ===

{{past|n|copy={{nbt|string}}{{nbt|int}}}}
Each type of number provider specifies the rules by which the number will be provided. To do this, they use associated extra contents, which function differently for each type. 

The type values can omit or include the namespace {{cd|minecraft}}, for example using the type {{cd|uniform}} or {{cd|minecraft:uniform}} has the same effect.

Number provider types can ''not'' be customized via data packs.

Each type has two ways to get a number: an [[Minecraft:integer]] or a [[Minecraft:float]]. 

<!--By default, the integer is the float converted to the nearest integer ({{cd|floor(x+0.5)}}). Numbers less than or equal to -2,147,483,648.0 are returned as -2,147,483,648, numbers greater than or equal to 2,147,483,648.0 are returned as 2,147,483,647. However, in many types, there is a specific method for gat a integers.-->

==== Integer Providers ====
These can be used in {{cd|minecraft:context_int_provider}}

===== Abs =====
Returns the absolute value of the input.

<div class="treeview" id="constant" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|abs}}
** {{Nbt|string}}{{nbt|compound|input}}: The number to take the absolute value of

===== Avg =====
The mean of all inputs. Note this rounds towards 0.

* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|avg}}
** {{nbt|list|inputs}}: The numbers to take the mean of
</div>

===== Binomial =====
A random number following a [[Minecraft:w:Binomial distribution|binomial distribution]]. The returned float has the same value as the int.

<div class="treeview" id="binomial" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|binomial}} 
** {{nbt|string}}{{nbt|int}}{{nbt|compound|n}}: Number provider. The amount of trials.
** {{Nbt|string}}{{Nbt|float}}{{nbt|compound|p}}: Number provider. The probability of success on an individual trial.
</div>

===== Conditional =====
Returns the value from {{nbt|string}}{{nbt|int}}{{nbt|compound|on_true}} if its {{Nbt|string}}{{nbt|compound|condition}} is met or {{nbt|string}}{{nbt|int}}{{nbt|compound|on_false}} if not.

<div class="treeview" id="conditional" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|conditional}}
** {{Nbt|string}}{{nbt|compound|condition}}: A '''[[Minecraft:predicate]]''' to test which value will be returned.
** {{nbt|string}}{{nbt|int}}{{nbt|compound|on_true}}: A number provider, which runs if the {{Nbt|string}}{{nbt|compound|condition}} is met.
** {{nbt|string}}{{nbt|int}}{{nbt|compound|on_false}}: (Optional. Default {{cd|0}}) A number provider,  which runs if the {{Nbt|string}}{{nbt|compound|condition}} is not met.
</div>

===== Constant =====
A constant value. 

<div class="treeview" id="constant" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|constant}}
** {{nbt|int|value}}: The exact value.
</div>

===== Sub =====
Subtracts {{nbt|string}}{{nbt|int}}{{nbt|compound|right}} from {{nbt|string}}{{nbt|int}}{{nbt|compound|left}} and then returns that value

<div class="treeview" id="sum" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|sub}}
** {{nbt|string}}{{nbt|int}}{{nbt|compound|left}}: The left of the equation
** {{nbt|string}}{{nbt|int}}{{nbt|compound|right}}: The right of the equation<br />
</div>
===== Uniform =====
A random number following a uniform distribution between two values. The values are inclusive, meaning the provided number can be either {{cd|min}} or {{cd|max}}, except if the provided number is a float, in which case it must be strictly less than {{cd|max}}. If {{cd|max}} &le; {{cd|min}}, the provided number is {{cd|min}}.

<div class="treeview" id="uniform" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|uniform}}
** {{past|n}}{{nbt|compound|min}}: Number provider. The minimum value ({{cd|min}}).
** {{past|n}}{{nbt|compound|max}}: Number provider. The maximum value ({{cd|max}}).
</div>

===== Score =====
To query and use a [[Minecraft:scoreboard]] value.
<div class="treeview" id="score" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|score}}
** {{Nbt|string}}{{nbt|compound|target}}: To choose which player name or entity UUID to query. (Must be an object unless specifying an entity from loot context using the same options as {{nbt|string|target}})
*** {{nbt|string|type}}: Set to {{cd|fixed}} to manually specify a player name or UUID. Set to {{cd|context}} to use an entity from loot context.
*** {{nbt|string|name}}: Included only if {{nbt|string|type}} is set to {{cd|fixed}}. Specifies the name of the player, or the entity's [[Minecraft:Universally unique identifier|UUID]] <small>(in hypenated hexadecimal format)</small> whose score to query.
*** {{nbt|string|target}}: Included only if {{nbt|string|type}} is set to {{cd|context}}. Specifies an entity from [[#Loot context types|loot context]] to query the score of. Can be {{Loot entity target}}
** {{nbt|string|score}}: The scoreboard objective to query on the selected player name or UUID.
** {{Past|n}}{{Nbt|compound|fallback}}: (Optional. Default {{Code|0}}) The value to return if {{nbt|string|target}} or {{nbt|string|score}} do not exist.
</div>

===== Storage =====
A value in [[Minecraft:command storage]].

<div class="treeview" id="storage" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|storage}} 
** {{nbt|string|storage}}: The [[Minecraft:resource location]] of the storage.
** {{nbt|string|path}}: The [[Minecraft:nbt path]] to the field in storage.
** {{Past|n}}{{Nbt|compound|fallback}}: (Optional. Default {{Code|0}}) The value to return if {{nbt|string|storage}} or {{nbt|string|path}} do not exist.
</div>

===== Enchantment level =====
A value dependent on the level of the [[Minecraft:loot context]] enchantment.

<div class="treeview" id="enchantment_level" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|enchantment_level}}
** {{nbt|string|amount}}: [[Minecraft:Level-based value]] calculating the value based on the enchantment.
</div>

===== Add =====
The sum of multiple value providers

<div class="treeview" id="sum" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|add}} 
** {{nbt|list|inputs}}: List of number providers to sum.
</div>

===== Mul =====
The product of the multiplication of multiple value providers

<div class="treeview" id="product" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|mul}}
** {{nbt|list|inputs}}: List of number providers to multiply.
</div>

===== Min =====
The minimum of multiple value providers

<div class="treeview" id="minimum" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|min}}
** {{nbt|list|inputs}}: List of number providers to compare.
</div>

===== Max =====
The maximum of multiple value providers

<div class="treeview" id="maximum" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|max}}
** {{nbt|list|inputs}}: List of number providers to compare.
</div>

===== Average =====
The average of multiple value providers

<div class="treeview" id="average" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|average}} 
** {{nbt|list|operands}}: List of number providers to average.
</div>

===== Environment attribute =====
Fetches and provides the value of an [[Minecraft:environment attribute]] (that can be represented as a number).

This provider requires a context with an origin position set as long as the environment attribute can vary positionally.

<div class="treeview" id="environment_attribute" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|environment_attribute}} 
** {{nbt|string|attribute}}: An environment attribute ID to fetch.
</div>

===== Number dispatcher =====
Returns the first case which fulfills its condition or the default if none do.

<div class="treeview" id="number_dispatcher" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|number_dispatcher}}
** {{nbt|list|cases}}: A list of cases in the order that the dispatcher will try to execute them.
*** {{nbt|compound}}: A single case:
**** {{Nbt|string}}{{nbt|compound|condition}}: A '''[[Minecraft:predicate]]''' to be tested in this case.
**** {{past|n}}{{nbt|compound|value}}: A number provider, which is executed if the {{Nbt|string}}{{nbt|compound|condition}} is met.
** {{past|n}}{{nbt|compound|default}}: (Optional. Default {{cd|0}}) A number provider, which runs if none of the conditions in {{nbt|list|cases}} are met.
</div>

<div class="treeview" id="conditional" style="margin-block-end: 1em;">
**
</div>

===== Weighted list =====
Returns a value from a distribution of weighted number providers.
<div class="treeview" id="weighted_list" style="margin-block-end: 1em;">
* {{nbt|compound}}
** {{nbt|string|type}}: {{cd|weighted_list}}
** {{nbt|list|distribution}}: Returns a value from a distribution of weighted number providers.
*** {{nbt|compound}}: A single weighted number provider:
**** {{past|n}}{{nbt|compound|data}}: A number provider, which is executed if the weighted number provider is chosen.
**** {{nbt|int|weight}}: A positive integer. Determines how often this weighted number provider is chosen out of all data in the distribution. Weighted number provider with higher weights are used more often. The chance of an weighted number provider being chosen is [this weighted number provider's weight ÷ total weight of all weighted number provider in the distribution]. 
</div>

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.14|dev=18w43a|Added value providers to [[Minecraft:Loot table]]s and their [[Minecraft:Item modifier|functions]]. Types include {{cd|minecraft:constant}}, {{cd|minecraft:uniform}}, and {{cd|minecraft:binomial}}.}}
|{{HistoryLine||1.17|dev=20w46a|Added the {{cd|minecraft:score}} type.|Number providers are now used in [[Minecraft:Predicate]]s.}}
|{{HistoryLine||1.20.5|dev=24w12a|Added the {{cd|minecraft:storage}} type.}}
|{{HistoryLine||1.21|dev=24w18a|Added the {{cd|minecraft:enchantment_level}} type.}}
|{{HistoryLine||26.1|dev=snap1|Added the {{cd|minecraft:sum}} type.|Number providers are now used in [[Minecraft:Villager trade definition]]s and [[Minecraft:Trade set]]s.}}
|{{HistoryLine|||dev=pre1|Added the {{cd|minecraft:environment_attribute}} type.}}
|{{HistoryLine||26.3|dev=snap3|Added the {{cd|minecraft:weighted_list}}, {{cd|minecraft:conditional}}, and {{cd|minecraft:number_dispatcher}} types.|Added the number provider registry, allowing for registration of preset number providers, to be used in place of inline number providers.|Number providers are now used in the {{cd|minecraft:compostable}} [[Minecraft:Data component format|Data component]].|Added vanilla number providers {{cd|minecraft:compostable/low}}, {{cd|minecraft:compostable/low_medium}}, {{cd|minecraft:compostable/medium}}, {{cd|minecraft:compostable/medium_high}}, and {{cd|minecraft:compostable/always_add_one}}.}}
|{{HistoryLine|||dev=snap4|The {{cd|type}} field always needs to be specified explicitly when using an inline number provider (it would previously default to {{cd|minecraft:uniform}}).|Number providers are now used in the {{cd|minecraft:cooking_fuel}} and {{cd|minecraft:brewing_fuel}} [[Minecraft:Data component format|Data components]].|Added vanilla number providers {{cd|minecraft:cooking/time_bamboo}}, {{cd|minecraft:cooking/time_blaze_rod}}, {{cd|minecraft:cooking/time_boats}}, {{cd|minecraft:cooking/time_coal}}, {{cd|minecraft:cooking/time_coal_block}}, {{cd|minecraft:cooking/time_dried_kelp_block}}, {{cd|minecraft:cooking/time_dry_plants}}, {{cd|minecraft:cooking/time_hanging_signs}}, {{cd|minecraft:cooking/time_lava_bucket}}, {{cd|minecraft:cooking/time_roots}}, {{cd|minecraft:cooking/time_wood_blocks}}, {{cd|minecraft:cooking/time_wood_items_extra_small}}, {{cd|minecraft:cooking/time_wood_items_large}}, {{cd|minecraft:cooking/time_wood_items_small}}, {{cd|minecraft:cooking/time_wood_slabs}}, {{cd|minecraft:cooking/time_wool}}, {{cd|minecraft:cooking/time_wool_carpets}}, {{cd|minecraft:cooking/time_wool_slabs}}, {{cd|minecraft:cooking/speed_default}}, {{cd|minecraft:brewing/speed_default}}, {{cd|minecraft:brewing/uses_default}}.}}
|{{HistoryLine|||dev=snap9|Changed {{cd|minecraft:sum}}: The {{cd|summands}} field was renamed to {{cd|operands}} and now accepts an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd|minecraft:number_provider}} type. Now requires at least one operand. When used in integer mode, integer mode is used for intermediate steps as well.|Added the {{cd|minecraft:product}}, {{cd|minecraft:minimum}}, {{cd|minecraft:maximum}} and {{cd|minecraft:average}} types.}}
|{{HistoryLine|||dev=Pre-Release 1|Number provider types and values have been split into separate registries for integer and float calculations.
|Renamed the following number provider types:
* {{cd|minecraft:sum}} to {{cd|minecraft:add}}
* {{cd|minecraft:product}} to {{cd|minecraft:mul}}
* {{cd|minecraft:minimum}} to {{cd|minecraft:min}}
* {{cd|minecraft:maximum}} to {{cd|minecraft:max}}
* {{cd|minecraft:average}} to {{cd|minecraft:avg}}
|The {{cd|minecraft:binomial}} and {{cd|minecraft:score}} types are only available as integer provider types.
|The {{cd|minecraft:enchantment_level}} type is only available as a float provider type.
|All other previously existing types are available as both integer and float provider types.
|Added the {{cd|minecraft:abs}}, {{cd|minecraft:div}}, {{cd|minecraft:mod}}, {{cd|minecraft:negate}}, {{cd|minecraft:pow}}, and {{cd|minecraft:sub}} types as both integer and float provider types.
|Added the {{cd|minecraft:floor_div}}, {{cd|minecraft:floor_mod}}, and {{cd|minecraft:from_float}} integer provider types. These are not available as float provider types.
|Added the {{cd|minecraft:ceil}}, {{cd|minecraft:cos}}, {{cd|minecraft:floor}}, {{cd|minecraft:from_int}}, {{cd|minecraft:length}}, {{cd|minecraft:round}}, {{cd|minecraft:sin}}, {{cd|minecraft:sqrt}}, and {{cd|minecraft:truncate}} float provider types. These are not available as integer provider types.
}}
|{{HistoryLine|||dev=Pre-Release 3|The {{cd|minecraft:mod}} float provider type now uses standard modulus instead of floor modulus, matching the integer variant.|The {{cd|minecraft:pow}} float provider type now causes an error and halts computation when attempting to raise 0 to the power of 0, matching the integer variant.}}
}}

== Navigation ==
[[Minecraft:de:Zahlenanbieter]]
[[Minecraft:fr:Fournisseur de nombre]]
[[Minecraft:ja:ナンバープロバイダー]]
[[Minecraft:lzh:供值器]]
[[Minecraft:zh:数值提供器]]