> For the complete documentation index, see [llms.txt](https://mobs.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mobs.advancedplugins.net/edit-custom-mobs/custom-mob-settings.md).

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

<pre class="language-yaml"><code class="lang-yaml"><strong>settings:
</strong>  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
</code></pre>

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

**`headFollow`**

**Explanation:** makes player's `head` part look at target (in pets, looks at owner)\
**Value**: boolean\
**Example** usage: `headFollow: true`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mobs.advancedplugins.net/edit-custom-mobs/custom-mob-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.