# Main Page Welcome to the custom mobs wiki! Here you can find all the information about custom mobs! ### Have questions? Pre-sale, support, or just want to talk? Join our support Discord for any type of help! # AdvancedPets UI \[NEW]

* 5 **redesigned** pet **menus** that have been reimagined to **enhance** the user experience. * **Updated graphics and UI**s that create a more immersive plugin experience. * A vast selection of **new icons** that are designed to attract more attention and improve the plugin's aesthetics. * **Designed** with **players** and **donations** in mind, ensuring that the plugin is user-friendly and tailored to players' needs. ### **View it on our website:** [**https://advancedplugins.net/item/AdvancedPets-UI.137**](https://advancedplugins.net/item/AdvancedPets-UI.137) ### **How does this work?** This uses ItemsAdder or Oraxen plugins to apply custom textures to AdvancedPets menus. This is as simple as just installing one of those plugins, adding this pack and custom AdvancedPets configuration - that's it!

Complete guide on how to install with those plugins (or just as a resource pack) is included within the pack files.\ \ **Full installation support is available for customers of this pack on our official AdvancedPlugins discord server, any questions or problems will be answered there.** # Premium Mobs Pack Our exclusive mobs designed to work flawlessly as Mobs and Pets. Premium Mobs Pack currently offers 3 mobs:


Reindeer	deer1.png
Mammoth	mammoth.png
Bear	bear.png

* Each works with **AdvancedMobs, AdvancedPets** and **MiniaturePets** * **Plug and Play** - simply add these models to ModelEngine and our plugins will work with them automatically - no need to configure separate pets. * With **AdvancedMobs**, these mobs already have pre-configured biomes they spawn in and health as well as sounds. * Each have 3 extra-detailed animations: **Walking, Idle, Death**

Premium Mobs Pack uses ModelEngine to implement fantastic 3D models into Minecraft. Learn how to use ModelEngine for free with our plugins: [Model Engine](/supported-plugins/modelengine) ### Available on AdvancedPlugins.net: # Available Pets Whatever your dreams are with pets - you can do that with this plugin. ### Why AdvancedPets? AdvancedPets is the ultimate custom 3D pets plugin. It allows you to create custom pets in-game without any programming knowledge. Pets are integrated with custom abilities, skins and way more. Custom pets do not require any texture packs or resource packs to be installed. ## Available Pets * Dog * Dragon * Giraffe * Gorilla * Monkey * Octopus * Racecar * Raccoon * Robot * Tiger * Turtle * Wyvern (Giant Dragon) Most of the pets are animated out of the box, with abilities and skins. ## **Premium Mobs:** * **Reindeer** * **Bear** * **Mammoth**


Reindeer	deer1.png
Mammoth	mammoth.png
Bear	bear.png

