Monsters

MonsterPlus

I. Temporary Monster Spawn Feature

Step 1: Select the monster type to spawn via command

Step 2: Select the quantity of monsters to spawn via command

II. Monster Template Configuration Feature (mobs)

Configuration folder location: mobs

Used to define monster basic abilities

Configuration Example

yaml

# This is a template example file (mobs)
# Used to define monster abilities, does not include spawn coordinates and time

# Template key, use pure key (globally unique)
TestTemplate:
  # Monster type
  entityType: ZOMBIE
  # Monster level, supports a fixed value or a random range
  # Takes effect only when the spawn point has no level configured
  level: "10,30"
  # Display name
  displayName: "Test BOSS"
  # LibsDisguises player name disguise
  skinName: ""
  # Drop items
  drops:
    - "DIAMOND: 10: 0.5"
    - "[ITEM]example.yml_woodenSword: 1: 0.5"
  # Skills (skill name or skill file name)
  skills:
    - "attackArrow.yml"
    - "attackBlitz.yml"
  # Add extended attributes, supported attribute plugins see buffType in config
  apAttributes:
    - "Physical Damage: 100"
  # Vanilla attributes
  attributes:
    - "GENERIC_SCALE: 1"
  # Potion effects, format: type: level: duration(seconds): interval(seconds, optional)
  # Level supports a random range (e.g. 1~3)
  # Duration defaults to one day (86400s), level defaults to 1
  # An interval greater than 0 enables periodic re-application
  potions:
    - "SPEED: 2: 30"
    - "REGENERATION: 1~3"
    - "INCREASE_DAMAGE: 2~3: 60"
    - "JUMP: 1: 30: 10"
  # Whether to disappear when far from player, true = disappear
  removeWhenFarAway: true
  # Survival time in seconds, 0 = unlimited
  survivalTime: 0
  # Spawn notification
  spawnMessages:
    - "${name} has appeared!"
  # Expiry notification
  expireMessages:
    - "${name} has disappeared!"
  # Death notification
  deathMessages:
    - '&e-----------------------------------------------------'
    - '&c${name} &7has been defeated'
    - '&7   Top &c1st&7 place: &f${onePlayer} &7dealt &c${oneDamage} &7damage'
    - '&7   Top &62nd&7 place: &f${twoPlayer} &7dealt &6${twoDamage} &7damage'
    - '&7   Top &e3rd&7 place: &f${threePlayer} &7dealt &3${threeDamage} &7damage'
    - '&4Finisher: &f${killer}'
    - '&e-----------------------------------------------------'

Configuration Details

1. Basic Configuration

entityType: Monster type (e.g., ZOMBIE, SKELETON, CREEPER, etc.)
level: Monster level
- Fixed value: 10
- Random range: 10,30, 10-30 or 10~30 (inclusive on both ends)
- If the spawn point in spawns also configures a level, the spawn point takes priority
- If neither is configured, a random level is generated from randomLevel in config.yml plus the distanceLevel bonus
displayName: Monster display name, supports color codes
skinName: LibsDisguises player name disguise (optional)

2. Drop Configuration (drops)

View Loot System

3. Skill Configuration (skills)

View Skill System

You can use the name declared in the skill file, or the skill file name directly

4. Attribute Configuration

apAttributes (Extended Attributes):

Supports third-party attribute plugins
Supported plugins include:

attributes (Vanilla Attributes):

Uses Minecraft native attribute system
Common attribute types:
- GENERIC_MAX_HEALTH: Max health
- GENERIC_ATTACK_DAMAGE: Attack damage
- GENERIC_MOVEMENT_SPEED: Movement speed
- GENERIC_SCALE: Size scale
- GENERIC_ARMOR: Armor value
- For more attributes, refer to the complete list in the item system

5. Potion Configuration (potions)

Format: type: level: duration(seconds): interval(seconds, optional)
Level supports a random range such as 1~3
Duration defaults to 86400 seconds, level defaults to 1
If the fourth segment is greater than 0, the effect is re-applied after the interval, and milk cannot remove it
Example:

