Rustling Spots Example Datapack

This is the official example datapack for the Custom Spot Definitions system added to Rustling Spots.

It demonstrates how to create your own custom rustling spots using datapacks only, without Java code, resource packs, custom models, custom textures, or scripting systems.

Features

Complete working example datapack
Designed for Minecraft 1.21.1
Uses the official Rustling Spots datapack format
Adds a complete swamp-themed custom spot example
Demonstrates custom spot definitions
Demonstrates custom Pokémon families
Demonstrates custom loot families
Supports biome and block tags
Supports weighted particle selection
Includes a reusable structure for modpacks and servers

What This Datapack Shows

The included example adds a custom swamp rustling spot that can appear in swamp-style environments and uses its own Pokémon pool, loot pool, priority, weight, valid blocks, valid biomes, and particle setup.

Custom spots can define:

where the spot can appear
which dimensions it can use
which biomes it can use
which blocks it can spawn on
which Pokémon family it uses
which loot family it uses
which particles it plays
its spawn priority and selection weight

Important Visual Note

Custom spots currently reuse the default grass spot visual base.

This means custom spots do not add new models, textures, or rendering systems. Their main visual difference comes from the particles defined in the datapack.

Installation

Place the datapack folder inside:

world/datapacks/

Then run:

/reload

You can test the included example spot with:

/rustlingspots spawn rustlingspots:swamp_custom

Datapack Structure

custom_swamp_spot_pack/
├─ pack.mcmeta
├─ README.txt
└─ data/
   └─ rustlingspots/
      └─ rustling_spots/
         ├─ spot_definitions/
         │  └─ swamp.json
         ├─ pokemon_families/
         │  └─ swamp.json
         └─ loot_families/
            └─ swamp.json

Example Spot Definition

{
  "format_version": 1,
  "id": "rustlingspots:swamp_custom",
  "display_name": "Swamp Spot",
  "priority": 10,
  "weight": 5,
  "dimensions": [
    "minecraft:overworld"
  ],
  "biomes": [
    "minecraft:swamp",
    "minecraft:mangrove_swamp",
    "#minecraft:is_forest"
  ],
  "blocks": [
    "minecraft:mud",
    "minecraft:grass_block",
    "#minecraft:dirt"
  ],
  "pokemon_family": "rustlingspots:swamp",
  "loot_family": "rustlingspots:swamp",
  "particles": [
    {
      "type": "rustlingspots:grass_burst",
      "weight": 7
    },
    {
      "type": "minecraft:happy_villager",
      "weight": 3
    }
  ]
}

Priority and Weight

When the mod tries to spawn a rustling spot, it checks all valid built-in and datapack spots for the current location.

The system then:

keeps only the matching spots with the highest priority
selects one final spot using weight

Built-in Rustling Spots use priority 0 and weight 1. If you want your custom spot to naturally override the default behavior in its area, use a priority above 0.

Supported Particles

Custom spots can use simple vanilla particles and existing Rustling Spots particle types.

Example:

"particles": [
  { "type": "rustlingspots:grass_burst", "weight": 7 },
  { "type": "minecraft:happy_villager", "weight": 3 }
]

Only type and weight are supported. There is no support for custom speed, offset, color, particle count, textures, or models.

Useful Commands

/reload
/rustlingspots reload
/rustlingspots spawn rustlingspots:swamp_custom
/rustlingspots spawnshiny rustlingspots:swamp_custom
/rustlingspots scan 64

Who Is This For?

Modpack creators
Cobblemon servers
Datapack creators
Custom world designers
Players who want to create themed Rustling Spots without coding

Requirements

Rustling Spots v3.0+
Cobblemon 1.7+
Minecraft 1.21.1

Important Notes

This is an example datapack, not a standalone mod.
It requires Rustling Spots to work.
It does not add custom models or textures.
It is meant as a clean template for creating your own custom spots.

Summary

Rustling Spots Example Datapack is a ready-to-use template showing how to create custom rustling spots with datapacks only.

Use it as a base, duplicate it, rename the IDs, adjust the biomes, blocks, Pokémon, loot, and particles, then build your own themed spot addons for Rustling Spots.

Rustling Spots - Example Addon Datapack