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

# Permissions

## Permissions

| Permission                      | Default | Intended For            | Description                                                                                                                                                                         |
| ------------------------------- | ------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cozytowns.use`                 | `true`  | Players                 | Base permission for CozyTowns player commands, most `/town` subcommands, `/townchat`, `/tc`, and `/allychat`.                                                                       |
| `cozytowns.create`              | `true`  | Players                 | Allows `/town create <name>`.                                                                                                                                                       |
| `cozytowns.info`                | `true`  | Players                 | Allows town information and discovery commands such as `/town list`, `/town top`, `/town finder`, `/town history`, `/town allies`, `/town contracts list`, and `/towns` finder use. |
| `cozytowns.profile`             | `true`  | Players                 | Allows opening town profile menus with `/town profile` and player `/town info`.                                                                                                     |
| `cozytowns.profile.others`      | `true`  | Players                 | Allows opening other towns' profile menus.                                                                                                                                          |
| `cozytowns.profile.teleport`    | `true`  | Players                 | Allows profile menu teleport buttons.                                                                                                                                               |
| `cozytowns.profile.rate`        | `true`  | Players                 | Allows rating towns from profile menus when ratings are enabled.                                                                                                                    |
| `cozytowns.profile.rate.bypass` | `op`    | Server Staff            | Bypasses town profile rating restrictions, such as own-town or member-town rating restrictions.                                                                                     |
| `cozytowns.admin`               | `op`    | Server Staff and Admins | Allows admin commands, `/town reload`, `/townadmin ...`, `/townsadmin ...`, `/towns admin ...`, and staff chat spy.                                                                 |

### Recommended Setup

Players:

* `cozytowns.use`
* `cozytowns.create`
* `cozytowns.info`
* `cozytowns.profile`
* `cozytowns.profile.others`
* `cozytowns.profile.teleport`
* `cozytowns.profile.rate`

Town Staff / Mayors:

* No separate mayor permission is documented in source.
* Mayor-only actions are enforced by town ownership checks, not by extra permission nodes.

Server Staff:

* `cozytowns.profile.rate.bypass`, if staff should bypass profile rating restrictions.
* `cozytowns.admin`, if staff should use admin commands or `/townadmin spy`.

Admins:

* `cozytowns.admin`

### Notes

* The current source does not define wildcard permissions such as `cozytowns.*`.
* Most player-facing town management actions use `cozytowns.use` plus town membership or mayor checks.
* `/town create` uses `cozytowns.create`, not only `cozytowns.use`.
* Town discovery commands generally use `cozytowns.info`.
* Profile menu actions use the `cozytowns.profile` permission family.
* Admin commands use one shared admin permission: `cozytowns.admin`.


---

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