Main Config

Guide to the config.yml file

The config.yml file is the main plugin configuration file and contains settings for mob and level formulas. All formulas support PlaceholderAPI placeholders that aren't player-dependent in addition to the list placeholders.

Options

• language - Sets the plugin language, which must be the language code of a file in the messages folder. Available languages are: English, Spanish, German and Dutch.

Mob defaults

mob_defaults:

The available placeholders in this section are {level} for the level of the mob and {distance} for the distance between the mob and the world spawn.

• damage:

  • formula - The formula for how much damage a mob deals based on its level. {mob_damage} is the base damage of the mob without any modifications.

  • max - The formula for the maximum possible mob damage.

    • Available placeholders are {mob_damage}, {level}, and {distance}

• health

  • formula - The formulae for how much max health a mob has based on its level. {mob_health} is the base mob health without any modifications.

  • max - The formula for the maximum possible mob health.

    • Available placeholders are {mob_health}, {level}, and {distance}

Mob level

mob_level:

• formula - The main formula for determining mob levels when there are players within the player_level.check_radius of a mob spawning.

• backup_formula - The formula to determine mob levels when there are no players within the player_level.check_radius of a mob spawning.

• max_level - The maximum possible mob level.

Placeholders for both formula and backup_formula:

• {distance} - Distance the mob spawn is from the world spawn.

• {sumlevel_global} - The sum of the player level of all online players (player levels are determined by player_level.formula)

• {location_x} - The X coordinate of the mob spawn.

• {location_y} - The Y coordinate of the mob spawn.

• {location_z} - The Z coordinate of the mob spawn.

Placeholders for only formula:

• {highestlvl} - The highest player level in the check_radius.

• {lowestlvl} - The lowest player level in the check_radius.

• {sumlevel} - The sum of all player levels in the check_radius.

• {playercount} - The number of players in the check_radius.

Boss level

bosses:

• enabled - Whether bosses will have levels. This affects the Ender Dragon, Wither and Guardian.

• health:

  • formula - The formula for how much max health a boss has based on its level. {mob_health} is the base health of the boss without any modifications.

  • max - The formula for the maximum possible boss health.

    • Available placeholders are {mob_health}, {level}, and {distance}

• damage:

  • formula - The formula for how much damage a boss deals based on its level. {mob_damage} is the base damage of the boss without any modifications. Note, that the Ender Dragon cannot have its damage modified.

  • max - The formula for the maximum possible boss damage.

    • Available placeholders are {mob_damage}, {level}, and {distance}

• mob_level:

  • formula - The main formula for determining boss levels when there are players within the player_level.check_radius of a boss spawning.

  • backup_formula - The formula to determine boss levels when there are no players within the player_level.check_radius of a boss spawning.

  • max_level - The maximum possible boss level.

Player level

player_level:

• check_radius - The radius to check for players when a mob spawns to determine it's level. If no players are within the radius, the mob level will default to the mob_level.backup_formula.

• formula - The formula to determine a player's level. The following placeholders are available:

  • {sumall} - The sum of all of a player's skill levels.

  • {average} - The player's average skill level.

  • {skillcount} - The number of skills that are enabled on the server.

  • {skillname} - Gets the player's level of a specific skill. Replace skillname with the name of any enabled skill in lowercase.

Custom name

custom_name:

• enabled - Whether the nametag of an AuraMob should be overriden with a custom name.

• format - The format of the custom mob name. Available placeholders:

  • {mob} - The name of the mob type from the messages file.

  • {lvl} - The level of the mob.

  • {health} - The formatted health of the mob.

  • {maxhealth} - The formatted max health of the mob.

• health_rounding_places - The number of decimals to round mob health to. If 0, the value is rounded to an integer.

• display_by_range - If true, the custom name will show when the player gets close enough even if the player is not directly targeting the mob.

• display_range - The maximum number of blocks away to show the custom name if display_by_range is true.

• allow_override - Whether AuraMobs affects mobs that also spawn with a custom name. Set to false for increased compatibility with other plugins.

Skills XP

skills_xp:

• enabled - If true, the skill XP gained from killing/damaging a mob will change based on its level.

• default_formula - The formula for determining the amount of XP to give. Available placeholders:

  • {source_xp} - The base XP gained from killing a mob, including any multipliers from AuraSkills.

  • {mob_level} - The level of the mob.

Worlds

worlds:

• type - The type of world list to use, either blacklist (only worlds on the list are disabled) or whitelist (all worlds except those on the list are disabled).

• list - The list of worlds to blacklist/whitelist the mob level functionality.

Mob replacements

mob_replacements:

• type - The type of replacements list to use, either whitelist or blacklist.

• list - The list of mob types that levels are enabled for if type is whitelist, or the mobs that are disabled if type is blacklist. The * symbol can be used as a wildcard for all mob types.

Spawn reasons

spawn_reasons - A list of valid spawn reasons for which levels will be applied to mobs.

Scaling

Scaling is an attribute which was introduced with 1.20.5 and modifies the overall size of an entity.

Scaling entries are defined in the scaling.levels section with the format:

• minLevel-maxLevel: - Specifies the range of levels which will be affected by this entry. You can add multiple entries for the same values.

  • chance - A decimal value which defines the likeliness of a mob having its size changes from 0 to 1 (where 1 is 100% chance). Defaults to 1.

  • scale - Specifies which value will be set for the entity instead. You can choose between the range variant, looking like from-to, which will generate a random decimal between these values, or use the list variant which looks like a, b, c, ... . Only values between 0.0625 and 16 will have an effect.

  • types - Allows you to define a list of entity types which will be eligible for the entry. If you want all entities to be affected, leave the field out.

Examples of a valid entries:

scaling:
  levels:
    50-100:
      chance: 0.5
      scale: 1-2
    10-100:
      chance: 1.0
      scale: 1,2,3
      types:
        - 'ZOMBIE'
        - 'SLIME'
    1-9:
      scale: 1.1

The override option in the scaling section controls how the existing scale of mobs (such as from other plugins) will be handled. If true, the AuraMobs scale will override any existing scale. If false, the mob will be multiplied from its existing scale.