> 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/getting-started/readme.md). # Overview Learn the basics of MyPet MyPet is a Minecraft plugin that allows you to capture almost any mob as your Pet. You can train your Pet to fight with you, collect items, and more. {% hint style="info" %} This guide is **player-facing**. It assumes MyPet is already installed on the server you're playing on. If you are looking to install MyPet on your server, visit the [Setup Guide](https://wiki.mypet-plugin.com/setup-guide/). If MyPet isn't on the server you're playing on, ask an admin! {% endhint %} {% hint style="info" %} This guide assumes that all settings have been left as default on the server you are playing on. Check with the server admins to see if there are any specific changes to the configuration on your sever. {% endhint %} ### Capture a mob as your Pet Before being able to capture a mob, you need to understand its capture requirements. Many mobs have the same capture requirement by default, but there are some exceptions - and server owners can always customize the requirements to better suit their server. #### Pet Capture Helper The easiest way to determine how to capture a mob as a Pet is to use the Pet Capture Helper (`/pch`). When enabled, mobs will display either red or green particles above their head based on whether they meet the requirements for being captured. Striking the mob with a lead (by default) will list the capture requirements in chat. Once captured, your Pet will follow you around wherever you go! ### Skilltrees Skilltrees are what allow your Pet to gain new skills and abilities. Assign your Pet to a skilltree with `/pcst`. It’s an alias of [`/petchooseskilltree`](/player-guide/commands/player-commands.md#petchooseskilltree). Pets gain XP when they kill mobs. They also gain some XP when you kill mobs. ### Equip your Pet Some Pets can hold items or wear armor. * Equip: sneak + right-click your pet with the item. * Remove: sneak + right-click with **shears**. ### Name your Pet Rename your Pet with [`/petname `](/player-guide/commands/player-commands.md#petname). ### Pet behavior Change how your Pet fights with [`/petbehavior`](/player-guide/commands/player-commands.md#petbehavior). Behaviors unlock as your Pet levels based on the Skilltree your Pet has enabled. * **Friendly**: won’t fight, even if attacked * **Normal**: acts like a normal wolf * **Aggressive**: attacks everything within 15 blocks of you * **Farm**: attacks hostile mobs within 15 blocks of you * **Raid**: won’t attack players or their pets * **Duel**: attacks other duel pets within 5 blocks ### Feed your Pet Feed your Pet to keep it alive. Hungry Pets are weaker and deal less damage. Each Pet has specific food. Check it with [`/petinfo`](/player-guide/commands/player-commands.md#petinfo). ### Pet Storage There are two different ways to store a Pet: `/petsendaway` or `/psa` allows you to temporarily send your Pet away (similar to telling a dog to go sit in their kennel.) Your Pet can be recalled with `/petcall`, and while sent away, you cannot capture other Pets. To store a Pet, use `/petstore` or `/pst`. This allows you to capture other Pets while your current Pet is stored. To switch between pets, use `/petswitch` or `/psw`. ### Useful commands * Release a Pet forever: [`/petrelease`](/player-guide/commands/player-commands.md#petrelease) * Stats + food: [`/petinfo`](/player-guide/commands/player-commands.md#petinfo) * Skills overview: [`/petskill`](/player-guide/commands/player-commands.md#petskill) * Behavior: [`/petbehavior`](/player-guide/commands/player-commands.md#petbehavior) * Walking beacon: [`/petbeacon`](/player-guide/commands/player-commands.md#petbeacon) --- # 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/getting-started/readme.md?ask=&goal= ``` `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.