> For the complete documentation index, see [llms.txt](https://wiki.incredibleplugins.com/betterfarming/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/betterfarming/rules/role-flags.md).

# Roles and Role Flags

The roles and their flags can be edited in the `roles.yml` file. These flags can't be toggled in game. However, each farm can set roles for their players.

* **BLOCK\_BREAK**\
  Allow a role to break non-harvestable blocks. In the current plugin code, non-harvestable block placement inside a farm is checked through this flag as well.\
  *Toggle permission: betterfarming.role.setting.block\_break*\
  *Bypass permission: betterfarming.bypass.block\_break*
* **BLOCK\_PLACE**\
  Registered as a role flag for block placement. Current placement checks use `PLANT` for harvestable blocks and `BLOCK_BREAK` for other blocks.\
  *Toggle permission: betterfarming.role.setting.block\_place*\
  *Bypass permission: betterfarming.bypass.block\_place*
* **HARVEST**\
  Allow a role to harvest crops.\
  *Toggle permission: betterfarming.role.setting.harvest*\
  *Bypass permission: betterfarming.bypass.harvest*
* **PLANT**\
  Allow a role to plant crops and saplings.\
  *Toggle permission: betterfarming.role.setting.plant*\
  *Bypass permission: betterfarming.bypass.plant*
* **INTERACT**\
  Allow a role to interact with farm-area blocks and open farm storage by right-clicking the farm.\
  *Toggle permission: betterfarming.role.setting.interact*\
  *Bypass permission: betterfarming.bypass.interact*
* **UPGRADE**\
  Allow a role to open the main farm menu and upgrade the farm.\
  *Toggle permission: betterfarming.role.setting.upgrade*\
  *Bypass permission: betterfarming.bypass.upgrade*
* **PLAYER\_SETROLE**\
  Allow a role to set roles for players that have a lower role.\
  *Toggle permission: betterfarming.role.setting.player\_setrole*\
  *Bypass permission: betterfarming.bypass.player\_setrole*
* **PLAYER\_TRUST**\
  Allow a role to trust other players.\
  *Toggle permission: betterfarming.role.setting.player\_trust*\
  *Bypass permission: betterfarming.bypass.player\_trust*
* **PLAYER\_UNTRUST**\
  Allow a role to untrust players with a lower role.\
  *Toggle permission: betterfarming.role.setting.player\_untrust*\
  *Bypass permission: betterfarming.bypass.player\_untrust*
* **DELETE**\
  Allow a role to delete the farm.\
  *Toggle permission: betterfarming.role.setting.delete*\
  *Bypass permission: betterfarming.bypass.delete*
* **CONFIGURE**\
  Allow a role to toggle settings of the farm.\
  *Toggle permission: betterfarming.role.setting.configure*\
  *Bypass permission: betterfarming.bypass.configure*