Getting Started

Getting Started

Installation

1. Download Radial Placements from CurseForge or Modrinth
2. Place the jar in your mods/ folder
3. Requires NeoForge for Minecraft 1.21.1

The mod itself adds no content -- it registers the radial_placements:equidistant_ring placement type for use in datapacks.

Your First Ring

Create a datapack with the following structure:

my_datapack/
  pack.mcmeta
  data/
    my_namespace/
      worldgen/
        structure_set/
          ring_villages.json

pack.mcmeta

{
  "pack": {
    "pack_format": 48,
    "description": "My ring structures"
  }
}

ring_villages.json

{
  "structures": [
    { "structure": "minecraft:village_plains", "weight": 1 },
    { "structure": "minecraft:village_desert", "weight": 1 },
    { "structure": "minecraft:village_savanna", "weight": 1 },
    { "structure": "minecraft:village_snowy", "weight": 1 },
    { "structure": "minecraft:village_taiga", "weight": 1 }
  ],
  "placement": {
    "type": "radial_placements:equidistant_ring",
    "salt": 74029831,
    "distance": 300,
    "count": 3
  }
}

This places 3 villages in a ring 300 blocks from world origin. Including all village variants ensures at least one can generate regardless of biome.

Verifying It Works

1. Create a new world with the datapack enabled
2. Open the console and run /locate structure minecraft:village_plains
3. Check the log output -- the mod logs node positions at INFO level on first evaluation:

   [RadialPlacements] Computing ring 'unnamed': salt=74029831, distance=300, count=3, ...
   [RadialPlacements]   'unnamed' Node 0 -> block(308, ~, 12) chunk(19, 0) angle=42.7deg dist=285