Settings

Click to view a comprehensive list of all Settings

settings:
# Core Levelling Setings
  minLevel: 1
  maxLevel: 50
  construct-level: '%weighted-random%'

# Nametag related Settings
  nametag: ' %tiered%Lvl %mob-lvl% &8&l༺ &f%displayname%&8 &8&l༻ &f%entity-health-rounded%&8/&f%entity-max-health-rounded% %tiered%%heart_symbol% '
  nametag-visible-time: 5s
  nametag-placeholder-unlevelled: ''
  nametag-placeholder-levelled: ''
  nametag-visibility-method: ['TARGETED', 'TRACKING', 'ATTACKED']
  creature-death-nametag: '%tiered%Lvl %mob-lvl%&8 | &f%displayname%'
  death-messages:
    1: ['%player% was killed by %death_nametag%!']

# Custom Name Settings
  entity-name-override:
    SKELETON: 'Jack Skellington'
    all_entities: 'Spawner %displayname%'

  entity-name-override:
    LVL-LVL:
      SKELETON: ['Verta Brae', 'Billy Bones']

# Nametag Health Indicator Settings
  health-indicator:
    indicator: '█'
    indicator-half: '▌'
    scale: 4
    max: 5
    colored-tiers:
      tier-1: '&#22E76B' #Green
      tier-2: '&#528CFF' #Blue
      tier-3: '&#FFCD56' #Yellow
      tier-4: '&#FE803C' #Orange
      tier-5: '&#F2003D' #Red
      tier-6: '&#B447FF' #Purple
      tier-X: '#COLOR' # Example Syntax
      default: '&#FFFFFF' #White
    merge: true

# CustomDrop Settings
  use-custom-item-drops-for-mobs: true
  use-droptable-id: ''

# Level Inheritace Settings
  baby-mobs-inherit-adult-setting: true
  transforming-mobs-inherit-level: true
  riding-passengers-match-vehicle-level: false

# Custom Mob Attribute Settings
  creeper-max-damage-radius: 3
  attribute-modifier:
#   Stacked Multipliers Method
    use-stacked: true
    max-health: ['5.0', 'STACKED']
#   Custom Formula Method
    max-health: '%max-health% + (%level% * %max-health% * 0.25)'
#   Default Multiplier Method
    max-health: 5.0
    movement-speed: 0.15
    attack-damage: 2.25
    ranged-attack-damage: 2.0
    creeper-blast-damage: 1.0
    follow-range: 0
    item-drop: 3
    xp-drop: 5
#   Special Multipliers (0.0 Min - 1.0 Max)
    armor-bonus: 0.25
    armor-toughness: 0.15
    attack-knockback: 0.25
    knockback-resistance: 0.2
    zombie-spawn-reinforcements: 0.25

  attribute-modifier:
    vanilla-bonus: ['']
 
  attribute-modifier:
    custom-attribute-modifier:
      EntityType:
        max-health: 5.0
        movement-speed: 0.15
        attack-damage: 2.25
        ranged-attack-damage: 2.0
        creeper-blast-damage: 1.0
        item-drop: 3
        xp-drop: 5

# Deaths in Chunks Settings
  maximum-death-in-chunk-threshold: 0
  max-adjacent-chunks: 3
  chunk-max-cooldown-seconds: 300
  disable-vanilla-drops-on-chunk-max: false
  disable-item-boost-on-chunk-max: true
  disable-xp-boost-on-chunk-max: true

# Miscellaneous Settings
  nbt-data: ''
  sunlight-intensity: 5

  tiered-coloring:
    1-5: '&#22E76B' #Green
    6-10: '&#528CFF' #Blue
    11-15: '&#FFCD56' #Yellow
    16-20: '&#F2003D' #Red
    21-25: '&#B447FF' #Purple
    X-Y: '#COLOR' # Example Syntax
    default: '&#FFFFFF' #White

  spawner-particles: 'SOUL'
  spawner-particles-count: 10

  lock-entity: false

---

