# Conditions

<details>

<summary>Click to view a comprehensive list of all <strong>Conditions</strong></summary>

{% code overflow="wrap" %}

```yaml
conditions: 
  spawn-reasons: ['']
  worldguard-regions: ['']
  worldguard-region-owners: ['']
  apply-above-y: 0
  apply-below-y: 0
  external-plugins: ['']
  biomes: ['']
  custom-names: ['']
  chance: 1.0
  entities: ['']
  maxLevel: 50
  minLevel: 1
  max-distance-from-spawn: 0
  min-distance-from-spawn: 0
  mob-customname-status: EITHER
  mob-tamed-status: EITHER
  mythicmobs-internal-names: ['']
  permission: ['']
  player-names: ['']
  gamemode: ['']
  spawner-names: ['']
  scoreboard-tags: ['']
  stop-processing: true
  within-coordinates: 
    start-x: 0
    end-x: 0
    start-y: 0
    end-y: 0
    start-z: 0
    end-z: 0 
  worlds: ['']
  world-time-tick: ['']
  cooldown-duration: 10s
  cooldown-limit: 0
```

{% endcode %}

</details>

***

| **Modular Option Conditions**                                                         | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `spawn-reasons:`                                                                      | <p>Check against possible spawn reason flags.<br>You can reference the <a href="https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/event/entity/CreatureSpawnEvent.SpawnReason.html"><strong>SpigotMC javadocs</strong></a> regarding <code>CreatureSpawnEvent.SpawnReason</code> for the different options. You may also use <code>LM\_SUMMON</code> or <code>LM\_SPAWNER</code>, referring to mobs created from the <code>/lm summon</code> or <code>/lm spawner</code> command.</p>                                                                                                    |
| <p><code>worldguard-regions:</code><br><code>worldguard-region-owners:</code></p>     | Check against the WorldGuard region or region owner where the mob spawned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><code>apply-above-y</code>:<br><code>apply-below-y:</code></p>                     | Checks whether the mob is above or below a specific Y coordinate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `external-plugins:`                                                                   | Check against whether the spawned mob came from an internally or externally supported plugin.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `biomes:`                                                                             | Check against the biome where the mob spawned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `custom-names:`                                                                       | Check against a mobs' Custom-Name when a level is first applied, presuming it has one.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `chance:`                                                                             | <p>Can be applied to a Custom Rule where the rule will only have the specified chance to apply the rule, otherwise it will be skipped.<br>By default, a rule without a specified chance will always process if it has been enabled.</p>                                                                                                                                                                                                                                                                                                                                                    |
| `entities:`                                                                           | Check against the mob which is being processed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><code>minLevel:</code><br><code>maxLevel:</code></p>                               | <p>Check against the level of the mob after it has been applied.<br>This check is only done for a handful of <strong>Settings</strong>, including Custom Drops.</p>                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><code>min-distance-from-spawn:</code><br><code>max-distance-from-spawn:</code></p> | Check against the minimum and maximum distance from the Minecraft server spawn coordinates where the mob spawned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><code>mob-customname-status:</code><br><code>mob-tamed-status:</code></p>          | <p>Check against the Custom-Name or Tamed status of a mob.<br><br><code>NOT\_SPECIFIED</code> / <code>EITHER</code> (Default)<br>Check is disabled / Check value does not matter<br><br><code>NAMETAGGED</code> / <code>TAMED</code><br>Checked mob must be either Nametagged or Tamed<br><br><code>NOT\_NAMETAGGED</code> / <code>NOT\_TAMED</code><br>Checked mob can not be either Nametagged or Tamed</p>                                                                                                                                                                              |
| `mythicmobs-internal-names:`                                                          | Check against the internal name used within the MythicMobs custom mob configuration file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `permission:`                                                                         | Check against the allowed permission nodes established for the nearest player to the entity, OR the player who killed an entity, depending on it's implementation.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `player-names:`                                                                       | Check against the name(s) of the nearest player to the mob.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `gamemode:`                                                                           | <p>Check against the current gamemode set for the nearest player to the mob.<br>Valid options include: <code>creative</code>, <code>survival</code>, and <code>spectator</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                       |
| `skylight-level:`                                                                     | Enter a range of numbers between `0` and `15` for the skylight level when the mob spawned in. Example for dark areas only: `0-5`                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `spawner-names:`                                                                      | Check against the name of the `LM Spawner` which created the mob.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `scoreboard-tags:`                                                                    | Check against any possible Minecraft Scoreboard tags applied to a mob, and whether those specified tags exist.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `stop-processing:`                                                                    | <p>Can be applied to a Custom Rule where the rule will cause future rule processing to cease upon activation of the <code>stop-processing:</code> setting.<br>By default, a rule without a specified stop-processing be processed from top down; starting with the Default Rule, then the first Custom Rule, and all subsequent rules in order.</p>                                                                                                                                                                                                                                        |
| `structures:`                                                                         | A list of structure names for the condition. Can be [built-in](https://jd.papermc.io/paper/1.21.11/org/bukkit/generator/structure/Structure.html) or 3rd party.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `within-coordinates:`                                                                 | This system allows you set the `start-` and `end-` coordinates to define a region within your world to apply a rule within. You can just specify a single axis to mark a single point or line; specify two axis to make a square along those two axis; or specify three to make a cuboid region. You can also place `'-'` or `'+'` as the `end-` of any coordinate and it will go from the `start-` value to infinity in the direction specified. Finally, if you specify a `start-` but do not specify an `end-`, then the `end-` will be the same value as the `start-`; and vice versa. |
| <p><code>cooldown-duration:</code><br><code>cooldown-limit:</code></p>                | Can be applied to a Custom Rule where the rule when successfully applied will count up from zero for each activation until it reaches the `cooldown-limit:`, then it will lock the rule from applying for the `cooldown-duration:` timer. Once the timer expires, the rule is unlocked and the limit count is reset.                                                                                                                                                                                                                                                                       |


---

# Agent Instructions: 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:

```
GET https://arcaneplugins.gitbook.io/levelledmobs-the-ultimate-mob-levelling-solution/the-default-files/rules.yml/conditions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
