Skip to content

Custom Raid Den Structures

necro50n3 edited this page Jul 21, 2026 · 12 revisions

Creating a Raid Den Structure

Adding a new raid den structure involves a little bit more than just "create and drop" in a data pack.

You do not need to add the raid crystal as that will be added in during generation (see Offset). You can choose to add a Power Spot if you would like players to be able to Dynamax during their battle.

Some extra tips when creating a new structure:

  • The size limit of a raid den is 128 blocks from the offset/origin point in x and z, and 64 blocks in y.
  • Make use of light blocks to ensure the area is properly lit up so players can see.
  • Make use of barrier blocks in structures with open spaces so players don't go to areas they aren't supposed to.
  • Players cannot break or place blocks while inside a raid den, so you can be very liberal in your block palette.

Directional Requirements

Raid dens must face NORTH. Players will face north when spawning into the raid den, and likewise the raid boss will face South.

NBT Requirements

Raid dens also need extra NBT data with specific values to properly function. I highly recommend using a program such as NBTExplorer or an IDE that allows editing NBTs to easily manage this.

"raid_pois": CompoundTag
├── "offset_x": Double Tag
├── "offset_y": Double Tag
├── "offset_z": Double Tag
├── "boss_x": Double Tag
├── "boss_y": Double Tag
├── "boss_z": Double Tag
├── "player_x": Double Tag
├── "player_y": Double Tag
└── "player_z": Double Tag

Offset

The distance from where the Raid Home Crystal will generate to the bottom corner of the structure. The structure will generate with the Raid Crystal as the origin point of the raid den region, and the other two POIs will be based off these coordinates.

Boss

The position the raid boss will spawn in. Note that this should be the coordinates AFTER the offset has been applied.

Player

The position the player will spawn in. Note that this should be the coordinates AFTER the offset has been applied.

Optional NBT Parameters

There are some additional optional parameters that let you further customise the raid den properties. These are not required for a functioning raid den.

"raid_pois": CompoundTag
└── "scale_modifier": Double Tag

Scale Modifier

A final modifier to the raid boss's scale to adjust their size based on the size of the raid den. This is applied on top of the existing scaling algorithm.

Adding A New Structure

Once you have created a valid structure, you must save the NBT under structure/raid_den/.... It will not be registered unless it is part of the raid_den subfolder.

Applying the New Structure

There are two ways you can make your structure spawn.

Raid Bosses

You can assign raid den structures when creating a raid boss. Adding the resource location (i.e. modid:raid_den/xxx) will allow raid bosses to generate randomly in any of its entries. You can also assign a structure pool (See below) by prefixing the entry with a hash "#".

The Default Structure Pool

By default, all raid bosses will generate a raid den from the #cobblemonraiddens:default structure pool, which only contains the basic raid den structure. You can add new structures to this pool by following the tag format:

data/cobblemonraiddens/raid/den_pool/default.json
{
    "replace": false,
    "values": [
        "cobblemonraiddens:raid_den/basic"
    ]
}

Structure Pools

You can add more pools by following the same format as above and putting them in the raid/den_pool namespace (i.e. modid/raid/den_pool/name.json). When a boss is generated, either on crystal spawn or after a reset, it will randomly select from one of the structures it's been assigned, including any from an assigned structure pool. You can assign a structure to the boss with the tag #modid:name.

Clone this wiki locally