> 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/cozyhomes/permissions.md).

# Permissions

<table><thead><tr><th>Permission</th><th width="200.34375">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>cozyhomes.use</code></td><td><code>true</code></td><td>Allows normal player usage, including <code>/homes</code>, <code>/home</code>, <code>/sethome</code>, and <code>/delhome</code>.</td></tr><tr><td><code>cozyhomes.admin</code></td><td><code>op</code></td><td>Allows CozyHomes admin access. Also grants reload, info, import, and protection bypass as child permissions in <code>plugin.yml</code>.</td></tr><tr><td><code>cozyhomes.reload</code></td><td><code>op</code></td><td>Allows <code>/cozyhomes reload</code>.</td></tr><tr><td><code>cozyhomes.info</code></td><td><code>op</code></td><td>Allows <code>/cozyhomes info</code> and <code>/cozyhomes debug</code>.</td></tr><tr><td><code>cozyhomes.import</code></td><td><code>op</code></td><td>Allows <code>/cozyhomes import essentials</code> and dry runs.</td></tr><tr><td><code>cozyhomes.bypass.protection</code></td><td><code>op</code></td><td>Allows setting and moving homes regardless of CozyHomes protection checks.</td></tr><tr><td><code>cozyhomes.limit.&#x3C;number></code></td><td></td><td>Raises a player's home limit to the matching number. The default config uses the prefix <code>cozyhomes.limit.</code> and checks numbered permissions up to 54. Example: <code>cozyhomes.limit.3</code>.</td></tr></tbody></table>

### Recommended Setup

Players:

* `cozyhomes.use`
* One numbered limit permission if the rank should have more than the default 1 home, such as `cozyhomes.limit.3`

Staff:

* `cozyhomes.info` if they only need to view diagnostics
* `cozyhomes.reload` if they are allowed to reload config/messages

Admins:

* `cozyhomes.admin` for full admin access
* `cozyhomes.import` only if using a narrower permission setup for Essentials imports

### Notes

No wildcard permission such as `cozyhomes.*` or `cozyhomes.limit.*` was documented in the confirmed source files.

The protection bypass permission is configurable in `config.yml`; the default value is `cozyhomes.bypass.protection`.


---

# 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/cozyhomes/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.