# Main Page

Welcome to AdvancedSpawners Wiki

## How to buy AdvancedSpawners?

You can buy at: [advancedplugins.net](https://advancedplugins.net/item/2?ref=wiki) for 25% OFF **Special Sale**

### Have questions? Pre-sale, support or just want to talk?

Join our Support discord for any type of help! <https://discord.gg/tm9QzqvmQA>

### Why AdvancedSpawners?

AdvancedSpawners is the ultimate and first ever custom mobs creation plugin. It features 10+ custom mobs created by default, with a possibility to create more easy through in-game mob creator (coming in v3.0.0 release). It also features Mob / Spawner stacking, custom mob sounds, animations and way more.\
\
\
Whatever you can think of, this plugin's got it.


# Can't Buy On SpigotMC

### 🌻 Save big with **Spring Sale!** 🌷

PayPal is currently **unavailable** as payment method on our SpigotMC page. \
You can purchase the plugin [our official website](https://advancedplugins.net/item/2?utm_source=wiki-feb\&utm_medium=purchaseLink\&utm_campaign=wiki) and you will get access on SpigotMC as well.

### Why?

PayPal is blocking Spigot Plugin developers from receiving payments - this has been an ongoing issue since November 2020. We are working towards resolving this issue as soon as possible. Not all developers have been affected, but a minority is being targeted and limited by paypal.

### Have further questions?

Contact us via [Discord Server](https://advancedplugins.net/discord) or [Email Us](mailto:support@advancedplugins.net) - we will gladly answer any of your questions and help you.


# In-Game Custom Mobs Creator

Learn how to create custom mobs in-game.

Preview of the editor:

![](/files/-MVX1ihyKhcxH0dFwgxD)

Video explaining how to use this editor:

{% embed url="<https://www.youtube.com/watch?v=6B-FflmRrpA>" %}


# Configuration Explanation

Find out how you can manually configure parts of mobs from files.

## Setting part items

#### 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

Detailed explanation of every custom mob setting.

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 (`/plugins/AdvancedSpawners/customMobs` folder). Mob settings are set at the top of their respective `.amob` file, e.g.:

```yaml
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?
  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: <https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html>\
**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`


# Commands & Permissions

All plugin commands

### Commands & Permissions

| Command      | Explanation                                               | Permission |
| ------------ | --------------------------------------------------------- | ---------- |
| /as          | Main plugin command                                       | N/A        |
| /as editor   | Open spawner editor                                       | N/A        |
| /spawnershop | Open the spawner shop where players can purchase spawners | N/A        |


# Custom Mobs Animations

Learn how to animate your custom mobs.

![](/files/-MVX28dusBkw-TxW7xrS)

This animation took 2 minutes to create.  Plugin does everything for you - it automatically calculates and animations your mob, all you have to do is set "frames" - starting, where part should start and where it should end. You can change animation speed and smoothness. Later this month we will have an in-depth explanation on how to achieve it.


# Languages

Default locale files available with v3.0.0 plugin release.

We have a variety of default translations available in AdvancedSpawners! Here they are:

* **English** (In config: `en`)
* **Filipino** (Philippines) (In config: `ph`)
* **Polish** (In config: `pl`)
* **German** (In config: `de`)
* **Dutch** (Netherlands) (In config: `nl`)
* **French** (In config: `fr`)
* **Lithuanian** (In config: `lt`)


# ModelEngine support

## How does ModelEngine work with AdvancedSpawners?&#x20;

Adding a custom ModelEngine model to AdvancedSpawners takes a couple of minutes. ModelEngine pets also fully supports settings from AdvnacedSpawners, as well as custom walking speed, custom damage.

## How to create a ModelEngine pet?

It's very simple! Go into `plugins/AddvancedSpawners/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).&#x20;

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`

That's it!


