> For the complete documentation index, see [llms.txt](https://wiki.incredibleplugins.com/lands/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.incredibleplugins.com/lands/rules-flags-and-gameplay/natural-flags.md).

# Natural Flags

## Natural Flags

Natural flags control land behavior that is not tied to a player role, such as mob spawning, fire spread, water flow, and special admin states.

Players can toggle visible natural flags in their land menu if they have the matching `lands.setting.<flag>` permission and a role that can edit land settings. Server admins can also edit them from `/lands admin menu` for wilderness settings.

## Configuration

Natural flags are configured in `config.yml` under `chunk.land-flags`.

`default_list` sets the natural flags that are enabled for newly created lands.

`display_list` controls which natural flags appear in the player menu. Hiding a flag from this list does not remove it from the plugin. You can still set its default value in config or change it with admin commands.

Changing flag defaults in config requires a reload or restart and only affects new lands, unless you reset existing lands.

## Admin Commands

`/lands admin land <land or *> setflag <flag> <true or false> <visitor>`

Sets a role flag or natural flag in one land, or all lands with `*`.

`/lands admin land <land or *> resetflag <flag or all>`

Resets one flag or all flags back to the values from config and `roles.yml`. Admin lands are skipped when resetting all lands.

Required permissions:

| Command                                 | Permission                           |
| --------------------------------------- | ------------------------------------ |
| Set a flag                              | `lands.admin.command.land.setflag`   |
| Reset flags                             | `lands.admin.command.land.resetflag` |
| Open admin menu for wilderness settings | `lands.admin.command.menu`           |

## Available Natural Flags

| Flag                   | What it controls                                                     | Toggle permission                    |
| ---------------------- | -------------------------------------------------------------------- | ------------------------------------ |
| `ENTITY_GRIEFING`      | Whether entities such as creepers can grief blocks.                  | `lands.setting.entity_griefing`      |
| `TNT_GRIEFING`         | Whether TNT can destroy blocks.                                      | `lands.setting.tnt_griefing`         |
| `PISTON_GRIEFING`      | Whether pistons can push blocks into the land from outside.          | `lands.setting.piston_griefing`      |
| `MONSTER_SPAWN`        | Whether monsters can spawn. Spawner handling depends on config.      | `lands.setting.monster_spawn`        |
| `PHANTOM_SPAWN`        | Whether phantoms can spawn.                                          | `lands.setting.phantom_spawn`        |
| `ANIMAL_SPAWN`         | Whether animals can spawn.                                           | `lands.setting.animal_spawn`         |
| `WATERFLOW_ALLOW`      | Whether water can flow into or inside the land.                      | `lands.setting.waterflow_allow`      |
| `LAVAFLOW_ALLOW`       | Whether lava can flow into or inside the land.                       | `lands.setting.lavaflow_allow`       |
| `FIRE_SPREAD`          | Whether fire can spread in the land.                                 | `lands.setting.fire_spread`          |
| `LEAF_DECAY`           | Whether leaves decay naturally.                                      | `lands.setting.leaf_decay`           |
| `PLANT_GROWTH`         | Whether plants and trees grow.                                       | `lands.setting.plant_growth`         |
| `SNOW_MELT`            | Whether snow and ice can melt.                                       | `lands.setting.snow_melt`            |
| `WITHER_ATTACK_ANIMAL` | Whether withers can damage animals.                                  | `lands.setting.wither_attack_animal` |
| `BLOCK_SPREADING`      | Whether spreading blocks, such as amethyst, can spread in the land.  | `lands.setting.block_spreading`      |
| `COPPER_GOLEM`         | Whether copper golems from other areas can sort chests in this area. | `lands.setting.copper_golem`         |

## System and Admin Natural Flags

These flags exist in source too, but they are not normal player-facing natural flags. Use them only when you intentionally expose them or manage them as an admin.

| Flag                | What it controls                                        | Toggle permission                 |
| ------------------- | ------------------------------------------------------- | --------------------------------- |
| `TITLE_HIDE`        | Hides land enter and leave title messages for the land. | `lands.setting.title_hide`        |
| `REQUEST_ACCEPT`    | Automatically accepts land join requests.               | `lands.setting.request_accept`    |
| `EXPIRATION_SHIELD` | Prevents the land from being removed by expiration.     | `lands.setting.expiration_shield` |
| `PEACEFUL`          | Prevents the land from taking part in wars.             | `lands.setting.peaceful`          |

## War Interaction

`wars.yml` has `land-flags_list`. Flags in that list are enabled for lands during war. For example, if you want TNT damage during wars, add `TNT_GRIEFING` there. If you also want players to ignite TNT, configure the matching role flag in `invading.flags.role-flags_list`.