Dollars¶

Dollars are a technology which allows you to use simple mathematical expressions when applying data.

Introduction¶

In your recipe output's and recipe remainder's data objects you may use dollar notation on every property.

Dollars are noted as string values on your desired attributes:

"data": {
    "Damage": "$ ...",
    "other": "normal value"
}

A dollar is a mathematical expression with +, -, *, / and % (modulo) operators as well as parentheses supported.

Data Types¶

Since version 2.0 Dollars are data type aware.

Existing data types are:

• String literals are text values like "test" (with quotes) or 'abc' (with apostrophes).
• Numeric values:
  • Integral values: whole numbers. Nbt Crafting will choose the integer type by default
    • Byte - holds integral values from 0 to 255
    • Short - holds integral values from ca. -32k to 32k
    • Integer - holds integral values from -2 billion to 2 billion
    • Long - holds bigger integral value
  • Floating point numbers: numbers with decimal positions. Nbt Crafting will choose the double type by default
    • Float - has fewer decimal positions
    • Double - is more precise
• Booleans: Can have two states - true or false; Note that these get converted to bytes for nbt data.
• Lists: collection of values - Even if JSON allows different data types, nbt will crash when a mixture of data types is present in a list. Uses square brackets ([]) in JSON.
• Compounds: Also called objects, maps or dictionaries in other languages. These contain "key" -> value pairs of data. Uses curly braces ({}) and colons (:).

References¶

A key feature of dollars is referencing the nbt data of ingredients. This can be done by referencing the ingredient with it's id. The id depends on the type of the recipe - a lot of the recipe types use base and ingredient for the respective ingredients. Shaped and shapeless recipes are a notable exception to this (As they have more than two ingredients, lol).

A full list of all reference ids for the recipe types can be found here.

Operators¶

Overview¶

Priority	Operator	Description	Example
1	#	Type casting	(5.0/2.0)#i=2
1	.	Compound child access	base.Damage
1	[0]	List element access	list[0]
2	*	Multiplication	2*3=6
2	/	Division	7/2.0=3.5
3	+	Addition	2+3=5
3	-	Subtraction	2-3=-1
4	?...:	Conditions	1?"true":"false"

Type casting¶

Used to convert between data types.

Usage is like <value>#<type-id> where <type-id> is one of the following:

• a or S for strings
• b or c for bytes
• s for shorts
• i for integers
• l for longs
• f for floats
• d for doubles
• B for booleans

Cut decimals of number:

(5.0 / 2.0)#i

Convert number to string:

(5.0)#S

Compound child access¶

Used to access a value with a known name. Also see the similar list access operator.

Based on the following nbt you could use bla.bla.test to access the value 123:

{
    "bla": {
        "bla": {
            "test": 123
        }
    }
}

List element access¶

Like compound child operators you can use square brackets to access anything in a list/object.

The typical usage is to provide a number (e.g. [1]) to access the elements of a list. In the following nbt you could access the string "giraffe" using the dollar expression animals[0].name:

{
    "animals": [
        { "name": "dog", "sound": "woof" },
        { "name": "giraffe", "sound": "slurp" },
        { "name": "pig", "sound": "oink" }
    ]
}

You can also give it a string or even pump in an expression that evaluates to a string to access properties like with the list access operator. The important difference is that with this operator you can dynamically access values where-as the .-operator is based on a hard name.

Arithmetic operators¶

There is not too much to say about arithmetic operators with numbers. They basically work as you would expect. One thing to know is that concerning data types, they'll always chose the biggest data type provided to the operator (3 + 4.0 = 7.0).

Where it gets interesting is using arithmetic operators for string operations:

• +: Will concatenate a string with any given value
• -: Will convert the second value to a string and then remove it from the base string.
• *: If the second operator is a number, this operator will repeat the first string that number of times.
• /: This operator will count all occasions of the second string in the first one.

Conditions¶

Like in many programming languages, dollars support the well known and loved ternary operator.

The ternary operator, or condition operator, consists of two symbols and three expression around them.

A ? B : C

It basically checks whether A is true or anything near true (mostly anything that isn't zero or empty). Based on that the whole expression evaluates either to B or C.

Nbt merging/inheriting¶

This part was former part of this page but because I largely expanded it I decided to give it it's own page. See Nbt merging.

Dynamic stack count¶

See experimental features.

Example¶

The following provides a way of slowly converting a wooden sword to sticks via dollars and recipe remainders.

{
    "type": "crafting_shapeless",
    "ingredients": [
        {
            "item": "minecraft:wooden_sword",
            "remainder": {
                "item": "minecraft:wooden_sword",
                "data": {
                    "Damage": "$ i0.Damage + 2"
                }
            }
        }
    ],
    "result": { "item": "minecraft:stick" }
}