> For the complete documentation index, see [llms.txt](https://zs0bye.gitbook.io/eluckyblock/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zs0bye.gitbook.io/eluckyblock/plugins/eluckyblock-free/set-up-a-luckyblock.md).

# Set up a LuckyBlock

## Material

```yaml
material: TEXT
```

> **Values you can enter:**
>
> * Material name for Minecraft 1.13+
> * Item Id for Minecraft 1.8+
>
> For the updated list of materials, you can click [HERE](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)!

## Data

```yaml
data: NUMBER
```

> For the list of ids + data 1.8+, click [HERE](https://minecraft-ids.grahamedgecombe.com/)!

{% hint style="warning" %}
This option is OPTIONAL if you are using spigot 1.13+
{% endhint %}

## Particles

```yaml
particles: TEXT
```

> For the updated particle list, click [HERE](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Effect.html)!

## Rewards

```yaml
rewards: TEXT
```

> **Values you can enter:**
>
> * Name of the reward located on rewards.yml

## **Permissions**

```yaml
  permission_required:
    enabled: BOOLEAN
    permission: PERMISSION
    modules:
      chat: BOOLEAN
      title: BOOLEAN
      action: BOOLEAN
    chat: TEXT
    title:
      title: TEXT
      subtitle: TEXT
      fade-in: TICKS
      stay: TICKS
      fade-out: TICKS
    action: TEXT
```

> **Legend of values:**
>
> * BOOLEAN = true / false
> * PERMISSION = LuckyBlock permission (es. luckyblock.exampleVip)
> * TEXT = Text it will send if you don't have permission
> * TICKS = 20 ticks > 1 second (es. 100 ticks equals 5 seconds)

| Placeholders | Description                             | Usage        |
| ------------ | --------------------------------------- | ------------ |
| %prefix%     | Insert situation prefix into config.yml | CHAT, ACTION |

{% hint style="info" %}
If you deactivate the requested permission, you can ignore everything under "enabled"
{% endhint %}

## Deny Pickup

```yaml
  prevent:
    deny_pickup: BOOLEAN
```

> **Legend of values:**
>
> * BOOLEAN = true / false

This option does not allow the block to be dropped once it is broken.

## **Deny Absorb**

```yaml
  prevent:
    deny_absorb: BOOLEAN
```

> **Legend of values:**
>
> * BOOLEAN = true / false

This option does not allow in case, if you had put a sponge as "Material", to be absorbed by the water.

{% hint style="warning" %}
This option only supports spigot 1.13+!
{% endhint %}

## Blocked Worlds

```yaml
  prevent:
    blocked_worlds:
      type: VALUE # BLACKLIST or WHITELIST
      worlds:
        - TEXT
```

> **Legend of values:**
>
> * VALUE = Here you have to enter the type of prohibition, you can enter only one of these 2 values: BLACKLIST, WHITELIST
> * TEXT = Here you have to enter the name of the world you want to blacklist / whitelist

## Blocked Regions

```yaml
  prevent:
    blocked_regions:
      type: VALUE
      regions:
        - TEXT
```

> **Legend of values:**
>
> * VALUE = Here you have to enter the type of prohibition, you can enter only one of these 2 values: BLACKLIST, WHITELIST
> * TEXT = Here you have to enter the name of the region you want to blacklist / whitelist

{% hint style="warning" %}
To use this option, you need to activate "WorldGuard" on Hooks! In the config.yml
{% endhint %}