Skip to content
Matcha! Mods

Introduction to Bloom

Introduction to Bloom

Section titled “Introduction to Bloom”

Bloom is a lure system for Cobblemon servers that gives players physical lure items they can place in the world or carry on their person. Lures attract specific Pokemon, boost spawn rates, increase shiny chances, and more — all within a configurable radius.

Why Bloom?

Section titled “Why Bloom?”

Players want to hunt for specific Pokemon without wandering aimlessly. Bloom makes that possible. A player places a Fire Lure and the area fills with Fire-type spawns. A shiny hunter pops a Shiny Charm and their odds jump. A server admin hands out event lures for a weekend festival. It’s all one item and a right-click.

Two Activation Modes

Section titled “Two Activation Modes”

Every lure supports two ways to activate:

Placed Mode (right-click) : Drop the lure into the world as a physical entity. It creates a hologram, plays particles, and affects spawns in a radius around where it was placed. The owner can recall it with a double right-click.

Personal Mode (sneak + right-click) : Bind the lure to yourself. It follows you as you move, with the hologram and particles riding on your character. A countdown timer appears in your action bar.

You can configure lures to support one mode, the other, or both.

Core Systems at a Glance

Section titled “Core Systems at a Glance”

Lure Definitions : Lures are defined as Filament item definitions in datapacks. The bloom:lure behaviour block controls targeting, duration, boosts, sounds, and display.

Targeting : Filter spawns by Pokemon type, specific species and forms, or spawn bucket rarity. Flip the blacklist flag to repel instead of attract.

Spawn Boosts : Multiply spawn rates, shiny chances, and hidden ability rates. Choose between multiply, add, or set modifier modes.

Particle Compositions : HOCON-based particle effect files with layered shapes — circles, helixes, spheres, cones, and more. Attach any composition to any lure.

Hologram Display : Placed and personal lures show customizable text holograms with MiniMessage formatting, owner heads, and live countdown timers.

Sounds : Configure ambient loops, placement sounds, attraction pings, expiration alerts, and recall effects per lure.

Configuration Structure

Section titled “Configuration Structure”
data/<namespace>/filament/item/    # Lure item definitions (JSON)
config/bloom/
├── bloom.conf                     # Global settings (HOCON)
└── particles/                     # Particle compositions (HOCON)
    ├── grass_aura.conf
    ├── fire_blaze.conf
    └── electric_surge.conf

Three example particle compositions are generated on first startup.

What You’ll Need

Section titled “What You’ll Need”

Required:

  • Minecraft 1.21.1 (Fabric)
  • Fabric Loader 0.17+
  • Fabric API
  • Fabric Language Kotlin
  • Cobblemon 1.6+
  • Ceremony 4.0+
  • Filament
  • Polymer

Optional:

  • Cardinal Components API (for data persistence features)

Next Steps

Section titled “Next Steps”
  1. Installation — Get Bloom running on your server
  2. Creating Lures — Build your first lure from scratch
  3. Particle Compositions — Design custom particle effects
  4. Configuration Reference — Every field, explained