Read more about it here: [**Premium Mobs Pack**](/premium-mobs-pack)**,** store link: [**https://advancedplugins.net/item/Premium-Mobs-Pack.80**](https://advancedplugins.net/item/Premium-Mobs-Pack.80) #### Mobs from our other plugins are interchangeable and all made for that plugin will work with AdvancedPets as well - community has made a ton of custom mobs. # Vanilla Mobs as Pets Use vanilla mobs with AdvancedPets ### Can I give vanilla mob pets to my players? Yes! Since version 2.0.0, vanilla mobs are now supported as pets. ### How to set up a vanilla mob as a pet? Very simple! All you need to do is create a file in AdvancedPets' plugin folder. Go to `your server/plugins/AdvancedPets/customMobs` , you will need to create a file called `.amob`, e.g. `Zombie.amob` and use this format inside:

settings:
  sounds: ZOMBIE
  mobtype: ZOMBIE
  nametagHeight: 0

skins:
parts:

Don't worry about the file extension - it's still a text file but using `.amob` our model format. Set `mobtype` and `sounds` to your vanilla mob's type, then save this file and restart. Here you can find all the proper names for vanilla mobs: # Abilities Guide on abilities with AdvancedPets * Over 60 abilities are built into the plugin. * Equip players with potion effects when pet is active, give potions when attacking, killing, set players on fire, strike lightning - it's your choice ## How to create abilities Start off by creating a file for mob in `plugins/AdvancedPets/abilities` folder, name format should be `.yml`, e.g. `Dog.yml` #### Example Abilities file: ```yaml # Dog Abilities # Pets can give off special abilities to pet owners passively or at events # Effect List: https://ae.advancedplugins.net/enchantments/creating-enchantments/effect-list # Read more here: https://wiki.advancedplugins.net/effects/types description: "Chance to deal more damage to players & mobs" ATTACK: chance: 15 cooldown: 2 effects: - 'ADD_HARM:3 @Other' ``` `description` - text displayed next to pet in /pets menu. Explains what abilities pet has. Under description is where Ability Types follow. Types can be found in [here](https://wiki.advancedplugins.net/abilities/triggers). Full list of effects: #### Setting abilities for pets Abilities can have attributes, such as: * `chance` - chance of ability activating when triggered by owner * `cooldown` - how long after activating ability wont be available (will be on cooldown) #### Placeholders You can assign who ability affects, be it owner (`%owner%`) or other player/entity (`%other%`). This way abilities are given towards the assigned player. *Example*: ```yaml effects: - 'POTION:HASTE:0:20 @Owner' ``` In this example, HASTE potion effect will be given to pet owner for 20 ticks = 1 second. *Another example*: ```yaml effects: - 'LIGHTNING @Other' ``` This example would strike lightning at other entity. E.g. when attacking mobs or players, the **other** entity would be entity getting attacked. ## Placeholders Placeholder list for effects: | Placeholder | Explanation | | ------------ | ------------------------------------------------- | | %owner name% | Inserts pet owner's name | | %other name% | Inserts other person's name (e.g. when attacking) | | | | # Commands All AdvancedPets commands | Command | Example Usage | Description | | ----------------- | -------------------------------------- | ----------------------------------- | | /advancedpets | - | Open Pets Menu | | /ap remove | - | Despawn your current pet | | /ap editor | - | Open Custom Mobs Creator | | /ap reload | - | Reload configuration | | /ap list | - | List all custom pets | | /ap addPet | /ap addpet \ \ | Add a pet to player | | /ap removePet | /ap removePet \ \ | Remove a pet from player | | /ap display | /ap display | Spawns a showcase mob | | /ap clearDisplays | - | Clears showcases in 10 block radius | | /ap setlevel | /ap setlevel \ \ \ | Set player's pet level | You can find all command permissions at [Permissions page](/advancedpets/permissions) # Permissions All AdvancedPets permissions ## Command Permissions | Permission | Command | | ---------------------- | -------------------------------------- | | advancedpets.menu | Command /advancedpets | | advancedpets.remove | Command /ap remove | | advancedpets.editor | Command /ap editor | | advancedpets.reload | Command /ap reload | | advancedpets.list | Command /ap list | | advancedpets.addpet | Command /ap addPet | | advancedpets.removepet | Command /ap removePet | | advancedpets.display | Command /ap display, /ap clearDisplays | ## Pets Permissions | Permission | Usage | | -------------------------- | --------------------------------------- | | advancedpets.pet.\ | Permission to unlock a pet | | advancedpets.skins.\ | Permission to unlock a skin | | advancedpets.rename.colors | Allow usage of color codes in pet names | ## Shop Permissions | Permission | Usage | | ---------------------------- | ------------------------------------------------------------------------------------------------------ | | advancedpets.buy.\ | Unlock a pet to purchase in /petshop (`permissions.enabled` must bet set to true in shopMenu.yml file) | # The AdvancedMobs Wiki

## **A solution to improving the boring Minecraft gameplay** **AdvancedMobs** is the **ultimate addition** to vanilla gameplay. \ **Generate new custom mobs in your world** and change the way Minecraft is played. Fight against new monsters in caves or meet the new, advanced mobs, in your worlds and make farms.\ \ **No mods. No resource packs. No texture packs.**


20+ New Mobs	Add many unique new mobs to your server! Click here to learn all new mobs AdvancedMobs has to offer.	Available Mobs	gif-template2.gif
Custom Mob Mechanics	Our custom mobs act like normal mobs! Learn all about vanilla mechanics we've implemented by clicking here.	Mechanics	gif-template---2.gif
Commands & Permissions	Click here to view all commands and permissions.	Commands
API	Click here to learn how to use AdvancedMobs developer api.	AdvancedMobs API

# Available Mobs Learn about AdvancedMobs, mechanics and mobs. ## Available Mobs * Giraffe * Frog * Demon * Dog * Dragon * Flamingo * Gorilla * Hippo * Monkey * Snail * Octopus * Raccoon * Raptor (Dinosaur) * Robot * Tiger * Duck * Turtle * Wyvern (Legendary Dragon) * Zebra * Panda * Otter (With ModelEngine only) ## **Premium Mobs:** * **Reindeer** * **Bear** * **Mammoth**


Reindeer	deer1.png
Mammoth	mammoth.png
Bear	bear.png

We are including a custom Otter ModelEngine mob in the plugin. It will be located in `/plugins/AdvancedMobs/included` folder. Simply move it to your `ModelEngine/blueprints` folder. ### How to Use ModelEngine models with our plugins? [ModelEngine](/supported-plugins/modelengine) # Commands All AdvancedMobs commands | Command | Permission | Description | | -------------------------------------------- | -------------------- | ----------------------------------- | | /advancedmobs | advancedmobs.use | Show help menu | | /am give \ \ \[amount] \[level] | advancedmobs.give | Give spawners | | /am editor | advancedmobs.editor | Open Custom Mobs Creator | | /am reload | advancedmobs.reload | Reload configuration | | /am list | advancedmobs.list | List all custom pets | | /am mob \ | advancedmobs.mob | Spawn a mob | | /am egg \ \ | advancedmobs.egg | Give a custom mob spawn egg | | /am killAll | advancedmobs.killall | Kill all custom and vanilla mobs | | /am display | advancedmobs.display | Spawns a showcase mob | | /am clearDisplays | advancedmobs.display | Clears showcases in 10 block radius | **<> -> required, \[] -> optional** # Mechanics Learn about all mechanics you can edit with AdvancedMobs here. * **Custom mobs appear in the world just like normal mobs do!** Mobs spawn depending on what biomes they have, if they are hostile (example: only spawn at dark, in caves, etc.) * **Peaceful and hostile mobs!** Hostile mobs will attack players that are in range with realistic damage handling (armor and other modifiers change how much custom mobs deal damage to players) * **Build Bosses With Blocks!** Allow players to build custom mobs with block patterns * **Sounds!** Mobs use selected vanilla sounds for immersive experience * **Breed mobs!** Peaceful mobs can be bred using specified items in config (can be disabled) * **Mobs drop loot!** All mobs drop their own specified loot, and you are able to configure it * **Persistent mobs!** Our custom mobs are persistent and stay after restarts or leaving areas and coming back later. Never worry about leaving your farms and mobs despawning.
# Build Mobs With Blocks Use your own patters to build bosses ## How do block patterns work? Building mobs with block patterns mimics the vanilla feature where Withers, Iron golems or snowmans can be built. Players must make a specific pattern for a mob to spawn - the block pattern disappears. Best explained by this gif:

## How to customize / make your own patterns? You will need to do this all inside `plugins/AdvancedMobs/bosses` folder. If you are customizing an already available pattern, find the file named same as the mob you want to change, otherwise, create a new file called `.yml`, example: `Wyvern.yml` We're going to be customizing a default pattern of Wyvern mob. The inside of file looks like this: {% code title="plugins/AdvancedMobs/bosses/Wyvern.yml" overflow="wrap" lineNumbers="true" %} ```yaml # Boss Configuration file for Wyvern # How to build Wyvern boss build: pattern: - ' e ' - 'idi' - ' d ' materials: e: ENCHANTING_TABLE i: IRON_BLOCK d: REINFORCED_DEEPSLATE ``` {% endcode %} Patterns are very simple to understand. Use empty space to act as an AIR block, otherwise specify material names below the pattern list. As an example, in our file, `e` means ENCHANTING\_TABLE. Here is a visual representation of how this pattern looks:

Because there's 3 lines, and 3 materials in each line, this is a 3x3 pattern. A very basic 2D pattern. You can have as many lines in height or width as you want. # Mob Loot Configure mob loot and toggle it on or off Custom mobs are able to drop extremely configurable loot using mob loot mechanic. ### How to disable loot for a mob? Go into `plugins/AdvancedMobs/drops` folder and find the file name which matches mob's name. Simply **delete the file** and restart! ### How to configure mob loot? In the `drops` folder, you can find all the loot configured for each mob. Find the mob you want to edit (in our case, we'll edit Gorilla's drops). {% code title="drops/Gorilla.yml" overflow="wrap" lineNumbers="true" %} ```yaml # Drops Configuration # Command drops are supported! Set `command: 'your command here'`, %player% placeholder is supported as a player name # Is Looting (Vanilla Enchant) enabled for this mob's drops? lootingEnabled: true # How much exp should the mob drop? exp: 1-3 # This only works for Vanilla mobs, decides whether vanilla drops should be disabled or not disableVanillaDrops: true drops: 0: chance: 45 type: IRON_INGOT amount: 1-2 # List all levels which should have this drop forLevels: 0-19 1: chance: 10 type: IRON_INGOT amount: 1-2 # Only upgraded spawners will have a chance to get this drop forLevels: 1-19 ``` {% endcode %} You can choose whether looting enchantment works with custom mobs, how much experience they drop or if editing vanilla mob's loot, whether vanilla drops work with mobs as well. Now, onto editing the custom drops. Two loot types are possible: **items** and **commands** #### Items You need to follow this item format: For mob to drop loot, you also need to specify for which upgradeLevels this loot will drop. With Gorilla, we can see that the first drop will work on all levels (**forLevels** setting), from **default (0)** all up to 19th level (that is the maximum by default). #### Commands To set a command drop, it's as simple as setting item's drop. Be aware, that this loot will not drop but rather execute upon a mob is killed. Example configuration for commands: {% code title="drops/Gorilla.yml" overflow="wrap" lineNumbers="true" %} ```yaml 1: chance: 10 command: 'broadcast %player% killed a Gorilla!' forLevels: 0-19 ``` {% endcode %} This will execute a command when Gorilla is killed, broadcasting ` killed a Gorilla!` **%player%** - will be replaced with player's who killed, name. # Random Spawning Configure random spawning and toggle it on or off Custom mobs can spawn randomly throughout the world with this mechanic. ### How to disable? Go into `plugins/AdvancedMobs/randomSpawning.yml` file, set `enabled` to false and restart. ### How to change which mobs randomly spawn? In the same file as mentioned above, you will find a list of mobs that can randomly spawn. By default, it looks like this:

# Random Spawn-able custom mobs list
mobsAllowedToRandomSpawn:
  - 'Demon'
  - 'Dog'
  - 'Dragon'
  - 'Flamingo'
  - 'Giraffe'
  - 'Gorilla'
  - 'Hippo'
  - 'Monkey'
  - 'Octopus'
  - 'Raccoon'
  - 'Raptor'
  - 'Robot'
  - 'Tiger'
  - 'Turtle'
  - 'Wyvern'
  - 'Zebra'
  - 'Snail'

To remove a custom mob, just simply remove that entry from list and restart. To add a new one, simply add an entry with your wanted mob's name. ### Add a world in which mobs randomly spawn By default, custom mobs spawn in `"world"` world only. To add new worlds, add an entry to `worldList` setting in randomSpawning.yml file. Below is an example where we add `custom_world` to our list.

# Worlds list for random spawning
#  In what worlds should random custom mobs spawn
worldList:
  - 'world'
  - 'custom_world'

### Change biomes of where custom mobs spawn To do that, go into `plugins/AdvancedMobs/customMobs` folder. Open any of the mobs file you want (the extension is `.amob` but the file acts like a `.yml` file - use your text editor to open it!). Here's how the settings look like for Demon mob: {% code title="customMobs/Demon.yml" overflow="wrap" lineNumbers="true" %} ```yaml settings: health: 40 sounds: WOLF hostile: true nametagHeight: 0.9 damage: 8 animateOnWalking: true animationSmoothness: 5 animationSpeed: 2 biomes: - 'ALL' ``` {% endcode %} You can see the setting called `biomes`. To change biomes, simply add your entry from biome name list - . Adding entry `ALL` will allow the mob to spawn in any biomes. # Breeding Configuring breeding and toggle it on or off Breeding mechanic allows players to breed 2 same type mobs to "create" a new mob of same type. ### How to disable? Go into `plugins/AdvancedMobs/breeding.yml` file and set `enabled` to false, then restart. ### How to change breeding materials or allow new mobs to be bred? In the same file mentioned above, you can customize which mobs can be bread and what material is required. {% code title="breeding.yml" overflow="wrap" lineNumbers="true" %} ```yaml mobs: Dog: BONE ``` {% endcode %} Here we have an example of how Dog mob can be bred. To add your own, simply add a new line and list the mob in this format: `: ` Example: {% code title="breeding.yml" overflow="wrap" lineNumbers="true" %} ```yaml mobs: Dog: BONE CustomMob: STICK ``` {% endcode %} # Mobs & Spawners Stacking Configure stacking and toggle it on or off AdvancedMobs can stack your mobs and spawners - to dramatically increase performance, be it vanilla or custom mobs. Stacking is **disabled** by default. ### How to enable? To enable, go into `plugins/AdvancedMobs/config.yml` file. You will need to find settings called `spawnerStacking` and `mobStacking`. Set both `enabled` to true and restart. ### How does this work You can give your players mob spawners, to spawn vanilla/custom mobs. To save performance, your server's RAM and space, mob spawners and mobs can be stacked. Placing spawners near one another will stack them depending on type and level. Once mobs spawn from these spawners, they will be stacked as well. Killing stacked mobs will have them killed one by one (can be changed to whole stack dying in config). ### Upgrading Spawners (Levels) You can upgrade spawners with this plugin. Plugin has a fully customisable leveling experience - `customMobs/AdvancedMobs/upgrades.yml`. Configure upgrades menu, economy, prices. Each level has configuration of: * Price to upgrade * How many mobs should spawn at once (spawning multiplier to spawn formula) * Spawning time of how often mobs should spawn ### How to customize Spawner Stacking {% code title="config.yml" overflow="wrap" lineNumbers="true" %} ```yaml # Spawner Stacking Settings spawnerStacking: # Is spawner stacking enabled? enabled: false # Maximum number of spawners in a stack maxSpawnersPerStack: 100 # Max distance in which spawners will stack together maxStackDistance: 5; # Number of mobs spawning per spawner mobsPerSpawner: "1-4 * %spawner count% * %upgrades%" # Default spawner spawning speed, in ticks spawnSpeed: 600 ``` {% endcode %} You can change how many spawners are allowed per stack (per one block), stacking distance, formula which is used to calculate how many mobs spawn from spawner and the default spawning speed. ### How to customize Mob Stacking {% code title="config.yml" overflow="wrap" lineNumbers="true" %} ```yaml # Mob Stacking Configuration mobStacking: # Is mob stacking enabled? enabled: false # Should vanilla mobs stack? # If set to false, only custom mobs will stack stackVanillaMobs: true # Max distance in which mobs will stack together maxMobStackDistance: 16 # Maximum number of mobs in a stack maxMobsPerStack: 100 # Should whole stack die when one is killed? wholeStackDeath: false # Stacked Mobs Blacklist # Add any mob type you want here to not stack mobBlacklist: - 'ENDER_DRAGON' ``` {% endcode %} Toggle stacking, set whether vanilla or custom mobs should spawn, distances, max mobs per stack, if whole stack dies and mobs blacklist here. # AdvancedMobs API Learn how to use AdvancedMobs API API class `AdvancedMobsAPI.class` is located in `net.advancedplugins.mobs`. {% hint style="info" %} **`CustomEntityInstance`**` ``matchEntityToCustomMob(UUID u)`\ Match an entity's UUID to a CustomEntityInstance. The entity can be an ArmorStand's UUID {% endhint %} {% hint style="info" %} **`AdvancedSpawner`**` ``matchSpawner(Location loc)`\ Get spawner's information from a location. {% endhint %} {% hint style="info" %} **CustomEntityInstance** spawnCustomMob(String type, Location loc) Spawn a custom entity in a location, type being a string name of custom entity, e.g. Gorilla. {% endhint %} # Available Pets Bring your Minecraft world to life with the cutest and most customizable pets! Welcome to Miniature Pets - the world of enchanting, cuddly creatures that bring joy to your server! Create, customize and bring your own pet friend along for all your adventures. ### Available Pets: * Boxer Dog * Duck * Frog * MiniMe * MP8 Robot * Panda * Pug * Turtle * Tiger * Gorilla MiniaturePets also supports vanilla pets as mobs! All of our pets are interchangeable with other plugins (AdvancedPets & AdvancedMobs) - there are ton of pets combined made for all of these plugins! ## **Premium Mobs:** * **Reindeer** * **Bear** * **Mammoth**


Reindeer	deer1.png
Mammoth	mammoth.png
Bear	bear.png

## Read more about it here: [**Premium Mobs Pack**](/premium-mobs-pack)**,** store link: [**https://advancedplugins.net/item/Premium-Mobs-Pack.80**](https://advancedplugins.net/item/Premium-Mobs-Pack.80) #### # Information Short guides on many MPets mechanics Learn more about MiniaturePets here! Our commands, configurations and more! # Commands & Permissions These are all the Commands & Permissions Miniature Pets utilizes. Please configure your permission manager accordingly. ## Player Commands & Permissions

Command	Permission	Description
/pet	miniaturepets.spawn	Opens the pet GUI.
/pet pet [pet]	miniaturepets.spawn	Spawns a pet directly by pet name.
/pet pet [pet] [player]	miniaturepets.spawnothers	Allows spawning pets for other people
/pet ride	miniaturepets.ride	Ride your spawned pet.
/pet hat	miniaturepets.hat	Puts your pat like a hat!
/pet call	miniaturepets.call	Teleport your pet to you.
/pet sit	miniaturepets.sit	Prevents your pet from following you.
/pet disguise	miniaturepets.disguise	Disguises you as your pet.
/pet remove	miniaturepets.remove	Despawns your pet.
/pet name [name]	miniaturepets.setname	Changes your pet name.
/pet name [colorname]	miniaturepets.setnamecolor	Allows using color codes in pet names.
/pet help	miniaturepets.help	Sends the help menu.
/pet npc [title] [pet]	miniaturepets.npc	Spawns an NPC in the form of a pet. Requires Citizens Integration.
N/A	miniaturepets.allpets	Gives you permission to use all pets installed.

## Administrator Commands & Permissions | Command | Permission | Description | | ---------------------- | -------------------------- | ------------------------------------------------------------------------------------ | | /pet reload | miniaturepets.reload | Reloads the pets and configuration. | | /pet clear \[radius] | miniaturepets.clear | Clears all pets in a distance of five blocks or the specified radius. | | /pet clearall | miniaturepets.clearall | Clears all pets from all worlds. | | /pet dump | miniaturepets.dump | Generates a dump file for support. | | /pet permission \[pet] | miniaturepets.permission | Gives the permission of a specific pet. | | N/A | miniaturepets.checkversion | Sends a message when joining the game if your Miniature Pets version is out-of-date. | # Config.yml Guide Quick Explanation of files ## config.yml

Setting (Directive)	Options	Description
checkForUpdates	true/false	Checks for a newer version of Miniature Pets when logged into your server.
disablePlugin	true/false	Disables the plugin entirely, without the need to uninstall it.
useWorldGuard	true/false	Hook into WorldGuard for region support and additional pet spawning options.
usePackets	true/false	Use packets for some menus to get a nicer display.
useHats	true/false	Allow users with the hat permission to wear pets as hats.
useDisguises	true/false	Allow users with the disguise permission to disguise as a pet.
useRide	true/false	Allow users with the ride permission to ride their pets.
useInteractGUI	true/false	Show pet options when right clicking your pet.
debug	true/false	Shows extra debug output in console.
combatTag	true/false	Use combat tag integration.
petPunch	true/false	Allow pets to be punched.
useHopperGUI	true/false	Use a hopper GUI for the interact menu, instead of a chest.
handlePlayerData	true/false	Save data pertaining to a player's pets.
PetExtraRemoval	true/false	Removes leftover armor stands after a server crash.
runGUIAsync	true/false	Use multithreading to improve GUI efficiency.
perPetName	true/false	Allow and save names per pet a player has, rather than using one name per player.
hideDisguisedPlayers	true/false	Show/hide players disguised as a pet.
respawnOnFallingToVoid	true/false	Respawn pet after falling to void.
animationRefreshRate	Integer	Controls how often pet animations update (lower is faster).
standardizedPermissions	true/false	Standardize permissions to be based on the file name, instead of configurable per pet.
dismountOnWater	true/false	If you should be dismounted when riding a pet into water.
bypassSpawnProtections	true/false	Bypasses most external spawning plugins. May help if pets don't spawn due to a plugin conflict.
minimumPetTeleportRange	Integer	Controls how far a pet has to be before teleported to the owner.
petTeleportCheckSeconds	Integer	Controls how often a pet's distance from its owner should be checked.
disallowDisguiseTeleport	true/false	Disallow teleportation when disguised.
respawnPetOnWorldMove	true/false	Should pets reappear after you change world?
downloadDefaultPetsIfNone	true/false	If true, downloads the default pet pack if your pets folder is empty.
disallowedPetNameWords	List of words introduced by a dash.	Words that should not be allowed in pet names.
respawnPetOnJoin	true/false	Respawn last spawned pet on server join.
petLoadingMessage	true/false	Sends a message on server startup for every pet successfully loaded.
despawnOnGamemodeChangeTo	List of Gamemodes introduced by a dash.	Despawns pet when gamemode is changed to one of the specified ones.
petDistance	Integer	Distance of pet from player at any given moment.
SaveWithUUID	true/false	Use UUID saving (probably not good for offline servers).
PetSpawnDistance	Integer	How far away should pets spawn, when selected?
PetNameLimit	Integer	Controls maximum characters in a pet's name.

# Sql.yml Guide ## sql.yml | Setting (Directive) | Options | Description | | ------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | useMySQL | true/false | Whether to use MySQL or not. Don't enable before you type in your database credentials. | | hostName | String | Database host. In most cases, the default will apply. | | port | String | Database port. Leaving as default is recommended. | | databaseName | String | Database name. | | username | String | Database username. | | password | String | Database password. | | method | String | A feature that's being tested and isn't fully functional. Avoid changing. | | autoReconnect | true/false | If your database disconnects a lot or drops the connection early then it's recommended to turn this on. It helps when you can control your hosting provider's configuration. | | useSSL | true/false | Whether your database connection requires SSL or not. | | tablePrefix | String | Prefix for table. Unless specifically needed, leave as default. | # FAQ Most frequent questions and answers ### How to use ModelEngine together? We have an extensive guide over at [ModelEngine](/supported-plugins/modelengine) page, where you can learn about our integration of ModelEngine. ### Pets Are Unable to Spawn This is usually caused due to WorldGuard configuration. Follow these steps to fix the issue: 1. Open WorldGuard's config.yml file. 2. Edit the directive `block-plugin-spawning` and set it to `false`. 3. That's it! If you're still having issues, please contact support # In-Game Custom Mobs Creator Guide on how to create custom mobs #### Editor Command In-Game: | Plugin | Command | | ------------ | -------------------- | | AdvancedPets | /advancedpets editor | | AdvancedMobs | /advancedmobs editor | Preview of the editor: {% embed url="" %} Video explaining how to use this editor: {% embed url="" %} # Configuration Explanation Find out how you can manually configure parts of mobs from files. ## Setting part items #### Custom Head Texture using AdvancedHeads plugin. How to find head ids: ```yaml advanced-heads: 619 ``` #### Set head as player's head (for pets only): ```yaml headItem: '%PetOwner%' ``` #### How to set item in main hand (right): ```yaml handItem: material:GOLD_SWORD ``` #### How to set item in off hand (left): ```yaml offhandItem: material:DIAMOND_SWORD ``` ## Setting part poses #### How to set main hand's pose (right): ```yaml right_handPose: 0;0;0 ``` How to set off hand's pose (left): ```yaml left_handPose: 0;0;0 ``` # Custom Mob Settings Custom mobs can be assigned unique settings to differentiate their values, such as speed, hologram height, etc. We explain here every setting, how to use it and what it changes. ## Where are these settings located? Settings are located in each custom mob's configuration file (`customMobs` folder). Mob settings are set at the top of their respective `.amob` file, e.g.:

settings:
  health: 30 # Mob's health 
  sounds: BLAZE # Sound List: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
  hostile: true # Is mob hostile? If set to false, mob will not be aggressive towards players
  nametagHeight: 0.3 # How high should the nametag be?
  damage: 3 # How much damage should the mobs do to players?
  animateOnWalking: true # Should animation be active only when mob is walking?
  headFollow: true # Should mob's head follow target
  animationSmoothness: 20 # How smooth should the animation be? 1-20, higher being smoother.
  animationSpeed: 10 # How smooth should the animation be? 1-20, lower being faster.
  walkingSpeed: 0.9 # How custom fast mob walks

## Each setting explanation #### `health` **Explanation:** Value of mob's health. To put into perspective, players by default have `20` health.\ **Value**: integer\ **Example Usage**: `health: 20` #### `sounds` **Explanation:** From what vanilla mob should the sounds be used. Sound list: \ **Value**: Sound enum\ **Example Usage**: `sounds: ZOMBIE` #### `hostile` **Explanation:** Changes whether custom mob is hostile (attacks players) or does not.\ **Value:** boolean\ **Example Usage**: `hostile: true` #### `nametagHeight` **Explanation:** Changes how high mob nametag is compared to mob's head location.\ **Value:** double\ **Example Usage**: `nametagHeight: 2.0` #### `damage` **Explanation:** Sets mob's damage towards players. 1 = half a heart of damage.\ **Value:** integer\ **Example Usage**: `damage: 2` #### `animationSmoothness` **Explanation:** Changes played animation smoothness. Does not impact performance, animations are cached on server startup.\ **Value:** integer, 1 to 20\ **Example Usage**: `animationSmoothness: 10` #### `animationSpeed` **Explanation:** Changes how fast animations are played between frames.\ **Value:** ticks, 1 to 20. *20 ticks = 1 second between animation frames.*\ **Example Usage**: `animationSpeed: 10` #### `walkingSpeed` **Explanation:** Changes mob's walking speed. 1.0 = default speed, 2.0 = 2x default speed, 0.5 = half default speed.\ **Value:** double\ **Example Usage**: `walkingSpeed: 2.5` **`headFollow`** **Explanation:** makes player's `head` part look at target (in pets, looks at owner)\ **Value**: boolean\ **Example** usage: `headFollow: true` # FAQ Most frequent questions and answers ### How do i change the Head Icon shown in the GUI? Make sure you have a Valid Head option in the .amob file. Make sure the Displayitem name is set the same as the parts name ( Example Below ) ```yaml settings: Sounds: '' Animationspeed: 1 Animationsmoothness: 5 Displayitem: head permission: Nametagheight: 1 parts: head: mini: false upDown: 0 forwardBackward: 0 rightLeft: 0 headPose: 0;0;0 headItem: YourTextureURLHere ``` ## ## # ItemsAdder support ItemsAdder is fully supported, however some users report that mob skins may be glitchy. This is caused by ItemsAdder, and you must follow the link below on how to resolve this: # ModelEngine Learn how to use ModelEngine with our plugins ## How does ModelEngine work with custom mobs? Adding a custom ModelEngine to our plugins take a couple of minutes. ModelEngine pets also fully support abilities from AdvancedPets, as well as custom walking speed, custom damage and players will be able to ride it as well. Don't have ModelEngine? It's available for purchase or free download here: \ (You can use up to 6 models with our plugins and ModelEngine for free by using demo - everything is the same as paid, it's just limited to 6 models)

Only v3.0.0+ is supported with our plugins

## How to create a ModelEngine pet? It's very simple! Go into `plugins//customMobs` folder. You will need to create a new mob now - using your text editor. Create a .amob file with the name of pet you want, e.g. `ModelRobot.amob`, example: ![](https://i.imgur.com/2t0YJnc.png) When you create the file, open it with your text editor (Notepad++ is recommended). We have a template you can use for ModelEngine pets: {% code title="ModelRobot.amob" %} ```yaml settings: health: 20 damage: 1 nametagheight: 0 walkingspeed: 1.1 modelengine: kindletronjr skins: parts: animations: ``` {% endcode %} To use your own custom ModelEngine model, simply change `settings.modelengine` to the model name you want. In this example we're using one of the demo mobs `kindletronjr` Now in-game you will be able to see your ModelPet in /pets menu, like this: ![](https://2125321039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAb528wVCZfJT8n3LXzI%2Fuploads%2FH3vBT2GCOOZUBCapjzNj%2Fimage.png?alt=media\&token=54c211da-8b42-486b-964a-973ebf865c57) Spawning it will show a pet with ModelEngine model: ![](https://2125321039-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAb528wVCZfJT8n3LXzI%2Fuploads%2FpjrbVdbZvF2qh4GtjZEl%2Fimage.png?alt=media\&token=e810e3ef-7075-4519-be85-c340c8c84fe3) That's it! ## Models Showing up as Horse Armor? If your Model is showing up as Horse Armor dont worry It's very simple to fix! Follow these few Steps and it will resolve your issue! 1: Add the .bbmodel into the blueprints folder 2: Type /Meg reload ingame 3: Delete the Resource pack file in the model engine directory 4: Restart the server and it will generate a fresh Resource pack 5: Add the Resource pack to your Client / Server 6: Make the .amob file ( Shown above ) and it will work!