BoostedMonsters — Configuration

Configuration

Current release information

Latest version: 2.5.2
Minecraft: 26.x
Platforms: Spigot / Paper / Folia

Version 2.5.2Last updated: 1970-01-01 01:33

BoostedMonsters — Configuration

Automatic spawn rules
spawnPeriod uses seconds; distances use blocks. Each cycle can request up to mobsPerRun mobs per eligible player, subject to world and chunk limits. With requirePlayerMovement enabled, the first check stores the player's location; later checks require movement by requiredPlayerMovement. Surface spawning is allowed at world time 13000–23000 or during rain/thunder. Underground searches can also run outside that period. Both options still require valid space, acceptable light, a safe floor and a location inside the world border. Searches use loaded chunks.

Population and search limits
maxTotalMobs is a per-world limit for tracked custom mobs, not one global server cap. maxPerChunk limits custom mobs in a chunk; countNaturalMobsTowardsChunkLimit additionally includes recent NATURAL spawn events, rather than a full census of all vanilla mobs. DisabledWorlds and ignoreCreativeAndSpectatorPlayers affect automatic spawning. Numeric settings are bounded; 0 is not an unlimited population setting. The reference below shows runtime ranges.

Code · Plain text


SpawnConfig.spawnPeriod: 1–86400 s
SpawnConfig.spawnRadius: 8–256 blocks
SpawnConfig.minimumSpawnDistance: 0–spawnRadius
SpawnConfig.mobsPerRun: 1–100
SpawnConfig.maxPerChunk: 1–100
SpawnConfig.maxTotalMobs: 1–100000 / world
SpawnConfig.requiredPlayerMovement: 0–256 blocks
SpawnConfig.maxSpawnLightLevel: 0–15
SpawnConfig.locationSearchAttempts: 1–200
SpawnConfig.spawnAttemptsPerMob: 1–50

Per-monster settings
Use Mobs.<category>.<ID>. Enabled and SpawnChance control automatic selection. SpawnChance is a weight from 0 to 100, not an absolute spawn percentage; 0 excludes automatic selection. Among eligible definitions, selection share is weight divided by the sum of weights. Keep IDs such as BlastwaveCreeper and the category spelling Endermans unchanged. CustomName supports & color codes and &#RRGGBB or <#RRGGBB> hex colors; names are trimmed to 64 characters.

Code · Plain text


Mobs.Creepers.BlastwaveCreeper
Mobs.Creepers.ChainCreeper
Mobs.Creepers.EchoCreeper
Mobs.Creepers.FrostCreeper
Mobs.Creepers.PouncingCreeper
Mobs.Skeletons.PotionsArcher
Mobs.Skeletons.RocketSkeleton
Mobs.Skeletons.SkeletonArcher
Mobs.Skeletons.SkeletonSniper
Mobs.Skeletons.RunnerSkeleton
Mobs.Spiders.FastJumpSpider
Mobs.Spiders.MultiplyingSpider
Mobs.Spiders.MutantSpider
Mobs.Spiders.ThrowingSpider
Mobs.Spiders.VenomousSpider
Mobs.Zombies.BabyMonster
Mobs.Zombies.BloodmoonZombie
Mobs.Zombies.FullTankZombie
Mobs.Zombies.InvisibleStrikeZombie
Mobs.Zombies.LauncherZombie
Mobs.Zombies.ZombieWarrior
Mobs.Endermans.ShadowstepEnderman
Mobs.Endermans.RiftbinderEnderman
Mobs.Endermans.BlinkAmbusherEnderman
Mobs.Endermans.BruteEnderman
Mobs.Endermans.SingularityEnderman
Mobs.Witches.HexWitch
Mobs.Witches.VoodooWitch
Mobs.Witches.VolleyWitch
Mobs.Witches.EclipseWitch
Mobs.Ghasts.StormcallerGhast
Mobs.Blazes.EmberguardBlaze

Custom drops
Drops.Enabled controls extra rewards without replacing vanilla loot. RequirePlayerKill requires a player killer when true. MaxAdditionalStacksPerKill defaults to 2 and is limited to 1–5. Per-monster Drops.Entries supports up to nine valid entries. Each has Enabled, an item Material, Chance (0–100 percent), and MinAmount/MaxAmount (1–64). Entries are checked in ID order, numeric IDs first; each chance is rolled separately until the stack cap is reached. Later entries can therefore be skipped when earlier ones fill the cap. Invalid materials are ignored.

