What Is PetStore and Why Your Minecraft Server Needs It
Managing tamed animals on a Minecraft server can quickly become chaotic without the right tools. Wolves, cats, parrots, and horses often end up with the wrong owner after a player leaves or during server events. PetStore is a focused Bukkit/Spigot plugin that gives players and operators complete control over pet ownership transfers. Instead of relying on clumsy workarounds, you can directly reassign a tamed animal, set it up for adoption, or even sell it using an economy plugin.
Core Purpose and Project Scope
PetStore does one thing exceptionally well: it changes the owner of a tamed animal. It does not provide pet protection, anti-theft measures for horses, or the ability to turn non-tameable mobs into pets. That deliberate simplicity keeps the plugin lightweight and compatible with other anti-grief solutions you may already use. If you need to stop players from stealing horses, pair PetStore with a land-claim or protection plugin. If you want to modify animal attributes or create custom pets, there are other plugins for those jobs.
Key Features at a Glance
- Direct transfer: Hand over a pet to another online player instantly.
- Giveaway mode: Mark an animal so the first player who right-clicks it claims ownership.
- Pet sales: Set a price and let players buy tamed animals with a Vault-compatible economy plugin.
- Release to wild: Remove ownership entirely, making the animal wild again.
- Instant taming: Staff can tame any tameable mob with a single command.
- Flags integration: Control where transfers, sales, and releases are allowed using region flags.
- Automatic updates: The plugin can check for new versions and optionally download and install them on server reload.
When you run a server that uses multiple plugins, ease of management matters. For client-side mods that enhance your gameplay experience, you might also appreciate how simple it is to get started with the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, streamlining your entire setup without hunting for files manually.
Commands and How to Use Them
All PetStore actions start with the /petstore command (or its alias /pet). After typing a command, you usually need to right-click the target animal to complete the action. Here is the full list:
- /petstore transfer <PlayerName> — Immediately changes the pet's owner to the specified online player.
- /petstore give — Marks the pet for giveaway. The next player who right-clicks it becomes the new owner.
- /petstore sell <Price> — Puts the pet up for sale. A buyer right-clicks and pays the set amount (requires Vault).
- /petstore release — Removes ownership, returning the animal to a wild state.
- /petstore tame — Instantly tames a tameable mob without the usual feeding process.
- /petstore cancel — Cancels an active give or sell state on an animal.
- /petstore reload — Reloads the plugin's YAML data files without restarting the server.
- /petstore save — Forces an immediate save of all pet data to disk.
The give and sell commands are perfect for server shops or community adoption events. The transfer command is ideal when a player wants to gift a beloved wolf to a friend. Staff members can use tame and release to quickly resolve disputes or clean up abandoned animals.
Permissions and Access Control
PetStore uses a straightforward permission system. Each main command has a corresponding permission node:
- petstore.transfer
- petstore.give
- petstore.sell
- petstore.release
- petstore.tame
- petstore.reload
- petstore.save
The first four are granted to all players by default (true). The tame, reload, and save permissions are operator-only (op). There is also an admin permission petstore.admin that bypasses ownership checks for all commands, and petstore.notifyupdate (op) that alerts staff when a new plugin version is available. Under the hood, technical permissions like petstore.command and petstore.cancel are inherited automatically, so you never need to assign them manually.
Flags Integration for Area Control
If you run the Flags plugin on your server, PetStore automatically registers four custom flags that let you toggle specific actions in protected regions:
- SellPet (default: true)
- GivePet (default: true)
- ReleasePet (default: true)
- TransferPet (default: true)
Setting any of these to false inside a WorldGuard region, for example, prevents that action there. This is incredibly useful for spawn areas where you might want to block pet sales but still allow giveaways. Only the base Flags.jar is required; other Flags modules are optional.
Update Checking and Maintenance
PetStore can automatically check for updates and even download them for you. In the configuration, set Check to true to enable update checks. If Download is false, players with the notify permission will see a message when a new version is available. If Download is true, the plugin fetches the update and installs it the next time the server reloads. While the downloaded update is pending, staff receive repeated reminders. The ServerModsAPIKey field is optional but can be provided to authenticate with BukkitDev; it is never shared with the plugin author.
Because PetStore stores all data in YAML files, the /petstore save command is a handy way to force a write to disk before a planned restart. The reload command picks up any manual edits you might make to those files without a full server reboot.
Conclusion
PetStore fills a very specific niche: changing pet ownership on a Minecraft server without bloating your plugin list. Its command set is intuitive, permissions are clear, and the optional Flags integration gives you fine-grained control over where trades and releases happen. Whether you run a small survival world or a large economy-driven server, PetStore helps keep animal companions in the right hands. Pair it with a solid protection plugin to prevent theft, and you have a complete pet management solution that respects your server's existing ecosystem.