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

# Commands

## Commands

### Player Commands

| Command           | Permission      | Description                                          |
| ----------------- | --------------- | ---------------------------------------------------- |
| `/homes`          | `cozyhomes.use` | Opens the player's homes menu.                       |
| `/home`           | `cozyhomes.use` | Opens the player's homes menu.                       |
| `/home <name>`    | `cozyhomes.use` | Teleports the player to the named home if it exists. |
| `/sethome <name>` | `cozyhomes.use` | Saves a new home at the player's current location.   |
| `/delhome <name>` | `cozyhomes.use` | Deletes one of the player's saved homes.             |

### Admin Commands

| Command                               | Permission                                                                     | Description                                                                                               |
| ------------------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| `/cozyhomes help`                     | `cozyhomes.admin`, `cozyhomes.reload`, `cozyhomes.info`, or `cozyhomes.import` | Shows the admin help lines available to the sender.                                                       |
| `/cozyhomes reload`                   | `cozyhomes.admin` or `cozyhomes.reload`                                        | Reloads config and messages.                                                                              |
| `/cozyhomes info`                     | `cozyhomes.admin` or `cozyhomes.info`                                          | Shows plugin diagnostics, including limits, teleport settings, import settings, and protection status.    |
| `/cozyhomes debug`                    | `cozyhomes.admin` or `cozyhomes.info`                                          | Runs the same info output as `/cozyhomes info`.                                                           |
| `/cozyhomes import essentials dryrun` | `cozyhomes.admin` or `cozyhomes.import`                                        | Previews an Essentials homes import without writing homes.                                                |
| `/cozyhomes import essentials`        | `cozyhomes.admin` or `cozyhomes.import`                                        | Imports Essentials homes without overwriting duplicates. The source recommends running the dry run first. |
| `/homesadmin`                         | `cozyhomes.admin`                                                              | Opens the admin home management menu.                                                                     |

### GUI Actions

In the player homes menu, players can create homes, sort the list, page through homes, teleport to homes, and open home settings.

In a home's settings menu, players can teleport, update the saved location, rename the home, change the icon, favorite or unfavorite it, and delete it.

In the admin menu, admins can view players with saved homes, open a player's home list, left-click a home to teleport to it, and shift-right-click a home to delete it.

### Examples

```
/homes
/home base
/sethome base
/delhome oldbase
/cozyhomes info
/cozyhomes import essentials dryrun
/homesadmin
```


---

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