Emberguard Blaze abilities
EmberguardBlaze has an Abilities section. MaxHealth is 1–200; ChargedDamageMultiplier is 1–2; WeaknessTicks is 0–200, where 0 disables weakness. ShieldHealthThreshold is a health fraction from 0 to 1; ShieldDamageMultiplier is 0.1–1. Defaults give 30 health, 1.2× charged damage, 40 ticks of Weakness I, and 25% projectile damage reduction at or below 40% health. At normal server speed, 20 ticks equal one second. Most other monster abilities are defined in Java rather than generic YAML skill lists.

Configuration example
This is a configuration fragment. Merge it into the corresponding existing sections instead of creating duplicate top-level keys. Use the full bundled configuration below as the reference for every registered monster.

Configuration fragment

Code · Plain text


SpawnStatus: true
Drops:
  Enabled: true
  RequirePlayerKill: true
  MaxAdditionalStacksPerKill: 2
Mobs:
  Creepers:
    BlastwaveCreeper:
      Enabled: true
      CustomName: "&6&lBlastwave Creeper"
      SpawnChance: 20
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FIRE_CHARGE
            Chance: 10.0
            MinAmount: 1
            MaxAmount: 1
          2:
            Enabled: true
            Material: DIAMOND
            Chance: 1.0
            MinAmount: 1
            MaxAmount: 1
SpawnConfig:
  spawnPeriod: 5
  spawnRadius: 32
  minimumSpawnDistance: 16
  mobsPerRun: 3
  maxPerChunk: 5
  maxTotalMobs: 500
  DisabledWorlds:
    - world_the_end

Complete default configuration
The following Config.yml is reproduced exactly from this version. It includes example drops for all 32 registered monsters and the default spawning settings.

Default Config.yml

Code · Plain text


# Configuration version
# Do not change this value manually.
CfgVersion: 4.3

# Notify administrators about available updates when they join.
UpdateInfoOnJoin: true

# Master switch for automatic custom mob spawning.
SpawnStatus: true

# Show custom mob names above their heads.
CustomNamesVisible: true

# Extra rewards are added on top of vanilla drops. They are intentionally
# restricted to player kills by default, with a small hard cap per mob.
Drops:
  Enabled: true
  RequirePlayerKill: true
  MaxAdditionalStacksPerKill: 2

