> For the complete documentation index, see [llms.txt](https://wiki.mypet-plugin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.mypet-plugin.com/player-guide/commands/player-commands.md).

# Player Commands

Player-facing commands and examples.

### Legend

* `<option>` required
* `[option]` optional

Most commands have aliases (example: `/pi`). Prefer aliases.

### Commands

| Command                                      | Description                                    |
| -------------------------------------------- | ---------------------------------------------- |
| [`/mypet`](#mypet)                           | Show available MyPet commands                  |
| [`/petbeacon`](#petbeacon)                   | Open your pet’s beacon window                  |
| [`/petbehavior`](#petbehavior)               | Set your pet’s behavior mode                   |
| [`/petcall`](#petcall)                       | Teleport your pet to you                       |
| [`/petcapturehelper`](#petcapturehelper)     | Toggle CaptureHelper                           |
| [`/petchooseskilltree`](#petchooseskilltree) | Select a skilltree                             |
| [`/petinfo`](#petinfo)                       | Show info about your (or another player’s) pet |
| [`/petinventory`](#petinventory)             | Open your pet’s inventory                      |
| [`/petlist`](#petlist)                       | (TODO) Document this command                   |
| [`/petname`](#petname)                       | Set your pet’s name (supports colors)          |
| [`/petoptions`](#petoptions)                 | Client-side options (healthbar, idle volume)   |
| [`/petpickup`](#petpickup)                   | Toggle item pickup                             |
| [`/petrelease`](#petrelease)                 | Release your pet                               |
| [`/petrespawn`](#petrespawn)                 | Manage paid pet respawn behavior               |
| [`/petsendaway`](#petsendaway)               | Send your pet away (can be called back)        |
| [`/petsettings`](#petsettings)               | (TODO) Document this command                   |
| [`/petshop`](#petshop)                       | Open the pet shop GUI                          |
| [`/petskill`](#petskill)                     | Show skill info for your pet                   |
| [`/petstop`](#petstop)                       | Stop your pet attacking its target             |
| [`/petstore`](#petstore)                     | Store your active pet                          |
| [`/petswitch`](#petswitch)                   | Switch between pets                            |
| [`/pettrade`](#pettrade)                     | Offer your pet to another player               |

***

### mypet

Shows all available MyPet commands.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/mypet
```

***

### petbeacon

Opens the beacon window of your pet.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petbeacon
```

#### Aliases

* `/pbeacon`

***

### petbehavior

Sets your pet’s behavior mode.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petbehavior [mode]
```

#### Modes

* `friendly` (`friend`): pet will not fight, even when attacked
* `normal`: pet acts like a normal wolf
* `aggressive` (`aggro`): attacks everything within 15 blocks of owner
* `farm`: attacks every monster within 15 blocks of owner
* `raid`: like normal, but will not attack players and their minions
* `duel`: attacks other duel pets within 5 blocks

#### Aliases

* `/pb`
* `/petb`

***

### petcall

Teleports your pet to you.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petcall
```

#### Aliases

* `/pc`
* `/petc`

***

### petcapturehelper

Enables/disables the CaptureHelper.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petcapturehelper
```

#### Aliases

* `/pch`

***

### petchooseskilltree

Shows all available skilltrees and lets you pick one for your pet.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petchooseskilltree
```

#### Aliases

* `/pcst`
* `/petcst`

***

### petinfo

Shows details about your pet. You can target another player.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petinfo [username]
```

#### Output

* hit-points
* hunger
* food items
* behavior
* experience
* level
* owner (only when the pet isn’t yours)
* skilltree

#### Aliases

* `/pinfo`

***

### petinventory

Opens your pet’s inventory.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petinventory [playername]
```

#### Notes

* Opening another player’s pet inventory requires admin permissions.

#### Aliases

* `/pi`
* `/peti`

***

### petlist

(TODO) Add the syntax, output, and aliases for `/petlist`.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

***

### petname

Sets the name of your pet.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petname <new-pet-name>
```

<details>

<summary>Color placeholders</summary>

Use placeholders inside the name:

`<black>`, `<darkaqua>`, `<darkblue>`, `<darkgreen>`, `<darkred>`, `<darkpurple>`, `<gold>`, `<gray>`, `<darkgray>`, `<blue>`, `<green>`, `<aqua>`, `<red>`, `<lightpurple>`, `<yellow>`, `<white>`, `<magic>`, `<bold>`, `<strikethrough>`, `<underline>`, `<italic>`, `<reset>`

</details>

***

### petoptions

Client-side options.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petoptions <option> [parameters...]
```

#### Options

* `healthbar`: toggle actionbar healthbar on/off
* `idle-volume <percent>`: set idle sound volume

***

### petpickup

Toggles pet pickup on/off.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Notes

* Requires an inventory with at least one row of slots.

#### Usage

```
/petpickup
```

#### Aliases

* `/pp`
* `/petp`

***

### petrelease

Releases your pet. You will no longer have an active pet.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petrelease [pet-name]
```

***

### petrespawn

Controls paid respawn behavior.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petrespawn [pay|show|auto]
```

#### Notes

* `auto <seconds>` sets the max time you want to pay for.
* Example: `/petrespawn auto 10`. If the pet has 16s respawn time, the plugin waits until 10s remain. Then it respawns if you can pay.

#### Aliases

* `/petr`
* `/pr`

***

### petsendaway

Sends your pet away. You can call it back with `/petcall`.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petsendaway
```

#### Aliases

* `/psa`
* `/petsa`

***

### petsettings

(TODO) Add the syntax, options, and aliases for `/petsettings`.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

***

### petshop

Opens a GUI that shows available pet shops.

#### Usage

```
/petshop [shopname] [player]
```

#### Aliases

* `/petsh`
* `/psh`

#### Notes

* `/petshop` and `/petshop <shopname>` are **player-only** — the console has no shop to open for itself.
* `/petshop <shopname> <player>` opens that shop **for another player**, and *is* usable from the console, from command blocks, and from GUI plugins that dispatch a console command such as `petshop all %player%`. It needs `mypet.command.shop.other` when a player runs it; console and command-block senders are always allowed.
* The target of `/petshop <shopname> <player>` does **not** need `mypet.shop.access.<shopname>` — the sender's permission is the authorization. That is what lets a custom menu open a shop for players who hold no MyPet shop permissions at all. Players opening a shop for themselves still need the access node.
* Shop names are single words (they are also used to build the `mypet.shop.access.<shopname>` permission node).

***

### petskill

Shows info about your pet’s skills.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petskill [playername]
```

#### Notes

* Viewing other players’ pets may require admin permissions.

***

### petstop

Orders your pet to stop attacking its target.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Notes

* Not useful in `farm` and `aggressive` behavior modes.

#### Usage

```
/petstop
```

#### Aliases

* `/ps`
* `/pets`

***

### petstore

Stores your active pet. Retrieve it later via `/petswitch`.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petstore
```

#### Aliases

* `/pstore`
* `/pst`

***

### petswitch

Switch between pets.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/petswitch
```

#### Aliases

* `/pswitch`

***

### pettrade

Offers your current pet to another player.

{% hint style="warning" %}
This command is **player-only**. You cannot run it from the console.
{% endhint %}

#### Usage

```
/pettrade [accept|reject|cancel|a <player name>] <price>
```

#### Notes

* `<price>` is any economy price.

#### Aliases

* `/pett`
* `/pt`


---

# 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, and the optional `goal` query parameter:

```
GET https://wiki.mypet-plugin.com/player-guide/commands/player-commands.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.