# World Groups

To allows server owners to manage the worlds where players have the same pet, MyPet uses World-groups to combine different worlds together (or split them up). These groups are managed in the `worldgroups.yml` file.

Changes made to the `worldgroups.yml` file will require a complete server restart. The reload command will not enforce these changes.

## How does it work?

Every world is in a *World-group* and every player can have one active pet per *World-group*, so players can have multiple pets on one server. The pet will switch automatically when the player changes the world and enters another *World-group*.

## How can I disable pets in certain worlds?

Put the world(s) into a new world-group (you can all the group whatever you want, for example `nopets`). Then remove (or don't add) the leash [permissions](/setup/permissions.md) form these worlds. Now no new pets can be created an no pets can enter this world.

## Installation

The plugin will create the default *World-group* configuration file and adds every available world to the `default` *World-group*.

## Configuration

Every world has to be in a *World-group*. You can create as many *World-groups* as you want as long as every world is in just **one** *World-group*.

**Example configuration:** With this configuration every player can have one pet in the normal worlds and one in the nether worlds

```
Groups:
  default:
  - normal
  - 2ndWorld
  nether:
  - normal_nether
  - 2ndWorld_nether
```

## Disable Worlds

You can also disable world where MyPet will not be active. This world cannot be in a world group.The config is also in the worldgroups.yml:

```
Disabled:
- example_world
```


---

# Agent Instructions: 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://wiki.mypet-plugin.de/systems/multiworld.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.