yaml

potions:
  - "SPEED: 2: 30"               # type: level: duration(seconds)
  - "REGENERATION: 1~3"          # random level 1~3
  - "INCREASE_DAMAGE: 2~3: 60"   # -, ~ and , are all valid separators
  - "JUMP: 1: 30: 10"            # lasts 30s, re-applied after 10s

6. Behavior Configuration

removeWhenFarAway: Whether to disappear when far from player
- true: Disappear
- false: Remain
survivalTime: Survival time in seconds
- 0: Unlimited
- Greater than 0: The monster is removed automatically when time is up

7. Message Configuration

spawnMessages (Spawn notification):

Supports variables: ${name} (monster name)
Can configure multiple messages

expireMessages (Expiry notification):

Supports variables: ${name} (monster name)
Only effective when survivalTime is configured

deathMessages (Death notification):

Supports variables:
- ${name}: Monster name
- ${onePlayer}, ${twoPlayer}, ${threePlayer}: Top 3 damage players
- ${oneDamage}, ${twoDamage}, ${threeDamage}: Corresponding damage values
- ${killer}: Finisher
Supports color codes (&+color letter)

Usage Scenarios

Dungeon BOSS Battle: Create a powerful BOSS template, combined with the fixed spawn feature in the spawn folder
Event Monsters: Quickly generate monsters with special abilities for server events
Custom Challenge: Design unique monster combinations and drops

Notes

mobs templates only define monster abilities, do not include spawn coordinates and time
For fixed spawn points, use in combination with the spawns folder
Template keys must be globally unique and cannot be duplicated
Drop probability range: 0.0-1.0 (0=0%, 1=100%)
Skill files must exist in the skill folder
If neither the template nor the spawn point configures a level, a random level is generated from randomLevel in config.yml

III. Open World Random Monster Enhancement Feature

Can specify world to generate monsters of different levels
Can customize level bonuses
Can customize random equipment generation probability
Can customize equipment drop rate
Can configure to become stronger the farther from specified location
Can generate random skills based on level (1.1.8+)
Can generate random drops based on level (1.1.8+)

Option	Description
`worlds`	Worlds where level rules apply, `[ALL]` means every world
`spawnChance`	Random spawn chance, `all` is the global chance and each monster type can also be configured separately
`randomLevel`	Upper bound of the random level when no level is configured
`levelHealth` / `levelDamage`	Health / damage added per level
`nameColorDefault` / `nameColor`	Default name format / name colors by level bracket
`distanceLevelEnable` / `distanceLevel`	Whether to add level by distance / distance-to-level mapping
`levelSkillEnable` / `levelSkill`	Whether to roll skills by level / skill and probability per level bracket
`levelDropEnable` / `levelDrop`	Whether to roll drops by level / normal and elite monster drops
`nether` / `diamond` / `iron` / `golden` / `chainMail` / `leather` / `none`	Monster equipment generation chances
`*DropChance`	Drop chance for the corresponding equipment tier (e.g. `netherDropChance`)
`enchantment` / `enchantmentNumber`	Random enchant chance / maximum number of random enchants
`buffType`	Extended attribute plugin type
`isAnvil` / `isDropItem` / `isPickupItem` / `dropHdTip` / `isTrimMaterial` / `autoPickup`	Anvil, drop, pickup, hologram, armor trim and auto-pickup switches

Monsters ​

I. Temporary Monster Spawn Feature ​

II. Monster Template Configuration Feature (mobs) ​

Configuration Example ​

Configuration Details ​

1. Basic Configuration ​

2. Drop Configuration (drops) ​

3. Skill Configuration (skills) ​

4. Attribute Configuration ​

5. Potion Configuration (potions) ​

6. Behavior Configuration ​

7. Message Configuration ​

Usage Scenarios ​

Notes ​

III. Open World Random Monster Enhancement Feature ​

Related Settings (config.yml) ​