Creating Lures

Lures are created using the Filament item framework. Each lure consists of two parts:

Filament Item Definition - Controls appearance (model, name, lore)
Lure Behaviour - Controls mechanics (targeting, duration, boosts)

File Location

Create lure files in your data pack at:

data/<namespace>/filament/item/

Example path:

data/bloom/filament/item/fire_lure.json

Filament Item Section

Required Fields

Every lure must have these Filament fields:

id: Unique identifier (namespace:name format)
vanillaItem: Base Minecraft item (usually minecraft:paper)
properties: Item display properties

Item Properties

Define how the lure appears to players:

"properties": {
  "name": "<red>Fire Lure",
  "lore": [
    "<gray>Attracts Fire type Pokémon",
    "<gold>3x spawn rate!"
  ]
}

MiniMessage Color Codes

Use these in name and lore:

Colors:

<red>, <blue>, <green>, <yellow>, <gold>, <gray>, <white>, <black>
<dark_red>, <dark_blue>, <dark_green>, <dark_gray>, <dark_purple>, <dark_aqua>
<light_purple>, <aqua>

Formatting:

<bold>, <italic>, <underlined>, <strikethrough>, <obfuscated>

Examples:

"name": "<red><bold>Premium Lure"
"lore": ["<gray>The ultimate lure!", "<gold>5x spawns, <yellow>10x shiny"]

Lure Behaviour Section

The bloom:lure behaviour defines how the lure works. All fields go directly under behaviour.bloom:lure:

Core Fields

Field	Type	Default	Description
`particle`	String	`minecraft:happy_villager`	Particle effect resource location
`duration`	Integer	6000	Duration in ticks (20 ticks = 1 second)
`range`	Integer	32	Effective radius in blocks
`interval`	Integer	20	Ticks between particle spawns
`cooldown`	Integer	0	Cooldown between uses in ticks
`infinite`	Boolean	false	Lure never expires if true
`max_uses`	Integer	1	Number of times lure can be used

Targeting Fields

Field	Type	Default	Description
`types`	Array	[]	Pokemon type names (e.g., `["fire", "electric"]`)
`species`	Array	[]	Specific Pokemon with forms/aspects
`buckets`	Array	[]	Spawn rarity buckets (e.g., `["rare", "ultra-rare"]`)
`blacklist`	Boolean	false	If true, repels matching Pokemon
`bypass_spawn_check`	Boolean	false	Allow spawns even if checks fail

Boost Fields

Field	Type	Default	Description
`spawn_boost`	Float	1.0	Spawn rate multiplier/modifier
`shiny_boost`	Float	1.0	Shiny rate multiplier/modifier
`ha_boost`	Float	0.0	Hidden ability chance (0.0-1.0 = 0%-100%)
`modifier_type`	String	`MULTIPLY`	How boosts apply: “MULTIPLY”, “ADD”, or “SET”

Species Format

When targeting specific Pokemon:

"species": [
  {
    "name": "pikachu",
    "forms": [
      {"aspects": []},
      {"aspects": ["alolan"]},
      {"aspects": ["shiny", "alolan"]}
    ]
  }
]

Note: Don’t include cobblemon: prefix in species names.

Type-Based Lures

Attract Pokemon of specific types.

Single Type

