Outbreak Types

Outbreak Types

Outbreaks come in two varieties, each with unique spawn mechanics and use cases.

Biome Pool Outbreaks

Biome pool outbreaks enhance the natural Pokemon spawns already present in a biome. When active, Pokemon that would normally spawn in that biome appear at dramatically increased rates.

How It Works

1. Uses the biome’s existing spawn pool (whatever Pokemon naturally spawn there)
2. Increases spawn rates for all species in that biome
3. Applies progressive bonuses: more catches = better rates for shinies, IVs, and hidden abilities
4. Respects normal spawning rules (time of day, weather, etc.)

Progressive Rewards

As players catch more Pokemon during a biome pool outbreak, rewards improve:

• Shiny Rates: Increases after catching multiple Pokemon (e.g., 1/4096 → 1/512)
• Perfect IVs: More guaranteed perfect stats as catches increase (0 → 4 perfect IVs)
• Hidden Abilities: Chance increases with more catches (0% → 40%)

Configuration Example

{
  type = "biome"

  spawnConditions {
    biomes = ["#minecraft:is_plains"]
  }

  duration = 3600
  spawnRate = 100
  maxSpawns = 50
  concurrentSpawnCap = 10
  radius = 150

  shinyRates = "0-10: 4096, 11-20: 1024, 21-30: 512, 31-999: 341.3"
  ivRangeValues = "0-5: 0, 6-10: 1, 11-20: 2, 21-30: 3, 31-999: 4"
  hiddenAbilityRangeValues = "0-5: 0, 6-10: 0.1, 11-20: 0.2, 21-30: 0.3, 31-999: 0.4"

  particleEffect {
    type = "vanilla"
    particle = "minecraft:electric_spark"
  }

  rewards = []
}

Use Cases

• Biome Exploration Events: Encourage players to visit specific biomes
• Catch Competitions: Players compete to catch the most outbreak Pokemon
• Shiny Hunting: Progressive shiny rates reward dedicated hunters
• Natural Spawns: Keeps spawns contextual to the environment

Distortion Outbreaks

Distortion outbreaks spawn a custom list of Pokemon regardless of biome. Think of them as dimensional rifts bringing in Pokemon that wouldn’t normally appear.

How It Works

1. Spawns only Pokemon from the configured species list
2. Ignores the biome’s natural spawn pool entirely
3. Can spawn rare or legendary Pokemon
4. Uses weighted spawn chances for different species
5. Can guarantee shinies or other special aspects

Configuration Example

{
  type = "distortion"

  spawnConditions {
    biomes = ["#minecraft:is_overworld"]
  }

  species = [
    {
      species = "porygon"
      aspects = []
      level_range = "30..40"
      weight = 3.0
    },
    {
      species = "porygon2"
      aspects = []
      level_range = "40..50"
      weight = 2.0
    },
    {
      species = "porygonz"
      aspects = ["shiny=yes"]
      level_range = "50..60"
      weight = 0.1
    }
  ]

  duration = 1800
  spawnRate = 100
  maxSpawns = 30
  concurrentSpawnCap = 8
  radius = 100

  particleEffect {
    type = "vanilla"
    particle = "minecraft:portal"
  }

  rewards = [
    {
      type = "command"
      command = "give {player} minecraft:diamond 3"
    }
  ]
}

Species Configuration

Each species entry supports:

• species: Pokemon identifier (e.g., “pikachu”, “charizard”)
• aspects: Special properties like shiny=yes, legendary, etc.
• level_range: Level range as “min..max” (e.g., “30..40”)
• weight: Spawn probability weight (higher = more common)

Use Cases

• Legendary Events: Time-limited access to rare Pokemon
• Themed Outbreaks: Spawn groups of related Pokemon (e.g., all evolutions)
• Guaranteed Shinies: Configure specific Pokemon to always be shiny
• Cross-Biome Access: Give players access to Pokemon from other biomes

Comparison

Feature	Biome Pool	Distortion
Spawn Source	Natural biome spawns	Custom species list
Progressive Bonuses	Yes (shiny, IV, HA)	No
Contextual	Yes	No
Guaranteed Species	No	Yes
Legendary Access	Only if biome allows	Yes, configurable
Best For	Natural events	Special events

Choosing an Outbreak Type

Use Biome Pool when:

• You want to enhance natural gameplay
• Progressive rewards fit your server
• You want contextual spawns
• Players should explore different biomes

Use Distortion when:

• You need specific Pokemon to spawn
• You want to give access to rare/legendary Pokemon
• You want guaranteed shinies or aspects
• You’re running a themed event

Common Patterns

Starter Outbreak (Biome Pool)

spawnConditions {
  biomes = ["#minecraft:is_plains"]
}
duration = 7200
maxSpawns = 100

Good for long events with natural spawns.

Legendary Hunt (Distortion)

species = [
  {
    species = "mewtwo"
    level_range = "70..70"
    weight = 0.5
  },
  {
    species = "rattata"
    level_range = "5..10"
    weight = 10.0
  }
]
duration = 600
maxSpawns = 10

Short, intense event with rare legendary spawns.

Shiny Guaranteed (Distortion)

species = [
  {
    species = "rayquaza"
    aspects = ["shiny=yes"]
    level_range = "70..70"
    weight = 1.0
  }
]
maxSpawns = 1

One-time guaranteed shiny spawn.

Next Steps

• Configuration
• Installation