Tested Minecraft Versions:
Wiki | Issues
General Information
ArmorStandPet is a plugin that adds cosmetic pets using armor stands, allowing several different types of pets with different functions, including ones that follow you around and others that stay in place to greet players. There are also many commands you can use to customize the messages that the pets use, as well as tell your pet to perform certain actions. Additionally, there is a suite of admin commands to find, list, remove, and otherwise manage players' pets.
This video demonstrates some basic features of the plugin.
This video is of a more updated version, done by ItsSniper
Pet Types
This is the current list of available pet types. See this page for descriptions of each pet type.
Player Commands
Listed here are the regular commands that can be given to players; see the wiki page for in-depth descriptions.
Admin Commands
These are commands that can be given to admins to help moderate and control pets; see this wiki page for in-depth descriptions.
Configuration
Many limits and default settings can be configured through the configuration file. See this wiki page for further explanations of each setting, although the comments in the config file should suffice.
Permissions
Permissions setup is very important for ArmorStandPet. Please read the explanations here for proper setup.
QuickStart
If you want to get started quickly with the plugin, just drop it in your plugins folder, give yourself the armorstandpet.* permission, and run /aspet help ingame; the ingame instructions should easily set you up with the needy child you've always wanted in your life
Dependencies
Just your choice of permissions handling.
Languages
After you have started your server at least once with the plugin loaded, it generates a lang.yml file in the plugin folder. You can edit this file to change the various messages that users see.
FAQ
Planned Features
I have already been working on this plugin for almost a month, but I decided to push its release forward because of the Mojang server blacklists; ArmorStandPet would be ideal for servers that are looking for cosmetic perks to comply with the EULA. There are plenty of other fun things I want to add, some of which are listed below.
Found a bug? Have suggestions or requests?
Send me a PM, post on the discussion thread, or submit an issue here! If submitting a bug report, please include as many details as possible, including which server version you are using and steps to reproduce the bug. The plugin has been tested most extensively on Spigot 1.8.8, but also verified to work on Spigot 1.9.2, Spigot 1.10.2, Spigot 1.11.2 and Spigot 1.12.
- 1.8
- 1.9
- 1.10
- 1.11
- 1.12
Wiki | Issues
General Information
ArmorStandPet is a plugin that adds cosmetic pets using armor stands, allowing several different types of pets with different functions, including ones that follow you around and others that stay in place to greet players. There are also many commands you can use to customize the messages that the pets use, as well as tell your pet to perform certain actions. Additionally, there is a suite of admin commands to find, list, remove, and otherwise manage players' pets.
This video demonstrates some basic features of the plugin.
This video is of a more updated version, done by ItsSniper
Pet Types
This is the current list of available pet types. See this page for descriptions of each pet type.
- Needy Child
- Doorman
- Silly Walker
- Demon
Player Commands
Listed here are the regular commands that can be given to players; see the wiki page for in-depth descriptions.
- /aspet call
- /aspet insult <player>
- /aspet say <message>
- /aspet tell <player> <message>
- /aspet ditch
- /aspet delete
- /aspet sit
- /aspet hug <player>
- /aspet name <name>
- /aspet speed <speed>
- /aspet goto [x y z]
- /aspet greetrange <range>
- /aspet where
- /aspet help
- /aspet insults
- /aspet announces
- /aspet greetings
- /aspet reset
- /aspet attr <arms|baseplate|visible|small> [on|off]
Admin Commands
These are commands that can be given to admins to help moderate and control pets; see this wiki page for in-depth descriptions.
- /aspetadmin list
- /aspetadmin near [radius]
- /aspetadmin tp <player>
- /aspetadmin killp <player> [world]
- /aspetadmin unbindp <player> [world]
- /aspetadmin killr <radius>
- /aspetadmin unbindr <radius>
- /aspetadmin transfer <source> <target> [world]
- /aspetadmin reload
- /aspetadmin help
Configuration
Many limits and default settings can be configured through the configuration file. See this wiki page for further explanations of each setting, although the comments in the config file should suffice.
Permissions
Permissions setup is very important for ArmorStandPet. Please read the explanations here for proper setup.
QuickStart
If you want to get started quickly with the plugin, just drop it in your plugins folder, give yourself the armorstandpet.* permission, and run /aspet help ingame; the ingame instructions should easily set you up with the needy child you've always wanted in your life
Dependencies
Just your choice of permissions handling.
Languages
After you have started your server at least once with the plugin loaded, it generates a lang.yml file in the plugin folder. You can edit this file to change the various messages that users see.
FAQ
Why doesn't anything happen when I try to click on an armor stand?
Make sure you're not holding anything in your hand and that you are crouching. If you still don't get anything, make sure that you have the armorstandpet.use permission.
Why is the GUI empty when I open it?
This means that you don't have access to any of the pet types. Check that you have the appropriate pet type permissions, such as armorstandpet.type.needychild. If you're sure that you have those right, check that the types are enabled in your configuration file.
Why doesn't my pet show up when I restart the server?
For some reason, the chunk loading event is a little odd sometimes on the first load, but if you teleport away and back (to unload and load the chunk) it should appear again.
Make sure you're not holding anything in your hand and that you are crouching. If you still don't get anything, make sure that you have the armorstandpet.use permission.
Why is the GUI empty when I open it?
This means that you don't have access to any of the pet types. Check that you have the appropriate pet type permissions, such as armorstandpet.type.needychild. If you're sure that you have those right, check that the types are enabled in your configuration file.
Why doesn't my pet show up when I restart the server?
For some reason, the chunk loading event is a little odd sometimes on the first load, but if you teleport away and back (to unload and load the chunk) it should appear again.
Planned Features
I have already been working on this plugin for almost a month, but I decided to push its release forward because of the Mojang server blacklists; ArmorStandPet would be ideal for servers that are looking for cosmetic perks to comply with the EULA. There are plenty of other fun things I want to add, some of which are listed below.
- Support for multiple pets per player, as well as limits set through permissions
- Multi-armorstand pets, to make unique shapes and characters
- More silly walks for the Silly Walker
- Customization of commands/messages to execute when clicking on a doorman, possibly a new pet type
- Configuration for bad-word filter, to prevent bad pet names and bad messages using /aspet tell, etc. -- you may not want a doorman at a player's shop screaming f u at everyone
- Options for turning on/off logging for actions
- A "Secretary" pet type similar to the doorman, but sitting instead and different animations
- A "Guard" pet type that patrols a customizable course
- A "Ghost" pet type that walks through walls and flickers
- A "Disobedient Child" pet type that disobeys your commands and throws things at other players
- A friend's list for your pet so it can greet friends in particular
- A GUI and commands to allow changing attributes of the pet, such as size and whether the arms are displayed
- Traits for pets
- Pathfinding >:[
- A better-looking wiki
Github is easy, but a more proper one would be nice
Found a bug? Have suggestions or requests?
Send me a PM, post on the discussion thread, or submit an issue here! If submitting a bug report, please include as many details as possible, including which server version you are using and steps to reproduce the bug. The plugin has been tested most extensively on Spigot 1.8.8, but also verified to work on Spigot 1.9.2, Spigot 1.10.2, Spigot 1.11.2 and Spigot 1.12.