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:

1. keeps only the matching spots with the highest priority
2. 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.