Modular Option Settings	Description
minLevel: maxLevel:	Establishes the Minimum and maximum level used by the program when processing strategies, modifiers, or construct-level.
construct-level:	More details on this setting are found here.
nametag:	Populates the nametag field of the levelled mob.
nametag-visiblity-time:	Sets how long a nametag will remain visible if an action activated the nametag on a temporary setting (IE 'attacked').
nametag-placeholder-unlevelled: nametag-placeholder-levelled:	Populates what the nametag field would be for the specific placeholder tag associated with this setting (%levelledmobs_mob-target%), when a player is hovered over a levelled or unlevelled mob.
nametag-visibility-method:	Sets how the nametag can be made visible to the players. TARGETED - When an entity has targeted a player with Line of Sight. ATTACKED - When a Player attacks an entity. TRACKING - When an entity is actively tracking a targeted player (Follow Range). ALWAYS_ON - The Nametag remains visible, even through blocks. MELEE - The Nametag is only visible in melee range. DISABLED - The Nametag is disabled.
creature-death-nametag:	This represents the name used whenever a player is killed by a levelled mob.
death-messages:	This represents the beginning of the Death Messages tree, where you define the settings to alter the messages sent to players when they are killed an an entity. You would set the chance of the message being used by changing the number on the left, while including your altered message on the right.
entity-name-override: | LVL-LVL:, EntityType:, all_entities:	This allows you to create false names for entities; this does not override any custom-name fields. This config option has multiple methods to implement it. You can use the single line item method, such as SKELETON: 'Jack'; multiple randomly selected options, such as SKELETON: ['Jack', 'Sally', 'Sandy Claws']; or checking levels of the mob prior to application.
health-indicator: | indicator:, indicator-half:, scale:, max:, colored-tiers:	These represent the Health Indicator visual aid system. Each setting maintains a different aspect of the feature: the indicator and indicator-half are the character representations of each of the 'health bars' of the entity. The indicator half is only used on the final bar. The max represents the number of indicator present per-bar of health, while scale represents how much health each indicator represents. Finally, colored-tiers allows for establishing different colors for each bar of health generated from the indicator, in ascending tiers of colors for higher health.
use-custom-item-drops-for-mobs:	When set to true, the mobs will use any applicable Custom Drops associated with it.
use-droptable-id:	This will apply a drop table identified in Custom Drops to a mob.
baby-mobs-inherit-adult-setting:	When set to true, both adult and baby variants of the mobs of the same EntityType will be considered the same. When false, adult and baby variants could be considered separate entities. For example: ZOMBIE and BABY_ZOMBIE
transforming-mobs-inherit-level:	When set to true, any entity which undergoes a transformation event will keep it's previous applied setting. When set to false, the newly transformed entity will attempt to relevel itself under it's new status. An example of a transformation event would be when a larger slime breaks into smaller slimes, or when a Villager transforms into a Zombie Villager and back again.
riding-passengers-match-vehicle-level:	When set to true, any entity which spawns as a Passenger combination will share the same level as generated by the lowest entity in the stack (the one moving the Passenger(s) around). Whatever level that lowest entity would have generated, the passengers will match that level. When set to false, each entity will generate it's own level based upon it's own levelling strategy.
creeper-max-damage-radius:	This represents the radius of a Creeper explosion. Minecraft's vanilla value is 3, a stronger middle ground would be 5; anything higher than 10 is basically a nuke and is not recommended.
attribute-modifier: | use-stacked:, max-health, movement-speed:, attack-damage:, ranged-attack-damage:, creeper-blast-damage:, follow-range:, item-drop:, xp-drop:, armor-bonus:, armor-toughness:, attack-knockback:, knockback-resistance:, zombie-spawn-reinforcements:, vanilla-bonus:, custom-attribute-modifier:	This represents the beginning of the Attribute Modifiers system tree, where you can adjust the change in entity attributes based on their maximum level or any various formula. The specified details for each attribute are detailed below. For xp-drop or item-drop, having a value of -1 will disable the dropping of the vanilla XP or Items respectively.
maximum-death-in-chunk-threshold:, max-adjacent-chunks:, chunk-max-cooldown-seconds:, disable-vanilla-drops-on-chunk-max:, disable-item-boost-on-chunk-max:. disable-xp-boost-on-chunk-max:	This represents the Deaths in Chunks system settings. These settings allow you to limit or shut off entirely the Custom Drops or Item/Experience Attribute Modifiers for any levelled mob which spawns within a specified area of chunks around a high-density death-zone. This is useful for player farm management, as well as limiting players from abusing the gain in item or experience drops. The specified details for this system are detailed below.
nbt-data:	This config option requires the soft-dependency NBT-API to function. This allows you to apply NBT tags to entities which have spawned. This adds the NBT tag to whatever list of NBT tags the mob already has (nothing is reset/overridden). A useful toolset for crafting even more unique styles of entities.
sunlight-intensity:	This represents an additional damage amount applied to entities which burn in the sunlight. This is a useful tool to help kill off higher level entities whose health can exceed the damage of the sun.
tiered-coloring: | LVL-LVL:, default:	This represents the beginning of the Tiered Coloring system tree, where you define the settings necessary to utilize the %tiered% tag which can be used within the nametag: config option. To apply a color based on the current level of an entity. You would establish a level range at LVL-LVL: and then either a Hex or Minecraft Color Code prefixed with an & in place of the color. You can establish a default: color which would apply to any entity which has spawned or was summoned in a level range which is not already specified.
spawner-particles:, spawner-particles-count:	This applies only to LM Spawners, it is the particle effect and count used when a mob is spawned. Can be any value from the Minecraft Particle Javadocs.
lock-entity:	When set to true, nametags and Custom Drop rules will be locked to the mob so it won't change even if a different rule would have applied changes to the mob later.