{
  "id": "bloom:fire_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<red>Fire Lure",
    "lore": [
      "<gray>Attracts Fire type Pokémon",
      "<gold>3x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:flame",
      "types": ["fire"],
      "species": [],
      "buckets": [],
      "blacklist": false,
      "bypass_spawn_check": false,
      "duration": 36000,
      "range": 32,
      "interval": 20,
      "cooldown": 0,
      "infinite": false,
      "max_uses": 1,
      "spawn_boost": 3.0,
      "shiny_boost": 1.0,
      "ha_boost": 0.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Multi-Type

{
  "id": "bloom:aquatic_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<blue>Aquatic Lure",
    "lore": [
      "<gray>Attracts Water and Ice types",
      "<gold>4x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:bubble",
      "types": ["water", "ice"],
      "duration": 48000,
      "range": 40,
      "spawn_boost": 4.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Species-Based Lures

Target specific Pokemon and their forms.

Single Species

{
  "id": "bloom:pikachu_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<yellow>Pikachu Lure",
    "lore": [
      "<gray>Attracts Pikachu",
      "<gold>10x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:electric_spark",
      "species": [
        {
          "name": "pikachu",
          "forms": [
            {"aspects": []}
          ]
        }
      ],
      "duration": 24000,
      "range": 32,
      "spawn_boost": 10.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Evolution Line

{
  "id": "bloom:eevee_evolution_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<light_purple>Eevee Evolution Lure",
    "lore": [
      "<gray>Attracts Eevee and evolutions",
      "<gold>5x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:end_rod",
      "species": [
        {"name": "eevee", "forms": [{"aspects": []}]},
        {"name": "vaporeon", "forms": [{"aspects": []}]},
        {"name": "jolteon", "forms": [{"aspects": []}]},
        {"name": "flareon", "forms": [{"aspects": []}]},
        {"name": "espeon", "forms": [{"aspects": []}]},
        {"name": "umbreon", "forms": [{"aspects": []}]},
        {"name": "leafeon", "forms": [{"aspects": []}]},
        {"name": "glaceon", "forms": [{"aspects": []}]},
        {"name": "sylveon", "forms": [{"aspects": []}]}
      ],
      "duration": 72000,
      "range": 48,
      "spawn_boost": 5.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Regional Forms

{
  "id": "bloom:alolan_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<light_purple>Alolan Lure",
    "lore": [
      "<gray>Attracts Alolan forms",
      "<gold>100x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:cherry_leaves",
      "species": [
        {
          "name": "vulpix",
          "forms": [{"aspects": ["alolan"]}]
        },
        {
          "name": "ninetales",
          "forms": [{"aspects": ["alolan"]}]
        },
        {
          "name": "sandshrew",
          "forms": [{"aspects": ["alolan"]}]
        },
        {
          "name": "sandslash",
          "forms": [{"aspects": ["alolan"]}]
        }
      ],
      "duration": 12000,
      "range": 32,
      "spawn_boost": 100.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Bucket-Based Lures

Target spawn rarity categories.

Rare Pokemon

{
  "id": "bloom:rare_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<gold>Rare Lure",
    "lore": [
      "<gray>Attracts rare Pokémon",
      "<gold>5x spawn rate!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:glow",
      "buckets": ["rare", "ultra-rare"],
      "duration": 12000,
      "range": 64,
      "spawn_boost": 5.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Shiny Hunting Lures

Boost shiny spawn rates.

Pure Shiny Boost

{
  "id": "bloom:shiny_charm",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<gold>Shiny Charm",
    "lore": [
      "<gray>Boosts shiny spawn rates",
      "<gold>5x shiny chance!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:glow",
      "duration": 24000,
      "range": 40,
      "spawn_boost": 1.5,
      "shiny_boost": 5.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Type-Specific Shiny

{
  "id": "bloom:electric_shiny_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<yellow><bold>Electric Shiny Lure",
    "lore": [
      "<gray>Attracts shiny Electric types",
      "<gold>3x spawns, 3x shiny!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:electric_spark",
      "types": ["electric"],
      "duration": 36000,
      "range": 32,
      "spawn_boost": 3.0,
      "shiny_boost": 3.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Hidden Ability Lures

Increase hidden ability chances.

{
  "id": "bloom:ha_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<dark_purple>Hidden Ability Lure",
    "lore": [
      "<gray>Spawns Pokémon with hidden abilities",
      "<gold>15% HA chance"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:witch",
      "duration": 36000,
      "range": 32,
      "spawn_boost": 2.0,
      "ha_boost": 0.15,
      "modifier_type": "MULTIPLY"
    }
  }
}

Repel Lures

Prevent unwanted spawns using blacklist mode.

Legendary Repel

{
  "id": "bloom:legendary_repel",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<dark_gray>Legendary Repel",
    "lore": ["<gray>Prevents legendary spawns"]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:smoke",
      "buckets": ["ultra-rare"],
      "blacklist": true,
      "duration": 72000,
      "range": 64,
      "modifier_type": "MULTIPLY"
    }
  }
}

Type Repel

{
  "id": "bloom:bug_repel",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<dark_gray>Bug Repel",
    "lore": ["<gray>Prevents Bug type spawns"]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:smoke",
      "types": ["bug"],
      "blacklist": true,
      "duration": 48000,
      "range": 48,
      "modifier_type": "MULTIPLY"
    }
  }
}

Omni Lures

Boost all spawns without targeting.

{
  "id": "bloom:omni_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<white><bold>Omni Lure",
    "lore": [
      "<gray>Boosts all spawns",
      "<gold>2x spawns, 1.5x shiny!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:end_rod",
      "duration": 72000,
      "range": 48,
      "spawn_boost": 2.0,
      "shiny_boost": 1.5,
      "ha_boost": 0.05,
      "modifier_type": "MULTIPLY"
    }
  }
}

Advanced Lures

Premium Lure

High boosts across all categories:

{
  "id": "bloom:premium_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<gold><bold>Premium Lure",
    "lore": [
      "<gray>The ultimate lure!",
      "<gold>5x spawns, 10x shiny, 20% HA!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:totem_of_undying",
      "duration": 144000,
      "range": 64,
      "spawn_boost": 5.0,
      "shiny_boost": 10.0,
      "ha_boost": 0.20,
      "modifier_type": "MULTIPLY"
    }
  }
}

Event Lure

Themed for server events:

{
  "id": "bloom:spring_festival_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<green><italic>Spring Festival Lure",
    "lore": [
      "<gray>Limited time event lure!",
      "<gold>3x spawns, 2x shiny!"
    ]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:cherry_leaves",
      "types": ["grass", "fairy"],
      "duration": 36000,
      "range": 32,
      "spawn_boost": 3.0,
      "shiny_boost": 2.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Infinite Lure

Never expires:

{
  "id": "bloom:eternal_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<light_purple><bold>Eternal Lure",
    "lore": ["<gray>Lasts forever!"]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:portal",
      "infinite": true,
      "range": 32,
      "spawn_boost": 2.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Multi-Use Lure

Can be placed multiple times:

{
  "id": "bloom:reusable_lure",
  "vanillaItem": "minecraft:paper",
  "properties": {
    "name": "<green>Reusable Lure",
    "lore": ["<gray>Can be used 5 times"]
  },
  "behaviour": {
    "bloom:lure": {
      "particle": "minecraft:happy_villager",
      "duration": 12000,
      "max_uses": 5,
      "range": 32,
      "spawn_boost": 2.0,
      "modifier_type": "MULTIPLY"
    }
  }
}

Lure Balancing

Duration Guidelines

Duration is in ticks (20 ticks = 1 second):

Short (6000-12000 ticks / 5-10 min): High boosts, rare lures
Medium (24000-48000 ticks / 20-40 min): Standard lures
Long (72000-144000 ticks / 1-2 hours): Lower boosts, farming lures

Common durations:

5 minutes: 6000 ticks
10 minutes: 12000 ticks
30 minutes: 36000 ticks
1 hour: 72000 ticks
2 hours: 144000 ticks

Range Guidelines

Small (16-32 blocks): Specific targeting
Medium (32-48 blocks): General use
Large (48-64 blocks): Area coverage

Boost Guidelines

spawn_boost: 1.5-5.0 for balanced, 5.0-20.0 for powerful
shiny_boost: 2.0-5.0 for balanced, 5.0-10.0 for dedicated shiny hunting
ha_boost: 0.05-0.20 (5%-20%) typical, 0.5-1.0 (50%-100%) for guaranteed

HA Boost Values:

Low: 0.05-0.10 (5-10%)
Medium: 0.15-0.25 (15-25%)
High: 0.30-0.50 (30-50%)
Guaranteed: 1.0 (100%)

File Organization

data/
  yournamespace/
    filament/
      item/
        fire_lure.json
        water_lure.json
        alolan_lure.json
        shiny_lure.json
        omni_lure.json

Testing Lures

Create your JSON file in data/<namespace>/filament/item/
Reload with /reload (Filament auto-reloads)
Give yourself the lure: /bloom lure <namespace>:<id>
Crouch and drop the lure item to place it
Test spawn rates and targeting
Adjust values and reload as needed

Creating Lures

Creating Lures

File Location

Filament Item Section

Required Fields

Item Properties

MiniMessage Color Codes

Lure Behaviour Section

Core Fields

Targeting Fields

Boost Fields

Species Format

Type-Based Lures

Single Type

Multi-Type

Species-Based Lures

Single Species

Evolution Line

Regional Forms

Bucket-Based Lures

Rare Pokemon

Shiny Hunting Lures

Pure Shiny Boost

Type-Specific Shiny

Hidden Ability Lures

Repel Lures

Legendary Repel

Type Repel

Omni Lures

Advanced Lures

Premium Lure

Event Lure

Infinite Lure

Multi-Use Lure

Lure Balancing

Duration Guidelines

Range Guidelines

Boost Guidelines

File Organization

Testing Lures

Next Steps