Ever teleported somewhere in Minecraft only for your pets to not follow you? I have! The problem is that the server instantly unloads unoccupied chunks, often with your pet in stow! This plugin ensures that all standing pets teleport to you if they ever end up in an unloaded chunk. Handy!

PetTeleport-OG is the TrueOG Network maintained fork of NotAShelf/pet-teleport, which is itself a fork of Chailotl/pet-teleport.

Differences from Upstream

Built for Purpur 1.19.4.
Builds with TrueOG Network live config file.
Adds WorldGuard integration via the pet-teleport region flag.

Usage

Tame your desired pets and the plugin will automatically work when you teleport. There is practically no manual input from the player required. Other than, well, moving around with your pets.

Commands

None!

Permissions

None!

Configuration

Each option is documented inline in config.yml, including what it does and the shipped default value.

# Whether to log pet teleports to the server console.
# Default: true
logPetTeleports: true

# Worlds that pets may or may not teleport to, depending on isBlacklist below.
# Default: [world, world_nether, world_the_end]
worldList:
  - world
  - world_nether
  - world_the_end

# Whether worldList acts as a blacklist.
# false = whitelist mode, so pets may only teleport to worlds in worldList.
# true = blacklist mode, so pets may not teleport to worlds in worldList.
# Default: false
isBlacklist: false

The shipped defaults are a whitelist of the three vanilla worlds (world, world_nether, world_the_end), rather than the sample blacklist (lobby, hub, some_other_world) used by upstream.

WorldGuard Integration

If WorldGuard is installed, PetTeleport-OG registers a pet-teleport state flag you can set per region to gate pet teleports into that region:

/region flag <region> pet-teleport allow
/region flag <region> pet-teleport deny

The flag defaults to allow, so regions without it explicitly set behave exactly as they did before. When set to deny, pets will not be teleported to a player standing inside the region. This only applies when WorldGuard is installed; otherwise PetTeleport-OG continues without region checks.

License

Following the original license, this repository is also licensed under the GPL-3.0 license.