> For the complete documentation index, see [llms.txt](https://docs.ohalee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohalee.com/products/ultimateoneblock/generators.md).

# Generators

## Example

{% hint style="info" %}
This is an example of a configuration.
{% endhint %}

{% code title="generators.yml" fullWidth="false" %}

```yaml
gui:
  title: "&6&lGenerators"
  date-format: "HH:mm:ss dd/MM/yyyy"
  generators:
    lore:
      - ""
      - "&7Blocks: &d%blocks%"
      - "&7Delay: &d%delay%"
      - "&7Probability: &d%probability%"
      - ""
      - "&7Coords: &d%x%&7, &d%y%&7, &d%z%"
      - "&7Placed At: &d%date%"

generators:
  wood:
    name: "Wooden Generator"
    delay: 1000
    success-probability: 50
    buffer: "COBBLESTONE"
    materials:
      - "OAK_LOG:10"
      - "SPRUCE_LOG:10"
      - "BIRCH_LOG:10"
      - "JUNGLE_LOG:10"
      - "ACACIA_LOG:10"
      - "DARK_OAK_LOG:10"
      - "OAK_PLANKS:10"
      - "SPRUCE_PLANKS:10"
      - "BIRCH_PLANKS:5"
      - "JUNGLE_PLANKS:5"
      - "ACACIA_PLANKS:5"
      - "DARK_OAK_PLANKS:5"
    item:
      material: "OAK_LOG"
      displayName: "&aWooden Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"

  redstone:
    name: "Redstone Generator"
    delay: 3000
    success-probability: 40
    buffer: "COBBLESTONE"
    materials:
      - "REDSTONE_BLOCK:20"
      - "REDSTONE_ORE:80"
    item:
      material: "REDSTONE_BLOCK"
      displayName: "&cRedstone Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"

  prismarine:
    name: "Prismarine Generator"
    delay: 1000
    success-probability: 60
    buffer: "COBBLESTONE"
    materials:
      - "PRISMARINE:30"
      - "PRISMARINE_BRICKS:30"
      - "DARK_PRISMARINE:30"
      - "SEA_LANTERN:10"
    item:
      material: "SEA_LANTERN"
      displayName: "&bPrismarine Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"

  amethyst:
    name: "Amethyst Generator"
    delay: 1000
    success-probability: 40
    buffer: "COBBLESTONE"
    materials:
      - "AMETHYST_BLOCK:25"
      - "BUDDING_AMETHYST:25"
      - "CALCITE:25"
      - "TUFF:25"
    item:
      material: "AMETHYST_BLOCK"
      displayName: "&dAmethyst Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"

  nether:
    name: "Nether Generator"
    delay: 1000
    success-probability: 60
    buffer: "COBBLESTONE"
    materials:
      - "GILDED_BLACKSTONE:20"
      - "BLACKSTONE:40"
      - "NETHER_GOLD_ORE:20"
      - "NETHER_QUARTZ_ORE:20"
    item:
      material: "GILDED_BLACKSTONE"
      displayName: "&4Nether Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"

  dripstone:
    name: "Dripstone Generator"
    delay: 1000
    success-probability: 70
    buffer: "COBBLESTONE"
    materials:
      - "DRIPSTONE_BLOCK:30"
      - "ROOTED_DIRT:20"
      - "MUD:10"
      - "MOSS_BLOCK:20"
      - "ANDESITE:20"
    item:
      material: "DRIPSTONE_BLOCK"
      displayName: "&6Dripstone Generator"
      lore:
        - ""
        - "&7Delay: &b%delay%s"
        - "&7Success Rate: &b%success%%"
```

{% endcode %}

### Fields

Each entry under `generators` defines one generator type (the key, e.g. `wood`, is the id used by `/generator <id>`):

* **name** — display name used in messages.
* **delay** — time between generation attempts, in milliseconds.
* **success-probability** — chance (0–100) that an attempt produces a block.
* **buffer** — the block placed while the generator is on cooldown.
* **materials** — the weighted output pool, one entry per line as "<mark style="color:red;">Material:Weight</mark>". Weights are relative, so a higher number means the material is picked more often.
* **item** — the in-game item players receive for this generator (`material`, `displayName`, `lore`). `%delay%` and `%success%` are replaced in the lore.

## Images

<figure><img src="/files/TwOnWRBUlXkiXgHSqVQx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/LOiF0mBd5OBta26YhAzR" alt=""><figcaption></figcaption></figure>