# Breakdown of Denomination Configuration File

### **1. Config Version**

* **Key**: `config-version`
* **Description**: Specifies the version of the denomination configuration file.
* **Default**: `2`
* **Recommendation**: Do not modify unless necessary, as this is used for file upgrades internally.

***

### **2. Basic Information**

#### **Info**

Configurations that define the identity of the denomination.

| Key      | Description                             | Example  |
| -------- | --------------------------------------- | -------- |
| `Single` | The singular name of this denomination. | `"One"`  |
| `Plural` | The plural name of this denomination.   | `"Ones"` |

***

### **3. Options**

#### **Options**

Settings that define the behavior and attributes of this denomination.

| Key            | Description                                                                                 | Example               |
| -------------- | ------------------------------------------------------------------------------------------- | --------------------- |
| `Weight`       | The relative value of this denomination (e.g., 1 for $1, 0.01 for 1 cent).                  | `1`                   |
| `Material`     | The material used for this item.                                                            | `"PAPER"`             |
| `Texture`      | The base64 texture to apply if `Material` is `PLAYER_HEAD`.                                 | `<base64 string>`     |
| `Damage`       | (Optional) The damage value for this denomination's item. Defaults to `0`.                  | `0`                   |
| `Name`         | (Optional) The custom name required for the item to be recognized as the denomination.      | `"One"`               |
| `Lore`         | (Optional) A list of lore lines required for the item to be recognized as the denomination. | `["Line 1"]`          |
| `ModelData`    | (Optional) The custom model data value for this item. Defaults to `0`.                      | `0`                   |
| `Enchantments` | (Optional) A list of enchantments required to recognize the item as the denomination.       | `["sharpness"]`       |
| `Flags`        | (Optional) A list of item flags required to recognize the item as the denomination.         | `["hide_attributes"]` |

***

### **4. Crafting**

#### **Crafting**

Settings for enabling and defining a crafting recipe for this denomination.

| Key         | Description                                                            | Example                        |
| ----------- | ---------------------------------------------------------------------- | ------------------------------ |
| `Enabled`   | Whether crafting is enabled for this denomination.                     | `false`                        |
| `Shapeless` | Whether the crafting recipe is shapeless.                              | `false`                        |
| `Amount`    | The amount of the denomination produced by the recipe.                 | `1`                            |
| `Materials` | A list of materials for crafting, mapped by character.                 | `["X:GOLD_NUGGET", "Y:PAPER"]` |
| `Recipe`    | A 3x3 grid defining the recipe characters. Use spaces for empty slots. | `[" X ", "XYX", " X "]`        |

***

### Example Denomination File (`one.yml`)

```yaml
config-version: 2

# Configurations relating to basic information about this currency tier.
Info:
  Single: "One"
  Plural: "Ones"

# Various options for this currency tier.
Options:
  Weight: 1
  Material: "PAPER"
  Texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDA0NzE5YjNiOTdkMTk1YTIwNTcxOGI2ZWUyMWY1Yzk1Y2FmYTE2N2U3YWJjYTg4YTIxMDNkNTJiMzdkNzIyIn19fQ=="
  # Optional settings:
  # Damage: 0
  # Name: "One"
  # Lore:
  #   - "example lore"
  #   - "example second line"
  # ModelData: 0
  # Enchantments:
  #   - "example_enchant"
  # Flags:
  #   - "example_flag"

  # Crafting configurations for this currency tier.
  Crafting:
    Enabled: false
    Shapeless: false
    Amount: 1
    Materials:
      - "X:GOLD_NUGGET"
      - "Y:PAPER"
    Recipe:
      - " X "
      - "XYX"
      - " X "
```