Minecraft:Commands/compute: Difference between revisions
From SAS Gaming Wiki
More actions
Sync: updated from Minecraft |
Sync: updated from Minecraft |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{wip}} | {{wip}} | ||
{{Infobox command | {{Infobox command | ||
|name = compute | |name = compute | ||
| Line 9: | Line 8: | ||
== Syntax == | == Syntax == | ||
: {{cmd|compute <CONTEXT> < | : {{cmd|compute <CONTEXT> float <floatProvider> [<scale>]}} | ||
: {{cmd|compute <CONTEXT> < | : {{cmd|compute <CONTEXT> integer <intProvider>}} | ||
: Where {{cd|CONTEXT}} is one of: | : Where {{cd|CONTEXT}} is one of: | ||
:: {{cd|default}} | :: {{cd|default}} | ||
::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_default|{{cd|minecraft:command_compute_default}}]] context, which provides common parameters such as the execution position and {{cd|this}} entity. | ::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_default|{{cd|minecraft:command_compute_default}}]] context, which provides common parameters such as the execution position and {{cd|this}} entity. | ||
:: {{cd|block <pos>}} | :: {{cd|block <pos>}} | ||
::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_position|{{cd|minecraft:command_compute_position}}]] context, providing the block state and block entity | ::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_position|{{cd|minecraft:command_compute_position}}]] context, providing the block state and block entity found at {{cd|<pos>}} alongside the common parameters. | ||
:: {{cd|entity <target>}} | :: {{cd|entity <target>}} | ||
::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_entity|{{cd|minecraft:command_compute_entity}}]] context, providing the selected entity as {{cd|target_entity}}. | ::: Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_entity|{{cd|minecraft:command_compute_entity}}]] context, providing the selected entity as {{cd|target_entity}} alongside the common parameters. | ||
Float providers are evaluated to produce a floating-point value, but a command's {{cd|result}} value can only be an integer, so the actual result is rounded down to the nearest integer before being returned. If {{cd|<scale>}} is specified, the result is multiplied by that before being rounded down, allowing more precision to be returned. Integer providers already produce an integer value, so no scaling is needed. | |||
To store a float without losing any precision, see {{cmd|data modify ... compute ...}} instead, which avoids passing the value through {{cd|result}}. | |||
== Arguments == | == Arguments == | ||
| Line 33: | Line 32: | ||
: {{arg desc|je=entity|amount=single|type=entities}} | : {{arg desc|je=entity|amount=single|type=entities}} | ||
{{argument|provider| | {{argument|floatProvider|context_float_provider}} | ||
: Specifies the [[Minecraft: | : Specifies the [[Minecraft:context float provider]] to evaluate. Can be an [[Minecraft:identifier]] or an inline definition. | ||
: {{arg desc|je= | : {{arg desc|je=context_float_provider}} | ||
{{argument|intProvider|context_int_provider}} | |||
: Specifies the [[Minecraft:context int provider]] to evaluate. Can be an [[Minecraft:identifier]] or an inline definition. | |||
: {{arg desc|je=context_int_provider}} | |||
{{argument|scale|float}} | {{argument|scale|float}} | ||
: Specifies the value by which the provider's result is multiplied | : Specifies the value by which the float provider's result is multiplied. | ||
: If omitted, {{cd|1.0}} is used. | : If omitted, {{cd|1.0}} is used. | ||
: The resulting value is rounded down to the nearest integer after scaling. | : The resulting value is rounded down to the nearest integer after scaling. | ||
| Line 53: | Line 56: | ||
{{Output table}} | {{Output table}} | ||
{{Output table|edition=je|On fail|0|0}} | {{Output table|edition=je|On fail|0|0}} | ||
{{Output table|On success| | {{Output table|cmd=/compute ... float ...|On success|1|1|the computed result, scaled and then rounded down}} | ||
{{Output table|cmd=/compute ... integer ...|On success|1|1|the computed result}} | |||
{{Output table}} | {{Output table}} | ||
| Line 60: | Line 64: | ||
== History == | == History == | ||
{{HistoryTable | {{HistoryTable | ||
|{{HistoryLine| | |{{HistoryLine|java}} | ||
|{{HistoryLine||26.3|dev=snap10|Added {{cmd|link=none|compute}}.}} | |{{HistoryLine||26.3|dev=snap10|Added {{cmd|link=none|compute}}.}} | ||
|{{HistoryLine||26.3|dev=pre1|Adjusted command syntax to match the separation of number providers into int and float providers.}} | |||
}} | }} | ||
Latest revision as of 11:06, 16 October 2026
Template:Wip Template:Infobox command
Evaluates Minecraft:number providers in various Minecraft:loot contexts.
Syntax
- Template:Cmd
- Template:Cmd
- Where Template:Cd is one of:
- Template:Cd
- Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_default|Template:Cd]] context, which provides common parameters such as the execution position and Template:Cd entity.
- Template:Cd
- Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_position|Template:Cd]] context, providing the block state and block entity found at Template:Cd alongside the common parameters.
- Template:Cd
- Runs the provider with the [[Minecraft:Loot context#minecraft:command_compute_entity|Template:Cd]] context, providing the selected entity as Template:Cd alongside the common parameters.
- Template:Cd
Float providers are evaluated to produce a floating-point value, but a command's Template:Cd value can only be an integer, so the actual result is rounded down to the nearest integer before being returned. If Template:Cd is specified, the result is multiplied by that before being rounded down, allowing more precision to be returned. Integer providers already produce an integer value, so no scaling is needed.
To store a float without losing any precision, see Template:Cmd instead, which avoids passing the value through Template:Cd.
Arguments
- Specifies the block whose state and block entity are made available to the number provider.
- Template:Arg desc
- Specifies the entity whose data is made available to the number provider as Template:Cd.
- Template:Arg desc
- Specifies the Minecraft:context float provider to evaluate. Can be an Minecraft:identifier or an inline definition.
- Template:Arg desc
- Specifies the Minecraft:context int provider to evaluate. Can be an Minecraft:identifier or an inline definition.
- Template:Arg desc
- Specifies the value by which the float provider's result is multiplied.
- If omitted, Template:Cd is used.
- The resulting value is rounded down to the nearest integer after scaling.
- Template:Arg desc
Result
Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table
Output
Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table
When the provider has a registered identifier, a successful command also displays its identifier and the computed result. In float mode, if scaling and rounding change the provider's original value, the output also displays the original floating-point value.
History
Template:Navbox new content Template:Navbox commands
Minecraft:de:Befehl/compute Minecraft:ja:コマンド/compute Minecraft:zh:命令/compute