Pillager Caravans

Caravan Placement

Updated 2025-10-05

Edit on GitHub
JSON Example
{
  "weight": 1000,
  "biomes": "#caravans:has_desert_caravan",
  "pools": [
    {
      "weight": 80,
      "variations": [
        "caravans:desert_gold_tier_1",
        "caravans:desert_gold_tier_2",
        "caravans:desert_gold_tier_3"
      ]
    },
    {
      "weight": 20,
      "variations": [
        "caravans:desert_sugar_cane_tier_1",
        "caravans:desert_sugar_cane_tier_2",
        "caravans:desert_sugar_cane_tier_3"
      ]
    }
  ]
}
FieldTypeDescription
weightIntegerHow likely this placement file is to be chosen compared to others. If several placements match the same area, one of them will be picked randomly using these weights.
biomesIdentifier or Array[Identifier]A single biome ID, a biome tag (like #minecraft:is_forest), or an array of them. Caravans from this placement will only spawn in these biomes.
poolsArray[CaravanPool]An array of themed groups of caravan variations.

- Each pool has its own weight – controlling how often that pool is picked.
- Inside each pool is an array of variations.
- When a caravan spawns, the game first chooses a random pool based on pool weights, then picks one of that pool’s variations by its own weight.