> For the complete documentation index, see [llms.txt](https://docs.cozycrafters.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cozycrafters.net/plugin-docs/cozyclaims/permissions.md).

# Permissions

## Permissions

<table><thead><tr><th>Permission</th><th width="107.15234375">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>cozyclaims.use</code></td><td><code>true</code></td><td>Allows use of the main CozyClaims menu with <code>/claims</code>.</td></tr><tr><td><code>cozyclaims.admin</code></td><td><code>op</code></td><td>Allows CozyClaims admin commands and access to the admin menu.</td></tr><tr><td><code>cozyclaims.tool</code></td><td><code>true</code></td><td>Allows use of the Claim Tool button.</td></tr><tr><td><code>cozyclaims.claims.view</code></td><td><code>true</code></td><td>Allows viewing the player's own claims in the GUI.</td></tr><tr><td><code>cozyclaims.blocks.view</code></td><td><code>true</code></td><td>Allows viewing the player's claim block information.</td></tr><tr><td><code>cozyclaims.trust.manage</code></td><td><code>true</code></td><td>Allows opening trust management for manageable claims.</td></tr><tr><td><code>cozyclaims.trust.add</code></td><td><code>true</code></td><td>Allows adding trusted players through CozyClaims.</td></tr><tr><td><code>cozyclaims.trust.remove</code></td><td><code>true</code></td><td>Allows removing trusted players through CozyClaims.</td></tr><tr><td><code>cozyclaims.teleport</code></td><td><code>true</code></td><td>Allows teleporting to the player's own or accessible claims through the GUI.</td></tr><tr><td><code>cozyclaims.borders</code></td><td><code>true</code></td><td>Allows showing claim borders through the GUI.</td></tr><tr><td><code>cozyclaims.rename</code></td><td><code>true</code></td><td>Allows renaming own or manageable claims.</td></tr><tr><td><code>cozyclaims.icon</code></td><td><code>true</code></td><td>Allows changing claim icons.</td></tr><tr><td><code>cozyclaims.search</code></td><td><code>true</code></td><td>Allows searching and filtering own claims in the GUI.</td></tr><tr><td><code>cozyclaims.admin.inspect</code></td><td><code>op</code></td><td>Allows inspecting another player's claims. Required for <code>/claimsadmin inspect &#x3C;player></code> and admin inspection flows.</td></tr><tr><td><code>cozyclaims.admin.players</code></td><td><code>op</code></td><td>Allows opening the admin player list.</td></tr><tr><td><code>cozyclaims.admin.teleport</code></td><td><code>op</code></td><td>Allows teleporting to inspected claims from the admin GUI.</td></tr><tr><td><code>cozyclaims.admin.borders</code></td><td><code>op</code></td><td>Allows showing inspected claim borders from the admin GUI.</td></tr><tr><td><code>cozyclaims.flags.view</code></td><td><code>true</code></td><td>Allows viewing claim flags in CozyClaims when the flags integration is available.</td></tr><tr><td><code>cozyclaims.flags.manage</code></td><td><code>true</code></td><td>Allows managing allowed claim flags in CozyClaims when the flags integration is available.</td></tr><tr><td><code>cozyclaims.bans.view</code></td><td><code>true</code></td><td>Allows viewing claim bans through CozyClaims when BanFromClaim is available.</td></tr><tr><td><code>cozyclaims.bans.manage</code></td><td><code>true</code></td><td>Allows banning and unbanning players through CozyClaims when BanFromClaim is available.</td></tr><tr><td><code>cozyclaims.flags.admin</code></td><td><code>op</code></td><td>Allows admin access to claim flag menus. Admin flag view is read-only in the confirmed source defaults.</td></tr><tr><td><code>bfc.ban</code></td><td></td><td>May be required for claim ban actions when <code>banfromclaim.use-player-permissions</code> is enabled.</td></tr><tr><td><code>bfc.unban</code></td><td></td><td>May be required for claim unban actions when <code>banfromclaim.use-player-permissions</code> is enabled.</td></tr><tr><td><code>bfc.list</code></td><td></td><td>May be required for viewing claim ban lists when <code>banfromclaim.use-player-permissions</code> is enabled.</td></tr><tr><td><code>bfc.bypass</code></td><td></td><td>Players with this permission cannot be banned through the CozyClaims BanFromClaim integration check.</td></tr><tr><td><code>gpflags.flag.&#x3C;flag></code></td><td></td><td>May be required to manage a specific GPFlags flag when <code>flags.yml</code> uses player permissions. The source checks both lowercase and original flag names.</td></tr><tr><td><code>gpflags.*</code></td><td></td><td>Wildcard accepted by the CozyClaims GPFlags permission check.</td></tr></tbody></table>

### Recommended Setup

Players:

* `cozyclaims.use`
* `cozyclaims.tool`
* `cozyclaims.claims.view`
* `cozyclaims.blocks.view`
* `cozyclaims.trust.manage`
* `cozyclaims.trust.add`
* `cozyclaims.trust.remove`
* `cozyclaims.teleport`
* `cozyclaims.borders`
* `cozyclaims.rename`
* `cozyclaims.icon`
* `cozyclaims.search`

Staff:

* `cozyclaims.admin.inspect`
* `cozyclaims.admin.players`
* `cozyclaims.admin.teleport`
* `cozyclaims.admin.borders`

Admins:

* `cozyclaims.admin`
* `cozyclaims.flags.admin`

Optional integrations:

* Give `cozyclaims.flags.view` and `cozyclaims.flags.manage` only if GPFlags or GriefPreventionFlags claim flag menus should be available.
* Give `cozyclaims.bans.view` and `cozyclaims.bans.manage` only if BanFromClaim claim ban menus should be available.
* If BanFromClaim player permissions are enabled, also configure `bfc.ban`, `bfc.unban`, and `bfc.list` as needed.
* If GPFlags player permissions are enabled, also configure the needed `gpflags.flag.<flag>` permissions or `gpflags.*`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cozycrafters.net/plugin-docs/cozyclaims/permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.