# Per-mob settings. SpawnChance is a selection weight from 0 to 100.
# A mob with a higher value is selected more often than other enabled mobs.
Mobs:

  Creepers:
    BlastwaveCreeper:
      Enabled: true
      CustomName: "&6&lBlastwave Creeper"
      SpawnChance: 20
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FIRE_CHARGE
            Chance: 10.0
            MinAmount: 1
            MaxAmount: 1
    ChainCreeper:
      Enabled: true
      CustomName: "&6&lChain Creeper"
      SpawnChance: 18
      Drops:
        Entries:
          1:
            Enabled: true
            Material: REDSTONE
            Chance: 18.0
            MinAmount: 1
            MaxAmount: 2
    EchoCreeper:
      Enabled: true
      CustomName: "&6&lEcho Creeper"
      SpawnChance: 14
      Drops:
        Entries:
          1:
            Enabled: true
            Material: ECHO_SHARD
            Chance: 4.0
            MinAmount: 1
            MaxAmount: 1
    FrostCreeper:
      Enabled: true
      CustomName: "&6&lFrost Creeper"
      SpawnChance: 16
      Drops:
        Entries:
          1:
            Enabled: true
            Material: PACKED_ICE
            Chance: 8.0
            MinAmount: 1
            MaxAmount: 1
    PouncingCreeper:
      Enabled: true
      CustomName: "&6&lPouncing Creeper"
      SpawnChance: 12
      Drops:
        Entries:
          1:
            Enabled: true
            Material: RABBIT_FOOT
            Chance: 8.0
            MinAmount: 1
            MaxAmount: 1

  Skeletons:
    PotionsArcher:
      Enabled: true
      CustomName: "&6&lPotions Archer"
      SpawnChance: 16
      Drops:
        Entries:
          1:
            Enabled: true
            Material: GLOWSTONE_DUST
            Chance: 16.0
            MinAmount: 1
            MaxAmount: 2
    RocketSkeleton:
      Enabled: true
      CustomName: "&6&lRocket Skeleton"
      SpawnChance: 14
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FIREWORK_ROCKET
            Chance: 7.0
            MinAmount: 1
            MaxAmount: 2
    SkeletonArcher:
      Enabled: true
      CustomName: "&6&lSkeleton Archer"
      SpawnChance: 20
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FLINT
            Chance: 20.0
            MinAmount: 1
            MaxAmount: 2
    SkeletonSniper:
      Enabled: true
      CustomName: "&6&lSkeleton Sniper"
      SpawnChance: 15
      Drops:
        Entries:
          1:
            Enabled: true
            Material: SPECTRAL_ARROW
            Chance: 5.0
            MinAmount: 1
            MaxAmount: 2
    RunnerSkeleton:
      Enabled: true
      CustomName: "&6&lRunner Skeleton"
      SpawnChance: 18
      Drops:
        Entries:
          1:
            Enabled: true
            Material: SUGAR
            Chance: 18.0
            MinAmount: 1
            MaxAmount: 2

  Spiders:
    FastJumpSpider:
      Enabled: true
      CustomName: "&6&lFast Jump Spider"
      SpawnChance: 18
      Drops:
        Entries:
          1:
            Enabled: true
            Material: RABBIT_HIDE
            Chance: 15.0
            MinAmount: 1
            MaxAmount: 2
    MultiplyingSpider:
      Enabled: true
      CustomName: "&6&lMultiplying Spider"
      SpawnChance: 12
      Drops:
        Entries:
          1:
            Enabled: true
            Material: SPIDER_EYE
            Chance: 15.0
            MinAmount: 1
            MaxAmount: 1
    MutantSpider:
      Enabled: true
      CustomName: "&6&lMutant Spider"
      SpawnChance: 10
      Drops:
        Entries:
          1:
            Enabled: true
            Material: COBWEB
            Chance: 6.0
            MinAmount: 1
            MaxAmount: 1
    ThrowingSpider:
      Enabled: true
      CustomName: "&6&lThrowing Spider"
      SpawnChance: 14
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FEATHER
            Chance: 18.0
            MinAmount: 1
            MaxAmount: 2
    VenomousSpider:
      Enabled: true
      CustomName: "&6&lVenomous Spider"
      SpawnChance: 12
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FERMENTED_SPIDER_EYE
            Chance: 8.0
            MinAmount: 1
            MaxAmount: 1

  Zombies:
    BabyMonster:
      Enabled: true
      CustomName: "&6&lBaby Monster"
      SpawnChance: 18
      Drops:
        Entries:
          1:
            Enabled: true
            Material: SWEET_BERRIES
            Chance: 20.0
            MinAmount: 2
            MaxAmount: 4
    BloodmoonZombie:
      Enabled: true
      CustomName: "&4&lBloodmoon Zombie"
      SpawnChance: 10
      Drops:
        Entries:
          1:
            Enabled: true
            Material: REDSTONE
            Chance: 18.0
            MinAmount: 1
            MaxAmount: 2
    FullTankZombie:
      Enabled: true
      CustomName: "&6&lFull Tank Zombie"
      SpawnChance: 12
      Drops:
        Entries:
          1:
            Enabled: true
            Material: IRON_NUGGET
            Chance: 24.0
            MinAmount: 2
            MaxAmount: 4
    InvisibleStrikeZombie:
      Enabled: true
      CustomName: "&6&lInvisible Strike Zombie"
      SpawnChance: 14
      Drops:
        Entries:
          1:
            Enabled: true
            Material: PHANTOM_MEMBRANE
            Chance: 7.0
            MinAmount: 1
            MaxAmount: 1
    LauncherZombie:
      Enabled: true
      CustomName: "&6&lLauncher Zombie"
      SpawnChance: 15
      Drops:
        Entries:
          1:
            Enabled: true
            Material: SLIME_BALL
            Chance: 14.0
            MinAmount: 1
            MaxAmount: 1
    ZombieWarrior:
      Enabled: true
      CustomName: "&6&lZombie Warrior"
      SpawnChance: 20
      Drops:
        Entries:
          1:
            Enabled: true
            Material: IRON_NUGGET
            Chance: 18.0
            MinAmount: 1
            MaxAmount: 3

  Endermans:
    ShadowstepEnderman:
      Enabled: true
      CustomName: "&6&lShadowstep Enderman"
      SpawnChance: 8
      Drops:
        Entries:
          1:
            Enabled: true
            Material: CHORUS_FRUIT
            Chance: 12.0
            MinAmount: 1
            MaxAmount: 1
    RiftbinderEnderman:
      Enabled: true
      CustomName: "&6&lRiftbinder Enderman"
      SpawnChance: 7
      Drops:
        Entries:
          1:
            Enabled: true
            Material: AMETHYST_SHARD
            Chance: 10.0
            MinAmount: 1
            MaxAmount: 2
    BlinkAmbusherEnderman:
      Enabled: true
      CustomName: "&6&lBlink Ambusher Enderman"
      SpawnChance: 6
      Drops:
        Entries:
          1:
            Enabled: true
            Material: ENDER_PEARL
            Chance: 10.0
            MinAmount: 1
            MaxAmount: 1
    BruteEnderman:
      Enabled: true
      CustomName: "&6&lBrute Enderman"
      SpawnChance: 7
      Drops:
        Entries:
          1:
            Enabled: true
            Material: OBSIDIAN
            Chance: 5.0
            MinAmount: 1
            MaxAmount: 1
    SingularityEnderman:
      Enabled: true
      CustomName: "&6&lSingularity Enderman"
      SpawnChance: 5
      Drops:
        Entries:
          1:
            Enabled: true
            Material: ECHO_SHARD
            Chance: 3.0
            MinAmount: 1
            MaxAmount: 1

  Witches:
    HexWitch:
      Enabled: true
      CustomName: "&6&lHex Witch"
      SpawnChance: 4
      Drops:
        Entries:
          1:
            Enabled: true
            Material: GLOWSTONE_DUST
            Chance: 15.0
            MinAmount: 1
            MaxAmount: 2
    VoodooWitch:
      Enabled: true
      CustomName: "&6&lVoodoo Witch"
      SpawnChance: 3
      Drops:
        Entries:
          1:
            Enabled: true
            Material: RABBIT_FOOT
            Chance: 8.0
            MinAmount: 1
            MaxAmount: 1
    VolleyWitch:
      Enabled: true
      CustomName: "&6&lVolley Witch"
      SpawnChance: 3
      Drops:
        Entries:
          1:
            Enabled: true
            Material: GUNPOWDER
            Chance: 15.0
            MinAmount: 1
            MaxAmount: 2
    EclipseWitch:
      Enabled: true
      CustomName: "&5&lEclipse Witch"
      SpawnChance: 2
      Drops:
        Entries:
          1:
            Enabled: true
            Material: AMETHYST_SHARD
            Chance: 13.0
            MinAmount: 1
            MaxAmount: 1

  Ghasts:
    StormcallerGhast:
      Enabled: true
      CustomName: "&d&lStormcaller Ghast"
      SpawnChance: 3
      Drops:
        Entries:
          1:
            Enabled: true
            Material: GHAST_TEAR
            Chance: 12.0
            MinAmount: 1
            MaxAmount: 1

  Blazes:
    EmberguardBlaze:
      Enabled: true
      CustomName: "&6&lEmberguard Blaze"
      SpawnChance: 4
      Abilities:
        MaxHealth: 30.0
        # Every third native fireball deals increased damage to players.
        ChargedDamageMultiplier: 1.2
        # Weakness I after a successful charged hit. 20 ticks = 1 second; 0 disables it.
        WeaknessTicks: 40
        # Below 40% health, incoming projectile damage is reduced by 25%.
        ShieldHealthThreshold: 0.4
        ShieldDamageMultiplier: 0.75
      Drops:
        Entries:
          1:
            Enabled: true
            Material: FIRE_CHARGE
            Chance: 12.0
            MinAmount: 1
            MaxAmount: 1

SpawnConfig:
  # Delay between spawn cycles in seconds.
  spawnPeriod: 5

  # Maximum and minimum horizontal distance from a player.
  spawnRadius: 32
  minimumSpawnDistance: 16

  # Amount and population safety limits.
  mobsPerRun: 3
  maxPerChunk: 5
  maxTotalMobs: 500

  # A player must move before another spawn attempt is made around them.
  requirePlayerMovement: true
  requiredPlayerMovement: 15

  # Location rules.
  allowSurfaceSpawns: true
  allowUndergroundSpawns: true
  maxSpawnLightLevel: 7
  locationSearchAttempts: 24
  spawnAttemptsPerMob: 4

  # Include recent vanilla natural spawns in the per-chunk safety limit.
  countNaturalMobsTowardsChunkLimit: true

  # Do not use creative or spectator players as spawn anchors.
  ignoreCreativeAndSpectatorPlayers: true

  # Extra diagnostic messages in the server console.
  debugLogging: false

  # Worlds in which BoostedMonsters must not spawn mobs.
  DisabledWorlds: []

BoostedMonsters — Configuration

Configuration

Welcome — language and privacy