> For the complete documentation index, see [llms.txt](https://paw-studio.gitbook.io/paw-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paw-studio.gitbook.io/paw-studio-docs/litedungeon/dungeon-configuration/flags.md).

# 🚩Flags

## Flags

Dungeon flags control specific gameplay mechanics and player actions inside the dungeon.

#### `BREAK_BLOCK`

Controls whether players can break blocks.

#### `PLACE_BLOCK`

Controls whether players can place blocks inside the dungeon.

#### `ENDER_PEARL`

Controls whether players can use Ender Pearls inside the dungeon.

#### `CHORUS_FRUIT`

Controls whether players can use Chorus Fruit inside the dungeon.

#### `NATURAL_REGEN`

Controls natural health regeneration from food.

This does **not** affect regeneration provided by potions or other effects.

#### `USE_COMMANDS`

Controls whether players can use commands while inside the dungeon.

***

### Configure Flags via GUI

Open the dungeon menu:

```
/ldungeon menu
```

Then navigate to:

```
Dungeon → Rule → Setting
```

**Left Click** — Toggle the flag status.

**Q** — Set the permission required to use the flag.

***

### Configure Flags via File

Flags can also be configured directly in the dungeon configuration:

```yml
flags:
  BREAK_BLOCK:
    status: BY_PERMISSION
    flag: BREAK_BLOCK
    permission: vip.1
  PLACE_BLOCK:
    status: DENY
    flag: PLACE_BLOCK
  ENDER_PEARL:
    status: DENY
    flag: ENDER_PEARL
  CHORUS_FRUIT:
    status: DENY
    flag: CHORUS_FRUIT
  NATURAL_REGEN:
    status: DENY
    flag: NATURAL_REGEN
  USE_COMMANDS:
    status: DENY
    flag: USE_COMMANDS
```

#### Flag Statuses

The `status` determines how the flag behaves:

* `ALLOW` — Always allows the action.
* `DENY` — Always prevents the action.
* `BY_PERMISSION` — Allows the action only if the player has the configured permission.

For example:

```yml
flags:
  BREAK_BLOCK:
    status: BY_PERMISSION
    flag: BREAK_BLOCK
    permission: vip.1
```

Only players with the `vip.1` permission can break blocks.