Attribute Modifiers

The Attribute Modifiers of LevelledMobs are how the attributes themselves are edited. We provide three distinct methods to achieve this: default, stacked, and custom.

The Default method is how LevelledMobs has always applied multipliers. Below represents the formula being used; the first being standard, the second being 'special':

$$newAttr = origAttr + (( origAttr * configValue ) * ( mobLevel / maxLevel ))$$

$$newAttr = (mobLevel / maxLevel) * (attrMax * configValue)$$

* 'Special' refers to Special Attribute Modifiers which have a maximum in-game value compared to the others which do not.

---

The values of the formula above are:

newAttr     - The final applied attribute value.
origAttr    - The original attribute value assigned to mob.
configValue - The value taken from the Rules configuration.
mobLevel    - The current applied level of the mob.
maxLevel    - The maximum level the mob could receive as assigned from the Rules.
attrMax     - The maximum value of the attribute (Special Attributes only).

For Special Attributes, the attrMax or 'Attribute Maximum' represents the maximum value of this Minecraft attribute. These special modifiers are unique in that they have a specified cap value compared to the other non special modifiers which in theory have no cap. That means that these are setup to be a 'percent of max' setup. The values of this are as follows:

armor-bonus                 - 30.0
armor-toughness             - 20.0
attack-knockback            - 5.0
knockback-resistance        - 1.0
zombie-spawn-reinforcements - 1.0

An example of the syntax used to implement this method is as follows:

max-health: 5.0
#OR
armor-bonus: 0.5

For the first line, the sample says that 'when at max level, give the entity a 5x or 500% increase in the max-health attribute'. Entities that are not at max level receive an equal portion based on the max level. For the second line, the sample says that 'when at max level, use 50% of the attributes' max value'. That is because it is a special attribute which had to be measured as a 'percent to max attribute value' rather than the standard method.

---

The Stacked method is an alternative default formula which allows you to say that, for every level the specified attribute would increase by a specified amount. This overrides the Special Attributes formula as well, however the cap imposed on each of the special attribute by Minecraft is still in force. An example of the syntax used to implement this method is as follows:

max-health: ['5.0', 'STACKED']

---

The final newer method for attribute calculation is the Custom formula. This allows you to craft your own formula to determine how the attribute is modified. The value you're crafting is being added to the default applied amount, and makes heavy use of the Placeholders system to construct a fluid mix of numbers to form a final value in a similar way that Construct-Level builds the final applied level. An example of the syntax used to implement this method is as follows:

max-health: '%max-health% + (%level% * (%max-health% * 0.25))'

Deaths in Chunks System

This system contains a set of settings which control how it works.

settings:
  maximum-death-in-chunk-threshold: 15
  max-adjacent-chunks: 5
  chunk-max-cooldown-seconds: 10m
  disable-vanilla-drops-on-chunk-max: false
  disable-item-boost-on-chunk-max: true
  disable-xp-boost-on-chunk-max: true

These settings allow LevelledMobs to limit or stop entirely the Custom Drops or Item and Experience boosts typically or otherwise given to a player in a certain area measured in chunks where there have been a higher than average number of mob deaths in the same chunk. This is typically done by player farms or other stationary or small area kill-zones. When any player breaches the threshold of mobs killed within the specified time in the same chunk, a cooldown timer will apply to the affected chunks and any specified adjacent chunks which will limit the drops and experience points of the mobs which die in those chunks until the cooldown expires and the chunk is reset.