![[SimplePetsAddon] Residence Addon](https://cdn.modrinth.com/data/bpOB60Kn/ac39a5147b6016368c876f64d8d2701cf21bb527.jpeg)
[SimplePetsAddon] Residence Addon
Hooks into Residence so that you can stop specific pet events in selected areas
What is this addon?
This is a SimplePets Addon that allows server owners/admins to utilize custom Residence flags that will allow for pets to have some restrictions in certain regions.
Plugin/Resource Links:
- SimplePets (REQUIRED)
- Residence (REQUIRED) (At least v5.0.1.6)
What Features does it have?
- New flag "allow-pet-spawn"- 
This is used when the player tries to spawn a pet (Default is set to allow) 
 
- 
- New flag "allow-pet-enter"- 
This is used a pet tries to walk into the region (Default is set to allow) 
 
- 
- New flag "allow-pet-mounting"- 
This is used the player tries to mount the pet (Default is set to allow) 
 
- 
- New flag "allow-pet-riding"- 
This is used when the player tries to ride the pet in the region (Default is set to allow) 
 
- 
How to install:
The addon can be installed a few different ways it can be done via the install command, via the GUI installer, or manually
Install via Command: (Easiest)
- Simply type the /pet addon install Residencecommand It will also attempt to load and enable it
Install via GUI Installer:
- Run the /pet addoncommand
- Click the Install Addonsitem that is in the bottom row of the GUI
- Locate the Residenceitem in the GUI
- Once found simply click it
NOTE: If it gets stuck saying "Installing..." then check your console for any errors, If there are none then try one of the other methods.
Install Manually:
- Open the SimplePets plugin folder
- Open the Addonsfolder (If the folder is not there then simply create one)
- Download the addon from one of the download locations
- Drop the addons jar file into the Addonsfolder
- Restart your server (This is to actually get the addon loaded into the plugin)
Default Config:
# What should the bypass permission be set to?
bypass-permission: pet.residence.bypass
checks:
  spawning:
    flag:
        # What should the flag for spawning a pet in a residence be named?
        name: 'allow-pet-spawn'
        # What should the default value of the flag be?
        default-value: true
        
    # Should the addon check when a pet is spawned?
    enabled: true
    # This message is only visible when you hover over the 'pet failed to spawn' message
    # You can make this blank or 'null' if you want no message
    reason: '&cYour pet is not able to be spawned in this area'
  mounting:
    flag:
        # What should the flag for mounting a pet in a residence be named?
        name: 'allow-pet-mounting'
        # What should the default value of the flag be?
        default-value: true
        
    # Should the addon check when the player mounts the pet?
    enabled: true
    # Should the pet be removed or should it just be canceled?
    remove-pet: true
  moving:
    flag:
        # What should the flag for when a pet is walking in a residence be named?
        name: 'allow-pet-enter'
        # What should the default value of the flag be?
        default-value: true
        
    # Should the addon check when a pet moves?
    enabled: true
    # Should the pet be removed or should it just be canceled?
    remove-pet: true
  riding:
    flag:
        # What should the flag for is riding their pet in a residence be named?
        name: 'allow-pet-riding'
        # What should the default value of the flag be?
        default-value: true
        
    # Should the addon check when the pets owner is riding it?
    enabled: true
    # Should the pet be removed or should it just be canceled?
    remove-pet: true
    # Should the player be dismounted (if remove-pet is set to true this is ignored)?
    dismount: true