Main Config

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.

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 max damage a mob can deal. When empty, damage is only controlled by formula.
• health:
  • formula - The formula 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 max health a mob can have. When empty, health is only controlled by formula.
• speed:
  • formula - The formula for the movement speed attribute of a mob based on its level. For reference, a zombie has a default speed of 0.23 and a piglin is 0.35.
  • max - The formula for the max speed a mob can have. When empty, speed is only controlled by formula.

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.
• {playercount} - The number of players in the check_radius for formula or on the server for backup_formula.
• {random_int} - A random integer from 1 to 100 (inclusive).
• {random_double} - A random double from 0.0 (inclusive) to 1.0 (exclusive).

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.

Bosses

bosses:

• enabled - Whether bosses can have levels. This includes the Ender Dragon, Wither, and Elder Guardian.
• health: - This section works the same as mob_defaults.health.
• damage: - This section works the same as mob_defaults.damage.
• level: - Controls the level of bosses. Works the same as the mob_level section.

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 - If false, mobs that already have a custom name from another plugin will not be affected by AuraMobs.
• ignore_mythic_mobs - If true, mobs from the MythicMobs plugin will not be affected by AuraMobs.

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 allows the resizing of mobs based on AuraMobs level. This feature has no effect unless scaling is defined in the levels section as described below.

• worlds:
  • type - The type of world list to use, either blacklist (scaling is disabled in listed worlds) or whitelist (scaling is only enabled in the listed worlds).
  • list - The list of worlds to blacklist/whitelist mob scaling.
• override - If true, the AuraMobs scale will override any existing scale. If false, the mob's new scale will be multiplied from its existing scale.
• levels: - The key of each section is the mob level range it applies to (e.g. 1-20:). Options within each level range include:
  • chance - The chance for a mob to be scaled from 0 to 1 (defaults to 1).
  • scale - The scale to set the mob to, where 1 is unchanged. This can be a single decimal (1.5), a comma separated string (1, 2, 3), or a range (1-3).
  • types - A list of entity types to only apply this scale to. If not specified, all mob types will be scaled.

Example of a mob scaling config:

scaling:
  levels:
    50-100:
      chance: 0.3
      scale: 1.5
      types:
        - spider
        - cave_spider

Functions

All configurable formulas (mob level, health, damage, player level, etc.) support the Exp4j built-in functions.

Formulas also support the following custom functions:

• random_between(num1, num2) - Returns a random decimal between num1 (inclusive) and num2 (exclusive)
• rand() - Returns a random decimal between 0 (inclusive) and 1 (exclusive).
• clamp(value, min, max) - Clamps a value between a minimum and maximum. Example: clamp(12, 0, 10) → 10.
• lerp(a, b, t) - Performs linear interpolation between a and b using t (0.0 to 1.0). Example: lerp(10, 20, 0.5) → 15.
• logn(base, value) - Computes the logarithm of a value with a custom base. Example: logn(2, 0) → 3.
• round(x) - Rounds a value to the nearest integer. Example: round(4.5) → 5.